供应商配置散在各处？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-switch

CC Switch 是一款跨平台桌面工具，把 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程 CLI 的供应商配置收进同一个 SQLite 数据库（~/.cc-switch/），一键切换、内置本地代理做自动故障转移，还能按供应商和模型统计 token 花费。下面从安装、配置到排障，完整走一遍。

装好并启动：三个系统各自的坑

结论先说：从官方渠道（ccswitch.io）下载对应系统版本，装完直接打开就能用，但每个系统有一个容易卡住的地方。

系统	常见卡点	处理办法
macOS	提示"来自身份不明的开发者"	打开"系统设置 → 隐私与安全性"，点"仍要打开"
Windows	装完点不开、无响应	缺 WebView2 运行时（Tauri 渲染依赖它），安装 Microsoft Evergreen Standalone Installer 后重启
Linux	AppImage 点不动或黑屏	先`chmod +x CC-Switch-*.AppImage`再运行；Wayland + NVIDIA 环境用环境变量`CC_SWITCH_GDK_BACKEND=wayland`启动

第一次配置：加供应商到切换生效

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 :49152`（Windows 用`netstat -ano \\| findstr :49152`）找到占用进程，释放或"恢复默认"
Windows 点不开	缺 WebView2	装 Microsoft Evergreen Standalone Installer
故障转移没触发	三个条件缺一个	依次确认：代理在运行、接管已开、自动转移已开、队列里有备用
用量面板空白	请求没走代理或日志没记	确认代理运行 + 接管开启 + 日志记录开关打开
重启后供应商列表消失	配置目录丢失或数据库损坏	从`~/.cc-switch/backups/`恢复最新备份，或重新导入导出文件

深挖方向：日志、源码与深度链接

日志：~/.cc-switch/logs/cc-switch.log，20MB 自动轮转（保留 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 反馈。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析