拓冰网站定制 
CC Switch 使用完整指南一键切换供应商、配置故障转移与备份的 5 步实操【免费下载链接】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 的供应商配置、本地路由、用量统计和数据备份收进同一个界面。本文不照搬功能清单而是按一条真实的使用路线走先让它在你的系统上装得起来再把它和供应商接得通然后学会路由与故障转移让它用得稳接着优化资源和开销最后保证配置数据丢不了。每一节都按遇到什么问题 → 怎么一步步做 → 背后为什么来讲。一、装得上macOS、Windows、Linux 各自的卡点与解法macOS 提示来自身份不明的开发者CC Switch 的 macOS 版已完成 Apple 代码签名与公证绝大多数情况下直接安装即可。若仍被 Gatekeeper 拦截通常是安装包来源过旧或下载不完整关闭弹窗进入系统设置 → 隐私与安全性在页面下方找到对应提示点击仍要打开再从官网下载最新版本安装即可。想彻底移除隔离标记可以在终端执行sudo xattr -dr com.apple.quarantine /Applications/CC\ Switch.app/原理很简单Gatekeeper 靠 quarantine 扩展属性识别从网络下载的应用去掉这个标记后就不再被拦。Windows 点击后毫无反应大概率是缺少 Tauri 依赖的 WebView2 运行时其次是杀毒软件拦截。处理顺序到微软官网下载安装 Evergreen Standalone InstallerWebView2 运行时装完重启一次系统仍打不开就把 CC Switch 加入杀毒白名单再试。企业环境可以把 WebView2 运行时的离线包放进统一分发通过组策略批量部署避免每台机器手动处理。Linux 启动报错或界面点不动AppImage 打不开一般先补执行权限个别沙箱环境下需要加--no-sandboxchmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage --no-sandbox还有一种更隐蔽的坑Wayland 会话 NVIDIA 显卡时主界面内容区点不动、缩放后黑屏。原因是启动钩子默认强制走 XWayland在新环境下反而让网页内容收不到鼠标事件。解决办法是显式指定后端再启动CC_SWITCH_GDK_BACKENDwayland ./CC-Switch-*.AppImage若从桌面图标启动需把该变量写进.desktop的Exec行。反过来在 sway/Hyprland 等平铺合成器下如果点击失效就改成CC_SWITCH_GDK_BACKENDx11。更多边界情况可查 FAQdocs/user-manual/zh/5-faq/5.2-questions.md。二、接得通用预设模板 5 分钟接好第一个供应商添加供应商选预设只填 Key打开主界面点右上角进入添加流程。这里最省心的地方是预设供应商DeepSeek、GLM、Kimi、MiniMax、Qwen Coder 等常见服务都内置了请求地址和协议细节选中后通常只需要填 API Key端点地址已预置好。添加完成回到主界面所有供应商以卡片形式排列当前在用的那个带绿色当前使用标记右侧还能直接看到已用额度和剩余余额。顶部的应用切换器Claude / Codex / Gemini……决定你在给哪个工具配供应商每个工具下的供应商互相独立。供应商卡片的管理逻辑在src/components/providers/目录下预设数据则来自src/config/里的各预设文件。切换后为什么没生效这是新手最常问的一句话。点启用之后CC Switch 已经把目标工具的配置环境变量或配置文件改好了但正在运行的 CLI 还持有旧配置Claude Code关掉终端重开或重启 IDE 插件Codex同样重开终端Gemini CLI托盘里切换即时生效无需重启。一句话原理CC Switch 改的是磁盘上的配置进程要重启才会重新读取。想切回官方登录用了一段时间中转之后想回到官方渠道不用手动清理环境变量选回官方登录预设Claude/Codex 为官方预设Gemini 为 Google 官方点启用重启对应 CLI按正常流程登录即可。Codex 的官方登录保留相关设置可以在 codex-official-auth-preservation 指南 里查到。三、用得稳开启本地路由主力供应商挂了自动切换端口 15721 被占用怎么办路由服务的默认监听地址是127.0.0.1、端口15721范围 1024–65535。启动失败报端口占用时先确认是谁占着再改端口绕开lsof -i :15721 # macOS / Linux netstat -ano | findstr :15721 # Windows改端口在设置 → 路由里完成修改监听端口后点保存重启路由服务即可。哪些供应商需要路由哪些不用不是所有供应商都需要本地路由。直连型供应商自带 Anthropic/OpenAI 兼容端点的中转服务配好 Key 就能用而协议不匹配的供应商必须走路由比如把 DeepSeek 接进 Claude Code、把 Codex 账号接进 Claude Desktop——这类卡片上会标需要路由。路由开启后CC Switch 在本机起一个转发服务负责协议翻译、模型映射和鉴权注入工具本身只需要把请求地址指向这个本地端口。故障转移与熔断主力挂了谁来顶路由面板提供自动故障转移给当前供应商配好优先级排序主请求失败达到熔断阈值后熔断器会暂时摘除该供应商流量自动落到下一位等熔断窗口过去再试探性恢复。阈值、恢复时间这些参数在面板里可视化调整底层实现可以看src-tauri/src/proxy/circuit_breaker.rs和src-tauri/src/proxy/failover_switch.rs。经验值日常开发把失败阈值保持在 3~5 次即可恢复窗口别设太短否则遇到供应商整体故障时会反复试探—失败白白消耗 token。四、跑得快轻量模式省内存用量看板管开销常驻后台内存却降不下来CC Switch 建议开着托盘常驻方便随时切换。v3.13 起新增的轻量模式就是为常驻场景设计的右键托盘图标选轻量模式后主窗口被彻底销毁不是隐藏UI 资源随之释放空闲占用接近零但托盘切换、深链接唤起全部照常可用下次打开主界面时窗口会按需重建。配套建议勾选关闭时最小化到托盘再按需开启开机自启路由服务随应用启动不用每天手动点一次。用量与余额怎么查使用统计页提供完整的用量看板按供应商、模型、日期筛选能看到请求日志、token 消耗趋势和缓存命中率官方订阅类Claude / Codex / Gemini / Copilot自动展示剩余额度第三方中转的余额通过内置模板一键启用。供应商卡片上也会同步显示已使用 / 剩余方便在切换前看一眼钱包。相关统计服务在src-tauri/src/services/usage_stats.rs前端看板在src/components/usage/。两个省资源的小习惯日志级别调到警告以上用不到的应用比如你根本不用 OpenClaw在应用可见性里直接隐藏界面更清爽列表也更轻。五、丢不了自动备份、恢复与 WebDAV 云同步自动备份怎么开所有配置、供应商、路由参数都存在本地 SQLite 数据库里。设置页的备份管理支持手动导出和自动备份可设定备份间隔默认 24 小时与保留份数默认 10 份每次恢复前还会自动打一个安全备份快照恢复操作本身也因此可逆。团队或个人最稳的姿势是自动备份开着 定期把备份文件拷到另一个磁盘或网盘。换电脑、团队共享导入导出与 WebDAV导入导出一键打包全部配置为备份文件新机器导入即可还原也支持通过深链接把单个供应商配置直接导入src/deeplink/目录处理深链接解析与导入确认。WebDAV 同步在 WebDAV 同步设置里填入私有 WebDAV 服务地址配置即可自动同步到企业网盘或自建存储多台电脑之间保持同一份供应商配置。实现位于src-tauri/src/services/webdav_sync/。安全上多提醒一句备份文件里含 API Key 明文同步目标选可信任的私有存储不要把备份提交进代码仓库。下一步按装得上 → 接得通 → 用得稳 → 跑得快 → 丢不了走完一遍你手上已经是一套能自动故障转移、可同步、可恢复的 AI 工具管理环境。接下来可以顺着两条线深入查docs/user-manual/zh/下的用户手册看 Claude Desktop 路由、Codex×DeepSeek 互转等进阶玩法或盯docs/release-notes/的更新日志轻量模式、用量看板这些能力仍在快速迭代。需要源码级定制的话克隆仓库git clone https://gitcode.com/GitHub_Trending/cc/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），仅供参考 CC Switch 使用完整指南：一键切换供应商、配置故障转移与备份的 5 步实操
CC Switch 使用完整指南一键切换供应商、配置故障转移与备份的 5 步实操【免费下载链接】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 的供应商配置、本地路由、用量统计和数据备份收进同一个界面。本文不照搬功能清单而是按一条真实的使用路线走先让它在你的系统上装得起来再把它和供应商接得通然后学会路由与故障转移让它用得稳接着优化资源和开销最后保证配置数据丢不了。每一节都按遇到什么问题 → 怎么一步步做 → 背后为什么来讲。一、装得上macOS、Windows、Linux 各自的卡点与解法macOS 提示来自身份不明的开发者CC Switch 的 macOS 版已完成 Apple 代码签名与公证绝大多数情况下直接安装即可。若仍被 Gatekeeper 拦截通常是安装包来源过旧或下载不完整关闭弹窗进入系统设置 → 隐私与安全性在页面下方找到对应提示点击仍要打开再从官网下载最新版本安装即可。想彻底移除隔离标记可以在终端执行sudo xattr -dr com.apple.quarantine /Applications/CC\ Switch.app/原理很简单Gatekeeper 靠 quarantine 扩展属性识别从网络下载的应用去掉这个标记后就不再被拦。Windows 点击后毫无反应大概率是缺少 Tauri 依赖的 WebView2 运行时其次是杀毒软件拦截。处理顺序到微软官网下载安装 Evergreen Standalone InstallerWebView2 运行时装完重启一次系统仍打不开就把 CC Switch 加入杀毒白名单再试。企业环境可以把 WebView2 运行时的离线包放进统一分发通过组策略批量部署避免每台机器手动处理。Linux 启动报错或界面点不动AppImage 打不开一般先补执行权限个别沙箱环境下需要加--no-sandboxchmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage --no-sandbox还有一种更隐蔽的坑Wayland 会话 NVIDIA 显卡时主界面内容区点不动、缩放后黑屏。原因是启动钩子默认强制走 XWayland在新环境下反而让网页内容收不到鼠标事件。解决办法是显式指定后端再启动CC_SWITCH_GDK_BACKENDwayland ./CC-Switch-*.AppImage若从桌面图标启动需把该变量写进.desktop的Exec行。反过来在 sway/Hyprland 等平铺合成器下如果点击失效就改成CC_SWITCH_GDK_BACKENDx11。更多边界情况可查 FAQdocs/user-manual/zh/5-faq/5.2-questions.md。二、接得通用预设模板 5 分钟接好第一个供应商添加供应商选预设只填 Key打开主界面点右上角进入添加流程。这里最省心的地方是预设供应商DeepSeek、GLM、Kimi、MiniMax、Qwen Coder 等常见服务都内置了请求地址和协议细节选中后通常只需要填 API Key端点地址已预置好。添加完成回到主界面所有供应商以卡片形式排列当前在用的那个带绿色当前使用标记右侧还能直接看到已用额度和剩余余额。顶部的应用切换器Claude / Codex / Gemini……决定你在给哪个工具配供应商每个工具下的供应商互相独立。供应商卡片的管理逻辑在src/components/providers/目录下预设数据则来自src/config/里的各预设文件。切换后为什么没生效这是新手最常问的一句话。点启用之后CC Switch 已经把目标工具的配置环境变量或配置文件改好了但正在运行的 CLI 还持有旧配置Claude Code关掉终端重开或重启 IDE 插件Codex同样重开终端Gemini CLI托盘里切换即时生效无需重启。一句话原理CC Switch 改的是磁盘上的配置进程要重启才会重新读取。想切回官方登录用了一段时间中转之后想回到官方渠道不用手动清理环境变量选回官方登录预设Claude/Codex 为官方预设Gemini 为 Google 官方点启用重启对应 CLI按正常流程登录即可。Codex 的官方登录保留相关设置可以在 codex-official-auth-preservation 指南 里查到。三、用得稳开启本地路由主力供应商挂了自动切换端口 15721 被占用怎么办路由服务的默认监听地址是127.0.0.1、端口15721范围 1024–65535。启动失败报端口占用时先确认是谁占着再改端口绕开lsof -i :15721 # macOS / Linux netstat -ano | findstr :15721 # Windows改端口在设置 → 路由里完成修改监听端口后点保存重启路由服务即可。哪些供应商需要路由哪些不用不是所有供应商都需要本地路由。直连型供应商自带 Anthropic/OpenAI 兼容端点的中转服务配好 Key 就能用而协议不匹配的供应商必须走路由比如把 DeepSeek 接进 Claude Code、把 Codex 账号接进 Claude Desktop——这类卡片上会标需要路由。路由开启后CC Switch 在本机起一个转发服务负责协议翻译、模型映射和鉴权注入工具本身只需要把请求地址指向这个本地端口。故障转移与熔断主力挂了谁来顶路由面板提供自动故障转移给当前供应商配好优先级排序主请求失败达到熔断阈值后熔断器会暂时摘除该供应商流量自动落到下一位等熔断窗口过去再试探性恢复。阈值、恢复时间这些参数在面板里可视化调整底层实现可以看src-tauri/src/proxy/circuit_breaker.rs和src-tauri/src/proxy/failover_switch.rs。经验值日常开发把失败阈值保持在 3~5 次即可恢复窗口别设太短否则遇到供应商整体故障时会反复试探—失败白白消耗 token。四、跑得快轻量模式省内存用量看板管开销常驻后台内存却降不下来CC Switch 建议开着托盘常驻方便随时切换。v3.13 起新增的轻量模式就是为常驻场景设计的右键托盘图标选轻量模式后主窗口被彻底销毁不是隐藏UI 资源随之释放空闲占用接近零但托盘切换、深链接唤起全部照常可用下次打开主界面时窗口会按需重建。配套建议勾选关闭时最小化到托盘再按需开启开机自启路由服务随应用启动不用每天手动点一次。用量与余额怎么查使用统计页提供完整的用量看板按供应商、模型、日期筛选能看到请求日志、token 消耗趋势和缓存命中率官方订阅类Claude / Codex / Gemini / Copilot自动展示剩余额度第三方中转的余额通过内置模板一键启用。供应商卡片上也会同步显示已使用 / 剩余方便在切换前看一眼钱包。相关统计服务在src-tauri/src/services/usage_stats.rs前端看板在src/components/usage/。两个省资源的小习惯日志级别调到警告以上用不到的应用比如你根本不用 OpenClaw在应用可见性里直接隐藏界面更清爽列表也更轻。五、丢不了自动备份、恢复与 WebDAV 云同步自动备份怎么开所有配置、供应商、路由参数都存在本地 SQLite 数据库里。设置页的备份管理支持手动导出和自动备份可设定备份间隔默认 24 小时与保留份数默认 10 份每次恢复前还会自动打一个安全备份快照恢复操作本身也因此可逆。团队或个人最稳的姿势是自动备份开着 定期把备份文件拷到另一个磁盘或网盘。换电脑、团队共享导入导出与 WebDAV导入导出一键打包全部配置为备份文件新机器导入即可还原也支持通过深链接把单个供应商配置直接导入src/deeplink/目录处理深链接解析与导入确认。WebDAV 同步在 WebDAV 同步设置里填入私有 WebDAV 服务地址配置即可自动同步到企业网盘或自建存储多台电脑之间保持同一份供应商配置。实现位于src-tauri/src/services/webdav_sync/。安全上多提醒一句备份文件里含 API Key 明文同步目标选可信任的私有存储不要把备份提交进代码仓库。下一步按装得上 → 接得通 → 用得稳 → 跑得快 → 丢不了走完一遍你手上已经是一套能自动故障转移、可同步、可恢复的 AI 工具管理环境。接下来可以顺着两条线深入查docs/user-manual/zh/下的用户手册看 Claude Desktop 路由、Codex×DeepSeek 互转等进阶玩法或盯docs/release-notes/的更新日志轻量模式、用量看板这些能力仍在快速迭代。需要源码级定制的话克隆仓库git clone https://gitcode.com/GitHub_Trending/cc/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），仅供参考