程式工具
OpenCode
設定 OpenCode 以使用 TokenLab API
讓我的 Agent 進行設定
將此任務複製到您電腦上已執行的 Agent:
Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/zh-TW/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.概覽
OpenCode 可以透過自訂的 OpenAI 相容提供者(provider)使用 TokenLab。請加入 TokenLab API 金鑰、Base URL 以及目前的模型 ID。
安裝
npm install -g opencode-ai@1.18.31驗證安裝:
opencode --version設定
第 1 步:設定環境變數
使用 macOS、Linux、WSL 或 Windows PowerShell 的 快速上手 終端機指令來設定 TOKENLAB_API_KEY,避免將金鑰寫入指令歷史記錄中。從該終端機啟動 OpenCode。若需持久化使用,請使用您當地的密鑰管理工具(secret manager);請勿將明文金鑰附加到您的 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 更新說明 並確認指令碼已存在。此處的手動設定在沒有輔助工具的情況下依然可用。
基本用法
使用 Quickstart 設定金鑰,然後載入此檔案並明確選擇該模型以進行呼叫。如果已自訂,請替換為您的實際路徑和提供者名稱。請將任何現有的 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模型探索會檢查本地載入情況,而非金鑰有效性或即時請求是否成功。提示詞(prompt)會消耗 TokenLab 餘額,且 OpenCode 可能會發送單獨計費的輔助請求,例如標題生成。請檢查回覆以及對應的 請求記錄。
若要使用您一般的設定,請在不載入此層的情況下啟動。請勿在本指南中將 OPENCODE_CONFIG 持久化到您的 shell 設定檔中。若要復原手動設定,僅需移除您建立的獨立檔案,或在存在備份的情況下還原它。
在同一個 Agent 中生成圖像與影片
OpenCode 也可以透過 TokenLab MCP server 建立圖像和短影片。每次生成都會從相同的 TokenLab 餘額中扣款。將此 mcp 項目合併到同一個 tokenlab.jsonc 中,放在 provider 旁邊。OpenCode 會將 {env:TOKENLAB_API_KEY} 替換為您終端機中的變數,因此金鑰不會被寫入檔案中:
{
"mcp": {
"tokenlab": {
"type": "local",
"command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
"environment": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
},
"timeout": 30000
}
}
}較長的 timeout 是為了讓 npx 有時間在首次啟動時下載套件。使用相同的 OPENCODE_CONFIG 執行 opencode mcp list 並檢查 tokenlab 是否已連線。然後嘗試:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video 會回傳一個任務 ID。Agent 會呼叫 get_task_status 直到影片準備就緒。請參閱 OpenCode MCP servers 以了解其他設定。
選擇模型
從 Models 頁面 複製一個當前的程式碼模型 ID。在設定預設值之前,請先在您自己的儲存庫上比較各個模型。
常見指令
分析程式碼:
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 |