OpenCode 接入教程
OpenCode 是开源的终端编程 Agent。复制下面的配置文件,填上 Key,就能在 OpenCode 里用 Claude 和 GPT。
更新于 2026-11-16
一、准备 API Key
在 TokenMilo 控制台注册并充值,到「API 密钥」页面创建一个 Key(以 sk- 开头)。
二、安装 OpenCode
# macOS / Linux
curl -fsSL https://opencode.ai/v2/install | bash
# 或者用 npm(需要 Node.js)
npm install -g @opencode/cli --registry=https://registry.npmmirror.comWindows 用户请到 OpenCode 官网下载独立压缩包或桌面版。如果装过 V1,要先卸载旧版。
三、写配置文件
新建或编辑 ~/.config/opencode/opencode.json(Windows 为 %USERPROFILE%\.config\opencode\opencode.json),粘贴:
{
"$schema": "https://opencode.ai/config.json",
"model": "tokenmilo-claude/claude-sonnet-5-5",
"providers": {
"tokenmilo-claude": {
"name": "TokenMilo Claude",
"package": "@opencode/ai/providers/anthropic-compatible",
"settings": { "baseURL": "https://api.tokenmilo.com/v1", "apiKey": "{env:TOKENMILO_API_KEY}" },
"models": {
"claude-sonnet-5-5": { "name": "Claude Sonnet 5.5", "limit": { "context": 200000, "output": 32000 } },
"claude-opus-5-5": { "name": "Claude Opus 5.5", "limit": { "context": 200000, "output": 32000 } },
"claude-haiku-5-5": { "name": "Claude Haiku 5.5", "limit": { "context": 200000, "output": 32000 } }
}
},
"tokenmilo-gpt": {
"name": "TokenMilo GPT",
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://api.tokenmilo.com/v1", "apiKey": "{env:TOKENMILO_API_KEY}" },
"models": {
"gpt-6.1-sol": { "name": "GPT-6.1 Sol", "limit": { "context": 200000, "output": 32000 } }
}
}
}
}注意地址:Claude 这一组填 https://api.tokenmilo.com/v1(要带 /v1),GPT 这一组填 https://api.tokenmilo.com/v1。
四、设置 Key 并启动
macOS / Linux:
export TOKENMILO_API_KEY=sk-你的TokenMilo密钥 # 写进 ~/.zshrc 或 ~/.bashrc 永久生效
opencodeWindows:
setx TOKENMILO_API_KEY "sk-你的TokenMilo密钥" # 然后重新打开终端
opencode启动后输入 /models 可以看到 TokenMilo 的模型。问一句话,再到控制台「使用日志」页确认请求已经记录。
五、常见报错
- 404:Claude 那组的 baseURL 没带
/v1,或者模型 ID 拼错(以模型列表为准)。 - 401:环境变量没生效(Windows 用 setx 后要重新开终端),或者 Key 复制不完整。
- 配置不生效:确认是 JSON 格式正确,并且字段名是
providers/package/settings(V2 格式)。
常见问题
为什么 Claude 的地址要带 /v1?
OpenCode 的 Anthropic 兼容接口会在地址后面只拼接 /messages,所以要填 https://api.tokenmilo.com/v1。这一点和 Claude Code 正好相反(Claude Code 不带 /v1)。
网上的教程写的是 provider、npm、options,为什么这里不一样?
OpenCode V2 改了配置格式:provider → providers,npm → package,options → settings。旧写法是 V1 的,新版本请用本页的格式。
不想把 Key 放在环境变量里怎么办?
可以删掉配置里的 apiKey 那一行,启动 OpenCode 后输入 /connect,选择 TokenMilo Claude 或 TokenMilo GPT,粘贴 Key 即可,Key 会保存在本机。
怎么切换模型?
在 OpenCode 里输入 /models 选择;或者修改配置里的 "model" 字段,格式是「提供商ID/模型ID」。
相关教程
- CC Switch 一键配置教程(Claude Code / Codex) — 最简单的方式:一键把 TokenMilo 导入 Claude Code 和 Codex,不用改配置文件。
- Codex 中转配置教程(CLI / VS Code 插件) — 不用 ChatGPT 订阅,改一个 config.toml 就能让 Codex 命令行和 VS Code 插件用 GPT-6。
- Claude Code 中转配置教程 — 在 macOS、Linux、Windows 上用 TokenMilo 的 Key 跑 Claude Code。
- DeepSeek Harness(dsh)接入 Claude / GPT 教程 — 在 DeepSeek 官方开源 Agent「dsh」里添加自定义提供方,用上 Claude 和 GPT。
- OpenClaw 接入教程 — 让 OpenClaw 个人 AI 助手通过 TokenMilo 使用 Claude 和 GPT。
- Aider 接入教程 — 在终端里用 Aider 结对编程,模型走 TokenMilo。