Appearance
CC Switch
文档说明
统一管理 Claude Code 等 5 款 AI CLI 工具的桌面应用，一键切换 API 提供商、模型和配置
概述
CC Switch 是一款基于 Tauri 2 构建的桌面应用，可以统一管理 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 五款 AI CLI 工具。告别手动编辑配置文件，通过图形界面一键切换 API 提供商、模型和密钥。
通过配置 FastAiToken 服务，您可以获得：
图形界面管理所有 CLI 工具配置，告别手动编辑 选择 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 安装：
bash
brew install --cask cc-switch或从 GitHub Releases 下载 DMG 安装包。
从 GitHub Releases 下载 MSI 安装程序或 Portable ZIP 包。 根据发行版选择安装方式：
```text
# 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+
### 第二步：获取 FastAiToken 密钥
1. 访问 [FastAiToken控制台 - 令牌页面](https://fastaitoken.com/token)
2. 点击创建新令牌
3. **重要**：选择 **【ClaudeCode】分组**，享受 **88% 折扣**
4. 复制生成的密钥（以 `sk-` 开头）
**省钱提示**：创建令牌时务必选择【ClaudeCode】分组，可享受 88 折优惠价格，大幅降低使用成本。
### 第三步：在 CC Switch 中配置 FastAiToken
1. 打开 CC Switch 应用
2. 进入 **Provider** 管理页面，点击添加，选择「自定义网关」：
3. 按照上图填写以下信息：
- **名称**：`FASTAITOKEN`
- **API 地址**：`https://fastaitoken.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 中选择 FastAiToken 作为当前 Provider，所有关联的 CLI 工具（Claude Code、Codex CLI 等）会自动切换到 FastAiToken 配置。
## 使用指南
### 管理多个 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 系列，FastAiToken 还支持 400+ 主流 AI 模型。查看完整的编程模型推荐、性能对比和场景化使用建议。
## 常见问题
支持 Windows 10+、macOS 10.15 (Catalina)+、以及主流 Linux 发行版（Ubuntu 22.04+、Debian 11+、Fedora 34+、Arch Linux）。 在 [FastAiToken控制台](https://fastaitoken.com/token) 创建令牌时，选择【ClaudeCode】分组即可自动享受 88% 折扣。 请检查：
```text
1. API Key 是否正确（以 `sk-` 开头）
2. Base URL 是否设置为 `https://fastaitoken.com`
3. FastAiToken 账户余额是否充足
4. CC Switch 是否已将配置同步到 Claude CodeThinking（推理）模型会强制启用思维链模式，在回答前进行深度推理分析。适合复杂逻辑推理、架构设计等需要深度思考的场景。标准模型响应更快，适合日常编程和简单任务。 CC Switch 支持导入功能，可以自动读取已有的环境变量和配置文件。安装后打开应用，它会自动检测已安装的 CLI 工具及其现有配置。 CC Switch 本身完全免费开源（MIT 许可证）。只有 API 调用会产生费用，通过 FastAiToken 使用 ClaudeCode 分组可享受 88 折优惠。
最佳实践
高效使用建议：
- 分组创建令牌：务必选择【ClaudeCode】分组，享受 88 折
- 善用热切换：在不同任务间快速切换 Provider 和模型
- 启用自动故障转移：配置多个 Provider 作为备选，确保服务连续性
- 定期备份：利用云同步功能定期备份配置
相关资源
查看 Claude Code 的详细配置教程 了解最新的 AI 模型推荐 管理 API 密钥和查看用量 探索 Cursor 等其他编程工具