CC Switch 完整教程：多供应商一键切换，AI 编程 CLI 配置不再手改
CC Switch 完整教程多供应商一键切换AI 编程 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、Grok Build 与 Hermes Agent 这些 AI 编程命令行工具提供供应商配置的集中管理与一键切换。它替你省掉的是每次换端点、贴密钥、改 TOML/JSON 配置文件时那份翻找文件再排查半天的心力。 适合谁用想象一下你的日常主力用 Claude Code 的官方订阅偶尔切到 Kimi 或 DeepSeek 的第三方端点省点钱再顺手用 Codex 跑批处理。配置散落在~/.claude、~/.codex、~/.gemini各处格式还不统一改一处忘一处。供应商限流或挂掉你正写着代码只能中断手头的事手动改配置再试。花了多少 token、钱花在哪月底完全说不清。只要你有两个以上供应商在轮换或者希望请求有自动兜底CC Switch 就能帮上忙所有供应商配置统一入库点一下切换请求还能走内置本地代理实现故障转移和用量记录。 装上并跑通第 1 步下载安装。从官方渠道官网 ccswitch.io下载对应系统的安装包安装完成后直接启动。第 2 步过掉首次启动的系统坑。三个系统各有各的拦路虎macOS如果提示来自身份不明的开发者进入「系统设置 → 隐私与安全性」点击仍要打开即可。Windows安装后点不开多半是缺少 WebView2 运行时Tauri 框架渲染界面依赖的微软组件。去微软官网下载 Evergreen Standalone Installer 装上再启动。LinuxAppImage 版本先执行chmod x CC-Switch-*.AppImage再运行。如果用的是 Wayland NVIDIA 显卡界面点了没反应或缩放后黑屏改用CC_SWITCH_GDK_BACKENDwayland ./CC-Switch-*.AppImage启动从桌面图标启动时把这个变量写进.desktop文件的Exec行。第 3 步添加第一个供应商。主界面点选择一个预设智谱 GLM、DeepSeek、Kimi 等会自动填好端点地址或者选自定义填入 API Key 后添加。第 4 步验证切换生效。在供应商卡片上点启用或直接右键托盘图标切换。生效时机因工具而异Claude Code、Gemini 即时生效Codex、OpenCode、OpenClaw 需要重开终端。然后运行claude随便问一句话能正常回答就算全链路通了。⚙️ 功能从基础到进阶供应商切换官方订阅当主力第三方端点做备份所有供应商配置都存在~/.cc-switch/Windows 为C:\Users\用户名\.cc-switch\的 SQLite 数据库里界面卡片或托盘菜单点两下即可完成切换预设模板覆盖主流供应商省去手改端点和密钥的重复劳动。要切回官方登录时选官方登录预设Gemini 对应Google 官方再走 CLI 自身的登录流程即可。典型搭配是官方订阅日常使用第三方端点留作备用供应商抽风时在托盘里切过去终端窗口完全不用动。内置本地代理所有请求走一道门不想每换一次供应商就重设一遍环境变量可以让请求统一收口到内置 HTTP 代理它默认监听 49152 端口转发工具请求并统一改写端点。在「设置 → 代理服务」里开启代理把 CLI 的端点指向本地代理地址如果端口被占用导致启动失败点恢复默认或先释放端口。开启后以 Codex 为例端点固定指向本地代理之后换供应商再也不用碰终端里的配置。怎么开启自动故障转移主供应商挂了自动换熔断器连续失败达到阈值就自动断开当前供应商的机制会持续监控主供应商失败次数到阈值后自动切到队列里的备用熔断时长默认 60 秒到期后再自动试探恢复。在代理面板打开自动故障转移开关队列里放 2~3 个备用供应商即可。如果发现误触发太频繁比如网络抖动把失败阈值从 3 调到 5。效果是主力供应商限流时请求自动落到备用端点你甚至感知不到中断。熔断与切换逻辑的实现在 src-tauri/src/proxy/ 目录下感兴趣可以直接读源码。用量统计token 花在哪一眼看清代理层会解析请求与响应中的用量信息按供应商、模型两个维度汇总花费和趋势月底对账不用再靠猜。前提是三个开关都打开代理运行中、应用接管开启让请求真正经代理转发、日志记录开启。另外部分第三方供应商还需要在供应商卡片上手动打开用量查询并选择内置模板。开启后在用量面板里就能看到单日花费与供应商分布了。 出问题先查这张表症状原因修复切换后工具还在用旧配置已运行的 CLI 进程不会自动重读配置重开终端再试Claude Code 与 Gemini 本身即时生效无需重启API Key 被拒、测速不通key 复制时带了空格或端点地址写错重新复制无空格的 key再点供应商卡片上的速度测试验证代理启动失败报端口占用默认端口 49152 已被其他程序占掉用lsof -i :49152Windows 用netstat -ano \| findstr :49152找出占用进程释放后重试或在设置里恢复默认Windows 装完打不开缺少 WebView2 运行时安装微软 Evergreen Standalone Installer 后重新启动故障转移始终不触发代理没运行或接管、自动转移、备用队列三项没配齐按顺序检查三个开关队列里确保有 2~3 个备用供应商用量面板一片空白请求没走代理或日志记录没开确认代理在跑、应用接管已开再检查日志记录开关重启后供应商列表消失配置目录被删或数据库损坏从~/.cc-switch/backups/恢复最新备份或用之前导出的文件重新导入 进阶入口日志运行日志在~/.cc-switch/logs/cc-switch.log按 20MB 自动轮转应用崩溃看同目录下的crash.logWindows 在C:\Users\用户名\.cc-switch\下。完整文档多语言用户手册见 docs/user-manual/安装、供应商管理、代理与故障转移都有专章。深度链接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），仅供参考