CC-Switch 配置工具

用图形界面一键管理小麦API 配置，告别手动编辑配置文件

📋 简介

CC-Switch 是一款跨平台桌面应用，支持 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 五大 AI 编程工具的统一管理。通过 CC-Switch，你可以用图形界面快速接入小麦API，一键切换供应商，不用再手动编辑 JSON / TOML / .env 配置文件。

⚠️ 适用环境

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

🔗 相关链接

资源	地址
GitHub 仓库	https://github.com/farion1231/cc-switch
下载页面	Releases

🛠️ 安装 CC-Switch

Windows 平台

方法一：MSI 安装器（推荐）

1. 访问 Releases 页面
2. 下载最新版本的 .msi 安装器
3. 双击运行，按照向导完成安装
4. 从开始菜单启动 CC-Switch

方法二：便携版（无需安装）

1. 下载 .zip 便携版压缩包
2. 解压到任意目录
3. 运行 cc-switch.exe 即可使用

macOS 平台

💡 说明

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

方式一：Homebrew 安装（推荐）

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

更新版本：

brew upgrade --cask cc-switch

方式二：手动安装

1. 访问 Releases 页面
2. 下载 .dmg 安装包
3. 打开 DMG 文件，将 CC-Switch 拖入应用程序文件夹

Linux 平台

Debian / Ubuntu

sudo dpkg -i CC-Switch-*.deb
sudo apt-get install -f  # 修复依赖

Fedora / RHEL / openSUSE

sudo rpm -i CC-Switch-*.rpm

Arch Linux（AUR）

paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin

AppImage 通用版本

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

Flatpak

flatpak install --user ./CC-Switch-*.flatpak
flatpak run com.ccswitch.desktop

⚙️ 接入小麦API 配置

第一步：导入现有配置

首次启动 CC-Switch 时，会自动检测你已有的 CLI 工具配置。

• 如果你之前已经手动配置过 Claude Code 等工具，按提示导入即可，已有配置会自动保存为默认供应商
• 如果是全新安装，跳过此步

第二步：添加小麦API 供应商

1. 点击「添加供应商」按钮
2. 选择「自定义」（Custom）创建新配置

🚨 不要选官方预设

官方供应商预设的 API 端点是锁定的，无法修改为小麦API 地址。必须选择「自定义」来手动填写。

3. 填写以下信息：

字段	填写内容
供应商名称	自定义名称，如 小麦API
API 端点	https://xiaomai.win
API 密钥	你的小麦API Key（sk-xxxx）
模型	根据需求选择，如 claude-sonnet-4-20250514

💡 Key 从哪来？

在 小麦API 控制台 创建令牌获取。不同工具可能需要不同令牌组的 Key，详见 创建专属 Key。

4. 点击「保存」完成配置

第三步：启用小麦API 供应商

两种方式任选：

• 主界面：在供应商列表中找到刚创建的「小麦API」→ 点击「启用」
• 系统托盘：右键点击托盘中的 CC-Switch 图标 → 直接选择「小麦API」

第四步：验证配置

1. 打开你的 AI 编程工具（如 Claude Code）
2. 发送一条测试消息，确认能正常响应

💡 提示

Claude Code 支持供应商热切换，无需重启。Codex、Gemini CLI 等其他工具需要关闭后重新打开才能生效。

为多个工具分别配置

如果你同时使用多个 AI 编程工具（如 Claude Code + Codex），需要为每个工具单独添加供应商：

1. 在 CC-Switch 顶部切换到对应工具的标签页（如 Codex）
2. 重复上面的「添加供应商」步骤
3. 每个工具使用对应令牌组的 Key

⚠️ 注意

不同工具可能需要不同的令牌组配置。请在小麦API 平台为每个工具创建对应的专用令牌，参考 创建专属 Key。

✨ 更多功能

CC-Switch 除了供应商管理，还提供以下实用功能：

统一 MCP / Skills 管理

一个面板管理所有应用的 MCP 服务器和 Skills，支持双向同步。点击「MCP」或「Skills」按钮进入管理面板。

Prompts 系统提示管理

使用 Markdown 编辑器创建不同场景的系统提示预设，激活后自动同步到对应应用的配置文件（CLAUDE.md / AGENTS.md / GEMINI.md）。

会话管理器

浏览、搜索和恢复所有应用的对话历史。

用量追踪

跨供应商追踪支出、请求数和 Token 用量，支持趋势图表和详细请求日志。

本地代理与故障转移

内置代理热切换，支持 Anthropic ↔ OpenAI 格式转换、自动故障转移和熔断器机制。

云同步

通过 Dropbox、OneDrive、iCloud、坚果云或 WebDAV 在不同设备间同步配置。

配置备份与恢复

每次修改配置时自动创建备份，保留最近 10 个版本，支持一键恢复。

📂 数据存储位置

路径	说明
~/.cc-switch/cc-switch.db	SQLite 数据库（供应商、MCP、提示词、技能）
~/.cc-switch/settings.json	本地设置（UI 偏好）
~/.cc-switch/backups/	自动备份（保留最近 10 个）
~/.cc-switch/skills/	技能文件（通过软链接连接到对应应用）

常见问题

添加供应商时选了官方预设，发现不能改 URL？

官方预设的端点是锁定的。要接入小麦API，必须选择「自定义」（Custom）来创建供应商，手动填写 https://xiaomai.win 作为 API 端点。

切换供应商后工具没反应？

大多数工具需要重启终端或 CLI 工具才能生效。Claude Code 是例外，支持热切换无需重启。

切换供应商后插件配置不见了？

在「编辑供应商」→「通用配置面板」里，点击「从当前供应商提取」，把插件等数据提取到通用配置中。之后新建供应商时勾选「写入通用配置」（默认勾选），就会自动带上这些配置。

为什么有一个供应商无法删除？

CC-Switch 始终保留一个激活中的配置，确保即使卸载 CC-Switch，CLI 工具也能正常使用。如果你不常用某个工具，可以在设置中关闭该工具的显示。

如何切换回官方登录？

在预设供应商里添加一个「官方供应商」，切换过去后执行一遍 Log out / Log in 流程，之后就可以在官方和第三方供应商之间随意切换。

更多问题

请查看 FAQ 或联系售后支持。