官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

为什么选择 CC Switch？

Claude Code、Codex、Gemini CLI 等 AI 编程工具各有各的配置格式。换一个 API 供应商，就得手动改 JSON、TOML、YAML 或 .env 文件；MCP、Skills 和提示词也要在每个工具里分别维护。

CC Switch 把这些工作集中到一个桌面应用里：选一个预设、填入 Key，一键即可切换，原有配置不会丢失。

• 一个应用，十个工具 — Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code
• 告别手动编辑 — 90+ 供应商预设，包括 AWS Bedrock、NVIDIA NIM 和社区中转服务
• 在 Claude Code 里用 GPT，在 Codex 里用 Claude — 内置本地路由，自动转换 Anthropic、OpenAI、Gemini 的接口格式，并支持自动故障转移
• MCP、Skills 与提示词集中管理 — MCP 和 Skills 添加一次，按工具勾选同步；提示词按工具分别维护
• 用量与额度一目了然 — 不开本地路由也能统计 Token 用量和花费，供应商卡片和托盘上直接显示订阅额度与余额
• 跨平台 — 基于 Tauri 2 构建的原生桌面应用，支持 Windows、macOS 和 Linux

界面预览

下载安装

系统要求

• Windows：Windows 10 及以上
• macOS：macOS 12 (Monterey) 及以上
• Linux：x86_64 或 ARM64，需要 glibc 2.35+ 和 WebKitGTK 4.1，例如 Ubuntu 22.04+、Debian 12+ 及较新的 Fedora；RHEL / Rocky / Alma 8–9 暂不支持

Windows 用户

从 Releases 页面下载最新版本的 CC-Switch-v{版本号}-Windows.msi 安装包或 CC-Switch-v{版本号}-Windows-Portable.zip 绿色版。ARM 版 Windows 请下载 CC-Switch-v{版本号}-Windows-arm64.msi 或 CC-Switch-v{版本号}-Windows-arm64-Portable.zip。

macOS 用户

方式一：通过 Homebrew 安装（推荐）

brew install --cask cc-switch

更新：

brew upgrade --cask cc-switch

方式二：手动下载

从 Releases 页面下载 CC-Switch-v{版本号}-macOS.dmg（推荐）或 .zip。这是 Universal 通用包，Apple Silicon 和 Intel Mac 均可原生运行。

注意：CC Switch macOS 版本已通过 Apple 代码签名和公证，可直接安装打开。

Arch Linux 用户

通过 paru 安装（推荐）

paru -S cc-switch-bin

Linux 用户

从 Releases 页面下载最新版本的 Linux 安装包：

• CC-Switch-v{版本号}-Linux-x86_64.deb / -Linux-arm64.deb（Debian/Ubuntu）
• CC-Switch-v{版本号}-Linux-x86_64.rpm / -Linux-arm64.rpm（Fedora 等提供 WebKitGTK 4.1 的 RPM 发行版）
• CC-Switch-v{版本号}-Linux-x86_64.AppImage / -Linux-arm64.AppImage（满足上述系统要求的发行版）

Flatpak：官方 Release 不包含 Flatpak 包。如需使用，可从 .deb 自行构建 — 参见 flatpak/README.md。

快速开始

基本使用

1. 添加供应商：点击工具栏的“添加新供应商”（+ 按钮）→ 选择预设或创建自定义配置
2. 切换供应商：
   • 主界面：选择供应商 → 点击“启用”（OpenCode、OpenClaw、Hermes、MiniMax Code 的按钮为“添加”；这四个工具和 Pi 是共存式工具，可以同时添加多个供应商）
   • 系统托盘：直接点击供应商名称（支持 Claude Code、Codex、Gemini CLI、Grok Build）
3. 生效方式：Claude Code 无需重启；Codex、Gemini CLI、Grok Build 需重启终端或对应的 CLI 工具；Claude Desktop 需重启应用本身（详见常见问题）
4. 恢复官方登录：切换到列表中自带的官方供应商（如“Claude Official”），重启工具后按照其登录/OAuth 流程操作
5. 本地路由（可选）：想在 Claude Code 里使用 OpenAI 或 Gemini 格式的供应商，或在 Codex 里使用 Claude，需要开启本地路由。做法是在「设置 → 路由 → 本地路由」里打开“路由总开关”，再在“路由启用”里打开对应的工具。想在主页顶部直接开关，可以打开“在主页面显示本地路由开关”

