告别手改配置文件：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
你同时开着 Claude Code、Codex 和 Gemini CLI 吗？那三套供应商配置就散落在~/.claude、~/.codex、~/.gemini三个目录里，JSON 和 TOML 混着存，换一次端点就得翻一遍文件，贴错了还得排查半天。CC Switch 把这些配置收进同一张桌面面板，点一下完成供应商切换，请求还能走内置本地代理做故障转移，顺手把用量统计记下来——本文按顺序带你把它装好、跑通、用熟。
从下载到跑通：CC Switch 安装与添加供应商的完整步骤
先用一个真实场景热身：周五下午主力端点被限流，你一边盯着一边手改三个工具的配置文件，改到第二个才想起来第三个还没动。这类时刻堆多了，你才会意识到供应商切换这件事值得交给一个面板，而不是每次自己翻文件。
跑通流程一共五步，十分钟以内能走完：
- 从官方渠道下载对应系统安装包，装完直接启动。
- 按下面这张表处理你所在系统的首启提示，别被弹窗吓退。
- 主界面点
+，选一个预设（智谱 GLM、DeepSeek、Kimi 等会直接填好端点），或选"自定义"手填，贴入 API Key 后保存。 - 点供应商卡片上的"启用"，或右键托盘图标直接切。
- 启动
claude随便问一句，能正常回答就算通了。
各系统首启的差异收进一张表，碰到再查：
| 系统 | 现象 | 处理 |
|---|---|---|
| macOS | 提示"来自身份不明的开发者" | 到系统设置的隐私与安全性里点"仍要打开" |
| Windows | 装完点不开、无响应 | 缺 WebView2 运行时，装 Microsoft Evergreen Standalone Installer 后重启 |
| Linux | AppImage 启动不了 | 先给文件加执行权限再运行 |
| Linux | Wayland + NVIDIA 下点不动或黑屏 | 用环境变量CC_SWITCH_GDK_BACKEND=wayland启动 |
供应商切换怎么操作：启用、回官方登录与配置存放位置
装好之后的第一件事是把切换习惯建起来。所有供应商配置都存在~/.cc-switch/的 SQLite 数据库里（Windows 在C:\Users\<用户名>\.cc-switch\），你在卡片或托盘上的每一次切换都是改这个库，然后由应用把配置写回对应 CLI 的目录。
几个高频动作：
- 想换第三方端点：选中供应商卡片点"启用"，托盘图标右键也能切，终端不用动。
- 想切回官方登录：选"官方登录"预设（Gemini 是"Google 官方"），再走 CLI 自己的登录流程。
- 生效时机有讲究：Claude Code、Gemini 即时生效；Codex、OpenCode、OpenClaw 要重开终端才读新配置。
- 常见摆法是官方订阅当主力、第三方端点当备份，平时不用碰，出事再切。
深挖三个实用功能：代理、故障转移与用量统计
本地代理怎么配置：端口 49152 与端点改向
每次换供应商都要改环境变量，这是最磨人的环节。把请求收口到内置 HTTP 代理之后，CLI 的端点就固定指向本地这一个门，换供应商只动面板配置，终端里的东西一个字都不用碰。
开启方式：设置 → 代理服务里打开开关，默认监听 49152 端口，把 CLI 的端点改指向它即可。端口被占用时点"恢复默认"能救急。好处不止一个：多个工具的请求统一改写端点，环境变量不再互相打架，代理层还能顺势记录每一次请求的用量，为后面的统计铺路。
故障转移怎么自动生效：失败阈值与熔断恢复
主力供应商突然限流，最省心的应对是让它自己退场。代理面板打开自动故障转移，再往队列里放两三个备用供应商，剩下的交给熔断器：它盯着主供应商的连续失败次数，达到阈值（默认 3 次）就断开主供应商，请求自动落到队列里按优先级逐个尝试；熔断时长默认 60 秒，到期后熔断器放一个试探请求过去，探活成功就自动恢复。误触发太频繁的话，把失败阈值从 3 调到 5 就行，不用改任何配置文件。
用量统计怎么开：花费按供应商与模型汇总
用了半个月，token 到底花在哪？代理层会解析每个请求与响应里的用量字段，按供应商、模型两个维度汇总花费，再画出趋势曲线，月底对账一眼看清。
前提是数据真的流过代理：开代理并开启应用接管，让请求都经代理转发，再确认日志记录是开的；部分第三方供应商还要在卡片上手动打开"用量查询"并选一个内置模板，缺哪步补哪步。
常见问题排查：切换不生效、端口占用与用量空白的快速修复
卡住的时候按这张表对，覆盖最高频的五类：
| 现象 | 原因 | 一步修复 | 验证方法 |
|---|---|---|---|
| 切了供应商，工具还在用旧端点 | 已运行的进程不会自动重载配置 | 重开终端（Claude Code、Gemini 除外） | 重新提问，观察走的是新端点 |
| API Key 被拒、测速失败 | key 带空格或端点写错 | 重新复制一份无空格的 key，顺手核对端点 | 点供应商卡片上的"速度测试"通过 |
| 代理起不来，提示端口占用 | 默认端口 49152 被别的程序占了 | macOS/Linux 跑lsof -i :49152，Windows 跑netstat -ano \| findstr :49152，杀掉占用进程，或回面板点"恢复默认" | 代理服务状态显示运行中 |
| 故障转移没触发 | 代理没跑、接管没开、队列空着，三者缺其一 | 按顺序开齐代理、应用接管、自动故障转移三个开关，队列补两三个备用 | 手动断网观察请求落到备用供应商 |
| 用量面板一片空白 | 请求没走代理，或日志记录没开 | 确认代理运行中、接管已开，再查日志记录开关 | 发一次请求后回面板看是否出现新记录 |
深入排查与源码阅读：日志、手册与反馈渠道
- 日志在
~/.cc-switch/logs/cc-switch.log（Windows 在C:\Users\<用户名>\.cc-switch\下），单文件到 20MB 自动轮转；崩溃现场看同目录的crash.log。 - 想看故障转移与熔断的实现，入口在 src-tauri/src/proxy/failover_switch.rs，整个代理层在 src-tauri/src/proxy/ 目录里。
- 完整多语言手册在 docs/user-manual/，排查问题前先翻一遍，大部分答案都写在 FAQ 里。
- 本地开发只需
git clone https://gitcode.com/GitHub_Trending/cc/cc-switch后pnpm install、pnpm tauri dev；踩的坑走项目 Issues 反馈。
卡住了先翻手册，想挖深了就翻源码——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），仅供参考
