程式工具
OpenCode
設定 OpenCode 以使用 TokenLab API
交給我的 Agent 設定
把這段任務交給電腦上已經可用的 Agent:
閱讀此教學,協助我將 OpenCode 連接至 TokenLab:
https://tokenlab.sh/docs/zh-TW/integrations/opencode
先檢查已安裝版本與目前生效的設定。
保留既有帳戶、供應商、權限及其他設定。
備份本機檔案並展示預計修改的內容。
讓我在本機輸入所需的 API 金鑰;不要在聊天中索取、顯示或貼上金鑰。
先確認設定能正常載入。
執行任何付費請求測試前,請另行說明費用。概覽
類型: 程式工具
主要路徑: OpenAI 相容
支援級別: 支援路徑
OpenCode 是一個在終端機中執行的開源 AI 程式設計助理。它支援多種 LLM 供應商,並可設定為使用 TokenLab 的 API,以存取數百個模型。
安裝
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 |