CC-Switch 快速配置工具

CC-Switch 是一个 All-in-One AI CLI 管理器，用桌面图形界面统一管理 Claude Code、Codex 和 Gemini CLI 等 AI 编程工具的提供商配置、MCP 服务、系统提示和扩展能力。

推荐用途

如果你经常在官方服务、PotatoAI.cc 和其他中转配置之间切换，优先使用 CC-Switch 管理配置，能减少手动编辑配置文件时的格式错误。

• 相关链接
• 工具介绍
• 核心功能
• 安装方法
  • Windows
  • macOS
  • Linux
• 快速开始
  • 1. 初始化设置
  • 2. 添加 Claude / Gemini 提供商
  • 3. 添加 Codex 提供商
  • 4. 切换提供商
  • 5. 应用配置
• 完整文档
• 项目资源
• 开始使用

相关链接

资源	地址
GitHub 发布页	github.com/farion1231/cc-switch/releases
GitHub 仓库	github.com/farion1231/cc-switch
CC-Switch 文档站	ccswitch.lovable.app
PotatoAI.cc API Key	创建 API Key

工具介绍

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

核心功能

功能	说明
提供商配置切换	为 Claude Code、Codex、Gemini CLI 分别保存多个服务端点和 API Key，并一键切换。
API 端点检测	测试端点速度，并通过质量指示器辅助判断可用性。
系统提示管理	管理多个预设系统提示，适配不同开发任务。
MCP 服务器管理	使用统一架构管理 MCP 服务器配置。
Claude Skills 管理	支持 Claude Skills 的发现与安装。
备份与恢复	自动保留最近 10 个配置备份，方便回滚。
深度链接协议	支持 ccswitch:// 深度链接。
环境变量检测	检测可能影响工具调用的环境变量冲突。

安装方法

Windows

推荐方式：MSI 安装器

1. 打开 GitHub Releases。
2. 下载最新版本的 .msi 安装器。
3. 运行安装器，并按向导完成安装。
4. 安装完成后，从开始菜单启动 CC-Switch。

便携版

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

macOS

推荐使用 Homebrew 安装：

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

手动安装

1. 打开 GitHub 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

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

快速开始

1. 初始化设置

打开 CC-Switch，进入 设置 页面，在 通用 标签下找到 窗口行为，建议将相关开关全部启用。

推荐开启

建议启用开机自启、静默启动、应用到 Claude Code 插件、跳过初次安装确认、关闭时最小化到托盘等选项，以获得更顺手的桌面体验。

2. 添加 Claude / Gemini 提供商

点击右上角加号按钮，添加 Claude Code 或 Gemini CLI 的提供商配置。

Gemini 用户

如果使用 Gemini CLI，请在 PotatoAI.cc 平台创建 Gemini 对应令牌组的 API Key，不要直接使用 Claude 分组令牌。

3. 添加 Codex 提供商

再次点击右上角加号，添加 Codex 提供商配置。

配置项	建议填写
Base URL	https://www.potatoai.cc/v1。如果控制台展示不同地址，以控制台为准。
API Key	根据工具选择对应令牌组创建的 Key。
Model	从模型广场或控制台复制完整模型 ID。
工具类型	Claude Code、Codex、Gemini CLI 应分别使用对应配置。

重要提示

不同 AI 工具需要不同令牌组配置。Claude Code、Codex 和 Gemini CLI 的令牌不要混用，否则可能出现模型不可用或无权限访问。

4. 切换提供商

1. 在提供商列表中选择要使用的配置。
2. 点击 启用 或 当前使用。
3. 也可以通过系统托盘图标快速切换。

系统托盘快速切换

右键点击系统托盘中的 CC-Switch 图标，从菜单中选择对应工具和提供商配置。Claude Code 支持热重载，其他工具通常建议关闭并重新启动后再使用。

5. 应用配置

切换配置后，关闭并重新启动对应的 AI 工具，让新配置被重新读取。

工具	切换后建议
Claude Code	通常支持热重载；异常时重启。
Codex / Codex CLI	关闭当前应用或终端会话后重新启动。
Gemini CLI	关闭当前终端会话后重新启动。

完整文档

更多详细配置和高级功能，请查看 CC-Switch 官方文档站。

项目资源

项目	地址
GitHub 仓库	github.com/farion1231/cc-switch
问题反馈	GitHub Issues
最新版本	Releases 页面

开始使用

现在你可以用 CC-Switch 管理多个 AI 编程工具配置：为不同工具创建独立令牌，保存多个中转站配置，并通过托盘或主界面快速切换。