CC Switch快速上手教程：从0到1，如何一键切换Claude Code与Codex的API供应商
【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch
CC Switch是一款跨平台的 AI 编程工具管理助手，专为 Claude Code、Codex、Gemini CLI 等工具设计，核心功能就是一键切换 API 供应商：无需手动编辑 JSON、TOML 或.env配置文件，内置 50+ 供应商预设，粘贴 API Key 即可完成导入，还能从系统托盘即时切换。本文带你从 0 到 1 走完整个上手流程，5 分钟即可配好。
一、为什么需要 CC Switch？
日常使用 AI 编程工具时，你是否遇到过这些麻烦：
- 每个工具（Claude Code / Codex / Gemini CLI）的配置格式都不一样；
- 想换一家 API 供应商，就得手动找配置文件、改 Key 和端点地址；
- 多个供应商来回切换，配置改乱了还不知道改哪错了。
CC Switch 用一个桌面应用统一管理这些工具的配置：供应商以卡片形式集中展示，点「启用」就完成切换，底层基于 SQLite 数据库 + 原子写入，避免配置被写坏。
二、一键安装：Windows / macOS / Linux 全覆盖
| 系统 | 最低要求 | 安装方式 |
|---|---|---|
| Windows | Windows 10 及以上（x64） | 下载.msi安装包，或绿色版解压即用 |
| macOS | macOS 12 及以上 | brew install --cask cc-switch或下载.dmg |
| Linux | 主流发行版（x64 / ARM64） | .deb/.rpm/ AppImage，Arch 可用 AUR |
💡 前置条件：被管理的 CLI 工具（Claude Code、Codex 等）依赖Node.js 18+环境。
完整安装说明见官方文档：1.2 安装指南。
安装完成后启动应用，验证三件事：窗口正常显示、系统托盘出现图标、应用切换器中能看到已启用的受管应用。
三、认识主界面：30 秒上手
主界面分为三块，记住它们就够了：
| 区域 | 位置 | 作用 |
|---|---|---|
| 🔁应用切换器 | 顶部中间 | 在 Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes 之间切换 |
| ➕添加按钮 | 右上角橙色按钮 | 添加新的 API 供应商 |
| 🃏供应商卡片 | 主列表 | 每张卡片一个供应商，鼠标悬停显示「启用 / 编辑 / 复制 / 测速」等操作按钮 |
卡片状态一眼可辨：蓝色边框 = 当前启用，绿色边框 = 代理模式下实际生效的供应商。
四、第一步：1 分钟添加供应商
点击主界面右上角的+按钮，打开添加面板。
方式一：选预设（推荐，最快）
- 在「预设」下拉框中选择供应商，常用预设包括：DeepSeek、智谱 GLM、Kimi、MiniMax、百炼、OpenRouter、PackyCode 等；
- 名称、端点地址自动填充，你只需要填写API Key；
- 点击「添加」，完成 ✅
⭐ 带星标的是官方合作伙伴预设，列表随版本持续更新，以应用内实际显示为准。
方式二：自定义配置
如果预设里没有你的供应商，选择「自定义」手动填写：API Key、请求地址、主模型等字段即可，下方 JSON 会实时联动，方便高级用户直接编辑。
更多预设清单与配置格式，详见：2.1 添加供应商。
五、第二步：一键切换供应商，即时生效
添加完成后，切换只有两种姿势：
姿势一：主界面切换—— 点击目标供应商卡片的「启用」按钮。
姿势二：托盘快速切换—— 右键系统托盘图标，在按应用分组的子菜单（如 "Claude · 当前供应商"）中直接点击要切换的供应商，无需打开主窗口。
切换后的生效方式各不相同，这是新手最容易踩的坑：
| 应用 | 生效方式 |
|---|---|
| Claude Code | ✅ 即时生效（支持热重载） |
| Gemini CLI | ✅ 即时生效（每次请求重读配置） |
| Codex | ⏳ 需关闭并重新打开终端 |
| OpenCode / OpenClaw | ⏳ 需关闭并重新打开终端 |
⚠️ 切换后如果「不生效」，99% 的原因是忘了重启终端——配置文件其实早已更新，只是运行中的程序不会自动重新加载。
原理细节见：2.2 切换供应商。
六、进阶：给 Codex 接入 DeepSeek、Kimi 等非 GPT 供应商
Codex 原生只认 OpenAI Responses API 与 GPT 系列模型。想接入 DeepSeek、Kimi、MiniMax 这类第三方模型怎么办？
CC Switch 提供了「需要本地路由映射」开关：由本地代理把 Codex 发出的请求自动转换成上游的 Chat 协议，再把流式响应、工具调用原样转回来。选择 DeepSeek / Kimi 等预设时，该开关和模型映射表会自动配置好，无需手动设置。
💡 注意：本地路由转换需要开启代理服务并启用应用接管，使用期间保持本地路由开启即可。
七、两个让体验翻倍的小技巧
1. 跳过 Claude Code 初次安装确认
Claude Code 首次启动会弹出登录引导，干扰使用。打开「设置 → 通用」，开启「跳过 Claude Code 初次安装确认」开关，再重启 Claude Code 即可：
2. 托盘轻量模式
勾选托盘菜单中的「轻量模式」，主窗口会关闭以释放资源，应用仅在托盘后台运行，但随时可以从托盘切换供应商——适合多供应商重度用户。
八、常见问题（FAQ）
Q：想切回官方登录怎么办？选择「Claude 官方 / OpenAI 官方」预设切换过去，然后按各工具的 Logout → Login 流程操作一遍，之后即可在官方与第三方供应商之间自由切换。
Q：切换供应商后插件等配置会丢吗？不会。可使用「通用配置片段」功能，把 Key 与端点之外的通用配置提取出来，新建供应商时勾选「应用通用配置」自动带入。
Q：数据存在哪里？全部在本地：数据库位于~/.cc-switch/cc-switch.db，并自动保留最近 10 份备份。
更多问题解答见：5.2 常见问题，完整界面说明见：1.3 界面概览。
总结：从 0 到 1 只需 4 步
- 📥 安装 CC Switch（三大平台一键安装）；
- ➕ 点「+」选预设，填 API Key 添加供应商；
- ▶️ 点「启用」或托盘点击，一键切换；
- 🔄 Codex 等工具重启终端，Claude Code 即时生效。
掌握以上流程，你就已经可以自如地在 Claude Code 与 Codex 之间切换任意 API 供应商了。接下来可以解锁的进阶玩法：统一 MCP 管理、Prompts 同步、Skills 技能安装，以及本地代理的自动故障转移——都藏在官方用户手册里，值得慢慢探索。
【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
