Appearance
OpenCode
在 OpenCode 里用 CodexZH 套餐额度跑 GPT / Grok 模型。
1. 安装 OpenCode
到 opencode.ai 按官方说明安装,macOS / Linux 也可以直接运行:
bash
curl -fsSL https://opencode.ai/v2/install | bash2. 在控制台导入到 OpenCode
登录 CodexZH 控制台 →「CC Switch 一键导入」,客户端选 OpenCode,默认模型选 GPT 或 Grok 模型(如 gpt-6.1-sol),点 导入到 OpenCode。

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

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

4. 开始使用
重启 OpenCode,执行 /models 选 CodexZH 下的模型,发一句话测试。CC Switch 会把 CodexZH 写进 OpenCode 的供应商列表,导入后在 OpenCode 里选 CodexZH 的模型即可。
没有桌面环境?手动配置
配置时注意两点
provider下的键名必须写openai(使用@ai-sdk/openai走 Responses API)- 必须加
"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 下的模型即可使用。 :::