CC-Switch 是一款用于在 Mac 上一键管理和切换 AI 模型（Claude / GPT / GLM 等）API 配置的图形化工具。以下是完整的安装、设置与使用指南：

一、安装（两种方法）

方法 1：Homebrew 安装（推荐）

打开「终端」，依次执行：

bash

运行

# 添加软件源
brew tap farion1231/ccswitch

# 安装
brew install --cask cc-switch

# 以后更新
brew upgrade --cask cc-switch

方法 2：手动下载 DMG

1. 前往 GitHub Releases 下载最新 .dmg：https://github.com/farion123/cc-switch/releases
2. 打开 DMG → 将 CC-Switch.app 拖入「应用程序」。

---

二、首次打开（解决「无法验证开发者」）

1. 右键点 CC-Switch.app → 打开
2. 如仍被拦截：
   • 打开 系统设置 → 隐私与安全性
   • 找到「cc-switch 被阻止」→ 点 仍要打开

---

三、使用流程

1. 启动与界面

• 启动后在顶部菜单栏出现图标 🚦
• 点击图标打开面板

2. 添加 API 配置（Add Provider）

支持：Claude、GLM、OpenAI、Gemini、自定义等。以 Claude 为例：

• 类型：选 Claude Code
• 名称：自定义（如 claude-sonnet）
• API Key：填入你的 sk-xxx
• API 地址（可选）：官方或中转地址
• 保存

3. 一键切换

• 点击面板中任一配置 → Enable
• 或直接在菜单栏图标快速切换

4. 让配置生效（关键）

切换后必须重启终端 / IDE，AI CLI 才会读取新环境变量。

5. 快捷键（可选）

默认：Shift + Cmd + C可在设置中修改。

---

四、常见问题

• 切换不生效：重启终端 / VSCode 再试
• API 报错：检查 Key、网络、地址是否正确
• 卸载

  bash

  运行

  brew uninstall --cask cc-switch
  

---

五、前提条件

• 已安装对应 AI CLI（如 claude/aichat）
• 有可用 API Key
• macOS 10.15+ / Apple Silicon & Intel