CC Switch 完全指南：一个免费桌面应用管住 Claude Code、Codex 等 AI 工具的供应商切换

CC Switch 完全指南一个免费桌面应用管住 Claude Code、Codex 等 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-switch在 Claude Code、Codex、Gemini CLI 之间轮换 API 供应商意味着手改 JSON、TOML 或 .env 文件还要担心碰坏自己加的配置。CC Switch 是免费的开源桌面应用把这件事收进一个界面内置 90 多个供应商预设一处填好 Key切换时只改地址、Key、模型这几项关键字段其余设置原样保留。本文带你从安装到常用场景完整过一遍。 快速上手分平台安装 CC Switch先把应用装起来再谈它能做什么。支持 Windows、macOS、Linux 三个平台从仓库 Releases 页面下载对应安装包即可。Windows下载.msi安装包ARM 设备选 arm64 版本或绿色免安装的 Portable 压缩包。要求 Windows 10 及以上。macOS推荐用 Homebrew一条命令完成安装与后续升级也可从 Releases 下载.dmgApple Silicon 和 Intel 芯片都能原生运行。brew install --cask cc-switchLinuxDebian/Ubuntu 选.debFedora 等选.rpm通用环境用 AppImage需chmod x后运行。Arch 用户可用paru -S cc-switch-bin一行装好。要求 x86_64 或 ARM64glibc 2.35 与 WebKitGTK 4.1例如 Ubuntu 22.04、Debian 12。首次启动时它会自动把 Claude Code、Codex、Gemini CLI、Grok Build 的现有配置导入为名为default的供应商并补上各工具的官方供应商。你原来的配置不会丢。 它替你把哪件烦事办了场景一你手上同时有 Claude 官方订阅和两家中转服务想按价格切换供应商。以前的动作是打开工具、找它的配置文件、改地址和 Key、祈祷没改错格式。现在这个动作变成了打开 CC Switch点一家供应商点启用。场景二你在 Claude Code 里加过插件、Hook、MCP 和注释。直接改配置文件的工具很容易把它们冲掉。CC Switch 切换时只替换请求地址、Key、模型名、接口协议这几项连接信息其余内容原样保留第一次改写每个配置文件之前还会把原文件备份到~/.cc-switch/backups/live-first-write/。另外它管理的不只是供应商MCP 服务器、Markdown 提示词、Skills 技能都有集中面板添加一次勾选同步到哪些工具即可。️ 日常供应商切换与配置管理主界面按工具分页Claude、Codex、Gemini…每页是一列供应商卡片卡片显示名称、接入地址和当前使用标记支持拖拽排序把最常用的放上面预设库内置90 多家供应商AWS Bedrock、NVIDIA NIM、各类社区中转可搜索也可以自定义配置从零填同一份配置可以写成通用供应商一次同步到 Claude Code、Codex、Gemini CLI 三个工具支持项目整套切换把当前工具的供应商、MCP、Skills、提示词保存为一个项目之后一键切换入口默认隐藏在「设置 → 通用」打开显示项目切换添加面板上方就是预设列表选中后只需填 API Key请求地址已预置。首次启动导入了官方供应商所以想回到官方登录时切到它再按工具自身流程如 Claude Code 的/login操作即可。 盯盘用量、成本与额度不用开路由也能统计默认自动扫描各工具的本地会话记录按供应商和模型统计请求数、Token、缓存命中率、输出速度和花费仪表板总成本、总请求数、真实消耗 Token、缓存命中率外加全年热力图和逐条请求日志额度倒计时供应商卡片和系统托盘上直接显示剩余量例如5 小时剩余 94%覆盖 Claude/ChatGPT/Gemini 官方订阅和 Kimi、智谱 GLM、MiniMax 等 Coding Plan 额度自定义定价按模型设置单价也可以从 models.dev 导入让成本数字更准️ 稳定运行本地路由、故障转移与云同步想让 Claude Code 用 GPT 格式的供应商、或让 Codex 用 Claude开本地路由请求经本机转发在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses、Gemini Native 四种格式之间自动转换。具体玩法见仓库里的攻略文档 在 Claude Code 中使用 GPT 和 在 Codex 中使用 Claude。自动故障转移为每个工具配置供应商队列请求失败时按顺序自动改道配合熔断器和健康监控聚合模式多家供应商的模型同时出现在 Claude Code 或 Codex 的模型选择器里选哪个模型请求就发给哪家不用回 CC Switch 切换云同步通过 WebDAV坚果云、Nextcloud、NAS或 S3 兼容存储Cloudflare R2、阿里云 OSS 等在多台设备间保持配置一致 三套可以叠加的工作流多设备一致云同步 开机自启。家里电脑和公司笔记本同步同一份供应商库开机就在托盘就绪换机器不用重新填 Key。高频切换系统托盘直切 用量盯盘。托盘里每个工具一行显示名称 · 供应商 · 额度不打开主窗口就能换供应商额度见底时卡片上的倒计时提醒你该切哪家。格式混搭本地路由 故障转移。给路由配一条供应商队列主线路挂了自动切备用整条链路比单点直连稳。❓ 避坑速查问题快速答案切换供应商后不生效大多数工具要重启终端才生效Claude Code 是唯一支持热切换的无需重启。Claude Desktop 需完全退出重开。连通检测通过但请求失败检测连通只测地址可达不验证 Key 和模型名。按顺序查Key 有没有多余空格、Key 是否过期、端点地址对不对。路由后配置文件里变成 127.0.0.1正常现象真实地址和密钥存在 CC Switch 里工具只拿到本地转发地址。退出 CC Switch 时会自动写回直连配置。正在使用的供应商删不掉这是最小侵入设计至少保留一个可用配置工具才不会瘫痪。先切换到别家再删。Codex 聚合里看不到新模型Codex 只在启动时读模型列表改动后需彻底重启CLI 要重启其后台守护进程桌面版 macOS 上按 ⌘Q 退出重开。 幕后一瞥技术栈一句话Tauri 2 Rust 写后端React 18 TypeScript Vite TailwindCSS 写前端数据落在本地 SQLite~/.cc-switch/cc-switch.db写入采用原子操作防止配置损坏。进阶小功能合起来记深色/浅色/跟随系统三种主题自动更新简体中文、繁体中文、英文、日文四语界面OpenClaw 工作区编辑器可直接编辑 AGENTS.md、SOUL.mdHermes 记忆管理可改 MEMORY.md、USER.mdccswitch://深度链接可一键导入供应商、MCP 和提示词。 资料与下一步完整用户手册安装、供应商、MCP、路由、FAQdocs/user-manual/zh/功能支持矩阵与更新历史README_ZH.md 与 CHANGELOG.md贡献与问题反馈CONTRIBUTING.md装好 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），仅供参考