OpenCode 是一个开源的代码编辑器,为 CLI 用户提供一个方便的的工具来编辑管理代码,但在添加模型上官方文档不是特别清晰,为此特地捋一下这些模型的相关配置。
按照官方说法,OpenCode 模型列表基于 Models.dev 的模型列表,用户可以通过 opencode auth login 为任何想要使用的提供商配置 API 密钥。
添加之后的密钥位于 ~/.local/share/opencode/auth.json,而离谱的是,第三方模型也是通过这种方式配置的,虽然官方文档里没有提到,但在 auth.json 里是可以添加第三方模型(OpenAI 格式)的 API 密钥的,添加之后就可以在 OpenCode 里使用了。
首先确保已经安装了 OpenCode,可以通过以下命令安装:
curl -fsSL https://opencode.ai/install | bash
然后可以通过以下命令登录并配置 API 密钥:
opencode auth login
这里填入一个名称,这个名称是你在 OpenCode 中看到的模型提供商名称,我这里填入 UCloud,然后填入对应的 API 密钥就会提示保存成功了。
接着在在 OpenCode 的配置目录下打开 ~/.config/opencode/opencode.json 文件(如无则新建),在 providers 部分添加以下内容:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
// 必须与上面登录时填入的名称一致
"Ucloud": {
// 根据供应商类型选择对应的 npm 包,这里选择 OpenAI 兼容的包
"npm": "@ai-sdk/openai-compatible",
// 在 OpenCode 中显示的名称
"name": "Ucloud",
// 自定义选项,这里设置了 baseURL 来指向 UCloud 的 API 端点
"options": {
"baseURL": "https://api.modelverse.cn/v1"
},
// 模型集合,这里添加了一个模型,名称为 "claude-opus-4-6",在 OpenCode 中显示为 "Claude Opus 4.6"
"models": {
"claude-opus-4-6": {
"name": "Claude Opus 4.6"
}
}
},
// 这是 OpenRouter 添加自定义模型的示例配置,用户可以根据需要添加自己的模型和选项
"openrouter": {
"models": {
"z-ai/glm-5-turbo": {
"options": {
"reasoningEffort": "high",
"textVerbosity": "low",
"reasoningSummary": "auto",
"include": ["reasoning.encrypted_content"]
}
}
}
}
},
...
}
保存后,重启 OpenCode,就可以在模型列表里看到新添加的模型了,选择后就可以正常使用了。