OneinAI

Appearance

CC-Switch 快速配置工具 ​

All-in-One AI CLI 管理器 — 跨平台桌面应用

🔗 相关链接 ​

资源地址
GitHub 发布页cc-switch/releases
CC-Switch 文档站ccswitch.io
oneinai 控制台https://api.oneinai.com/console/token

🎯 工具介绍 ​

CC-Switch 是一款跨平台桌面应用，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，让你在多个供应商配置之间一键切换，并集中管理 MCP 服务器、系统提示和 Claude Skills。

💡 核心功能

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

CC-Switch 软件界面

📦 安装方法 ​

🖥️ Windows 平台 ​

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

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

方法二：便携版（免安装）

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

🍏 macOS 平台 ​

推荐方式：Homebrew 安装

bash
# 添加 tap 源
brew tap farion1231/ccswitch

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

手动安装

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

🐧 Linux 平台 ​

Debian / Ubuntu 系列（推荐）

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

AppImage 通用版本

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

Arch Linux（AUR）

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

🚀 快速开始 ​

第一步：初始化设置 ​

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

CC-Switch 初始化设置界面

💡 推荐配置 建议启用以下选项以获得最佳体验：

  • 开机自启
  • 静默启动
  • 应用到 Claude Code 插件
  • 跳过初次安装确认
  • 关闭时最小化到托盘

第二步：添加供应商配置 ​

1. 添加 Claude / Gemini 供应商

点击右上角的「+」按钮，进入添加面板。

添加 Claude / Gemini 供应商

💡 Gemini 用户提示 使用 Gemini CLI 时，请在 oneinai 平台创建 Gemini 分组的令牌，而非 Claude 分组。

2. 添加 Codex 供应商

切换到 Codex 标签后，同样点击右上角「+」按钮添加。

添加 Codex 供应商

3. 保存配置

填写完成后点击「保存」即可。

⚠️ 重要提示 不同 AI 工具（Claude Code / Codex / Gemini CLI）需要使用不同的令牌组。请在监测站中确认模型状态后，再选择合适的分组创建令牌。

第三步：切换供应商 ​

操作方式步骤
应用内切换在供应商列表中选择目标配置 → 点击「启用」
托盘快捷切换右键点击托盘图标 → 选择对应工具的供应商

ℹ️ 生效说明 Claude Code 支持热重载，切换后立即生效；Codex 和 Gemini CLI 需要重启工具才能应用新配置。

第四步：开始使用 ​

切换完成后，启动对应的 AI 工具即可享受新配置。

📖 进阶使用 ​

系统托盘菜单 ​

  • 右键点击托盘图标可看到分类列表（Claude / Codex / Gemini）
  • 直接点击对应分类下的供应商即可切换
  • 无需打开主界面，提升日常切换效率

API 速度测试 ​

在供应商详情页可以一键测试 API 端点的连接速度，并以颜色直观展示质量等级，帮你快速选出最优节点。

配置备份与恢复 ​

CC-Switch 会自动保留最近 10 个配置版本，意外修改后可一键回滚到任意历史版本。

📚 完整文档 ​

更多高级功能与详细说明，请参阅 CC-Switch 官方文档。

🔗 项目资源 ​

🎉 开始使用！ 现在你可以用 CC-Switch 轻松管理多个 AI 编程工具的配置，享受高效的开发体验。