TokenLab

程式工具

OpenCode

設定 OpenCode 以使用 TokenLab API

交給我的 Agent 設定

把這段任務交給電腦上已經可用的 Agent:

閱讀此教學,協助我將 OpenCode 連接至 TokenLab:
https://tokenlab.sh/docs/zh-TW/integrations/opencode
先檢查已安裝版本與目前生效的設定。
保留既有帳戶、供應商、權限及其他設定。
備份本機檔案並展示預計修改的內容。
讓我在本機輸入所需的 API 金鑰;不要在聊天中索取、顯示或貼上金鑰。
先確認設定能正常載入。
執行任何付費請求測試前,請另行說明費用。

概覽

類型: 程式工具

主要路徑: OpenAI 相容

支援級別: 支援路徑

OpenCode 是一個在終端機中執行的開源 AI 程式設計助理。它支援多種 LLM 供應商,並可設定為使用 TokenLab 的 API,以存取數百個模型。

安裝

OpenCode

npm install -g opencode-ai@1.18.31

驗證安裝:

opencode --version

設定

步驟 1:設定環境變數

依快速開始的 macOS、Linux、WSL 或 Windows PowerShell 步驟設定 TOKENLAB_API_KEY,避免把金鑰寫入命令歷史,再從同一終端機啟動 OpenCode。長期使用請透過本地秘密管理工具提供金鑰,不要把明文金鑰附加至 shell 設定檔。

步驟 2:設定 OpenCode

以下設定已在 OpenCode 1.18.31 驗證;其他版本須依其官方文件另行確認。

將以下設定儲存為獨立的 ~/.config/opencode/tokenlab.jsonc;若已設定 XDG_CONFIG_HOME,則使用該目錄下的 opencode/tokenlab.jsonc。保留一般的 opencode.json / opencode.jsonc、帳戶、預設模型與權限;只有本次啟動以 OPENCODE_CONFIG 選取此檔案時才會載入。若檔案或供應商名稱已用於其他設定,請另選檔案或名稱並同步修改啟動指令。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:TOKENLAB_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        }
      }
    }
  }
}

此處使用 @ai-sdk/openai-compatible 傳送 Chat Completions。請依目前模型詳情確認 Chat Completions 與所需工具支援;此範例無法證明其他協定或版本相容。

可選:使用可還原的 OpenCode 設定工具,透過 Python 3.11+ 預覽、套用並還原原始檔案。TokenLab Skills 外掛 0.1.2 已包含新腳本;獨立安裝的 Skill 更新至包含這些腳本的版本後也可使用。已安裝外掛或獨立 Skill 的使用者請依 README 更新說明更新,並確認腳本已安裝。也可直接完成本頁的手動設定。

基本用法

依快速開始設定金鑰後,僅為本次啟動載入此檔案並明確選取模型。使用自訂路徑或供應商名稱時請相應替換。若已有 OPENCODE_CONFIG 或內嵌 OPENCODE_CONFIG_CONTENT 設定,請保留原設定並使用獨立啟動環境;專案及受管理設定仍可能優先。

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terra

模型清單只能確認本機載入,不能證明金鑰有效或線上請求成功。傳送提示詞會使用 TokenLab 餘額,OpenCode 也可能發出標題生成等個別計費的輔助請求。請核對回覆及對應的請求記錄。

不載入此檔案即可使用原設定啟動。請勿為本教學將 OPENCODE_CONFIG 寫入 shell 設定檔。撤銷手動設定時,只刪除本次建立的獨立檔案;若檔案原本已存在,則還原其備份。

可用模型

模型最適合用途
gpt-5.6-terra複雜任務、程式碼架構
gpt-5.6-luna快速修正、簡單查詢
claude-sonnet-4-6程式碼審查、文件撰寫
claude-opus-4-6複雜推理
gemini-3.5-flash快速回應

常用指令

分析程式碼:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.ts

產生程式碼:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"

檢查變更:

git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"

修正錯誤:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"

互動指令

指令說明
/help顯示可用指令
/models切換至不同模型
/clear清除對話歷史
/exit結束 OpenCode

疑難排解

最佳實務

本頁內容