CC Switch

统一管理 Claude Code 等 5 款 AI CLI 工具的桌面应用，一键切换 API 提供商、模型和配置

​

概述

CC Switch 是一款基于 Tauri 2 构建的桌面应用，可以统一管理 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 五款 AI CLI 工具。告别手动编辑配置文件，通过图形界面一键切换 API 提供商、模型和密钥。

通过配置 API易 服务，您可以获得：

🚀 一键切换

图形界面管理所有 CLI 工具配置，告别手动编辑

💰 88 折优惠

选择 ClaudeCode 分组创建令牌，享受 88% 折扣

📊 用量追踪

内置 Usage Dashboard，实时查看花费、请求数和 Token 用量

🔄 智能容错

本地代理支持热切换、自动故障转移和熔断保护

项目信息

• 🔗 开源地址：github.com/farion1231/cc-switch
• 📜 许可证：MIT
• 👤 作者：Jason Young（farion1231）
• 🏷️ 最新版本：v3.12.0

​

核心功能

​

Provider 管理

• 内置 50+ 预设提供商（含 AWS Bedrock、NVIDIA NIM 等）
• 一键切换、拖拽排序、导入导出配置
• 系统托盘快速访问

​

MCP 服务器管理

• 统一管理所有 CLI 工具的 MCP 服务器配置
• 双向同步，修改一处自动同步到所有应用

​

更多特性

• Prompts 管理：Markdown 编辑器 + 跨应用同步
• Skills 安装：从 GitHub 仓库或 ZIP 文件安装技能
• Session 浏览器：查看和恢复对话历史
• 云同步：支持 Dropbox、OneDrive、iCloud、WebDAV
• Deep Link：ccswitch:// 协议一键导入配置

​

快速开始

​

第一步：安装 CC Switch

macOS

使用 Homebrew 安装：

brew install --cask cc-switch

或从 GitHub Releases 下载 DMG 安装包。

Windows

从 GitHub Releases 下载 MSI 安装程序或 Portable ZIP 包。

Linux

根据发行版选择安装方式：

# Debian/Ubuntu
sudo dpkg -i cc-switch_*.deb

# Fedora/RHEL
sudo rpm -i cc-switch_*.rpm

# Arch Linux
paru -S cc-switch-bin

也可使用 AppImage 或 Flatpak。

系统要求：Windows 10+、macOS 10.15 (Catalina)+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+

​

第二步：获取 API易 密钥

1. 访问 API易控制台 - 令牌页面
2. 点击创建新令牌
3. 重要：选择 【ClaudeCode】分组，享受 88% 折扣
4. 复制生成的密钥（以 sk- 开头）

省钱提示：创建令牌时务必选择【ClaudeCode】分组，可享受 88 折优惠价格，大幅降低使用成本。

​

第三步：在 CC Switch 中配置 API易

1. 打开 CC Switch 应用
2. 进入 Provider 管理页面，点击添加，选择「自定义网关」：

3. 按照上图填写以下信息：
   • 名称：APIYI
   • API 地址：https://api.apiyi.com
   • API Key：粘贴上一步获取的密钥
   • 启用的应用：开启 Claude Code（按需开启其他工具）
4. 点击「添加」保存配置

​

第四步：添加模型

在 Provider 配置中添加以下模型：

标准模型：

模型名称	模型标识	说明
Claude Opus 4.6	claude-opus-4-6	最强旗舰，复杂任务首选
Claude Sonnet 4.6	claude-sonnet-4-6	编程能力强，性价比之选
Claude Haiku 4.5	claude-haiku-4-5-20251001	轻量快速，简单任务适用

推理模型（强制启用思维链）：

模型名称	模型标识	说明
Claude Opus 4.6 Thinking	claude-opus-4-6-thinking	深度推理，复杂逻辑分析
Claude Sonnet 4.6 Thinking	claude-sonnet-4-6-thinking	推理增强编程，平衡效率
Claude Haiku 4.5 Thinking	claude-haiku-4-5-20251001-thinking	轻量推理，快速思考

模型选择建议：日常编程推荐 claude-sonnet-4-6，复杂架构设计用 claude-opus-4-6，快速问答用 claude-haiku-4-5-20251001。需要深度推理时使用对应的 thinking 版本。

​

第五步：一键切换

配置完成后，在 CC Switch 中选择 API易 作为当前 Provider，所有关联的 CLI 工具（Claude Code、Codex CLI 等）会自动切换到 API易 配置。

​

使用指南

​

管理多个 CLI 工具

CC Switch 支持同时管理以下 5 款 AI CLI 工具：

• Claude Code — Anthropic 官方命令行编程助手
• Codex CLI — OpenAI 的命令行编程工具
• Gemini CLI — Google 的命令行 AI 助手
• OpenCode — 开源命令行编程工具
• OpenClaw — 开源本地 AI Agent

所有工具共享 Provider 配置，切换一次即可全部生效。

​

本地代理功能

CC Switch 内置本地代理服务器，提供：

• 热切换：无需重启即可切换 Provider
• 自动故障转移：当前 Provider 不可用时自动切换备选
• 熔断保护：检测到持续故障时自动停止请求，防止资源浪费

​

配置备份

• 自动备份系统保留最近 10 个版本
• 支持导入/导出完整配置
• 云同步支持 Dropbox、OneDrive、iCloud、WebDAV

​

模型推荐

查看更多编程模型推荐

除了 Claude 系列，API易 还支持 200+ 主流 AI 模型。查看完整的编程模型推荐、性能对比和场景化使用建议。

​

常见问题

CC Switch 支持哪些操作系统？

支持 Windows 10+、macOS 10.15 (Catalina)+、以及主流 Linux 发行版（Ubuntu 22.04+、Debian 11+、Fedora 34+、Arch Linux）。

如何享受 88 折优惠？

在 API易控制台 创建令牌时，选择【ClaudeCode】分组即可自动享受 88% 折扣。

配置后 Claude Code 无法连接？

请检查：

1. API Key 是否正确（以 sk- 开头）
2. Base URL 是否设置为 https://api.apiyi.com
3. API易 账户余额是否充足
4. CC Switch 是否已将配置同步到 Claude Code

标准模型和 Thinking 模型有什么区别？

Thinking（推理）模型会强制启用思维链模式，在回答前进行深度推理分析。适合复杂逻辑推理、架构设计等需要深度思考的场景。标准模型响应更快，适合日常编程和简单任务。

如何从其他配置方式迁移到 CC Switch？

CC Switch 支持导入功能，可以自动读取已有的环境变量和配置文件。安装后打开应用，它会自动检测已安装的 CLI 工具及其现有配置。

CC Switch 是否收费？

CC Switch 本身完全免费开源（MIT 许可证）。只有 API 调用会产生费用，通过 API易 使用 ClaudeCode 分组可享受 88 折优惠。

​

最佳实践

高效使用建议：

1. 分组创建令牌：务必选择【ClaudeCode】分组，享受 88 折
2. 善用热切换：在不同任务间快速切换 Provider 和模型
3. 启用自动故障转移：配置多个 Provider 作为备选，确保服务连续性
4. 定期备份：利用云同步功能定期备份配置

​

相关资源

Claude Code 配置

查看 Claude Code 的详细配置教程

模型推荐

了解最新的 AI 模型推荐

API易控制台

管理 API 密钥和查看用量

其他编程工具

探索 Cursor 等其他编程工具