farion1231/cc-switch

CC Switch 是一个跨平台桌面管理器，面向 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code 和 Oh My Pi。它替用户免去切换 API 供应商时手动修改各工具 JSON/TOML/YAML 配置的麻烦，并把 MCP 服务器、技能和提示词收拢到一处管理 CC Switch README。

工作方式的变化

无需再逐个工具编辑配置文件：从 90 多个预设或自定义配置中添加供应商，然后一键启用。切换时只重写连接字段——端点、密钥、模型、API 协议，以及 Codex 推理强度、Gemini 认证方式等供应商专属项；插件、hooks、权限、MCP 条目、用户自行添加的环境变量和注释都保留。每个配置文件首次被改写前会备份到 ~/.cc-switch/backups/live-first-write/ README FAQ。此外还有 Apps 页面用于安装、升级和排查 CLI 工具，会话阅读视图会把每轮工作汇总成一行并标红失败步骤，用量和额度即使不走本地路由也能从各工具的本地会话日志汇总。

三种连接方式

直连把供应商真实地址写进工具配置。路由让工具指向本机服务，在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 和 Gemini Native 之间转换格式，并可选按供应商队列自动故障转移——因此在 Claude Code 里可用 OpenAI 或 Gemini 格式的供应商，在 Codex 里可用 Claude 格式；官方供应商（Codex 的 OpenAI Official 除外）不能走路由 README。聚合模式面向 Claude Code 和 Codex，把多个供应商的模型放进客户端模型列表，请求按所选模型发往对应供应商，但不提供故障转移 聚合模式手册。

前提与限制

CC Switch 只提供图形界面桌面版。支持 Windows 10+、macOS 12+，或满足 glibc 2.35+ 与 WebKitGTK 4.1 的 Linux；RHEL/Rocky/Alma 8–9 暂不支持 安装说明。服务器和 SSH 场景可用社区维护的 CC Switch CLI，但它支持的数据库版本有时落后于桌面版 README FAQ。

生效时机因工具而异：Claude Code 无需重启；Codex、Gemini CLI、Grok Build 需重启终端或工具；Claude Desktop 必须完全退出后重新打开，使用 Model Mapping 时还需保持 CC Switch 运行。Codex 在聚合模式下需要重启其共享后台进程，这会中断正在运行的任务。路由地址为 127.0.0.1，WSL2 默认 NAT 网络无法访问，需改为镜像网络。路由/聚合模式下配置文件里是本机地址和占位密钥 PROXY_MANAGED；退出 CC Switch 时会先写回直连配置。

内置的账号功能可登录 GitHub Copilot、ChatGPT、xAI 账户并把订阅当作供应商使用，README 提醒在官方客户端之外使用订阅可能违反供应商条款，需自行评估风险。数据存于 ~/.cc-switch（SQLite 数据库、备份、OAuth 凭据文件），可选 WebDAV/S3 同步，但设备级文件不参与同步。项目采用 MIT 许可证 仓库。