用 CC Switch 配置
Codex / Claude Code 教程
统一管理多个 Provider，再切换给不同客户端使用
小贺AI编辑部 · 资料核对 2026-10-14 · 教学操作与预期结果
Codex使用此配置Claude Code使用此配置先选择要管理的客户端
CC Switch 用来保存和切换供应商配置，任务仍在 Codex 或 Claude Code 中运行。先确认实际使用的是 Codex CLI、Codex 桌面应用，还是 Claude Code CLI；同一条配置不能不检查协议就套给所有客户端。
如果你只想用已有的官方账号登录，先按客户端的登录流程继续，不必为了安装教程购买 API 或安装 CC Switch。需要管理多套 API 配置时，再走本页流程。
还没安装 CC Switch：官方下载与安装。只维护一套配置且愿意自己管理参数：手动 API 配置路径选择。
准备 API 供应商信息与配置备份
先记下当前 Provider、客户端版本以及是否启用本地代理或路由，并备份将要修改的客户端配置。备份可能含 Key，应保存在受控位置；不要通过删除整个配置目录来重置。
| 要确认的项目 | 从哪里取得，检查什么 |
|---|---|
| 目标客户端 | 在 CC Switch 中选择实际使用的 Codex 或 Claude Code，按该客户端选择预设 |
| Base URL 与协议 | 使用供应商的 API 接入说明；控制台网页地址不等于 API 地址，只有聊天接口可用也不代表客户端工具调用可用 |
| API Key 与认证方式 | 使用同一供应商签发的凭证，不把另一家的 Key 填进来 |
| 模型标识 | 使用该服务当前支持的模型名称，不凭展示名称猜接口标识 |
缺少其中一项，先回服务的接入说明核对。不要在一次导入后无依据地同时改地址、Key 和模型。
在 CC Switch 中添加 Provider 并切换
- 在 CC Switch 选择要管理的客户端，进入对应的供应商列表。
- 点击添加供应商，选择与服务匹配的预设；没有匹配项时，按服务的接入文档填写自定义配置。检查 Base URL、API Key、模型和协议属于同一服务。
- 保存后回到供应商列表。在直连模式点击目标卡片的“切换”，确认它显示“使用中”。只保存记录或切换客户端标签，并不会自动启用这条记录。
- 如果服务提供自动导入入口，导入后仍要检查目标客户端和字段，再执行切换。不要因为导入按钮提示成功就跳过客户端验证。
字段填写分别见 Codex API 配置 和 Claude Code API 配置。添加页面的具体位置随版本变化，可对照 CC Switch 官方添加说明。
Codex 与 Claude Code 怎样读取配置
直连切换会把对应字段写入客户端配置文件。下一步是让实际客户端读取这些字段，而不是在客户端中寻找一个通用的 CC Switch 接入开关。
| 你实际使用的入口 | 切换后怎样继续 |
|---|---|
| Codex CLI | 退出当前 Codex 会话，再从终端启动；在重新启动的会话中测试 |
| Codex 桌面应用 | 完全退出应用后重新打开，再选择练习项目；仅关掉一个窗口不一定退出进程 |
| Claude Code CLI | 官方支持部分设置热重载；用 /status 查看状态，模型选择用 /model 检查。启动时确定的模型等设置有例外，必要时新建会话或重启 |
如果你还修改了终端环境变量，已经运行的进程不会自动继承新终端环境，应重新打开相应终端或应用。Claude Code 的设置机制见 官方设置重载说明，不要把一种客户端的行为套给另一种。
切换不同 Provider 的方法：先看生效模式
当前 CC Switch 文档区分直连、路由和聚合。点击模式标签只切换视图；“开始路由”“切换到聚合模式”“回到直连”才改变活动模式。操作后检查活动标记和供应商状态，具体按钮以所用版本为准。
直连配置写入客户端后，请求直接发往供应商；使用本地路由时，请求先到 CC Switch，路由服务必须保持运行。路由中的目标切换可以即时生效，但模型变化仍可能需要新会话或重启。是否需要协议转换，要看目标客户端与服务协议，不能仅凭“兼容 API”判断。
练习恢复时，切回记录下来的原 Provider；若启用了路由，按对应模式恢复直连或原路由，再重复同一个任务。不要先停掉本地服务，却把客户端留在本机代理地址。完整模式差异见 CC Switch 官方切换说明。
如何验证已生效：任务结果与请求归属分开检查
在一个没有敏感内容的练习目录中创建 README.txt，写入 cc-switch-practice。在刚才切换配置的客户端选择该目录，发送：
只读取当前目录的 README.txt，告诉我文件内容和文件路径。不要修改文件、安装依赖或联网搜索。
预期客户端能读到 cc-switch-practice 并指出文件路径。随后检查目录没有新增或修改文件。这说明该客户端完成了一次文件读取任务，但还不能单独证明用了哪家供应商。
再去目标服务的请求记录中对应测试时间、模型及 request_id（服务提供时）；本地路由日志可以帮助核对转发去向。没有可核对的服务记录时，应保留“任务成功，请求归属待确认”，不要把模型自报名称、账号头像或一句问候成功当作计费归属证据。
以上是教学操作与预期结果，本文未声称替你完成实际账户或付费请求测试。
常见问题：只修已找到的差异
相关教程与资料核对范围
- 只配置 Codex：Codex API 字段与验证。
- 只配置 Claude Code：Claude Code API 接入。
- 暂不需要配置管理器：手动配置路径选择。
资料核对：2026-10-14。产品步骤依据上文链接的 CC Switch 官方用户手册、Claude Code 设置文档，以及 Codex 官方认证说明。界面标签以实际版本为准；资料核对不等于各系统、各供应商均已实测。