如果你已持有 OpenAI、Anthropic、阿里云、百度、智谱 AI 等厂商的 API Key，可直接将其接入 OpenCode，无需绑定官方账号体系。该模式适合希望灵活选用底层模型，或团队已有统一 API 资源池的场景。
1. 进入配置面板
按 2.2 节所述打开 OpenCode 设置，将模型来源切换为云端 API（部分版本显示为自定义模型 / Custom）。
2. 选择服务商并填写凭证
在服务商下拉框中选择对应厂商，系统会自动加载该平台的默认请求格式：
| 服务商 | 需填写内容 | 常见模型示例 |
|---|---|---|
| OpenAI | API Key | gpt-4o、gpt-4o-mini、gpt-3.5-turbo |
| Azure OpenAI | API Key + Endpoint + 部署名称 | gpt-4o（对应部署名） |
| Anthropic | API Key | claude-3-5-sonnet-20241022 |
| 阿里通义 | API Key | qwen-coder、qwen-max |
| 百度文心 | API Key + Secret Key | ernie-4.0、ernie-speed |
| 智谱 GLM | API Key | glm-4、glm-4-flash |
| DeepSeek | API Key | deepseek-chat、deepseek-coder |
| 自定义 | API Key + Base URL | 任意兼容 OpenAI 接口格式的模型 |
提示：若通过第三方代理或私有网关访问海外模型，选择自定义，在 Base URL 栏填入代理地址（如
https://api.example.com/v1），并在模型名称中手动输入模型 ID。
3. 设置功能级别的模型（如支持）
部分版本的 OpenCode 允许分别指定：
- 代码补全模型：建议选择响应快、成本低的轻量模型（如
gpt-4o-mini、deepseek-coder），降低延迟和开销。 - 对话/解释模型：建议选用推理能力更强的模型（如
gpt-4o、claude-3-5-sonnet），以获得更准确的代码审查与业务解释。
4. 可选高级参数
根据实际需求调整，一般保持默认即可：
- Temperature：控制生成随机性。代码补全建议
0.1–0.3（确定性高），代码解释或重构建议0.5–0.7（表述更自然）。 - Max Tokens：单次返回的最大 Token 数，处理大文件时可视情况调高（如 4096 或 8192）。
- 请求超时：默认 30 秒，若网络到海外模型不稳定，可设为 60–120 秒。
5. 连接测试与保存
填写完成后点击测试连接。若提示成功，表明密钥有效且网络可达，保存即可生效。若报错：
401：API Key 错误或已过期，请核对密钥。404：模型名称或 Endpoint 路径填写有误，请检查服务商文档。timeout：网络不通或代理异常，检查本地网络或配置 HTTP 代理（在插件设置的「网络」页填入http://代理IP:端口）。
注意事项
- 密钥安全：API Key 仅保存在本地 IDE 的配置文件中，不会上传至 OpenCode 官方服务器；建议定期轮换密钥。
- 计费方式：按实际调用的 Token 量直接向对应云厂商付费，OpenCode 作为客户端不收取中间费用。
- 国内与海外线路：接入国内模型（通义、文心、DeepSeek）通常可直连；接入 OpenAI、Anthropic 官方接口时，若遇网络问题，建议配置本地代理或改用国内中转服务。
- 模型切换：同一配置页可随时切换不同厂商的模型，无需重启 IDE，保存后新对话与补全立即生效。