通用步骤

CC-Switch 简介

Claude Code / Codex / Gemini CLI 全方位辅助工具。

• 版本：3.7.x，以 GitHub 最新 Release 为准
• 平台：Windows / macOS / Linux
• 技术栈：Tauri 2 桌面应用

CC-Switch 可以统一管理 Claude Code、Codex 与 Gemini CLI 的供应商配置、MCP 服务器、Skills 扩展和系统提示词。

TIP

如果内置模板没有 aivoyz，选择 自定义，再手动填写 https://api.52hertz-palpitate.cn/v1。

软件下载

Windows

1. 访问 GitHub Release 页面：farion1231/cc-switch。
2. 选择 .msi 后缀安装包。
3. 双击运行安装程序。
4. 安装完成后从开始菜单启动 CC-Switch。

macOS（推荐 Homebrew）

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

也可以从 GitHub Releases 下载 .dmg 手动安装。

Linux（Debian / Ubuntu）

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb

把文件名中的 x.x.x 替换为实际最新版本号。

桌面版使用前检查

如果你是经验用户，并且已经确认 Node.js 与各 CLI 都安装无误，可以跳过本节。否则建议先完成以下检查。

环境检查要做三件事：

1. 确认 Node.js 已安装。
2. 装好 Claude Code / Codex / Gemini 三个 CLI。
3. 让每个 CLI 至少运行一次，在用户目录生成配置文件夹，后续 CC-Switch 才能写入。

检查 Node.js

node -v
npm -v

检查 CLI

claude --version
codex --version
gemini --version

生成初始配置目录

claude
codex
gemini

每个 CLI 进入交互或输出配置提示即可退出。

桌面版主界面

打开 CC-Switch 后，重点关注三个区域：

区域	用途
顶部分组条	在 Claude、Codex、Gemini 之间切换配置对象。
供应商卡片	添加、编辑、启用不同供应商配置。
Settings	调整通用设置，例如是否跳过首次安装确认。

后续页面都会按这个图形界面流程说明，不需要使用 CC-Switch 命令行。

接下来

按顺序继续配置：

1. Claude Code 配置
2. Codex 配置
3. Gemini 配置