供应商配置散在各处？CC Switch 把 Claude Code、Codex、Gemini CLI 的切换变成一次点击

供应商配置散在各处CC Switch 把 Claude Code、Codex、Gemini CLI 的切换变成一次点击【免费下载链接】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 编程 CLI 的供应商配置收进同一个 SQLite 数据库~/.cc-switch/一键切换、内置本地代理做自动故障转移还能按供应商和模型统计 token 花费。下面从安装、配置到排障完整走一遍。装好并启动三个系统各自的坑结论先说从官方渠道ccswitch.io下载对应系统版本装完直接打开就能用但每个系统有一个容易卡住的地方。系统常见卡点处理办法macOS提示来自身份不明的开发者打开系统设置 → 隐私与安全性点仍要打开Windows装完点不开、无响应缺 WebView2 运行时Tauri 渲染依赖它安装 Microsoft Evergreen Standalone Installer 后重启LinuxAppImage 点不动或黑屏先chmod x CC-Switch-*.AppImage再运行Wayland NVIDIA 环境用环境变量CC_SWITCH_GDK_BACKENDwayland启动第一次配置加供应商到切换生效1. 添加供应商。主界面点号选一个预设智谱 GLM、DeepSeek、Kimi 等会自动填好端点地址或选自定义手填端点和 API Key确认添加。2. 切换。点供应商卡片上的启用或者右键系统托盘图标直接切两处等效。3. 验证生效。注意生效时机按工具分两档Claude Code、Gemini CLI即时生效不用动终端Codex、OpenCode、OpenClaw需要重开终端才读到新配置验证很简单终端里跑claude问一句话能正常回答就说明链路通了。想切回官方登录选官方登录预设Gemini 对应Google 官方再走 CLI 自带的登录流程即可。日常节奏可以是官方订阅当主力、第三方端点当备胎需要时在托盘里一换终端完全不用碰。本地代理请求统一走一道门场景你不想每换一次供应商就改一遍 CLI 的端点和环境变量或者多个工具的 env 变量互相打架。操作打开设置 → 代理服务开启内置 HTTP 代理默认监听49152端口然后把对应 CLI 的端点指向这个本地地址。端口被占用时点恢复默认即可。效果所有请求统一从本地代理出口转发端点由代理层改写。以 Codex 为例端点指到本地代理后之后换供应商不再动终端配置。自动故障转移主供应商挂了不用你盯着场景主力供应商突然限流你不希望每次都手动重改配置。操作在代理面板开启自动故障转移队列里放2~3 个备用供应商。熔断器的规则是主供应商**连续失败达到阈值默认 3 次**就自动断开请求落到队列备用上。效果熔断时长默认60 秒到期后自动尝试恢复主力。如果你的备用经常误触发把失败阈值从 3 调到 5 就能明显减少误报。用量统计token 花在哪一目了然场景用了半个月账单上的 token 消耗说不清去向。操作三步——开代理、开启应用接管让请求全部经代理转发、打开日志记录。另外部分第三方供应商还需要在供应商卡片上手动开启用量查询并选择内置模板。效果代理层解析每次请求与响应里的用量信息按供应商、模型汇总花费与趋势用量面板可以看单日花费和供应商分布月底对账不用翻记录。出问题了怎么办一张表对号入座现象原因动作切换后工具还在用旧配置运行中的进程不会自动重载重开终端Claude Code / Gemini 除外API Key 被拒、测速失败key 里混了空格或端点写错重新复制无空格 key点供应商卡片速度测试代理起不来提示端口占用49152被占lsof -i :49152Windows 用netstat -ano \| findstr :49152找到占用进程释放或恢复默认Windows 点不开缺 WebView2装 Microsoft Evergreen Standalone Installer故障转移没触发三个条件缺一个依次确认代理在运行、接管已开、自动转移已开、队列里有备用用量面板空白请求没走代理或日志没记确认代理运行 接管开启 日志记录开关打开重启后供应商列表消失配置目录丢失或数据库损坏从~/.cc-switch/backups/恢复最新备份或重新导入导出文件深挖方向日志、源码与深度链接日志~/.cc-switch/logs/cc-switch.log20MB 自动轮转保留 4 份崩溃信息看crash.log。Windows 下位于C:\Users\用户名\.cc-switch\。源码故障转移与熔断逻辑在 src-tauri/src/proxy/failover_switch.rs代理模块整体在 src-tauri/src/proxy/。文档完整多语言使用手册见 docs/user-manual/排障细节可从 docs/user-manual/zh/5-faq/5.2-questions.md 入手。深度链接ccswitch://v1/import?resource...能把供应商、MCP、提示词一键导入应用分享链接比重填省事。本地开发git clone https://gitcode.com/GitHub_Trending/cc/cc-switch然后pnpm install、pnpm tauri dev即可跑起来遇到问题走项目 Issues 反馈。【免费下载链接】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），仅供参考