十二、CC switch 使用指南

1安装 Homebrew

Plain TextCopyxxxxxxxxxx1 1/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2验证 Homebrew 安装结果

安装完成后，在终端输入以下命令并回车，验证是否安装成功：

Plain TextCopyxxxxxxxxxx1 1brew -v

正常结果：输出 Homebrew 版本号，无 command not found 报错，即安装成功。

3在终端执行以下命令进行安装claude-code

Plain TextCopyxxxxxxxxxx1 1npm install -g @anthropic-ai/claude-code

异常处理 & 备选方案

安装卡住 / 下载超时

若脚本长时间卡在下载环节、报错连接超时，可按 Control+C 终止当前流程，改用国内镜像一键安装命令（适配国内网络，成功率更高）：

1通过 brew 安装 CC Switch（最终目标）：

依次执行以下 2 条命令，每条命令执行完成后再执行下一条：

执行完成后，即可在 Mac 启动台、应用程序文件夹中找到 CC Switch，直接启动使用。

1主界面顶部是应用切换栏，点击对应图标（Claude Code / Codex / Gemini CLI 等）即可切换当前管理的应用

2点击右上角的 + ，从内置预设中选择自定义模型，手动填写以下信息：

名称：便于区分的备注名

API Key：服务商提供的密钥

Base URL（可选）：https://ai.yunsuguan.com

模型：指定默认使用的模型名称

API 格式：OpenAI Chat Completions 兼容格式

3回顾创建API令牌，在 AI模型平台中创建 CC 分组的令牌，点击复制按钮，复制ApiKey到剪切板

4下拉模态框，找到“API Key”配置项，填入你刚才复制的ApiKey，再点击右下角“添加”按钮

5添加成功后，在主界面会看到我们配置的分组，在右侧点击“启用”按钮，显示“使用中”，则配置完成

6点击左上角“设置”按钮，在通用页面下拉找到跳过 Claude Code初次安装确认，务必勾选

7在终端运行 claude，看到对话界面并能正常回复即表示配置完成

1安装 Claude Code 命令行工具

Claude Code 是一个命令行界面 (CLI) 工具，用于在终端内与 AI 进行交互。

在终端中运行以下命令进行安装：

安装完成后，输入 claude 并回车，若显示 Claude Code 的欢迎界面，则表示安装成功。

2点击下载链接→https://github.com/farion1231/cc-switch/releases←，进入CC-Switch的Github Release页面

3鼠标滚动到最下方选择适合自己版本的安装包，windows系统推荐下载普通msi后缀的安装包进行安装

4安装后运行CC-Switch主程序，界面如下。

5首次打开软件后，点击左上角的“齿轮”图标，进入 CC Switch 的全局设置页面。

6在设置页面的“通用”选项卡中，找到并开启 “应用到 XXX 插件”（例如应用到 Claude Code 插件）开关，这样当你在 CC Switch 切换供应商时，对应的终端工具配置才会生效。你可以顺便开启“开机自启”。

7回到软件主界面，点击右上角的 “+” 加号图标，新建一个 API 供应商配置。

8填写 API 信息

如果你只打算在某个单独的应用中使用（比如只用在 Claude Code），那么直接在弹出的供应商编辑窗口中填写。

供应商名称： GemAPI （可自定义）

官网链接： https://ai.yunsuguan.com （选填）

API Key：填入你在控制台获取的令牌

API 请求地址： https://ai.yunsuguan.com （注意：因为图中使用的是💡 填写兼容 OpenAI Chat Completions 的服务端点地址，不要以斜杠结尾）

模型名称：例如 claude-sonnet-4-6

9保存后在主界面可以看到刚刚配置的模型在使用中

10在终端运行 claude，看到对话界面并能正常回复即表示配置完成