Skip to content

Claude Code 接入 CodexZH(cc- 系列模型) ​

在 Claude Code(终端 / VSCode 插件)里用 CodexZH 套餐额度调用 cc- 系列模型。扣的是 CodexZH 套餐额度,和 CcodeZH 余额不互通。

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

1. 安装 Claude Code ​

按 Claude Code 官方文档 安装:

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex

2. 在控制台导入到 Claude Code ​

登录 CodexZH 控制台 →「CC Switch 一键导入」,客户端选 Claude Code,默认模型选 cc-grok-4.6 或 cc-grok-4.7,点 导入到 Claude Code。

控制台选择 Claude Code

3. 在 CC Switch 里确认导入 ​

浏览器询问是否打开 CC Switch 时点 打开,确认弹窗里各档模型都是 cc- 模型、地址是 https://api.codexzh.com(不带 /v1):

CC Switch 确认导入 Claude Code

往下滚动,打开「导入后立即切换到这个供应商」,再点 导入:

CC Switch 确认导入 Claude Code(下半部分)

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

在 CC Switch 中启用 CodexZH

4. 开始使用 ​

重开终端运行 claude,或重启编辑器,发一句话测试。

可用模型 ​

模型对应原版
cc-grok-4.7grok-4.7
cc-grok-4.6grok-4.6
cc-gpt-6-astragpt-6-astra
cc-gpt-6.1-solgpt-6.1-sol
cc-gpt-6-solgpt-6-sol
cc-gpt-5.6-solgpt-5.6-sol

cc- 只是 Claude 协议名,单价与原版一致,见 模型与切换。推荐用 cc-grok-4.6 或 cc-grok-4.7;cc-gpt-5.6-terra、cc-grok-4.5、cc-gpt-5.6-luna、cc-gpt-5.5、cc-gpt-5.4 已下架。

不建议在 Claude Code 里用 cc-gpt

GPT 模型针对 Codex 工具链训练,在 Claude Code 里容易出现缓存不命中或任务中途停止。GPT 模型建议在 Codex 客户端 里用,详见 常见问题。

不用 CC Switch?手动编辑 settings.json

配置地址两个高频错误

  1. 末尾不要加 /v1:写 https://api.codexzh.com
  2. 域名是 codexzh.com,不是 ccodezh.com

编辑 ~/.claude/settings.json,把 env 中所有模型字段设为同一个 cc- 模型:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codexzh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 CodexZH API Key",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "cc-grok-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "cc-grok-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "cc-grok-4.6",
    "ANTHROPIC_MODEL": "cc-grok-4.6"
  }
}

其他字段见 模型设置。 :::

思维深度(effort) ​

启动时用 --effort 调整推理深度(或在 settings.json 同级加 "output_config": { "effort": "high" }):

bash
claude --effort low     # 简单问答,省 token
claude --effort medium  # 常规开发
claude --effort high    # 复杂推理(默认)

常见报错 ​

  • 点「一键导入」没反应:装了免安装 zip 版 CC-Switch,换安装包重装
  • 报 No available channel:确认模型名带 cc- 前缀且未下架(如 cc-grok-4.6)
  • 请求失败:检查 ANTHROPIC_BASE_URL 是否多了 /v1 或写成 ccodezh.com
  • 改完不生效:彻底退出客户端再打开

其他报错见 错误排查指南。