最近看到不少朋友对 OpenCode 很感兴趣，但因不清楚如何接入自定义 API 中转站而望而却步。经过一番尝试，我成功将中转站接入 OpenCode，现将完整流程整理如下，希望能帮到有需要的朋友！
前提条件
- 已安装 OpenCode CLI（可通过
npm install -g @opencode/cli安装），官网也提供其他安装方式
接入步骤
初始化自定义服务商（Provider）
先不要直接启动 OpenCode，而是在终端执行以下命令：
opencode auth login
- 在服务商列表中，选择
other（在最下面，可以直接搜索）。 - 系统会提示你输入 Provider ID：
请填写一个唯一标识名（例如 myproxy），后续配置需与之严格一致。 - 接着输入 API Key：
可填写任意内容（如 dummy），因为实际密钥可通过配置文件安全引用（见下一步）。
这一步的作用是让 OpenCode 在本地凭证管理器中注册一个自定义服务商，便于后续引用密钥。
配置中转站 API 地址
打开 OpenCode 配置目录（路径因系统而异）：
- macOS / Linux:
~/.config/opencode/ - Windows:
Users\***\.config\opencode(来自评论区大佬的提供)
在该目录下创建或编辑配置文件：opencode.json，内容如下：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"myproxy": { // 这里必须和上一步的提供商 ID 完全一致！
"npm": "@ai-sdk/openai-compatible",
"name": "我的中转站", // 在 UI 中显示的名称，可自定义
"options": {
"baseURL": "https://your-proxy-domain.com/v1" // 你的中转站 API 地址（必须以 /v1 结尾或符合 OpenAI 格式）
// "apiKey": "{cred:myproxy}" // 可选：自动引用上一步存储的密钥（推荐，不用明文写 key）
// 如果中转站需要自定义 headers，可添加：
// "headers": {
// "X-Custom-Header": "your-value"
// }
},
"models": {
"gpt-4o": { // 中转站支持的模型 ID，例如 gpt-4o、claude-3-5-sonnet 等
"name": "GPT-4o（中转）"
},
"claude-3-5-sonnet-20241022": {
"name": "Claude 3.5 Sonnet"
}
// 添加更多模型...
}
}
}
}
关键说明：
myproxy必须与第 1 步中输入的 Provider ID 完全一致。
baseURL需指向中转站的 OpenAI 兼容 API 入口，通常以/v1结尾（如不生效，可尝试去掉/v1测试）。
apiKey: "{cred:myproxy}"会自动读取你在opencode auth login时保存的密钥，无需明文写入配置文件，更安全！
重启并验证
保存配置后，启动 OpenCode：
opencode
在聊天界面输入命令：
/models
即可在模型列表中看到你配置的中转站及其模型（如 “GPT-4o（中转）”）。选择后即可正常使用！
注意事项
-
Provider ID 必须一致：配置文件中的键名（如
myproxy）必须与auth login时输入的 ID 完全相同（区分大小写）。 -
API 地址格式：确保
baseURL正确。可先用curl或 Postman 测试中转站是否响应/v1/models。 -
模型 ID 要匹配：
models下的键（如gpt-4o）必须与中转站实际支持的模型 ID 一致。 -
若修改配置后未生效，请尝试完全退出 OpenCode 并重新启动。
，