CC-Switch 快速配置工具

All-in-One AI CLI 管理器 - 桌面应用程序

🔗 相关链接

资源	地址
GitHub 发布页	cc-switch/releases
CC-Switch 文档站	ccswitch.lovable.app

🎯 工具介绍

CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，实现配置切换、MCP 服务器管理、系统提示和 Claude Skills 管理。

💡 核心功能

• 一键切换不同 AI 工具的提供商配置
• API 端点速度测试与质量指示器
• 多预设系统提示管理
• MCP 服务器统一架构管理
• Claude Skills 发现与安装系统
• 配置备份/恢复（自动保留最近10个）
• 深度链接协议支持（ccswitch://）
• 环境变量冲突检测

📦 安装方法

🖥️ Windows 平台

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

1. 访问项目发布页：https://github.com/farion1231/cc-switch/releases
2. 下载最新版本的 .msi 安装器
3. 运行安装器，按照向导完成安装
4. 安装完成后从开始菜单启动 CC-Switch

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

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

🍏 macOS 平台

推荐方式：Homebrew 安装

# 添加 tap 源
brew tap farion1231/ccswitch

# 安装 cc-switch
brew install --cask cc-switch

手动安装

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

🐧 Linux 平台

Debian/Ubuntu 系列（推荐）

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

AppImage 通用版本

chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage

Arch Linux（AUR）

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

🚀 快速开始

Claude Code 配置

第一步：初始化设置

打开 CC-Switch，进入「设置」页面，在「通用」标签下将「窗口行为」中的所有开关全部打开，确保自启动、Claude Code 插件集成、托盘最小化等功能正常生效。

💡 推荐配置

建议将「窗口行为」中的所有开关全部启用，以获得最佳使用体验：开机自启、静默启动、应用到 Claude Code 插件、跳过初次安装确认、关闭时最小化到托盘。

第二步：添加 HuHu 提供商配置

1. 点击右上角的加号按钮来添加提供商（Claude/Gemini）

   💡 Gemini 用户

   如果使用的是 Gemini CLI，请在 HuHu 平台创建对应的 Gemini 令牌，而非 Claude 分组。

2. 在配置表单中填写以下信息：

   字段	值
   名称	HuHu（可自定义）
   API 地址	https://www.huhu.asia
   API Key	你的 HuHu 令牌

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

⚠️ 重要提示

不同的 AI 工具（Claude Code、Codex、Gemini CLI）需要不同的令牌组配置。请在 HuHu 控制台 中选择合适的分组创建令牌。

第三步：切换提供商

1. 在提供商列表中选择要使用的配置
2. 点击「启用」按钮
3. 或使用系统托盘图标进行即时切换

系统托盘快速切换：

• 右键点击系统托盘中的 CC-Switch 图标
• 从菜单中直接选择要切换的提供商
• 配置立即生效（Claude Code 支持热重载，其他工具可能需要重新启动）

第四步：应用配置

切换配置后，关闭并重新启动对应的 AI 工具即可自动应用新配置。

CC-Switch 会自动设置 ANTHROPIC_BASE_URL（指向 https://www.huhu.asia）和 ANTHROPIC_API_KEY 等环境变量。

CodeX 配置

CC-Switch 同样支持为 CodeX 配置 API 地址，操作步骤与 Claude Code 类似。

第一步：初始化设置

与 Claude Code 配置相同，打开 CC-Switch，进入「设置」页面，在「通用」标签下启用所有「窗口行为」开关。

第二步：添加 HuHu 提供商配置（CodeX）

1. 点击右上角的加号按钮添加提供商（选择 Codex 类型）

2. 在配置表单中填写以下信息：

   字段	值
   名称	HuHu-CodeX（可自定义）
   API 地址	https://www.huhu.asia/v1
   API Key	你的 HuHu 令牌

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

💡 CodeX 环境变量说明

CC-Switch 为 CodeX 自动配置以下环境变量：

• OPENAI_BASE_URL：指向 https://www.huhu.asia/v1
• OPENAI_API_KEY：填写你的 HuHu 令牌

与 Claude Code 使用 ANTHROPIC_BASE_URL 不同，CodeX 使用 OpenAI 兼容接口。

⚠️ 令牌分组提示

请在 HuHu 控制台 中选择适用于 CodeX / OpenAI 兼容 分组创建令牌，勿与 Claude 令牌混用。

第三步：切换提供商

1. 在提供商列表中选择刚添加的 CodeX 配置
2. 点击「启用」按钮
3. 或使用系统托盘图标进行即时切换

第四步：应用配置

关闭并重新启动 CodeX 即可自动应用新配置。

📖 完整文档

更多详细配置和高级功能，请参阅 CC-Switch 官方完整文档。

🔗 项目资源

• GitHub 仓库：https://github.com/farion1231/cc-switch
• 问题反馈：GitHub Issues
• 最新版本：Releases 页面

🎉 开始使用！

现在你可以使用 CC-Switch 轻松管理多个 AI 编程工具的配置了。 配合 HuHu API 中转服务（https://www.huhu.asia），享受高效稳定的开发体验！