MCP、提示词、Skills、项目与会话

• MCP：点击“MCP 管理”按钮 → 通过模板或自定义配置添加服务器（或“导入已有”）→ 切换各工具的同步开关
• 提示词：点击“提示词” → 使用 Markdown 编辑器创建提示词 → 启用后写入该工具的提示词文件
• Skills：点击“Skills” →“发现技能” → 搜索 skills.sh 或浏览 GitHub 仓库 → 一键安装到支持的工具
• 项目：在 Claude Code、Claude Desktop 或 Codex 页面，打开主页顶部的项目切换器 →“新建项目”，把当前配置保存下来，之后从切换器里选择即可整套切换
• 会话：点击“会话管理” → 浏览、搜索和恢复各工具的会话历史

注意：首次启动时，CC Switch 会自动把 Claude Code、Codex、Gemini CLI、Grok Build 的现有配置导入为名为 default 的供应商，并为这几个工具和 Claude Desktop 添加官方供应商，原有配置不会丢失。

各项功能的详细用法请查阅 用户手册，涵盖供应商管理、MCP/提示词/Skills、本地路由与故障转移等全部功能。

功能特性

完整更新日志 | 发布说明

各工具支持的功能

• 切换：同一时间只启用一个供应商；共存：多个供应商同时写入工具自身的配置，在工具里选择使用。
• 本地路由：由 CC Switch 在本机转发请求并转换接口格式，见下方本地路由与故障转移。Claude Desktop 的供应商可选“直连”或“模型映射”，选“模型映射”时经本地路由转发。
• 会话：浏览、搜索会话历史，复制恢复命令继续对话（OpenClaw、Hermes 的会话暂不支持恢复）。Hermes 的会话需要在会话管理里选择“全部”查看。
• 用量统计：不开本地路由时，从各工具的本地会话记录统计；经本地路由的请求也会计入。
• 在 Claude Desktop 页面打开的 MCP、Skills、提示词和会话面板，作用于 Claude Code。

供应商管理

• 90+ 供应商预设 — 选择预设、填入 Key 即可添加，也可以创建自定义配置
• 只改关键字段 — 切换时只替换请求地址、Key、模型等连接信息，插件、Hook、MCP、你自己加的设置和注释都原样保留
• 项目 — 把 Claude Code 或 Codex 当前的供应商、MCP、Skills 和提示词文件保存为一个项目（Claude Desktop 只保存供应商），之后在主页顶部的项目切换器或托盘里一键整套切换；切到其他项目时，当前状态会自动存回原项目
• OAuth 认证中心（Beta） — 在「设置 → 认证」里登录多个 GitHub Copilot、ChatGPT、xAI（Grok）账号，把订阅当作供应商用在 Claude Code、Claude Desktop 和 Codex 中（除 Codex 的 OpenAI Official 外，都需要开启本地路由）。在官方客户端以外使用订阅可能违反厂商的服务条款，请自行评估风险
• Claude Desktop 接入第三方 — 可以直连 Anthropic 兼容端点；非 Claude 模型选“模型映射”，经本地路由把 Sonnet、Opus、Haiku 等档位映射到供应商的实际模型
• 通用供应商 — 一份配置同步到 Claude Code、Codex 和 Gemini CLI
• 一键切换、系统托盘快速切换（Claude Code、Codex、Gemini CLI、Grok Build）、拖拽排序、导入导出

本地路由与故障转移

