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

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

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

CC Switch 支持五个工具：Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw。每个工具都有专属的供应商预设和配置管理。

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

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

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 个）

设计原则

123456789101112131415
┌─────────────────────────────────────────────────────────────┐│                    前端 (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+

开发命令

bash
1234567891011121314151617181920212223242526
# 安装依赖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 后端开发

bash
12345678910111213141516
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 进行组件测试

运行测试：

bash
12345678
# 运行所有测试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

123456789101112131415161718192021222324252627282930313233
├── 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/                     # 截图 & 合作商资源