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 ← 域名拼错了CodexZH 已上线新一代 GPT 系列模型,通过协议适配层将 GPT 格式兼容为 Claude 协议格式,可直接在 Claude Code 终端或 IDE 插件中使用,无需额外配置。
可用模型
cc-gpt-5.6-solcc-gpt-5.6-terracc-gpt-5.5cc-gpt-5.4
这些是对 OpenAI GPT 系列模型的协议兼容映射(如 gpt-5.5 → cc-gpt-5.5),全系列均已完成协议适配,任选一个都可以直接在 Claude Code 中稳定使用。各型号定价见 模型与价格。
如何配置
方式一:参考第三方渠道教程
配置方式与 Claude Code 渠道分组配置完全一致,详细步骤请参考:渠道分组配置
将模型名称替换为上面的 cc-gpt 系列即可,例如:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codexzh.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的 API Key",
"ANTHROPIC_MODEL": "cc-gpt-5.5"
}
}方式二:手动编辑 settings.json
编辑 ~/.claude/settings.json,在 env 中将所有模型字段统一设置为同一个 cc-gpt 模型(示例使用 cc-gpt-5.5,可替换为任意 cc-gpt 系列型号):
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codexzh.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的 API Key",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "cc-gpt-5.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "cc-gpt-5.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "cc-gpt-5.5",
"ANTHROPIC_MODEL": "cc-gpt-5.5"
}
}设置多个模型字段可确保 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.5"
},
"output_config": {
"effort": "high"
}
}
output_config.effort支持的值与--effort一致:low、medium、high。配置后所有会话默认生效,命令行--effort可临时覆盖。
| 等级 | 适用场景 | Token 消耗 |
|---|---|---|
low | 简单问答、快速补全 | 少 |
medium | 常规开发任务 | 中 |
high | 复杂推理、架构设计(默认) | 多 |