Skip to content

Claude Code 集成 ​

配置地址常见错误

在 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           ← 域名拼错了

CodexZH 已上线新一代 GPT 系列模型,通过协议适配层将 GPT 格式兼容为 Claude 协议格式,可在 Claude Code 终端或 IDE 插件中直接调用,无需额外配置。使用前请先看下面「可用模型」里的效果说明。

可用模型 ​

  • cc-gpt-6-astra
  • cc-gpt-6-sol
  • cc-gpt-5.6-sol
  • cc-gpt-5.6-terra
  • cc-grok-4.7
  • cc-grok-4.6
  • cc-grok-4.5

这些是对原版模型的协议兼容映射(如 gpt-5.6-sol → cc-gpt-5.6-sol),可在 Claude Code 中调用。cc-gpt-5.6-luna(2026-09-17 暂时下架)、cc-gpt-5.5、cc-gpt-5.4 已下架,配置里如果还写着这些名字,请改成上面的型号。按站内公告,在 Claude Code 里 grok 相对稳定、速度也快。各型号定价见 模型与价格。专门跑 Grok 的图文步骤见 Grok 的 Claude 使用教程。

先了解使用效果

cc- 只是协议转换层,跑的仍然是 GPT 模型,而这些模型自带 Codex 的系统提示词、也是专门针对 Codex 训练的。在 Claude Code 里用,可能出现缓存频繁不命中、任务跑到一半无故终止、指令遵循不稳定等情况,这是两套体系不兼容导致的,平台侧改配置也消除不了。

想要最佳效果,建议 GPT 模型在 Codex 里用,Claude Code 里用 Claude 模型(走 ccodezh,配置见 ccodezh 一键脚本配置)。详见 常见问题。

如何配置 ​

方式一:参考第三方渠道教程 ​

配置方式与 Claude Code 渠道分组配置完全一致,详细步骤请参考:渠道分组配置

将模型名称替换为上面的 cc-gpt 系列即可,例如:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codexzh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 API Key",
    "ANTHROPIC_MODEL": "cc-gpt-5.6-sol"
  }
}

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

编辑 ~/.claude/settings.json,在 env 中将所有模型字段统一设置为同一个 cc-gpt 模型(示例使用 cc-gpt-5.6-sol,也可换成 cc-gpt-5.6-terra):

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

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

思维深度配置(Extended Thinking) ​

Claude Sonnet 4.5 和 Claude Opus 4.5 支持扩展思考(Extended Thinking)功能,模型在回答前会先进行深度推理,提升复杂任务的准确性。Thinking 默认已开启,无需额外配置。

Thinking tokens 按输出 token 计费,深度越高消耗越多,请按需调整。

启动 Claude Code 时通过 --effort 指定推理深度:

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

也可同时指定模型:

bash
claude --model claude-sonnet-4-5-20250929 --effort medium

在 settings.json 中通过 output_config 持久化配置思维深度,免去每次启动时手动指定:

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

output_config.effort 支持的值与 --effort 一致:low、medium、high。配置后所有会话默认生效,命令行 --effort 可临时覆盖。

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

这页没解决你的问题?