Skip to content

OpenCode ​

在 OpenCode 里用 CodexZH 套餐额度跑 GPT / Grok 模型。

开始前先完成 购买套餐,并装好 CC Switch。

1. 安装 OpenCode ​

到 opencode.ai 按官方说明安装,macOS / Linux 也可以直接运行:

bash
curl -fsSL https://opencode.ai/v2/install | bash

2. 在控制台导入到 OpenCode ​

登录 CodexZH 控制台 →「CC Switch 一键导入」,客户端选 OpenCode,默认模型选 GPT 或 Grok 模型(如 gpt-6.1-sol),点 导入到 OpenCode。

控制台选择 OpenCode

3. 在 CC Switch 里确认导入 ​

浏览器询问是否打开 CC Switch 时点 打开,确认弹窗里「导入后立即添加到 OpenCode 配置」保持打开(默认已开),再点 导入。

CC Switch 确认导入 OpenCode

没勾这个开关的:在 CC Switch 左侧选你正在配置的客户端,点 CodexZH 那一行的 ▷ 启用。下图以 Codex 为例,其他客户端操作相同。

在 CC Switch 中启用 CodexZH

4. 开始使用 ​

重启 OpenCode,执行 /models 选 CodexZH 下的模型,发一句话测试。CC Switch 会把 CodexZH 写进 OpenCode 的供应商列表,导入后在 OpenCode 里选 CodexZH 的模型即可。

没有桌面环境?手动配置

配置时注意两点

  1. provider 下的键名必须写 openai(使用 @ai-sdk/openai 走 Responses API)
  2. 必须加 "setCachekey": true,否则缓存不命中

编辑配置文件:

  • macOS / Linux:~/.config/opencode/opencode.json
  • Windows:C:\Users\你的用户名\.config\opencode\opencode.json

写入或合并以下内容:

json
{
  "provider": {
    "openai": {
      "npm": "@ai-sdk/openai",
      "name": "codexzh",
      "options": {
        "baseURL": "https://api.codexzh.com/v1",
        "apiKey": "sk-替换成你自己的 key",
        "setCachekey": true,
        "options": {
          "reasoningEffort": "high",
          "textVerbosity": "low",
          "reasoningSummary": "auto"
        }
      },
      "models": {
        "gpt-6.1-sol": { "name": "gpt-6.1-sol" },
        "gpt-6.1-terra": { "name": "gpt-6.1-terra" }
      }
    }
  }
}

保存后重启 OpenCode,选择 codexzh 下的模型即可使用。 :::