接入

OpenCode

最后更新：2026 年 10 月 28 日

OpenCode 是开源的终端编程 Agent，支持任意 OpenAI 兼容的提供方。在它的配置文件里加一个 CoreCode 提供方，就能在同一个 OpenCode 里切换 Claude、GPT、Grok 和 Gemini。配置写法来自 OpenCode 的 提供方文档。

安装

npm install -g opencode-ai

装好后运行 opencode --version，能打印版本号就说明装好了。

创建密钥

在 API 密钥 页创建密钥，分组用 auto。OpenCode 不是 Claude Code，「仅限CC」分组会拒绝它的请求；只用 Claude 的话也可以选「Claude 满血（可外接）」。

配置

编辑 ~/.config/opencode/opencode.json，没有就新建（也可以放在项目目录里，只对这个项目生效）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "corecode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CoreCode",
      "options": {
        "baseURL": "https://corecode.live/v1",
        "apiKey": "{env:CORECODE_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "claude-opus-5-5": { "name": "Claude Opus 5.5" },
        "gpt-6.1-sol": { "name": "GPT-6.1 Sol" },
        "grok-4.7": { "name": "Grok 4.7" },
        "gemini-3.8-flash-high": { "name": "Gemini 3.8 Flash" }
      }
    }
  }
}

models 里的名字要和 模型定价 页一致，按需增删。然后把密钥放进环境变量：

export CORECODE_API_KEY=sk-你的密钥

$env:CORECODE_API_KEY = "sk-你的密钥"

想永久生效，把这一行加进 ~/.zshrc 或 ~/.bashrc；Windows 用 setx CORECODE_API_KEY sk-你的密钥，然后重开终端。

检查是否生效

opencode run -m corecode/claude-sonnet-5-5 "回复 ok"

返回 ok 即接通。在 OpenCode 里输入 /models，能看到 CoreCode 下的模型，选中即可切换。

常见问题