OpenCode 接入指南

适用角色：开发者、主用户、子用户 更新日期：2026-08-06

OpenCode 可以把 OpenAI Compatible 服务注册成独立 Provider。Provider 名称只在本地使用，示例采用 myplatform。

安装

macOS 可以使用 Homebrew：

brew install anomalyco/tap/opencode

也可以通过 npm 安装：

npm install -g opencode-ai

增加 Provider

在项目目录创建 opencode.json，或把同样的配置合并到用户级文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myplatform": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "自定义平台",
      "options": {
        "baseURL": "https://<接口地址>",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "deepseek-v4-flash": {
          "name": "DeepSeek V4 Flash"
        }
      }
    }
  }
}

以控制台「API Key」页展示的接口地址为准。

对象键 deepseek-v4-flash 是发送给本平台的调用名，name 只是 OpenCode 中的显示名称。项目配置含真实 Key 时不要提交；长期使用建议按 OpenCode 当前版本支持的环境变量方式保存密钥。

启动和定位问题

运行 opencode，在模型选择器中选择 myplatform/deepseek-v4-flash。模型没有出现在列表中，先检查 JSON 和 Provider 键名；模型可选但请求失败，再检查 Base URL、Key 和分组权限。

完成文本问答后，再测试文件读取和小范围修改。工具权限问题与 API 连接问题应分开处理。