• 接口格式转换 — 本地路由在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 和 Gemini Native 之间转换请求格式：Claude Code 和 Claude Desktop 可以使用 OpenAI 或 Gemini 格式的供应商，Codex 和 Grok Build 可以使用 Chat Completions 或 Anthropic Messages 格式的供应商
• 按工具开启 — Claude Code、Codex、Gemini CLI、Grok Build 可以分别开启本地路由；开启后，切换供应商会立即作用于后续请求（如果切换改变了模型，Codex、Gemini CLI 和 Grok Build 仍可能需要重启）
• 自动故障转移 — 为每个工具配置故障转移队列，请求失败时按队列顺序自动改用下一个供应商，配合熔断器和供应商健康监控
• 整流器 — 自动修正部分上游不兼容的请求（如 Thinking 签名、不支持图片时降级）
• 官方供应商（如 Claude Official）不能走本地路由（Codex 的 OpenAI Official 除外）
• 使用攻略：在 Claude Code 中使用 GPT · 在 Codex 中使用 Claude

MCP、提示词与 Skills

• 统一 MCP 面板 — 一处管理所有 MCP 服务器，按工具勾选同步，支持从各工具导入现有配置，支持 Deep Link 导入
• 提示词 — 按工具分别管理的提示词库，使用 Markdown 编辑器；启用后写入该工具的提示词文件（CLAUDE.md / AGENTS.md / GEMINI.md），启用前会先把文件里原有的内容存回提示词库，不会丢失。Pi 还可以编辑 SYSTEM.md、APPEND_SYSTEM.md 和提示词模板
• Skills — 搜索 skills.sh，或从 GitHub 仓库、ZIP 文件一键安装；检查更新并一键全部更新；通过软链接或文件复制同步到各工具，存储位置可选 ~/.agents/skills
• 三个面板都支持搜索，MCP 和 Skills 还可以按工具一键全部启用或停用

用量与成本追踪

• 用量仪表盘 — 不开本地路由也能统计：默认自动扫描各工具的本地会话记录，按供应商和模型统计请求数、Token、缓存命中率和花费，提供趋势图和逐条请求日志
• 额度与余额 — 供应商卡片和托盘上直接显示官方订阅额度（Claude、ChatGPT、Gemini、SuperGrok）、Coding Plan 的 5 小时 / 周 / 月额度（Kimi、智谱 GLM、MiniMax、火山方舟等）和账户余额（DeepSeek、OpenRouter、硅基流动等），部分需要先在供应商卡片的“配置用量查询”里开启；其他供应商可以写自定义用量脚本
• 自定义定价 — 按模型设置单价，可以从 models.dev 导入

会话管理器与工作区

• 会话管理器 — 浏览、搜索各工具的会话历史，复制恢复命令继续对话；macOS 上可以一键在终端中恢复
• 工作区编辑器（OpenClaw）— 编辑 Agent 文件（AGENTS.md、SOUL.md 等）和每日记忆
• 记忆管理（Hermes）— 编辑 Hermes 的 MEMORY.md 和 USER.md

系统与平台

• 云同步 — 通过 WebDAV（坚果云、Nextcloud、群晖 NAS 等）或 S3 兼容存储（AWS S3、Cloudflare R2、阿里云 OSS、腾讯云 COS 等）在多台设备之间同步；也可以把 CC Switch 配置目录放到 Dropbox、OneDrive、iCloud 等网盘文件夹中
• CLI 工具管理 — 在「关于」页查看 Claude Code、Codex 等命令行工具的当前版本和最新版本，一键安装、升级或全部升级，并诊断重复安装；Windows 上还能管理 WSL 里的工具（见常见问题）
• Deep Link（ccswitch://）— 通过链接一键导入供应商、MCP 服务器和提示词，或添加技能仓库
• 小工具 — 跳过 Claude Code 初次安装确认、隐藏 AI 署名、让 VS Code 的 Claude Code 插件随本软件切换供应商等
• 深色 / 浅色 / 跟随系统主题、开机自启、自动更新、原子写入、自动备份、国际化（简中/繁中/英/日）

常见问题

CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage

更多问题请查看用户手册中的常见问题。

贡献

欢迎提交 Issue 反馈问题和建议！新功能开发前，请先开 Issue 讨论实现方案，不适合项目的功能性 PR 有可能会被关闭。

开发环境、提交前检查和架构说明见 CONTRIBUTING.md；使用问题请先看 SUPPORT.md；安全漏洞请按 SECURITY.md 私下报告。

技术栈：Tauri 2 · Rust · React 18 · TypeScript · SQLite

Star History

License

MIT © Jason Young