推荐使用
- 同时使用 Codex 和 Claude Code 等多个客户端
- 希望统一管理多个 API 供应商
- 需要在不同项目或模型之间快速切换
- 希望避免在多个配置文件中重复填写 API Key
配置教程用 CC Switch 配置
用 CC Switch 配置
Codex / Claude Code 教程
统一管理多个 Provider，再切换给不同客户端使用
小贺AI编辑部 · 实测更新 2026-09-16 · 阅读约 11 分钟先在 CC Switch 添加并启用 Provider，再到 Codex 或 Claude Code 中验证配置。
一个工具，连接更多可能
Providers＋ 添加 Provider
OpenAIhttps://platform.openai.com
已启用Anthropichttps://console.anthropic.com
未启用小贺AIhttps://api.xiao-he.top
已启用自定义按服务商文档填写
未启用Codex使用此配置Claude Code使用此配置1
适合谁使用
如果你有以下需求，推荐使用 CC Switch 来统一管理 API 配置：
可能不需要
- 只使用一个客户端（如只用 Codex）
- 不需要频繁切换供应商
- 已经有自己固定的配置方式
- 对配置管理工具不感兴趣
2
准备 API 供应商信息
在添加 Provider 之前，你需要从 API 控制台或服务商文档获取以下信息：
获取渠道
- OpenAI：platform.openai.com
- Anthropic：console.anthropic.com
- 小贺AI：api.xiao-he.top
- 其他 Compatible 服务：查看服务商文档
添加 Provider示例
3
在 CC Switch 中添加 Provider
按以下步骤在 CC Switch 中添加并启用你的 Provider：
- 1
打开 CC Switch
启动 CC Switch，进入 Providers 页面。
- 2
点击「添加 Provider」
在右上角点击添加按钮，选择目标客户端或供应商模板。
- 3
填写配置信息
按控制台或服务商文档填写名称、Base URL、API Key 和模型。
- 4
保存并启用
点击保存后，在列表中找到 Provider，确认状态变为“已启用”。
4
如何让 Codex / Claude Code 使用它
在 CC Switch 中启用 Provider 后，还需要在对应客户端确认配置已读取：
Codex 配置方法
通用- 打开 Codex 客户端或命令行工具
- 在设置中选择“使用 CC Switch 配置”
- 确认 Base URL、模型与 Provider 一致
- 此时会使用当前在 CC Switch 中启用的 Provider
Claude Code 配置方法
通用- 打开 Claude Code 客户端或终端
- 在设置中选择“使用 CC Switch 配置”
- 确认当前协议支持 Anthropic Messages
- 重新启动会话后发送一条最小测试消息
提示：不同客户端的具体设置入口可能略有不同，如遇到问题请以当前版本界面和官方文档为准。
5
切换不同 Provider 的方法
当你需要切换到其他模型或服务商时，只需在 CC Switch 中按顺序操作：
- 1
在 CC Switch 中启用目标 Provider
- 2
（如需要）调整默认模型或配置
- 3
重启 Codex 或 Claude Code
- 4
开始使用新的 Provider
6
如何验证已生效
你可以通过以下方式确认配置已经在客户端生效：
- 在客户端中发送一个简单的请求
- 检查返回结果是否正常
- 确认返回中的模型与服务商一致
- 如遇问题，查看客户端日志或开启调试模式
示例请求（以 Codex 为例）
发送一个简单的问题：
codex “你好，请介绍一下你自己”如果能够正常返回结果，说明已成功使用当前的 Provider。
7
常见问题
下面是配置和切换过程中最常遇到的问题：
Codex / Claude Code 中没有看到我添加的 Provider？
确认已经点击保存和启用，然后完全退出并重新打开客户端。不同客户端读取配置的时机不同，单独关闭一个窗口可能不会重新加载。
是否需要为每个客户端单独配置？
需要。CC Switch 可以统一保存供应商信息，但 Codex 与 Claude Code 使用的协议和配置来源可能不同，请分别核对目标客户端。
切换 Provider 后仍然使用旧配置？
重新确认当前启用项，完全退出旧进程后重启客户端，再发送一次最小请求。必要时检查日志或配置文件的最后更新时间。
遇到认证错误或模型不存在怎么办？
401 通常先检查 API Key 与权限；404 检查 Base URL、路径和模型名；429 检查余额、并发和请求频率。
8
相关教程
完成 CC Switch 配置后，可以继续查看这些相关内容：
实在不会安装或配置？
如果安装失败、Provider 配置不成功或遇到环境报错，可以申请远程协助。充值满 50 元或购买月卡，可免费获得 CC Switch 安装、配置、汉化与基础流程验证。