Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Latest commit

 

History

History
History
519 lines (363 loc) · 30.1 KB

File metadata and controls

519 lines (363 loc) · 30.1 KB
Copy raw file
Download raw file
Outline
Edit and raw actions

CC Switch

Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的全方位管理工具

Version Platform Built with Tauri Downloads

farion1231%2Fcc-switch | Trendshift

English | 中文 | 日本語 | 更新日志

❤️赞助商

想出现在这里?

点击折叠

MiniMax

MiniMax M2.7 是 MiniMax 首个深度参与自我迭代的模型,可自主构建复杂 Agent Harness,并基于 Agent Teams、复杂 Skills、Tool Search Tool 等能力完成高复杂度生产力任务;其在软件工程、端到端项目交付及办公场景中表现优异,多项评测接近行业领先水平,同时具备稳定的复杂任务执行、环境交互能力以及良好的情商与身份保持能力。

点击此处享 MiniMax Token Plan 专属 88 折优惠!


PackyCode 感谢 PackyCode 赞助了本项目!PackyCode 是一家稳定、高效的API中转服务商,提供 Claude Code、Codex、Gemini 等多种中转服务。PackyCode 为本软件的用户提供了特别优惠,使用此链接注册并在充值时填写"cc-switch"优惠码,首次充值可以享受9折优惠!
AIGoCode 感谢 AIGoCode 赞助了本项目!AIGoCode 是一个集成了 Claude Code、Codex 以及 Gemini 最新模型的一站式平台,为你提供稳定、高效且高性价比的AI编程服务。本站提供灵活的订阅计划,零封号风险,国内直连,无需魔法,极速响应。AIGoCode 为 CC Switch 的用户提供了特别福利,通过此链接注册的用户首次充值可以获得额外10%奖励额度!
Shengsuanyun 感谢胜算云赞助了本项目!胜算云是专为AI Native Teams服务的超级工厂,工业级AI任务并行执行平台,模型商城集采直供聚合接入了Claude、Chatgpt、Gemini等海内外LLM及图片视频多媒体模型算力,绝无逆向掺水、全站模型SLA可用性高达99.7%、监测接口日常全绿。更有企业级专属定制网关,实现团队精细化成本与权限管控,智能路由+安全防护+BYOK企业自带密钥托管。平台按量及tokens plan(即将上线)计费,可开票,使用此链接注册新用户可获10元模力及首充10%赠送。
AICodeMirror 感谢 AICodeMirror 赞助了本项目!AICodeMirror 提供 Claude Code / Codex / Gemini CLI 官方高稳定中转服务,支持企业级高并发、极速开票、7×24 专属技术支持。 Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折,充值更有折上折!AICodeMirror 为 CCSwitch 的用户提供了特别福利,通过此链接注册的用户,可享受首充8折,企业客户最高可享 7.5 折!
PatewayAI 感谢 PatewayAI 赞助了本项目!PatewayAI 是一家面向重度 AI 开发者、专注官方直连高品质模型 API 中转服务商。提供 Claude 全系列与 Codex 系列模型,100% 官方源直供,不掺假不注水,欢迎检验。计费透明,Token 级账单可逐笔核验。 同时支持企业级高并发,并为企业客户提供了专业的管理平台,企业客户可签订正式合同并开具发票,更多详情进入官网获取联系方式。 现在通过此链接注册即送 $3 试用额度,用户充值低至 6 折,邀请好友双向赠送,邀请奖励可达 $150!
SiliconFlow 感谢硅基流动赞助了本项目!硅基流动是一个高性能 AI 基础设施与模型 API 平台,一站式提供语言、语音、图像、视频等多模态模型的快速、可靠访问。平台支持按量计费、丰富的多模态模型选择、高速推理和企业级稳定性,帮助开发者和团队更高效地构建和扩展 AI 应用。通过此链接注册并完成实名认证,即可获得 ¥16 奖励金,可在平台内跨模型使用。硅基流动现已兼容 OpenClaw,用户可接入硅基流动 API Key 免费调用主流 AI 模型。
Cubence 感谢 Cubence 赞助本项目!Cubence 是一家可靠高效的 API 中继服务提供商,提供对 Claude Code、Codex、Gemini 等模型的中继服务,并提供按量、包月等灵活的计费方式。Cubence 为 CC Switch 的用户提供了特别优惠:使用 此链接 注册,并在充值时输入 "CCSWITCH" 优惠码,每次充值均可享受九折优惠!
DMXAPI 感谢 DMXAPI(大模型API)赞助了本项目! DMXAPI,一个Key用全球大模型。 为200多家企业用户提供全球大模型API服务。· 充值即开票 ·当天开票 ·并发不限制 ·1元起充 · 7x24 在线技术辅导,GPT/Claude/Gemini全部6.8折,国内模型5~8折,Claude Code 专属模型3.4折进行中!点击这里注册
优云智算 感谢优云智算赞助了本项目!优云智算是UCloud旗下AI云平台,提供稳定、全面的国内外模型API,仅一个key即可调用。主打包月、按次的高性价比 国模Coding Plan套餐,同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7*24技术支持、自助开票。通过此链接注册的用户,可得免费5元平台体验金!
AICoding 感谢 AICoding.sh 赞助了本项目!AICoding.sh —— 全球大模型 API 超值中转服务!Claude Code 1.9 折,GPT 0.1 折,已为数百家企业提供高性价比 AI 服务。支持 Claude Code、GPT、Gemini 及国内主流模型,企业级高并发、极速开票、7×24 专属技术支持,通过此链接 注册的 CC Switch 用户,首充可享受九折优惠!
Crazyrouter 感谢 Crazyrouter 赞助了本项目!Crazyrouter 是一个高性能 AI API 聚合平台——一个 API Key 即可访问 300+ 模型,包括 Claude Code、Codex、Gemini CLI 等。全部模型低至官方定价的 55%,支持自动故障转移、智能路由和无限并发。Crazyrouter 为 CC Switch 用户提供了专属优惠:通过此链接注册后联系客服即可领取 $2 免费额度,首次充值时输入优惠码 `CCSWITCH` 还可获得额外 30% 奖励额度
RightCode 感谢 Right Code 赞助了本项目!Right Code 稳定提供 Claude Code、Codex、Gemini 等模型的中转服务,并可选按量、包月两种计费模式。充值即可开票,企业、团队用户一对一对接。同时为 CC Switch 的用户提供了特别优惠:通过此链接注册,每次充值均可获得实付金额5%的按量额度!
SSSAiCode 感谢 SSSAiCode 赞助了本项目!SSSAiCode 是一家稳定可靠的API中转站,致力于提供稳定、可靠、平价的Claude、CodeX模型服务,支持当日快速开票,SSSAiCode为本软件的用户提供特别优惠,使用此链接注册每次充值均可享受10$的额外奖励!
Micu 感谢 米醋API 赞助了本项目!米醋API 是一家致力于提供极致性价比与高稳定性的全球大模型中转服务商。米醋API 背后有实体企业做核心保障,杜绝跑路风险,支持极速正规开票!我们主打“试错零成本”:1 元起充低门槛,0 手续费随时退款!米醋API 为本软件的用户提供了特别优惠,使用此链接注册并在充值时填写"ccswitch"优惠码可享九折优惠!
LemonData 感谢 LemonData 赞助了本项目!LemonData 是一个高性能 AI API 聚合平台——一个 API Key 即可访问 GPT、Claude、Gemini、DeepSeek 等 300+ 模型。所有模型定价为官方价格的 30%-70%,支持自动故障转移、智能路由和无限并发。新用户注册即获 $1 免费额度——通过此链接注册即可领取奖励,立即开始开发!
CTok 感谢 CTok.ai 赞助了本项目!CTok.ai 致力于打造一站式 AI 编程工具服务平台。我们提供 Claude Code 专业套餐及技术社群服务,同时支持 Google Gemini 和 OpenAI Codex。通过精心设计的套餐方案和专业的技术社群,为开发者提供稳定的服务保障和持续的技术支持,让 AI 辅助编程真正成为开发者的生产力工具。点击这里注册!
LionCC 感谢 LionCC 狮子API 赞助了本项目!LionCC 专为追求极致开发体验的”Vibe Coders”而生。我们提供稳定、低延迟、优惠价格的 Claude Code、Codex 及 OpenClaw 算力服务,可节约 50% 成本。注册后添加客服微信 HSQBJ088888888,发暗号 cc-switch 备注即可送 10 美金额度(1000 万 token 算力)。其他项目合作关注博客 @LionCC.ai,点击这里注册!
ClaudeAPI 本项目由 Claude API 赞助。Claude API 直连,三分钟接入 Claude Code 与 Agent 应用 新用户可领取测试额度。基于 Anthropic 官方 Key + AWS Bedrock 官方渠道,非逆向、非降智,支持 Opus / Sonnet / Haiku 全系列模型,保留 Tool Use、1M 上下文等官方能力。适合 Claude Code 深度用户、Agent 工程师与企业技术团队,支持开票和团队对接。点击这里注册!
DDS 感谢 DDS 赞助本项目!呆呆兽是一家专注 Claude 的可靠高效 API 中转站,为个人和企业用户提供极具性价比的国内 Claude 直连加速服务。支持 Claude Haiku / Opus / Sonnet 等满血模型。充值满 1000 元即可开具发票,企业客户更可享受定制化分组和技术支持服务。CC Switch 用户专属福利:通过此链接注册后,首单充值可额外赠送 10% 额度(充值后请联系群主领取)!

