跳转到主要内容

​
概述

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

使用 Homebrew 安装：
brew install --cask cc-switch
或从 GitHub Releases 下载 DMG 安装包。
系统要求：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. 添加新的 Provider，填写以下信息：
    • 名称：API易
    • API Key：粘贴上一步获取的密钥
    • Base URL：https://api.apiyi.com
  4. 保存配置

​
第四步：添加模型

在 Provider 配置中添加以下模型： 标准模型：
模型名称模型标识说明
Claude Opus 4.6claude-opus-4-6最强旗舰，复杂任务首选
Claude Sonnet 4.6claude-sonnet-4-6编程能力强，性价比之选
Claude Haiku 4.5claude-haiku-4-5-20251001轻量快速，简单任务适用
推理模型（强制启用思维链）：
模型名称模型标识说明
Claude Opus 4.6 Thinkingclaude-opus-4-6-thinking深度推理，复杂逻辑分析
Claude Sonnet 4.6 Thinkingclaude-sonnet-4-6-thinking推理增强编程，平衡效率
Claude Haiku 4.5 Thinkingclaude-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 模型。查看完整的编程模型推荐、性能对比和场景化使用建议。

​
常见问题

支持 Windows 10+、macOS 10.15 (Catalina)+、以及主流 Linux 发行版（Ubuntu 22.04+、Debian 11+、Fedora 34+、Arch Linux）。
在 API易控制台 创建令牌时，选择【ClaudeCode】分组即可自动享受 88% 折扣。
请检查：
  1. API Key 是否正确（以 sk- 开头）
  2. Base URL 是否设置为 https://api.apiyi.com
  3. API易 账户余额是否充足
  4. CC Switch 是否已将配置同步到 Claude Code
Thinking（推理）模型会强制启用思维链模式，在回答前进行深度推理分析。适合复杂逻辑推理、架构设计等需要深度思考的场景。标准模型响应更快，适合日常编程和简单任务。
CC Switch 支持导入功能，可以自动读取已有的环境变量和配置文件。安装后打开应用，它会自动检测已安装的 CLI 工具及其现有配置。
CC Switch 本身完全免费开源（MIT 许可证）。只有 API 调用会产生费用，通过 API易 使用 ClaudeCode 分组可享受 88 折优惠。

​
最佳实践

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

​
相关资源

Claude Code 配置

查看 Claude Code 的详细配置教程

模型推荐

了解最新的 AI 模型推荐

API易控制台

管理 API 密钥和查看用量

其他编程工具

探索 Cursor 等其他编程工具