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

Codex 中转站现已上线新一代 GPT 系列模型,通过协议适配层将 GPT 格式完美兼容为 Claude 协议格式,让你可以直接在 Claude Code 终端或 IDE 插件中使用这些模型,无需额外配置。

可用模型

  • cc-gpt-5.5

cc-gpt-5.5 在兼容性上面还存在问题,多轮对话后可能会报错,保险起见请先使用 cc-gpt-5.4

  • cc-gpt-5.4
  • cc-gpt-5.2

这些是对 OpenAI GPT 系列模型的协议兼容映射(如 gpt-5.4cc-gpt-5.4),通过 Claude 协议格式适配后,可直接在 Claude Code 中使用。

如何配置

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

配置方式与 Claude Code 第三方渠道 -n 模型完全一致,详细步骤请参考:第三方渠道 -n 模型配置

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

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

方式二:手动编辑 settings.json

编辑 ~/.claude/settings.json,在 env 中将所有模型字段统一设置为 cc-gpt-5.4

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

设置多个模型字段可以确保 Claude Code 在任何调用路径下都使用 cc-gpt-5.4,避免因模型切换导致请求失败。

思维深度配置(Extended Thinking)

Claude Sonnet 4.6 和 Claude Opus 4.6 支持扩展思考(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-6 --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.4"
  },
  "output_config": {
    "effort": "high"
  }
}

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

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