OpenCode CLI 接入第三方 API 完整配置教程

本文档旨在说明如何将符合 OpenAI 接口规范的第三方 API 服务集成到 OpenCode 环境中。

如果你想在 OpenCode 中使用 Gemini 模型，可以尝试使用 Chat 格式，如果使用原生格式请使用其他编程工具，OpenCode 使用 Gemini 模型因格式协议问题可能会报错不兼容，请大家知悉！

1. OpenCode 环境准备

pnpm install -g @opencode/cli

在修改配置文件前，需先在本地密钥管理器中注册一个服务商别名（Provider ID）。这一步是为了安全地托管 API Key，避免在配置文件中明文硬编码。
1.执行认证指令：

opencode auth login

OpenCode 通过opencode.json文件来解析服务商参数。请根据你的操作系统定位并新建/编辑该文件。

参数节点	说明
根键名 (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。