第 7 课2026-06-14
本文档旨在说明如何将符合 OpenAI 接口规范的第三方 API 服务集成到 OpenCode 环境中。
如果你想在 OpenCode 中使用 Gemini 模型，可以尝试使用 Chat 格式，如果使用原生格式请使用其他编程工具，OpenCode 使用 Gemini 模型因格式协议问题可能会报错不兼容，请大家知悉！
pnpm install -g @opencode/cli在修改配置文件前，需先在本地密钥管理器中注册一个服务商别名（Provider ID）。这一步是为了安全地托管 API Key，避免在配置文件中明文硬编码。
1.执行认证指令：
opencode auth loginOpenCode 通过opencode.json文件来解析服务商参数。请根据你的操作系统定位并新建/编辑该文件。
`~/.config/opencode/opencode.json`{
"$schema": "https://opencode.ai/config.json",
"provider": {
"local": {
"npm": "@ai-sdk/openai-compatible",
"name": "local",
"options": {
"baseURL": "http://api.gpt.ge/v1",
},
"models": {
"gpt-4o": { "name": "gpt-4o" },
"claude-sonnet-4-6"
| 参数节点 | 说明 |
|---|---|
| 根键名 (custom_proxy) | 必须与 CLI 注册时的 Provider ID 完全一致（大小写敏感）。 |
| npm | 固定使用 @ai-sdk/openai-compatible 以适配通用协议。 |
| baseURL | 填写V-API平台的API接口地址，通常需包含 /v1 后缀。 |
| apiKey | 使用 "{cred:ID}" 语法。系统会自动从本地凭证库中提取对应 ID 的密钥，实现无明文配置。 |
| models | 需手动声明V-API平台支持的模型列表，键名（Key）需对应真实的 Model ID。 |
配置完成后，重启客户端以加载新的映射关系。
opencode/modelsopencode auth login时输入的Provider ID字面量完全相等？