Skip to main content
OpenCode 是开源的命令行 AI 编程助手。它通过 OpenAI 兼容接口(/v1/chat/completions)调用模型,本站的 DeepSeek、GLM、Kimi 系列都可以使用,写一个配置文件就能用。 以上为 2026-09-28 使用 OpenCode 1.18 实测结果。

给 AI 助手的一段话

已经有别的 AI 助手(例如 Claude Code、WorkBuddy)?把下面这段话发给它,它会帮你完成配置。这段话会包含你的完整密钥,接收它的 AI 服务会看到,请只发给你信任的 AI 助手。把 YOUR_API_KEY 换成你的密钥,deepseek-v4-pro 换成你要用的模型 ID。
在控制台 API 密钥 页面点密钥右侧的 接入配置,选 OpenCode 后点 复制给 Agent,复制到的内容已经填好了你的密钥。

准备

  • 在 API 密钥 页面创建一个密钥,并确认 钱包 有余额。
  • 在 模型广场 选好模型,复制模型 ID,例如 deepseek-v4-pro。

第 1 步:安装 OpenCode

安装后运行 opencode --version,能看到版本号就说明装好了。

第 2 步:写入配置

1. 打开配置文件,不存在时会自动新建:
2. 粘贴下面的内容并保存,把 YOUR_API_KEY 换成你的密钥。models 里列出你要用的模型,可以放多个:
只想在某个项目里用这套配置,可以改放在项目根目录的 opencode.json。

各配置项的作用

第 3 步:验证

运行下面的命令,tokendiscount/ 后面是你的模型 ID:
看到模型回答 OK 就说明接入成功。之后运行 opencode 进入交互界面,输入 /models 可以在 再来点Token 下切换模型。每次调用的用量和费用都可以在 使用日志 里查到。

常见问题

检查配置文件是不是合法的 JSON,以及 models 里有没有列出模型。用下面的命令在本机检查 JSON 格式,只检查格式,不会显示或上传密钥:macOS / Linux 运行 python3 -m json.tool ~/.config/opencode/opencode.json > /dev/null && echo OK,Windows PowerShell 运行 Get-Content "$env:USERPROFILE\.config\opencode\opencode.json" -Raw | ConvertFrom-Json | Out-Null,没有报错就说明格式正确。
models 的键名必须和本站模型 ID 完全一致;命令行 -m 参数的格式是 tokendiscount/模型ID。
baseURL 要带 /v1,不要填成完整的 /v1/chat/completions 地址。
密钥填错、被禁用、过期或额度用完,都会返回 Invalid token。到控制台检查密钥状态和钱包余额,详见 错误排查。