CC Switch 快速上手指南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 CLICC Switch 是一个跨平台桌面应用能把这 8 个 AI 编程工具的供应商配置、API Key、MCP 和技能统一管理起来点击一次就完成切换。适合经常需要在多个模型供应商之间切换的开发者以及想要用量统计和故障转移的团队。首次启动安装 CC Switch 并确认环境三个平台的安装都很直接没有构建步骤macOS终端执行 Homebrew 安装后续升级用brew upgrade --cask cc-switchbrew install --cask cc-switchWindows下载.msi安装包或绿色版 zip。如果双击没反应右键文件 → 属性 → 常规 → 勾选解除锁定再打开。LinuxDebian/Ubuntu 装.debFedora 装.rpmArch 用paru -S cc-switch-bin。启动后确认两件事主窗口能正常显示供应商列表系统托盘里出现了 CC Switch 图标。应用基于 Tauri 2 构建系统要求是 Windows 10、macOS 12 或主流 Linux 发行版macOS 版已通过 Apple 签名公证不会出现身份不明开发者的拦截。 一个 Linux 专属坑Wayland NVIDIA 显卡下用 AppImage 启动时可能出现内容区点不动、缩放后黑屏。原因是 AppImage 默认强制走 XWayland用环境变量切回原生 Wayland 即可CC_SWITCH_GDK_BACKENDwayland ./CC-Switch-*.AppImage接入第一个供应商50 预设一键导入传统做法是手改settings.json、auth.json、.env三种格式的文件CC Switch 把这一步变成了选菜单。添加流程只有四步点主界面右上角的按钮在预设下拉框里选供应商——内置 50 预设智谱 GLM、DeepSeek、Kimi、AWS Bedrock、各种中转站端点地址自动填好只填 API Key点添加供应商卡片出现在列表中预设列表里没有你的供应商选自定义手动填端点和 Key。想要官方账号登录流程直接添加官方登录预设重启 CLI 后走一遍 OAuth 即可之后官方和第三方供应商之间可以随时来回切。只想跑通的话做这 2 步选一个预设、填 Key、点添加然后回主界面点启用。剩下的功能后面慢慢用。日常切换主界面与系统托盘两种用法切换有两条路按场景选方式操作适合场景主界面点供应商卡片的启用按钮首次切换、需要确认配置细节系统托盘右键托盘图标 → 应用子菜单 → 点供应商名高频切换不用打开窗口v3.13 起托盘菜单按 Claude / Codex / Gemini 分了子菜单标题直接显示当前供应商和用量摘要供应商再多也不会溢出屏幕。关键是生效时机各工具不一样这是新手最容易踩的坑工具生效方式Claude Code即时生效热重载不用重启Gemini CLI即时生效每次请求重读.envCodex / OpenCode / OpenClaw必须关闭终端窗口重开切完没反应90% 是忘了重启终端——配置文件早就写好了只是运行中的进程没重新加载。开启本地代理故障转移与熔断器配置想让主供应商挂了自动切备用或者统计每个供应商花了多少钱就开本地代理。点主界面顶部的代理开关绿色即运行中或在设置 → 高级 → 代理服务里开默认监听127.0.0.1:15721只改端口前必须先停代理在设置 → 高级 → 故障转移里按 Claude / Codex / Gemini 分 Tab把备用供应商拖进队列并排序序号越小优先级越高打开自动故障转移开关熔断器防止反复重试一个已经挂掉的供应商参数在同一个页面调整。默认值连续失败 4 次Claude 是 8 次因为它请求本来就慢触发熔断60 秒后发试探请求成功 2 次后恢复。队列里的供应商带健康徽章绿健康、黄降级、红已熔断被跳过。避坑故障转移没触发时按顺序检查四件事——代理在跑吗应用接管开了吗自动故障转移开关开了吗队列里有备用供应商吗四样缺一不可。常见问题自查切换失败、配置丢失、托盘残留按现象 → 原因 → 处理对号入座切换时提示失败。通常是配置文件被别的程序占用锁定关掉正在运行的 CLI 工具再切一次即可少数情况是目录权限不足检查配置目录的写权限。切完供应商插件等配置不见了。没丢——CC Switch 用通用配置片段机制Key 之外的公共数据不随供应商走。进编辑供应商的通用配置面板点从当前供应商提取把插件等数据存进通用配置之后新建供应商默认勾选应用通用配置就会自动带入。总有一个激活中的供应商删不掉。这是刻意设计的最小侵入性原则删光所有配置对应 CLI 工具就没法正常工作了所以系统始终保留一份激活配置。不常用的应用可以在设置里关掉它的显示。问所有供应商都熔断了就等着不用干等熔断时长一到自动试探恢复急用可以手动重启代理服务重置熔断状态。数据安全数据在哪、怎么备份、怎么多设备同步所有数据都放在你自己机器上核心就一个 SQLite 数据库~/.cc-switch/cc-switch.db供应商、MCP、提示词、技能~/.cc-switch/settings.json设备级界面偏好~/.cc-switch/backups/自动备份轮换保留最近 10 份写入用的是临时文件 重命名的原子操作应用中途崩溃也不会把配置写坏一半。想跨设备同步两条路把配置目录指到 Dropbox / OneDrive / iCloud / WebDAV 文件夹实现文件级同步或在设置里配置 WebDAV 服务器让应用自己同步。效率技巧给重要供应商配上备用 自动故障转移后日常几乎不用操心数据面——备份自动做、配置原子写、切换有留痕出问题先翻backups/目录。CC Switch 的核心价值就是把 8 个工具的供应商切换、MCP、技能、用量统计收进一个窗口省掉手改三种配置文件格式的重复劳动。各功能细节可以查官方用户手册新功能看更新日志随着 Codex 路由、Claude Desktop 直连等能力持续加入这个单一管理入口的覆盖范围还在扩大。【免费下载链接】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 快速上手指南：AI 编程工具供应商切换一次搞定
CC Switch 快速上手指南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 CLICC Switch 是一个跨平台桌面应用能把这 8 个 AI 编程工具的供应商配置、API Key、MCP 和技能统一管理起来点击一次就完成切换。适合经常需要在多个模型供应商之间切换的开发者以及想要用量统计和故障转移的团队。首次启动安装 CC Switch 并确认环境三个平台的安装都很直接没有构建步骤macOS终端执行 Homebrew 安装后续升级用brew upgrade --cask cc-switchbrew install --cask cc-switchWindows下载.msi安装包或绿色版 zip。如果双击没反应右键文件 → 属性 → 常规 → 勾选解除锁定再打开。LinuxDebian/Ubuntu 装.debFedora 装.rpmArch 用paru -S cc-switch-bin。启动后确认两件事主窗口能正常显示供应商列表系统托盘里出现了 CC Switch 图标。应用基于 Tauri 2 构建系统要求是 Windows 10、macOS 12 或主流 Linux 发行版macOS 版已通过 Apple 签名公证不会出现身份不明开发者的拦截。 一个 Linux 专属坑Wayland NVIDIA 显卡下用 AppImage 启动时可能出现内容区点不动、缩放后黑屏。原因是 AppImage 默认强制走 XWayland用环境变量切回原生 Wayland 即可CC_SWITCH_GDK_BACKENDwayland ./CC-Switch-*.AppImage接入第一个供应商50 预设一键导入传统做法是手改settings.json、auth.json、.env三种格式的文件CC Switch 把这一步变成了选菜单。添加流程只有四步点主界面右上角的按钮在预设下拉框里选供应商——内置 50 预设智谱 GLM、DeepSeek、Kimi、AWS Bedrock、各种中转站端点地址自动填好只填 API Key点添加供应商卡片出现在列表中预设列表里没有你的供应商选自定义手动填端点和 Key。想要官方账号登录流程直接添加官方登录预设重启 CLI 后走一遍 OAuth 即可之后官方和第三方供应商之间可以随时来回切。只想跑通的话做这 2 步选一个预设、填 Key、点添加然后回主界面点启用。剩下的功能后面慢慢用。日常切换主界面与系统托盘两种用法切换有两条路按场景选方式操作适合场景主界面点供应商卡片的启用按钮首次切换、需要确认配置细节系统托盘右键托盘图标 → 应用子菜单 → 点供应商名高频切换不用打开窗口v3.13 起托盘菜单按 Claude / Codex / Gemini 分了子菜单标题直接显示当前供应商和用量摘要供应商再多也不会溢出屏幕。关键是生效时机各工具不一样这是新手最容易踩的坑工具生效方式Claude Code即时生效热重载不用重启Gemini CLI即时生效每次请求重读.envCodex / OpenCode / OpenClaw必须关闭终端窗口重开切完没反应90% 是忘了重启终端——配置文件早就写好了只是运行中的进程没重新加载。开启本地代理故障转移与熔断器配置想让主供应商挂了自动切备用或者统计每个供应商花了多少钱就开本地代理。点主界面顶部的代理开关绿色即运行中或在设置 → 高级 → 代理服务里开默认监听127.0.0.1:15721只改端口前必须先停代理在设置 → 高级 → 故障转移里按 Claude / Codex / Gemini 分 Tab把备用供应商拖进队列并排序序号越小优先级越高打开自动故障转移开关熔断器防止反复重试一个已经挂掉的供应商参数在同一个页面调整。默认值连续失败 4 次Claude 是 8 次因为它请求本来就慢触发熔断60 秒后发试探请求成功 2 次后恢复。队列里的供应商带健康徽章绿健康、黄降级、红已熔断被跳过。避坑故障转移没触发时按顺序检查四件事——代理在跑吗应用接管开了吗自动故障转移开关开了吗队列里有备用供应商吗四样缺一不可。常见问题自查切换失败、配置丢失、托盘残留按现象 → 原因 → 处理对号入座切换时提示失败。通常是配置文件被别的程序占用锁定关掉正在运行的 CLI 工具再切一次即可少数情况是目录权限不足检查配置目录的写权限。切完供应商插件等配置不见了。没丢——CC Switch 用通用配置片段机制Key 之外的公共数据不随供应商走。进编辑供应商的通用配置面板点从当前供应商提取把插件等数据存进通用配置之后新建供应商默认勾选应用通用配置就会自动带入。总有一个激活中的供应商删不掉。这是刻意设计的最小侵入性原则删光所有配置对应 CLI 工具就没法正常工作了所以系统始终保留一份激活配置。不常用的应用可以在设置里关掉它的显示。问所有供应商都熔断了就等着不用干等熔断时长一到自动试探恢复急用可以手动重启代理服务重置熔断状态。数据安全数据在哪、怎么备份、怎么多设备同步所有数据都放在你自己机器上核心就一个 SQLite 数据库~/.cc-switch/cc-switch.db供应商、MCP、提示词、技能~/.cc-switch/settings.json设备级界面偏好~/.cc-switch/backups/自动备份轮换保留最近 10 份写入用的是临时文件 重命名的原子操作应用中途崩溃也不会把配置写坏一半。想跨设备同步两条路把配置目录指到 Dropbox / OneDrive / iCloud / WebDAV 文件夹实现文件级同步或在设置里配置 WebDAV 服务器让应用自己同步。效率技巧给重要供应商配上备用 自动故障转移后日常几乎不用操心数据面——备份自动做、配置原子写、切换有留痕出问题先翻backups/目录。CC Switch 的核心价值就是把 8 个工具的供应商切换、MCP、技能、用量统计收进一个窗口省掉手改三种配置文件格式的重复劳动。各功能细节可以查官方用户手册新功能看更新日志随着 Codex 路由、Claude Desktop 直连等能力持续加入这个单一管理入口的覆盖范围还在扩大。【免费下载链接】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），仅供参考