推荐安装
- 同时使用多个客户端（如 Claude Code、Codex 等）
- 需要在不同的 API 供应商之间切换
- 希望统一管理多个 Provider 的配置
- 需要快速比较不同模型或供应商的效果
认识工具CC Switch 是什么？
CC Switch 是什么？
下载、安装与供应商切换教程
CC Switch 是一个 Provider 配置管理工具，用于统一管理多个 AI 供应商，不是 Codex 或 Claude Code 的客户端，也不提供模型能力。
小贺AI编辑部 · 实测更新 2026-09-16 · 阅读约 10 分钟先用它统一管理多个 Provider，再完成导入、启用、切换和验证。已核对官方 Release
Providers＋ 添加 Provider
OpenAIsk-••••••••••••
已启用
Anthropicsk-ant-••••••••
未启用小贺AIsk-••••••••••••
已启用自定义按服务商文档填写
未启用1
先判断你需不需要装
CC Switch 不是必须的。如果你只在一个客户端里使用固定的 Provider，可能不需要它。
可能不需要
- 只在一个客户端中使用固定的 Provider
- 不需要频繁切换供应商或配置
- 已经有自己熟悉的配置文件管理方式
2
下载 CC Switch
从 GitHub 官方 Releases 页面下载最新版，按你的系统选择安装包。
3
安装与配置（图文步骤）
- 1备份当前配置
如果你之前配置过 CC Switch，建议先备份好现有配置文件。
- 2安装并首次导入
运行下载的安装包，完成安装后启动 CC Switch。
- 3添加 Provider
在 Providers 页面点击「添加 Provider」，填写名称、Base URL 和 API Key。
- 4点击启用
添加完成后，开启该 Provider 的开关，使其处于「已启用」状态。
- 5重启目标客户端
在关闭的 Codex、Claude Code 等客户端中重新启动，确保配置被读取。
- 6用最小任务验证
运行一个简单问题，确认返回结果正常并且模型配置正确。
编辑 Provider
启用此 Provider
4
关键概念：普通直连 vs 本地代理
普通直连：无需常驻运行
推荐直接配置 API Base URL 和 API Key 即可使用，不需要额外启动本地代理，适合大多数用户。
- 配置后即可使用
- 不占用本地代理端口
- 适合大多数场景
本地代理：必须运行
进阶通过本地代理服务器转发请求，需要先启动本地代理，再在 CC Switch 中配置对应的地址。
- 需要先启动本地代理
- 配置本地地址（如 http://localhost:7890）
- 适合进阶用户
5
安全提示与注意事项
妥善保管 API Key
API Key 涉及账户安全，请勿泄露给他人，也不要提交到公开仓库或不可信的工具中。
遵守第三方服务条款
使用第三方 Provider 时，请遵守服务商的服务条款和使用限制。
仅从官方渠道下载
请从 GitHub Releases 页面下载，避免使用来源不明的安装包。
6
验证是否配置成功
- 在 CC Switch 中看到 Provider 状态为「已启用」
- 在目标客户端中可以正常调用并返回结果
- 切换不同 Provider 后，结果符合预期
- 如遇问题，可先查看下方常见问题
7
常见问题
下载后无法安装怎么办？
确认安装包来自官方 Releases，检查系统架构和权限，并尝试重新下载最新版本。
添加 Provider 时提示连接失败？
检查 Base URL、API Key 和网络连接，确认服务商文档中的协议和地址没有填错。
如何切换不同的 Provider？
在对应客户端的 Provider 列表中启用目标配置，重启需要重新读取配置的客户端即可。
是否需要持续运行 CC Switch？
普通直连配置不需要；只有启用了本地代理模式时，才需要保持代理服务运行。