CC Switch 统一配置
本站默认通过 CC Switch 统一管理 Claude Code、Codex 等环境的 API 配置。除非需要手动排障或高级自定义，否则不再建议分别编辑各工具配置文件。
安装
项目地址：https://github.com/farion1231/cc-switch
Windows
前往Releases下载安装版或便携版。
macOS
brew tap farion1231/ccswitch && brew install --cask cc-switch
通用配置流程
在 CC Switch 中手动填写请求地址https://duoapi.zeabur.app，注意末尾不要加/，再按渠道选择正确模型：
- 打开 CC Switch，点击"添加配置"
- 选择对应框架（Claude Code / Codex / 其他外接客户端）
- 请求地址填写
https://duoapi.zeabur.app（不要以/结尾） - 填写 API Key（
sk-xxx） - 根据渠道确认
model是否需要切换 - 点击添加或应用，随后重启终端或客户端
如果只是日常使用，配置到这里就够了。只有在 CC Switch 无法使用，或需要排查覆盖问题时，才需要继续查看各工具的手动配置页。
渠道与模型对应关系
| 令牌分组 | 典型场景 | model填写建议 |
|---|---|---|
default | Claude | 留空或填写可用 Claude 模型 |
codex0.3 | Codex Go / Plus / Pro 号池 | 推荐填写可用 GPT / Codex 模型 |
分组使用说明
default用于 Claude Code、Claude 外接和日常 Claude 模型调用，倍率为 1。
codex0.3用于 Codex Go / Plus / Pro 号池，倍率为 0.3。使用 Codex CLI 或外接 Codex 时选择这个分组，并填写对应可用模型。
外接调用说明
外接调用时，除了选择正确分组，还需要按接入类型补对应的User-Agent。
这部分规则已单独拆分到外接调用 User-Agent 说明，请在以下场景优先查看：
- 第三方平台或网关外接 Claude / Codex
- 请求返回
403 block、403 Forbidden、Connection blocked
相关页面
| 页面 | 说明 |
|---|---|
| Claude Code 快速上手 | 安装、启动、常用命令 |
| Codex CLI 快速上手 | 安装、启动、推理深度 |
| Claude Code 配置参考 | 手动配置、环境变量与排障 |
| Codex CLI 配置参考 | 手动配置、模型列表与排障 |