编码工具
OpenCode
配置 OpenCode 以使用 TokenLab API
交给我的 Agent 做
把这段任务交给电脑上已经可用的 Agent:
阅读此教程,帮我将 OpenCode 接入 TokenLab:
https://tokenlab.sh/docs/zh/integrations/opencode
先检查已安装版本和实际配置。
保留已有账户、提供商、权限及无关设置。
备份本机文件并展示修改内容。
让我在本机输入所需 API Key,不要在聊天里索取、打印或粘贴密钥。
先验证配置能否加载;真实请求测试的费用须单独说明后再运行。概述
在 OpenCode 中添加自定义 OpenAI 兼容服务,填入 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。长期使用请通过本地密钥管理器提供密钥,不要把明文密钥追加到 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 配置文件。撤销手工配置时,仅删除本次新建的独立文件;若原文件已存在,则恢复其备份。
在同一个 Agent 里出图、做视频
OpenCode 还可以通过 TokenLab MCP 服务器生成图片和短视频。每次生成从同一个 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 已连接。然后试试:
先用 get_model_pricing 查询 nano-banana-2 的价格,再用 create_image 以 nano-banana-2、1k 分辨率生成一张照片:白色桌面上的一只哑光黑色咖啡杯。create_video 返回任务 ID,Agent 会调用 get_task_status,直到视频生成完成。其他设置见 OpenCode MCP 文档。
选择模型
从模型页面复制当前可用的编码模型 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"交互命令
| Command | 描述 |
|---|---|
/help | 显示可用命令 |
/models | 切换到其他模型 |
/clear | 清除对话历史 |
/exit | 退出 OpenCode |