为什么选择 CC Switch?

现代 AI 编程依赖于 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等 CLI 工具——但每个工具都有自己的配置格式。切换 API 供应商意味着手动编辑 JSON、TOML 或 .env 文件,而在多个工具之间缺乏一个统一管理 MCP, SKILLS 的方式。

CC Switch 为你提供一个桌面应用来管理所有五个 CLI 工具。无需手动编辑配置文件,你将获得一个可视化界面,一键将供应商导入应用,一键在不同的供应商之间进行切换,内置 50+ 供应商预设、统一的 MCP, SKILLS 管理以及系统托盘即时切换功能——所有操作都基于可靠的 SQLite 数据库和原子写入机制,保护你的配置不被损坏。

  • 一个应用,五个 CLI 工具 — 在单一界面中管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw
  • 告别手动编辑 — 50+ 供应商预设,包括 AWS Bedrock、NVIDIA NIM 和社区中转服务;一键即可切换
  • 统一 MCP, SKILLS 管理 — 一个面板管理四个应用的 MCP, SKILLS, 支持双向同步
  • 系统托盘快速切换 — 从托盘菜单即时切换供应商,无需打开完整应用
  • 云同步 — 通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器在不同设备之间同步供应商数据
  • 跨平台 — 基于 Tauri 2 构建的原生桌面应用,支持 Windows、macOS 和 Linux
  • 小工具 - 内置了多种小工具来解决首次安装登录确认、禁止签名、插件拓展同步等多种功能

