常见问题解答

规则以官网为准

模型、倍率和套餐会变。具体数字看 定价说明 和 模型页。

不确定该买 Claude Code 还是 Codex？先看 不知道选哪个。

产品功能

Claude Code、VSCode 插件和 Claude App 有什么区别？

三个都能接 ccodezh，选一种就够：

• Claude Code CLI：终端里用，需要 Node.js，教程见 Claude Code CLI 集成
• VSCode 插件：在编辑器里用，教程见 VSCode 插件
• Claude App：独立桌面应用，教程见 Claude App 桌面版

安装入口在 （2）安装与环境检查。只有 CLI 需要先装 Node.js。

和 Codex 包月有什么区别？该买哪个？

• Claude Code（ccodezh）：按量计费，给 Claude Code 用 Claude 模型
• CodexZH：包月，给 Codex / Cursor / Windsurf 用 GPT 模型

两边账号和额度都不共用。写代码先看你用的客户端：Claude Code 走这边，Cursor / Codex CLI 走 Codex 文档。对照表见 不知道选哪个。

能在网页上直接用吗？

ccodezh 提供的是 API 接入，不是网页聊天站。只想打开浏览器聊天，用 AI HUB 镜像站。

---

价格套餐

为什么我只问了一句「你好」，却扣了这么多钱？

Claude Code 是 Agent，不是普通聊天框。发一句「你好」，它也可能去读项目目录、扫文件、分析上下文，这些内部请求都计费。问题越复杂，读取和思考轮次越多，费用越高。

只想试通连接或闲聊，用网页聊天工具，不要拿 Claude Code 当聊天机器人。排障页也有这条说明：你好扣费。

按量怎么算？倍率和充值金额是什么关系？

模型表上的美元单价不是你最终付的人民币。费用先按输入 / 输出 / 缓存算基准，再乘渠道倍率，从平台额度里扣。充值换算和分组倍率见 计费与充值，实时单价看 模型与渠道选择。

已充值的余额能退吗？

API 服务通常不退已充值余额。建议先小额测试，确认稳定后再加大充值。说明见 退款与风控提醒。

和 CodexZH 的额度能共用吗？

不能。ccodezh 按量，CodexZH 包月，要分别买。ccodezh 控制台里的 cx 分组也是按量渠道，扣的是 ccodezh 余额，不是 CodexZH 包月。见 不知道选哪个。

---

配置接入

一键脚本、CC-Switch、手动改 settings.json，该用哪个？

三种都能配通，选一种即可：

1. 一键脚本（最省事）：一键脚本配置
2. CC-Switch（图形界面，方便换渠道）：CC-Switch 一键配置
3. 手动编辑（想看清楚字段）：手动配置 settings.json

配完重启终端或 VSCode，再运行 claude 验证。

ANTHROPIC_BASE_URL 要不要加 /v1？

接 ccodezh 时写 https://api.ccodezh.com，不要加 /v1。Claude Code 会自己补路径，手动加上容易请求失败。

如果是把 Claude Code 接到 CodexZH 的 GPT 兼容接口，地址是 https://api.codexzh.com，同样不要 /v1，也别写成 ccodezh.com（多一个 c）。对照见 Claude Code 集成 和 不知道选哪个。

报 401 / 无效的令牌，是不是缺了 apiKeyHelper？

不一定。文档里「该加」和「该删」都出现过，Windows 上这个字段还有已知问题。

401 时优先打开 ~/.claude/settings.json，有 apiKeyHelper 就先删掉再试；仍 401 再按排障页加回去，或在 Claude Code 里执行 /logout 后重进。逐步操作见 401 无效的令牌。

一键脚本跑完还是连 api.anthropic.com？

多半是配置没写到 Claude Code 实际读取的文件，或 apiKeyHelper 状态不对。先核对 ANTHROPIC_BASE_URL 是 https://api.ccodezh.com，再按上面的 401 步骤处理。模板见 手动配置。

---

模型与渠道

cc、cc-n、cx 怎么选？

渠道绑在 API 令牌的分组上，不是改模型名后缀：

• 用 Claude Code 跑 Claude 模型：主渠道选 cc，便宜第三方选 cc-n
• 第三方 API 客户端要主渠道：选 cc-3
• 在 Codex CLI 里用 GPT、且走 ccodezh 按量：选 cx

完整对照见 渠道分组配置 和 模型与渠道选择。

cx 分组是 CodexZH 包月吗？

不是。cx 是 ccodezh 的 GPT / Codex 按量分组，导入 Codex 后扣 ccodezh 余额。CodexZH 包月是另一套账号。导入步骤见 使用 cx 分组导入 Codex 配置。

能在 Claude Code 里用 cc-gpt 吗？

能配，但不推荐。cc-gpt 只是协议转换，模型仍是给 Codex 训练的 GPT，在 Claude Code 里容易缓存不命中、任务中途停住。Claude Code 用 Claude 模型，GPT 放到 Codex 里。说明见 cc-gpt 在 Claude Code 里好不好用。

---

下一步

配置报错、HTTP 状态码、ToolSearch、thinking 签名等问题，走逐步排查：错误排查指南。