CC Switch 完整指南：3分钟统一管理AI编程工具，一键切换供应商
CC Switch 完整指南3分钟统一管理AI编程工具一键切换供应商【免费下载链接】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 是一款面向 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程工具的跨平台全能桌面助手把供应商管理、一键切换、本地代理和用量统计收进同一个窗口。同时维护多个 AI 编程工具和多份 API 配置时过去你要反复手改各家 CLI 的配置文件。CC Switch 把所有供应商配置存进本地数据库切换时替你改写对应工具的端点与密钥点一下按钮就完成整套动作。按下面的顺序操作5 分钟内可以从安装走到第一次成功切换。3分钟装好CC Switch各系统一键安装CC Switch 支持 Windows、macOS、Linux按你的系统选一种方式macOSbrew install --cask cc-switch一条命令完成官方包已签名并公证可直接打开Windows从官网下载.msi安装若双击安装程序无反应右键文件 → 属性 → 在安全里勾选解除锁定Linux按架构安装 deb 包或给 AppImage 加执行权限后直接运行开发者也可以从源码启动本地开发环境git clone https://gitcode.com/GitHub_Trending/cc/cc-switch cd cc-switch pnpm install pnpm tauri dev被管理的 CLI 工具本身依赖 Node.js 18如果还没装 Claude Code、Codex、Gemini CLI用npm install -g全局安装对应包即可。确认安装成功启动后检查两件事主界面顶部能看到应用切换器列出了你启用的受管应用系统托盘出现了 CC Switch 图标。两者都在就可以开始添加供应商。设置里还能调整语言、主题和退出时是否最小化到托盘。5分钟添加第一个供应商三步填好API Key点击主界面右上角的按钮在预设下拉框选择供应商常用预设包括智谱 GLM、DeepSeek、Kimi、MiniMax 等找不到就选自定义粘贴 API Key点击添加预设就像填空题模板端点地址、模型参数都由 CC Switch 预先填好你只负责 Key。添加完成后供应商以卡片形式出现在列表里可以立即用内置的速度测试验证连通性测速通过再启用更稳妥。切换之后如何生效点击供应商卡片上的启用按钮CC Switch 会把配置写入对应 CLI 工具的配置文件。不同工具的生效方式不同应用生效方式Claude Code即时生效支持热重载Gemini CLI即时生效每次请求重新读配置Codex / OpenCode / OpenClaw关闭终端重新打开切换还有一个快捷入口右键系统托盘图标在按应用分级的菜单里直接点供应商名称不用打开主窗口。所有供应商数据都保存在~/.cc-switch/cc-switch.db这个 SQLite 数据库里每次导入配置前会自动创建备份迁移新机器时用内置导入功能即可整体恢复。⚡ 开启本地代理与应用接管本地代理像一个快递中转站API 请求先经过这个站点再转发给真实供应商用量、延迟、成败都顺手记录下来。点击主界面顶部的代理开关即可启动默认监听127.0.0.1:15721开启应用接管后工具配置被自动改写到指向本地代理停止代理时配置会自动还原只支持 OpenAI 兼容 API 的供应商也能通过代理的格式转换用在 Claude Code 上流式与非流式请求都支持代理面板实时显示活跃连接、总请求数和成功率超过 90% 为绿色请求是否通畅一眼可见。监听地址保持127.0.0.1即可只有局域网内多台机器共用时才需要改0.0.0.0。更完整的参数说明见 代理服务章节。智能故障转移与用量统计配置故障转移队列故障转移是主供应商掉线时的自动换人请求失败后自动切到队列里下一个供应商继续完成。配套的熔断器类似电路里的保险丝某家供应商连续失败后会被暂时断开避免反复重试卡住请求。进入 设置 → 高级 → 故障转移选择应用 TabClaude / Codex / Gemini点击添加供应商把备用供应商放进队列拖拽调整顺序序号越小优先级越高打开自动故障转移开关供应商卡片上的健康徽章帮你判断状态绿色健康、黄色降级连续失败 1-2 次、红色熔断连续失败 3 次以上。默认失败阈值 4 次、恢复等待 60 秒Claude 因请求耗时更长阈值放宽到 8 次、等待 90 秒都可以按需调整。查看用量与估算费用打开设置 → 用量顶部 Hero 卡汇总总请求数、真实消耗 Tokens、缓存命中率、估算费用和成功率切换日期、应用、供应商筛选时数字同步刷新。数据有两个来源代理请求日志需要代理和应用接管都在运行以及CLI 会话日志——直接解析各工具自己的会话历史文件不依赖代理。也就是说即使不开代理也能看到 Claude、Codex、Gemini 各自的 Token 消耗与费用估算。问题速查症状一步处理macOS 提示来自身份不明的开发者系统设置 → 隐私与安全性 → 点仍要打开Windows 安装程序双击无反应右键安装包 → 属性 → 勾选解除锁定代理启动失败、端口被占用先停止代理在设置里更换端口后重新启动切换供应商后不生效关闭终端重新打开Codex / OpenCode / OpenClaw 需要API Key 校验失败去掉 Key 首尾空格用内置速度测试复测配置丢失、供应商列表为空到~/.cc-switch/backups/找最近备份恢复 生态与贡献入口完整功能手册MCP、Prompts、Skills、会话管理在 用户手册 中。想参与开发克隆仓库后pnpm install再pnpm tauri dev启动本地调试按仓库内 CONTRIBUTING.md 的规范提交 PR。如果你每天要在多个 AI 编程工具之间来回配置CC Switch 可以把这些动作收敛成一次点击。【免费下载链接】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），仅供参考