界面预览

主界面 添加供应商
主界面 添加供应商

功能特性

完整更新日志 | 发布说明

供应商管理

  • 5 个 CLI 工具,50+ 预设 — Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw;复制 key 即可一键导入
  • 通用供应商 — 一份配置同步到多个应用(OpenCode、OpenClaw)
  • 一键切换、系统托盘快速访问、拖拽排序、导入导出

代理与故障转移

  • 本地代理热切换 — 格式转换、自动故障转移、熔断器、供应商健康监控和整流器
  • 应用级代理接管 — 独立为 Claude、Codex 或 Gemini 配置代理,具体到单个供应商

MCP、Prompts 与 Skills

  • 统一 MCP 面板 — 管理 4 个应用的 MCP 服务器,双向同步,支持 Deep Link 导入
  • Prompts — Markdown 编辑器,跨应用同步(CLAUDE.md / AGENTS.md / GEMINI.md),回填保护
  • Skills — 从 GitHub 仓库或 ZIP 文件一键安装,自定义仓库管理,支持软连接和文件复制

用量与成本追踪

  • 用量仪表盘 — 跨供应商追踪支出、请求数和 Token 用量,趋势图表、详细请求日志和自定义模型定价

会话管理器与工作区

  • 浏览、搜索和恢复全部应用对话历史
  • 工作区编辑器(OpenClaw)— 编辑 Agent 文件(AGENTS.md、SOUL.md 等),支持 Markdown 预览

