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 是一款基于 Tauri 2 Rust 构建的跨平台桌面应用把 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes 这 8 个 AI 编程工具的供应商配置收进同一个界面。你不用再去手改 JSON、TOML 或 .env 文件在界面上选中一个供应商点启用它就把对应工具的配置写到位。内置 50 供应商预设、本地代理故障转移、用量统计看板、MCP 与 Skills 统一管理Windows、macOS、Linux 都能用。先解决什么问题换供应商为什么这么麻烦日常用 AI 编程工具换一家 API 供应商通常意味着这几步打开 Claude Code 的 JSON 配置改 base URL 和 API Key再打开 Codex 的 TOML 配置按它的格式改一遍Gemini CLI 又要改环境变量手抖改错一个字符还得逐个文件回滚。配置分散在多个文件、多种格式里没有任何统一视图告诉你现在到底在用哪家的 Key。CC Switch 的思路是所有供应商配置存进一个本地 SQLite 数据库界面里做增删改查切换时由它统一写入各工具的配置文件。数据库位于~/.cc-switch/cc-switch.db写入采用临时文件 重命名的原子操作还自动保留最近 10 份备份在~/.cc-switch/backups/配置文件损坏的风险被基本排除。安装 CC Switch三大平台各走一条路安装本身没有门槛按你的系统选一种即可macOS推荐 Homebrew 一条命令装好后续brew upgrade --cask cc-switch就能升级也可以下载官方 .dmg已做代码签名和 Apple 公证双击即装。Windows下载 .msi 安装包或便携版 zipWin10 及以上。Linux提供 .debDebian/Ubuntu、.rpmFedora/RHEL、AppImage 三种格式Ubuntu 22.04 / Debian 11 / Fedora 34 及以上均可。首次启动时它会把你现有 CLI 工具的配置导入为default供应商——这一步很关键意味着你原来的官方登录状态不会丢。一个已知的小坑Linux 上 Wayland NVIDIA 组合如果点击无响应或窗口黑屏用CC_SWITCH_GDK_BACKENDwayland或 x11环境变量启动 AppImage 即可绕过。一键添加供应商预设模板 只填一个 API Key主界面按 Claude / Codex / Gemini 等应用分 Tab每个供应商是一张卡片显示名称、端点地址和余额信息如已使用 157.60 / 剩余 52.40 USD。点击右上角的加号开始添加添加流程分两种选预设界面顶部列出 50 内置预设DeepSeek、GLM、Kimi、MiniMax、PackyCode 等选中后请求地址自动填好你只需粘贴 API Key。自定义配置选自定义配置后填入供应商名称、请求地址、主模型等。这里有个实用设计——请求地址支持配置多个端点并能一键测速测速结果直接显示延迟和状态码例如同一个服务两个端点分别是 297ms 和 2146ms勾选自动选择后切换时自动走最快的那个。切换供应商主界面启用与系统托盘两种姿势供应商加好之后两种切换方式主界面选中卡片点启用配置写入对应工具的文件系统托盘不打开应用直接在托盘菜单里点供应商名称即时生效。托盘菜单按应用分级Claude / Codex / Gemini 各自子菜单标题栏还显示当前供应商和用量摘要。生效方式上有个细节要知道大多数工具需要重启终端或 CLI 才生效唯独 Claude Code 支持热切换改完立刻可用。卡片右侧一排图标分别对应编辑、复制、用量、删除。注意当前使用的供应商删不掉——这是刻意设计的最小侵入原则哪怕你卸载了 CC Switch你的 CLI 工具也必须还能正常工作系统至少要留一份可用配置。想换回官方登录也不麻烦从预设里添加官方登录供应商切换后按工具自己的登录流程走一遍即可Codex 还因此支持多个 Plus / Team 账号来回切。本地代理与故障转移主供应商挂了自动接管基础切换之外CC Switch 的代理模式是把所有 API 请求先经过本地代理再转发默认监听127.0.0.1:15721。主界面顶部的 Proxy 开关一开代理就进入运行状态代理层带来的能力格式转换比如把只支持 Chat 协议的 DeepSeek、Kimi 接入 Codex由代理做协议适配请求日志每次调用的端点、模型、Token 数都落库故障转移队列主供应商请求失败时按队列顺序自动切到备用供应商配合熔断器机制——连续失败超过阈值会熔断该供应商避免反复撞墙恢复后按退避策略试探性放回。配置路径是设置 → 高级 → 故障转移页面按 Claude / Codex / Gemini 分 Tab拖拽调整队列优先级即可。开启自动故障转移开关后失败才真正触发切换不开则只记录不切换适合只想观察的场景。用量看板怎么读Token、成本、趋势一屏看全代理跑起来之后用量数据就开始积累。用量看板按供应商、模型、时间三个维度统计Hero 区展示筛选范围内的总 Token缓存归一化后的真实值和缓存命中率跟随日期/供应商/模型筛选实时刷新趋势图按天查看请求量和花费曲线哪天空闲异常一眼可见请求日志单条请求的端点、模型、状态、Token 明细可逐条查自定义定价内置 models.dev 价格数据也可按模型手动改单价适配各家不同计费。对用多套 Key、多个套餐的团队来说这个月到底烧了多少钱、烧在哪个模型上这个问题不用再去各家后台对账了。进阶能力MCP、提示词、Skills 与会话统一管理CC Switch 管的不只是 API Key还管 AI 工具周边的三样东西模块做什么同步目标MCP一个面板管理所有 MCP 服务器按应用勾选启用支持 Deep Link 导入Claude、Codex、Gemini、Grok Build、OpenCode、HermesPromptsMarkdown 编辑器管理提示词预设激活即写入对应文件支持智能回填防覆盖CLAUDE.md / AGENTS.md / GEMINI.mdSkills从 GitHub 仓库或 ZIP 一键安装技能支持符号链接、批量更新与 SHA-256 变更检测各工具的技能目录另外还有两个容易忽略的实用功能会话管理器可以跨来源浏览、搜索、恢复历史对话云同步支持把配置目录指向 Dropbox、OneDrive、iCloud 或自建 WebDAV 服务器实现多设备配置一致。ccswitch://深度链接协议则允许你通过 URL 直接把供应商配置、MCP、提示词、技能导入进来方便在团队内分享配置。常见问题排坑清单切换后没生效重启终端或对应 CLIClaude Code 除外它支持热切换。插件配置消失了进编辑供应商 → 共享配置面板 → 从当前供应商提取把公共配置存成片段新建供应商时勾选写入共享配置即可带入。环境变量冲突如果工具读取的环境变量与配置文件打架设置里有冲突检测与处理入口按提示清理即可。数据存哪了数据库~/.cc-switch/cc-switch.db、设备级设置~/.cc-switch/settings.json、备份~/.cc-switch/backups/、技能~/.cc-switch/skills/。源码贡献前端在src/React TS Tailwind后端在src-tauri/src/命令层、服务层、SQLite DAO 分层清晰代理模块在src-tauri/src/proxy/需要本地构建可以git clone https://gitcode.com/GitHub_Trending/cc/cc-switch后用pnpm dev起开发模式需 Node.js 18、pnpm 8、Rust 1.85。适合谁用如果你的工作流里同时跑着 Claude Code、Codex 和 Gemini CLI 中的任意两个以上或者你在多家 API 供应商之间来回倒腾CC Switch 能把改配置文件这件事从日常里彻底删掉预设一键导入、托盘秒切、代理兜底、花费可见。对个人开发者它省下的是每次切换的十分钟和手改配置的心碎对团队它提供的是配置模板化分发、统一用量口径和多设备同步。MIT 协议开源三大平台通吃装一次就回不去了。【免费下载链接】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），仅供参考 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 是一款基于 Tauri 2 Rust 构建的跨平台桌面应用把 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes 这 8 个 AI 编程工具的供应商配置收进同一个界面。你不用再去手改 JSON、TOML 或 .env 文件在界面上选中一个供应商点启用它就把对应工具的配置写到位。内置 50 供应商预设、本地代理故障转移、用量统计看板、MCP 与 Skills 统一管理Windows、macOS、Linux 都能用。先解决什么问题换供应商为什么这么麻烦日常用 AI 编程工具换一家 API 供应商通常意味着这几步打开 Claude Code 的 JSON 配置改 base URL 和 API Key再打开 Codex 的 TOML 配置按它的格式改一遍Gemini CLI 又要改环境变量手抖改错一个字符还得逐个文件回滚。配置分散在多个文件、多种格式里没有任何统一视图告诉你现在到底在用哪家的 Key。CC Switch 的思路是所有供应商配置存进一个本地 SQLite 数据库界面里做增删改查切换时由它统一写入各工具的配置文件。数据库位于~/.cc-switch/cc-switch.db写入采用临时文件 重命名的原子操作还自动保留最近 10 份备份在~/.cc-switch/backups/配置文件损坏的风险被基本排除。安装 CC Switch三大平台各走一条路安装本身没有门槛按你的系统选一种即可macOS推荐 Homebrew 一条命令装好后续brew upgrade --cask cc-switch就能升级也可以下载官方 .dmg已做代码签名和 Apple 公证双击即装。Windows下载 .msi 安装包或便携版 zipWin10 及以上。Linux提供 .debDebian/Ubuntu、.rpmFedora/RHEL、AppImage 三种格式Ubuntu 22.04 / Debian 11 / Fedora 34 及以上均可。首次启动时它会把你现有 CLI 工具的配置导入为default供应商——这一步很关键意味着你原来的官方登录状态不会丢。一个已知的小坑Linux 上 Wayland NVIDIA 组合如果点击无响应或窗口黑屏用CC_SWITCH_GDK_BACKENDwayland或 x11环境变量启动 AppImage 即可绕过。一键添加供应商预设模板 只填一个 API Key主界面按 Claude / Codex / Gemini 等应用分 Tab每个供应商是一张卡片显示名称、端点地址和余额信息如已使用 157.60 / 剩余 52.40 USD。点击右上角的加号开始添加添加流程分两种选预设界面顶部列出 50 内置预设DeepSeek、GLM、Kimi、MiniMax、PackyCode 等选中后请求地址自动填好你只需粘贴 API Key。自定义配置选自定义配置后填入供应商名称、请求地址、主模型等。这里有个实用设计——请求地址支持配置多个端点并能一键测速测速结果直接显示延迟和状态码例如同一个服务两个端点分别是 297ms 和 2146ms勾选自动选择后切换时自动走最快的那个。切换供应商主界面启用与系统托盘两种姿势供应商加好之后两种切换方式主界面选中卡片点启用配置写入对应工具的文件系统托盘不打开应用直接在托盘菜单里点供应商名称即时生效。托盘菜单按应用分级Claude / Codex / Gemini 各自子菜单标题栏还显示当前供应商和用量摘要。生效方式上有个细节要知道大多数工具需要重启终端或 CLI 才生效唯独 Claude Code 支持热切换改完立刻可用。卡片右侧一排图标分别对应编辑、复制、用量、删除。注意当前使用的供应商删不掉——这是刻意设计的最小侵入原则哪怕你卸载了 CC Switch你的 CLI 工具也必须还能正常工作系统至少要留一份可用配置。想换回官方登录也不麻烦从预设里添加官方登录供应商切换后按工具自己的登录流程走一遍即可Codex 还因此支持多个 Plus / Team 账号来回切。本地代理与故障转移主供应商挂了自动接管基础切换之外CC Switch 的代理模式是把所有 API 请求先经过本地代理再转发默认监听127.0.0.1:15721。主界面顶部的 Proxy 开关一开代理就进入运行状态代理层带来的能力格式转换比如把只支持 Chat 协议的 DeepSeek、Kimi 接入 Codex由代理做协议适配请求日志每次调用的端点、模型、Token 数都落库故障转移队列主供应商请求失败时按队列顺序自动切到备用供应商配合熔断器机制——连续失败超过阈值会熔断该供应商避免反复撞墙恢复后按退避策略试探性放回。配置路径是设置 → 高级 → 故障转移页面按 Claude / Codex / Gemini 分 Tab拖拽调整队列优先级即可。开启自动故障转移开关后失败才真正触发切换不开则只记录不切换适合只想观察的场景。用量看板怎么读Token、成本、趋势一屏看全代理跑起来之后用量数据就开始积累。用量看板按供应商、模型、时间三个维度统计Hero 区展示筛选范围内的总 Token缓存归一化后的真实值和缓存命中率跟随日期/供应商/模型筛选实时刷新趋势图按天查看请求量和花费曲线哪天空闲异常一眼可见请求日志单条请求的端点、模型、状态、Token 明细可逐条查自定义定价内置 models.dev 价格数据也可按模型手动改单价适配各家不同计费。对用多套 Key、多个套餐的团队来说这个月到底烧了多少钱、烧在哪个模型上这个问题不用再去各家后台对账了。进阶能力MCP、提示词、Skills 与会话统一管理CC Switch 管的不只是 API Key还管 AI 工具周边的三样东西模块做什么同步目标MCP一个面板管理所有 MCP 服务器按应用勾选启用支持 Deep Link 导入Claude、Codex、Gemini、Grok Build、OpenCode、HermesPromptsMarkdown 编辑器管理提示词预设激活即写入对应文件支持智能回填防覆盖CLAUDE.md / AGENTS.md / GEMINI.mdSkills从 GitHub 仓库或 ZIP 一键安装技能支持符号链接、批量更新与 SHA-256 变更检测各工具的技能目录另外还有两个容易忽略的实用功能会话管理器可以跨来源浏览、搜索、恢复历史对话云同步支持把配置目录指向 Dropbox、OneDrive、iCloud 或自建 WebDAV 服务器实现多设备配置一致。ccswitch://深度链接协议则允许你通过 URL 直接把供应商配置、MCP、提示词、技能导入进来方便在团队内分享配置。常见问题排坑清单切换后没生效重启终端或对应 CLIClaude Code 除外它支持热切换。插件配置消失了进编辑供应商 → 共享配置面板 → 从当前供应商提取把公共配置存成片段新建供应商时勾选写入共享配置即可带入。环境变量冲突如果工具读取的环境变量与配置文件打架设置里有冲突检测与处理入口按提示清理即可。数据存哪了数据库~/.cc-switch/cc-switch.db、设备级设置~/.cc-switch/settings.json、备份~/.cc-switch/backups/、技能~/.cc-switch/skills/。源码贡献前端在src/React TS Tailwind后端在src-tauri/src/命令层、服务层、SQLite DAO 分层清晰代理模块在src-tauri/src/proxy/需要本地构建可以git clone https://gitcode.com/GitHub_Trending/cc/cc-switch后用pnpm dev起开发模式需 Node.js 18、pnpm 8、Rust 1.85。适合谁用如果你的工作流里同时跑着 Claude Code、Codex 和 Gemini CLI 中的任意两个以上或者你在多家 API 供应商之间来回倒腾CC Switch 能把改配置文件这件事从日常里彻底删掉预设一键导入、托盘秒切、代理兜底、花费可见。对个人开发者它省下的是每次切换的十分钟和手改配置的心碎对团队它提供的是配置模板化分发、统一用量口径和多设备同步。MIT 协议开源三大平台通吃装一次就回不去了。【免费下载链接】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），仅供参考