CC Switch 入门统一管理 Claude Code、Codex、Gemini CLI 等多 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-switchCC Switch 是一款专为使用 AI 编程工具的开发者设计的跨平台桌面应用核心目标是把 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等工具各自独立的配置文件统一到同一界面下管理。读完本文你将了解它解决了哪些多供应商开发痛点、覆盖哪些应用与平台以及它在供应商管理、MCP/Prompts/Skills 扩展和本地代理高可用三方面的能力边界并看到这些能力在源码中的对应实现。定位一个入口管理所有 AI 编程工具的供应商配置CC Switch 是一款跨平台桌面应用。它的定位不是 AI 编程工具本身而是这些工具背后的配置中枢当你同时使用多个 AI 编程助手、且在不同 API 供应商官方直连或中转服务之间切换时它把原本散落各处、格式各异的手动改配置过程收敛为一次点击。从源码结构看受管应用清单定义在后端的AppType枚举中见 app_config.rs当前版本v3.20.0共包含 9 种客户端类型Claude、ClaudeDesktop、Codex、Gemini、GrokBuild、OpenCode、OpenClaw、Hermes和Pi。相比用户文档中的 7 项列表源码中还能看到对 Grok Build 与 Pi 客户端的支持这也是项目描述中提到的 Grok Build Hermes Agent 的落点。它解决的四类痛点在多 AI 工具并用的日常开发中典型痛点有四类CC Switch 分别给出了对应方案痛点具体表现CC Switch 的应对多供应商切换麻烦换一家 API 供应商官方或中转服务商就要手动改配置文件供应商列表 一键切换支持预设模板快速添加常用供应商配置分散难管理各工具有独立配置文件路径与格式各不相同JSON、TOML 等统一界面读写各应用的原生配置文件跨应用共享供应商配置无法监控用量不知道 API 调用了多少次、花了多少钱本地代理记录请求日志做 Token 用量追踪与成本估算服务不稳定单一供应商故障导致整个工作流中断自动故障转移Failover 熔断器机制其中配置分散这一点在 config.rs 中有清晰的代码印证Claude Code 的主配置位于~/.claude/settings.json并兼容旧命名claude.jsonMCP 配置位于~/.claude.json而 CC Switch 自身的数据目录为~/.cc-switch。应用同时支持通过设置覆盖上述路径以便多 Profile 场景下管理不同配置目录。支持的应用及其写入模式官方文档1.1-introduction.md列出的受管应用如下应用说明Claude CodeAnthropic 官方的 AI 编程助手Claude DesktopClaude 桌面应用支持官方登录与第三方 3P profileCodexOpenAI 的代码生成工具Gemini CLIGoogle 的 AI 命令行工具OpenCode开源 AI 编程终端工具OpenClaw开源 AI 助手多供应商网关HermesHermes Agent支持供应商、MCP、Skills 和 Memory 管理值得注意的是从源码结构看不同应用的供应商切换语义并不相同。AppType上定义了两个关键方法见 app_config.rsSwitch 模式覆盖式Claude、Codex、Gemini、GrokBuild。切换供应商时只有当前激活供应商的凭据被写入该工具的原生配置文件配置文件中始终只保留当前在用的一份供应商信息。Additive 模式共存式OpenCode、OpenClaw、Hermes、Pi。多个供应商同时写入该工具的本地原生配置is_additive_mode()返回 true各自可以独立启用/禁用互不覆盖。此外supports_local_proxy()表明本地代理服务目前面向Claude、Codex、Gemini、GrokBuild四类客户端生效其余客户端的供应商配置则直接写入各自的原生配置文件。理解这一区分有助于判断某项功能如代理日志、故障转移对你所用的具体工具是否可用。核心功能一供应商管理供应商管理是 CC Switch 的主体能力包含六个要点一键切换多个 API 供应商配置每个应用维护一份供应商列表切换时由 Rust 后端读取供应商数据并原子性地改写目标工具的原生配置文件预设模板内置多家常见供应商的预设如 claudeProviderPresets.ts、codexProviderPresets.ts、geminiProviderPresets.ts 等配置文件填好 API Key 即可快速添加无需手写完整配置统一供应商、跨应用共享同一供应商的凭据信息可在不同受管应用间复用Claude Desktop 专项支持支持第三方供应商接入、直连模式与模型映射前端对应实现见 claudeDesktopProviderPresets.ts 及相关表单组件用量查询与余额显示读取供应商侧用量/余额接口并在卡片上展示端点速度测试对供应商端点做连通性与速度探测辅助选择最优端点。供应商配置写入的可靠性值得单独一提。后端对配置文件的写入采用先写临时文件、再原子替换的策略见 config.rs 中的 atomic_write写入过程中目标文件始终处于完整状态避免写一半崩溃导致配置文件损坏在 Windows 上会优先使用ReplaceFileW并带重试回退包含对 WSL UNC 路径的专门处理。同时JSON 输出前会递归按键名字母序排序sort_json_keys保证同一份逻辑配置无论编辑顺序如何落盘字节一致便于 diff 与版本对比。相关测试用例如atomic_write_replaces_existing_file位于同一文件内可验证替换成功且无临时文件残留等契约。核心功能二MCP、Prompts 与 Skills 扩展除供应商外CC Switch 把三类扩展资源也纳入统一管理MCP 服务器管理 Model Context Protocol 服务器配置扩展 AI 工具可访问的外部能力。Claude 的 MCP 配置写入~/.claude.json路径解析逻辑见 config.rs前端提供表单与向导式添加McpFormModal.tsx、McpWizardModal.tsx内置常用 MCP 预设mcpPresets.tsPrompts管理系统提示词预设按客户端分开维护、快速切换不同场景。后端数据结构PromptRoot见 app_config.rs为 claude、claude-desktop、codex、gemini、grokbuild、opencode、openclaw、hermes 各自维护独立的 Prompt 集合互不干扰Skills安装和管理技能扩展支持按仓库管理技能前端入口见 RepoManagerPanel.tsx。核心功能三本地代理与高可用当把 Claude Code、Codex 等工具的流量指向 CC Switch 的本地代理后就获得了日志、统计与高可用能力包括四项本地代理服务与请求日志代理转发请求并记录日志与用量统计。代理核心实现在 src-tauri/src/proxy/ 目录下包含请求转发forwarder.rs、SSE 流处理sse.rs、用量统计usage/子目录等模块自动故障转移主供应商失败时自动切换到备用供应商由failover_switch.rs与provider_router.rs实现路由与切换决策前端通过 FailoverToggle.tsx、AutoFailoverConfigPanel.tsx 配置开关与策略熔断器机制防止频繁重试已失败的供应商。实现见 circuit_breaker.rs采用经典的三态模型Closed关闭正常工作Open打开熔断激活拒绝向该供应商发请求HalfOpen半开允许部分探测请求通过成功达到阈值后恢复Closed。从源码的Default实现可以看到默认参数连续失败 4 次failure_threshold打开熔断打开后 60 秒timeout_seconds进入半开试探半开状态下连续成功 2 次success_threshold恢复关闭错误率超过 60%error_rate_threshold且总请求数达到 10 次min_requests时也会触发熔断。该模块还支持配置热更新update_config不重置统计状态Token 用量追踪与成本估算逐请求统计 Token 消耗并做成本估算前端用量看板UsageDashboard.tsx展示趋势、按模型/供应商的统计与请求明细。支持的平台官方支持矩阵如下与 README.md 中的系统要求一致Windows10 及以上macOS12 (Monterey) 及以上LinuxUbuntu 22.04 / Debian 11 / Fedora 34x64 / ARM64。从源码的 Cargo.toml 可以看到平台适配的工程细节Linux 依赖webkit2gtk 2.16对应 Tauri 2 的 WebKitGTK 要求、Windows ARM64 下rquickjs启用bindgen特性、macOS 使用objc2系列库做系统集成且 macOS 构建产物经 Apple 代码签名与公证可直接安装。技术架构与数据存储CC Switch 使用现代化的桌面端技术栈构建版本号以当前仓库 package.json 与 Cargo.toml 中的 3.20.0 为准前端React 18 TypeScript 5.3 Tailwind CSS 3.4配合 TanStack Query 管理数据请求、Radix UI 组件库与 shadcn 风格的 UI 层见 src/components/ui/i18next 提供多语言后端Tauri 2依赖tauri 2.8.2 Rust要求 Rust 1.85见 rust-toolchain.toml。代理层使用axum/hyper/reqwestrustls处理 HTTP 转发rquickjs内嵌 JS 引擎用于用量脚本等场景toml/toml_edit处理 Codex 等工具的 TOML 配置数据存储SQLiterusqlite bundled存放供应商、MCP、Prompts 等结构化数据数据库位于~/.cc-switch/cc-switch.db JSON~/.cc-switch/config.json等设备设置数据库表结构与迁移逻辑见 src-tauri/src/database/。这套Web 前端 Rust 系统层的架构带来的结果是三个平台上的界面与交互一致配置读写、代理转发等重活在本地原生进程完成所有数据含 API Key只落在用户本机不经过任何第三方服务端。下一步本文是 用户手册 入门篇的第一篇软件介绍建议按以下顺序继续阅读1.2 安装各平台的具体下载与安装方式1.3 界面介绍主界面各区域的功能说明1.4 快速上手从添加第一个供应商到完成首次切换1.5 设置应用目录、语言、主题等全局设置。若需要深入某一功能可直接查看对应源码目录代理与高可用见 src-tauri/src/proxy/应用与配置解析见 src-tauri/src/app_config.rs 与 src-tauri/src/config.rs数据库见 src-tauri/src/database/。【免费下载链接】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 等多 AI 工具的跨平台桌面助手
CC Switch 入门统一管理 Claude Code、Codex、Gemini CLI 等多 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-switchCC Switch 是一款专为使用 AI 编程工具的开发者设计的跨平台桌面应用核心目标是把 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等工具各自独立的配置文件统一到同一界面下管理。读完本文你将了解它解决了哪些多供应商开发痛点、覆盖哪些应用与平台以及它在供应商管理、MCP/Prompts/Skills 扩展和本地代理高可用三方面的能力边界并看到这些能力在源码中的对应实现。定位一个入口管理所有 AI 编程工具的供应商配置CC Switch 是一款跨平台桌面应用。它的定位不是 AI 编程工具本身而是这些工具背后的配置中枢当你同时使用多个 AI 编程助手、且在不同 API 供应商官方直连或中转服务之间切换时它把原本散落各处、格式各异的手动改配置过程收敛为一次点击。从源码结构看受管应用清单定义在后端的AppType枚举中见 app_config.rs当前版本v3.20.0共包含 9 种客户端类型Claude、ClaudeDesktop、Codex、Gemini、GrokBuild、OpenCode、OpenClaw、Hermes和Pi。相比用户文档中的 7 项列表源码中还能看到对 Grok Build 与 Pi 客户端的支持这也是项目描述中提到的 Grok Build Hermes Agent 的落点。它解决的四类痛点在多 AI 工具并用的日常开发中典型痛点有四类CC Switch 分别给出了对应方案痛点具体表现CC Switch 的应对多供应商切换麻烦换一家 API 供应商官方或中转服务商就要手动改配置文件供应商列表 一键切换支持预设模板快速添加常用供应商配置分散难管理各工具有独立配置文件路径与格式各不相同JSON、TOML 等统一界面读写各应用的原生配置文件跨应用共享供应商配置无法监控用量不知道 API 调用了多少次、花了多少钱本地代理记录请求日志做 Token 用量追踪与成本估算服务不稳定单一供应商故障导致整个工作流中断自动故障转移Failover 熔断器机制其中配置分散这一点在 config.rs 中有清晰的代码印证Claude Code 的主配置位于~/.claude/settings.json并兼容旧命名claude.jsonMCP 配置位于~/.claude.json而 CC Switch 自身的数据目录为~/.cc-switch。应用同时支持通过设置覆盖上述路径以便多 Profile 场景下管理不同配置目录。支持的应用及其写入模式官方文档1.1-introduction.md列出的受管应用如下应用说明Claude CodeAnthropic 官方的 AI 编程助手Claude DesktopClaude 桌面应用支持官方登录与第三方 3P profileCodexOpenAI 的代码生成工具Gemini CLIGoogle 的 AI 命令行工具OpenCode开源 AI 编程终端工具OpenClaw开源 AI 助手多供应商网关HermesHermes Agent支持供应商、MCP、Skills 和 Memory 管理值得注意的是从源码结构看不同应用的供应商切换语义并不相同。AppType上定义了两个关键方法见 app_config.rsSwitch 模式覆盖式Claude、Codex、Gemini、GrokBuild。切换供应商时只有当前激活供应商的凭据被写入该工具的原生配置文件配置文件中始终只保留当前在用的一份供应商信息。Additive 模式共存式OpenCode、OpenClaw、Hermes、Pi。多个供应商同时写入该工具的本地原生配置is_additive_mode()返回 true各自可以独立启用/禁用互不覆盖。此外supports_local_proxy()表明本地代理服务目前面向Claude、Codex、Gemini、GrokBuild四类客户端生效其余客户端的供应商配置则直接写入各自的原生配置文件。理解这一区分有助于判断某项功能如代理日志、故障转移对你所用的具体工具是否可用。核心功能一供应商管理供应商管理是 CC Switch 的主体能力包含六个要点一键切换多个 API 供应商配置每个应用维护一份供应商列表切换时由 Rust 后端读取供应商数据并原子性地改写目标工具的原生配置文件预设模板内置多家常见供应商的预设如 claudeProviderPresets.ts、codexProviderPresets.ts、geminiProviderPresets.ts 等配置文件填好 API Key 即可快速添加无需手写完整配置统一供应商、跨应用共享同一供应商的凭据信息可在不同受管应用间复用Claude Desktop 专项支持支持第三方供应商接入、直连模式与模型映射前端对应实现见 claudeDesktopProviderPresets.ts 及相关表单组件用量查询与余额显示读取供应商侧用量/余额接口并在卡片上展示端点速度测试对供应商端点做连通性与速度探测辅助选择最优端点。供应商配置写入的可靠性值得单独一提。后端对配置文件的写入采用先写临时文件、再原子替换的策略见 config.rs 中的 atomic_write写入过程中目标文件始终处于完整状态避免写一半崩溃导致配置文件损坏在 Windows 上会优先使用ReplaceFileW并带重试回退包含对 WSL UNC 路径的专门处理。同时JSON 输出前会递归按键名字母序排序sort_json_keys保证同一份逻辑配置无论编辑顺序如何落盘字节一致便于 diff 与版本对比。相关测试用例如atomic_write_replaces_existing_file位于同一文件内可验证替换成功且无临时文件残留等契约。核心功能二MCP、Prompts 与 Skills 扩展除供应商外CC Switch 把三类扩展资源也纳入统一管理MCP 服务器管理 Model Context Protocol 服务器配置扩展 AI 工具可访问的外部能力。Claude 的 MCP 配置写入~/.claude.json路径解析逻辑见 config.rs前端提供表单与向导式添加McpFormModal.tsx、McpWizardModal.tsx内置常用 MCP 预设mcpPresets.tsPrompts管理系统提示词预设按客户端分开维护、快速切换不同场景。后端数据结构PromptRoot见 app_config.rs为 claude、claude-desktop、codex、gemini、grokbuild、opencode、openclaw、hermes 各自维护独立的 Prompt 集合互不干扰Skills安装和管理技能扩展支持按仓库管理技能前端入口见 RepoManagerPanel.tsx。核心功能三本地代理与高可用当把 Claude Code、Codex 等工具的流量指向 CC Switch 的本地代理后就获得了日志、统计与高可用能力包括四项本地代理服务与请求日志代理转发请求并记录日志与用量统计。代理核心实现在 src-tauri/src/proxy/ 目录下包含请求转发forwarder.rs、SSE 流处理sse.rs、用量统计usage/子目录等模块自动故障转移主供应商失败时自动切换到备用供应商由failover_switch.rs与provider_router.rs实现路由与切换决策前端通过 FailoverToggle.tsx、AutoFailoverConfigPanel.tsx 配置开关与策略熔断器机制防止频繁重试已失败的供应商。实现见 circuit_breaker.rs采用经典的三态模型Closed关闭正常工作Open打开熔断激活拒绝向该供应商发请求HalfOpen半开允许部分探测请求通过成功达到阈值后恢复Closed。从源码的Default实现可以看到默认参数连续失败 4 次failure_threshold打开熔断打开后 60 秒timeout_seconds进入半开试探半开状态下连续成功 2 次success_threshold恢复关闭错误率超过 60%error_rate_threshold且总请求数达到 10 次min_requests时也会触发熔断。该模块还支持配置热更新update_config不重置统计状态Token 用量追踪与成本估算逐请求统计 Token 消耗并做成本估算前端用量看板UsageDashboard.tsx展示趋势、按模型/供应商的统计与请求明细。支持的平台官方支持矩阵如下与 README.md 中的系统要求一致Windows10 及以上macOS12 (Monterey) 及以上LinuxUbuntu 22.04 / Debian 11 / Fedora 34x64 / ARM64。从源码的 Cargo.toml 可以看到平台适配的工程细节Linux 依赖webkit2gtk 2.16对应 Tauri 2 的 WebKitGTK 要求、Windows ARM64 下rquickjs启用bindgen特性、macOS 使用objc2系列库做系统集成且 macOS 构建产物经 Apple 代码签名与公证可直接安装。技术架构与数据存储CC Switch 使用现代化的桌面端技术栈构建版本号以当前仓库 package.json 与 Cargo.toml 中的 3.20.0 为准前端React 18 TypeScript 5.3 Tailwind CSS 3.4配合 TanStack Query 管理数据请求、Radix UI 组件库与 shadcn 风格的 UI 层见 src/components/ui/i18next 提供多语言后端Tauri 2依赖tauri 2.8.2 Rust要求 Rust 1.85见 rust-toolchain.toml。代理层使用axum/hyper/reqwestrustls处理 HTTP 转发rquickjs内嵌 JS 引擎用于用量脚本等场景toml/toml_edit处理 Codex 等工具的 TOML 配置数据存储SQLiterusqlite bundled存放供应商、MCP、Prompts 等结构化数据数据库位于~/.cc-switch/cc-switch.db JSON~/.cc-switch/config.json等设备设置数据库表结构与迁移逻辑见 src-tauri/src/database/。这套Web 前端 Rust 系统层的架构带来的结果是三个平台上的界面与交互一致配置读写、代理转发等重活在本地原生进程完成所有数据含 API Key只落在用户本机不经过任何第三方服务端。下一步本文是 用户手册 入门篇的第一篇软件介绍建议按以下顺序继续阅读1.2 安装各平台的具体下载与安装方式1.3 界面介绍主界面各区域的功能说明1.4 快速上手从添加第一个供应商到完成首次切换1.5 设置应用目录、语言、主题等全局设置。若需要深入某一功能可直接查看对应源码目录代理与高可用见 src-tauri/src/proxy/应用与配置解析见 src-tauri/src/app_config.rs 与 src-tauri/src/config.rs数据库见 src-tauri/src/database/。【免费下载链接】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），仅供参考