Appearance
Claude Code 集成
⚠️ 配置地址常见错误,请务必注意
在 Claude Code 中配置 ANTHROPIC_BASE_URL 时,有两个高频错误:
- 地址末尾不要加
/v1— Claude Code 会自动处理路径,手动加上会导致请求失败 - 域名拼写要看清楚 — 正确域名是
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.4cc-gpt-5.2
这些是对 OpenAI GPT 系列模型的协议兼容映射(如 gpt-5.4 → cc-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一致:low、medium、high。配置后所有会话默认生效,命令行--effort可临时覆盖。
| 等级 | 适用场景 | Token 消耗 |
|---|---|---|
low | 简单问答、快速补全 | 少 |
medium | 常规开发任务 | 中 |
high | 复杂推理、架构设计(默认) | 多 |