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-switchCC 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 全覆盖系统最低要求安装方式WindowsWindows 10 及以上x64下载.msi安装包或绿色版解压即用macOSmacOS 12 及以上brew install --cask cc-switch或下载.dmgLinux主流发行版x64 / ARM64.deb/.rpm/ AppImageArch 可用 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. 托盘轻量模式勾选托盘菜单中的「轻量模式」主窗口会关闭以释放资源应用仅在托盘后台运行但随时可以从托盘切换供应商——适合多供应商重度用户。八、常见问题FAQQ想切回官方登录怎么办选择「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），仅供参考