用 CodeGateway 配置 OpenCode

一份配置、一次复制、一次测试请求,沿用你现有的 OpenAI 兼容工作流。

~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "codegateway": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CodeGateway",
      "options": {
        "baseURL": "https://api.codegateway.dev/v1",
        "apiKey": "sk-cg-YOUR_KEY"
      },
      "models": {
        "deepseek-v4-flash": {}
      }
    }
  },
  "model": "codegateway/deepseek-v4-flash"
}

支持卡支付。用量按请求计量,可在控制台查看。

三步跑通

  1. 把上面的配置粘贴到 ~/.config/opencode/opencode.json,并把 sk-cg-YOUR_KEY 换成你的 Key。
  2. 把 <model-id> 换成 https://api.codegateway.dev/v1/models 里的模型 —— 列表实时更新,不会写死过期 id。
  3. 运行 opencode,选择 codegateway/<model-id> 模型,发一条测试消息。
  4. 在控制台 → 用量里确认请求已记录;额度不足时再充值。

常见问题

为什么 baseURL 必须以 /v1 结尾?

OpenCode 通过 @ai-sdk/openai-compatible 访问 OpenAI 兼容端点,会在 baseURL 后拼接 /chat/completions。少了 /v1 就会打到错误路径,OpenCode 会报模型不可用。

为什么模型 id 是占位符?

模型 id 会轮换。GET /v1/models 是实时目录,所以页面用占位符,而不是一个下个月可能下线的 id。

测试前需要先买套餐吗?

不需要。注册拿 Key 后自带额度就够发第一批请求,持续使用再充值。

余额用完了会怎样?

请求会返回 402 insufficient_balance,错误信息里直接带充值链接和剩余用量,不用自己找计费页。

继续了解

OpenCode + CodeGateway 接入:一份配置,一次自检