系统与平台

  • 云同步 — 自定义配置目录(Dropbox、OneDrive、iCloud、坚果云、NAS)及 WebDAV 服务器同步
  • Deep Link (ccswitch://) — 通过 URL 一键导入供应商、MCP 服务器、提示词和技能
  • 深色 / 浅色 / 跟随系统主题、开机自启、自动更新、原子写入、自动备份、国际化(中/英/日)

常见问题

CC Switch 支持哪些 AI CLI 工具?

CC Switch 支持五个工具:Claude CodeCodexGemini CLIOpenCodeOpenClaw。每个工具都有专属的供应商预设和配置管理。

切换供应商后需要重启终端吗?

大多数工具需要重启终端或 CLI 工具才能使更改生效。例外的是 Claude Code,它目前支持供应商数据的热切换,无需重启。

切换供应商之后我的插件配置怎么不见了?

CC Switch 使用“通用配置片段”功能,在不同的供应商之间传递 Key 和请求地址之外的通用数据,您可以在“编辑供应商”菜单的“通用配置面板”里,点击“从当前供应商提取”,把所有的通用数据提取到通用配置中,之后在新建“供应商”的时候,只要勾选“写入通用配置”(默认勾选),就会把插件等数据写入到新的供应商配置中。您的所有配置项都会保存在运行本软件的时候,第一次导入的默认供应商里面,不会丢失。

macOS 安装

CC Switch macOS 版本已通过 Apple 代码签名和公证,可直接下载安装,无需额外操作。推荐使用 .dmg 安装包。

为什么总有一个正在激活中的供应商无法删除?

本软件的设计原则是“最小侵入性”,即使卸载本软件,也不会影响应用的正常使用。

所以系统总会保留一个正在激活中的配置,因为如果将所有配置全部删除,该应用将无法正常使用。如果你不经常使用某个对应的应用,可以在设置中关掉该应用的显示。如果你想切换回官方登录,可以参考下条。

如何切换回官方登录?

可以在预设供应商里面添加一个官方供应商。切换过去之后,执行一遍 Log out / Log in 流程,之后便可以在官方供应商和第三方供应商之间随意切换。CodeX 可以在不同官方供应商之间进行切换,方便多个 Plus 或者 Team 账号之间切换。

我的数据存储在哪里?
  • 数据库~/.cc-switch/cc-switch.db(SQLite — 供应商、MCP、提示词、技能)
  • 本地设置~/.cc-switch/settings.json(设备级 UI 偏好设置)
  • 备份~/.cc-switch/backups/(自动轮换,保留最近 10 个)
  • SKILLS~/.cc-switch/skills/(默认通过软链接连接到对应应用)
  • 技能备份~/.cc-switch/skill-backups/(卸载前自动创建,保留最近 20 个)

文档

如需了解各项功能的详细使用方法,请查阅 用户手册 — 涵盖供应商管理、MCP/Prompts/Skills、代理与故障转移等全部功能。

快速开始

基本使用

  1. 添加供应商:点击"添加供应商" → 选择预设或创建自定义配置
  2. 切换供应商
    • 主界面:选择供应商 → 点击"启用"
    • 系统托盘:直接点击供应商名称(立即生效)
  3. 生效方式:重启终端或对应的 CLI 工具以应用更改(CLaude Code 无需重启)
  4. 恢复官方登录:添加"官方登录"预设,重启 CLI 工具后按照其登录/OAuth 流程操作

MCP、Prompts、Skills 与会话

  • MCP:点击"MCP"按钮 → 通过模板或自定义配置添加服务器 → 切换各应用同步开关
  • Prompts:点击"Prompts" → 使用 Markdown 编辑器创建预设 → 激活后同步到 live 文件
  • Skills:点击"Skills" → 浏览 GitHub 仓库 → 一键安装到全部应用
  • 会话:点击"Sessions" → 浏览和搜索和恢复全部应用对话历史

注意:首次启动可以手动导入现有 CLI 工具配置作为默认供应商。

下载安装

系统要求

  • Windows:Windows 10 及以上
  • macOS:macOS 12 (Monterey) 及以上
  • Linux:Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版

Windows 用户

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

macOS 用户

方式一:通过 Homebrew 安装(推荐)

brew tap farion1231/ccswitch
brew install --cask cc-switch

更新:

brew upgrade --cask cc-switch

方式二:手动下载

Releases 页面下载 CC-Switch-v{版本号}-macOS.dmg(推荐)或 .zip

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

Arch Linux 用户

通过 paru 安装(推荐)

paru -S cc-switch-bin

Linux 用户

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

  • CC-Switch-v{版本号}-Linux.deb(Debian/Ubuntu)
  • CC-Switch-v{版本号}-Linux.rpm(Fedora/RHEL/openSUSE)
  • CC-Switch-v{版本号}-Linux.AppImage(通用)

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

架构总览

设计原则

┌─────────────────────────────────────────────────────────────┐
│                    前端 (React + TS)                         │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │ Components  │  │    Hooks     │  │  TanStack Query  │    │
│  │   (UI)     │──│ (业务逻辑)   │──│   (缓存/同步)    │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└────────────────────────┬────────────────────────────────────┘
                         │ Tauri IPC
┌────────────────────────▼────────────────────────────────────┐
│                  后端 (Tauri + Rust)                         │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │  Commands   │  │   Services   │  │  Models/Config   │    │
│  │ (API 层)   │──│  (业务层)    │──│    (数据)       │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└─────────────────────────────────────────────────────────────┘

核心设计模式

  • SSOT(单一事实源):所有数据存储在 ~/.cc-switch/cc-switch.db(SQLite)
  • 双层存储:SQLite 存储可同步数据,JSON 存储设备级设置
  • 双向同步:切换时写入 live 文件,编辑当前供应商时从 live 回填
  • 原子写入:临时文件 + 重命名模式防止配置损坏
  • 并发安全:Mutex 保护的数据库连接避免竞态条件
  • 分层架构:清晰分离(Commands → Services → DAO → Database)

核心组件

  • ProviderService:供应商增删改查、切换、回填、排序
  • McpService:MCP 服务器管理、导入导出、live 文件同步
  • ProxyService:本地 Proxy 模式,支持热切换和格式转换
  • SessionManager:全应用会话历史浏览
  • ConfigService:配置导入导出、备份轮换
  • SpeedtestService:API 端点延迟测量
开发指南

环境要求

  • Node.js 18+
  • pnpm 8+
  • Rust 1.85+
  • Tauri CLI 2.8+

开发命令

# 安装依赖
pnpm install

# 开发模式(热重载)
pnpm dev

# 类型检查
pnpm typecheck

# 代码格式化
pnpm format

# 检查代码格式
pnpm format:check

# 运行前端单元测试
pnpm test:unit

# 监听模式运行测试(推荐开发时使用)
pnpm test:unit:watch

# 构建应用
pnpm build

# 构建调试版本
pnpm tauri build --debug

Rust 后端开发

cd src-tauri

# 格式化 Rust 代码
cargo fmt

# 运行 clippy 检查
cargo clippy

# 运行后端测试
cargo test

# 运行特定测试
cargo test test_name

# 运行带测试 hooks 的测试
cargo test --features test-hooks

测试说明

前端测试

  • 使用 vitest 作为测试框架
  • 使用 MSW (Mock Service Worker) 模拟 Tauri API 调用
  • 使用 @testing-library/react 进行组件测试

运行测试

# 运行所有测试
pnpm test:unit

# 监听模式(自动重跑)
pnpm test:unit:watch

# 带覆盖率报告
pnpm test:unit --coverage

技术栈

前端:React 18 · TypeScript · Vite · TailwindCSS 3.4 · TanStack Query v5 · react-i18next · react-hook-form · zod · shadcn/ui · @dnd-kit

后端:Tauri 2.8 · Rust · serde · tokio · thiserror · tauri-plugin-updater/process/dialog/store/log

测试:vitest · MSW · @testing-library/react

项目结构
├── src/                        # 前端 (React + TypeScript)
│   ├── components/
│   │   ├── providers/          # 供应商管理
│   │   ├── mcp/                # MCP 面板
│   │   ├── prompts/            # Prompts 管理
│   │   ├── skills/             # Skills 管理
│   │   ├── sessions/           # 会话管理器
│   │   ├── proxy/              # Proxy 模式面板
│   │   ├── openclaw/           # OpenClaw 配置面板
│   │   ├── settings/           # 设置(终端/备份/关于)
│   │   ├── deeplink/           # Deep Link 导入
│   │   ├── env/                # 环境变量管理
│   │   ├── universal/          # 跨应用配置
│   │   ├── usage/              # 用量统计
│   │   └── ui/                 # shadcn/ui 组件库
│   ├── hooks/                  # 自定义 hooks(业务逻辑)
│   ├── lib/
│   │   ├── api/                # Tauri API 封装(类型安全)
│   │   └── query/              # TanStack Query 配置
│   ├── locales/                # 翻译 (zh/en/ja)
│   ├── config/                 # 预设 (providers/mcp)
│   └── types/                  # TypeScript 类型定义
├── src-tauri/                  # 后端 (Rust)
│   └── src/
│       ├── commands/           # Tauri 命令层(按领域)
│       ├── services/           # 业务逻辑层
│       ├── database/           # SQLite DAO 层
│       ├── proxy/              # Proxy 模块
│       ├── session_manager/    # 会话管理
│       ├── deeplink/           # Deep Link 处理
│       └── mcp/                # MCP 同步模块
├── tests/                      # 前端测试
└── assets/                     # 截图 & 合作商资源

贡献

欢迎提交 Issue 反馈问题和建议!

提交 PR 前请确保:

  • 通过类型检查:pnpm typecheck
  • 通过格式检查:pnpm format:check
  • 通过单元测试:pnpm test:unit

新功能开发前,欢迎先开 Issue 讨论实现方案,不适合项目的功能性 PR 有可能会被关闭。

Star History

Star History Chart

License

MIT © Jason Young

Morty Proxy This is a proxified and sanitized view of the page, visit original site.