AI精品店

Appearance

在 Claude Code 中使用 CodexZH 模型 ​

用 CodexZH（codexzh.com）的 API Key，在 Claude Code 终端、IDE 插件和 Claude 桌面版里调用 cc-grok、cc-gpt 系列模型。扣的是 CodexZH 套餐额度，和 CcodeZH 的余额不互通。

配置地址常见错误

Claude Code 里的 ANTHROPIC_BASE_URL 有两个高频错误：

  1. 地址末尾不要加 /v1：Claude Code 会自动处理路径，手动加上会导致请求失败
  2. 域名是 codexzh.com，不是 ccodezh.com（多了一个 c）

正确写法：

ANTHROPIC_BASE_URL=https://api.codexzh.com

错误写法：

ANTHROPIC_BASE_URL=https://api.codexzh.com/v1       ← 不要加 /v1
ANTHROPIC_BASE_URL=https://api.ccodezh.com           ← 域名拼错了

可用模型 ​

模型对应原版
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-gpt-5.6-terra、cc-grok-4.5、cc-gpt-5.6-luna、cc-gpt-5.5、cc-gpt-5.4 已不可用，配置里还写着这些名字的，改成上表型号。

按站内公告，在 Claude Code 里 Grok 相对稳定、速度也快，推荐 cc-grok-4.6 或 cc-grok-4.7。

cc-gpt 在 Claude Code 里的效果

GPT 模型自带 Codex 的系统提示词，也是针对 Codex 训练的。在 Claude Code 里用，可能出现缓存频繁不命中、任务跑到一半终止、指令遵循不稳定等情况，平台侧改配置也消除不了。

GPT 模型建议在 Codex 客户端 里用。详见 常见问题。

方式一：CC Switch 一键导入（推荐） ​

适用于 Claude Code 终端和 IDE 插件。控制台会导入一条默认模型为 cc-grok-4.6 的配置。

需要先准备：

不要用免安装版

绿色免安装 EXE / zip 解压版没有向系统注册，控制台点「一键导入」时调不起软件，看起来像没反应。已经装过免安装版的，先删掉，再用安装包装一次。

1. 在控制台一键导入 ​

登录 CodexZH 控制台，找到 CC Switch 一键导入，按图中箭头操作：

控制台一键导入 CC Switch

在 CC-Switch 中确认导入的配置

浏览器若询问是否打开 CC Switch，选允许。

2. 启用配置并重启 ​

导入后确认默认模型是 cc-grok-4.6（想换别的型号在这里改），把这条配置设为使用中 / 启用：

启用 cc-grok-4.6 配置

然后重启 Claude Code：

  • 插件：重启 VS Code / Cursor 等编辑器
  • CLI：关掉当前终端，重新开一个再运行 claude

方式二：手动编辑 settings.json ​

编辑用户目录下的 .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"
  }
}

设置多个模型字段可确保 Claude Code 在任何调用路径下都用同一个模型，避免主模型和后台辅助模型走了不同渠道。其他字段的含义见 模型设置。

Claude 桌面版 ​

桌面版不能一键导入，分两种情况。

桌面版里还没有任何配置： 打开后会提示复用 Claude Code 里的配置，点复用即可。前提是已经按上面配好了 Claude Code。

已经有别的配置，或没有弹出复用： 按下图手动填。

桌面版复用 Claude Code 配置

Claude 桌面版手动配置（1）

Claude 桌面版手动配置（2）

手动填写时注意：

  • 接口地址用 https://api.codexzh.com，末尾不要加 /v1
  • 密钥用 CodexZH 控制台的 sk- Key
  • 模型填 cc-grok-4.6，不要填 grok-4.6

配置启用后，打开 Claude，确认当前模型是 Grok，直接发消息：

打开 Claude

确认当前模型

开始对话

思维深度（effort） ​

启动 Claude Code 时用 --effort 指定推理深度：

bash
claude --effort low     # 快速响应，节省 token
claude --effort medium  # 均衡模式
claude --effort high    # 深度推理（默认）

也可以在 settings.json 里用 output_config 固定下来，命令行的 --effort 可临时覆盖：

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

思考过程的 token 按输出计费，深度越高消耗越多。

等级适用场景Token 消耗
low简单问答、快速补全少
medium常规开发任务中
high复杂推理、架构设计（默认）多

常见报错 ​

  1. 点「一键导入」没反应：多半装的是免安装版 CC-Switch，改用安装包重装
  2. 报模型不可用 / No available channel：确认填的是 cc-grok-4.6 这类带 cc- 的名字，不是 grok-4.6，也不是 cc-grok-4.5 这类已下架型号
  3. 请求失败：检查 ANTHROPIC_BASE_URL 是否多了 /v1 或把域名写成了 ccodezh.com
  4. 改完没变化：Claude Code 或桌面版没有完全退出再打开

其他报错看 CodexZH 的 错误排查指南。