在 OpenCode 中配置使用

配置 OpenCode

重要

后台密钥列表的 使用密钥 弹窗中提供了 OpenCode 配置示例（含各平台模型清单），可以直接复制，本页示例供手动配置参考。

1. 安装并运行一次 OpenCode

curl -fsSL https://opencode.ai/install | bash
# 或使用 npm:
# npm i -g opencode-ai@latest
opencode --version
opencode

2. 找到 OpenCode 的配置文件夹。目录不存在时先创建目录，再打开：

Windows

CMD 命令行：

if not exist "%USERPROFILE%\.config\opencode" mkdir "%USERPROFILE%\.config\opencode"
start "" "%USERPROFILE%\.config\opencode"

macOS

mkdir -p "$HOME/.config/opencode"
open "$HOME/.config/opencode"

3. 创建或编辑 opencode.json（不存在需手动创建），按你要使用的平台写入配置：

Claude 分组

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://goodcode.store/v1",
        "apiKey": "sk-你的ApiKey"
      }
    }
  }
}

OpenAI 分组

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://goodcode.store/v1",
        "apiKey": "sk-你的ApiKey"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5",
          "limit": { "context": 1050000, "output": 128000 },
          "options": { "store": false },
          "variants": { "low": {}, "medium": {}, "high": {}, "xhigh": {} }
        }
      }
    }
  },
  "agent": {
    "build": { "options": { "store": false } },
    "plan": { "options": { "store": false } }
  }
}

Gemini 分组

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gemini": {
      "npm": "@ai-sdk/google",
      "options": {
        "baseURL": "https://goodcode.store/v1beta",
        "apiKey": "sk-你的ApiKey"
      },
      "models": {
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro",
          "limit": { "context": 2097152, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "options": { "thinking": { "budgetTokens": 24576, "type": "enabled" } }
        },
        "gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        }
      }
    }
  }
}

Antigravity 分组

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "antigravity-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "Antigravity (Claude)",
      "options": {
        "baseURL": "https://goodcode.store/antigravity/v1",
        "apiKey": "sk-你的ApiKey"
      }
    },
    "antigravity-gemini": {
      "npm": "@ai-sdk/google",
      "name": "Antigravity (Gemini)",
      "options": {
        "baseURL": "https://goodcode.store/antigravity/v1beta",
        "apiKey": "sk-你的ApiKey"
      }
    }
  }
}

相关信息

• 本页示例直接在 provider.options.apiKey 中写入 GoodCode API Key，不需要再执行 /connect
• 如果你选择使用 /connect 存储凭据，请确保 /connect 中的 provider id 与 opencode.json 里的 provider id 一致，不要给同一 provider 配置两套不同 Key
• 示例中的模型清单仅供参考，可按 分组与模型 查询到的实际列表增删
• 如果只想复制最小配置，可以直接使用 GoodCode 后台 使用密钥 弹窗中的 OpenCode 示例

4. 重启并验证

关闭当前 OpenCode 会话，重新打开终端后运行：

opencode

进入交互界面后使用 /models 查看模型是否出现，选择 GoodCode 模型后发送一句简单消息测试。如果 /models 中没有新模型，优先确认 opencode.json 路径是否正确，以及 JSON 是否存在语法错误。