CC Switch - AI CLI 统一管理工具
CC Switch 教程 — 跨平台 AI CLI 管理工具,统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等 AI 编程工具的 Provider 配置、MCP 服务器与系统提示词。对接 88API 一键填入。
🔀 CC Switch 是一款开源、跨平台的桌面工具,可统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、 OpenCode、OpenClaw 等 10 款 AI 编程工具的 Provider 配置、MCP 服务器、系统提示词(Prompts)与 Skills, 并内置 88API 预设(填入 API Key 即可使用),让你在多个 AI 编程助手之间自由切换,无需手动编辑配置文件。
- GitHub 仓库:https://github.com/farion1231/cc-switch
- 下载地址:GitHub Releases
核心特性
🔌 Provider 管理
- 一键切换 — 在 Claude Code、Codex、Gemini 的 API 配置之间一键切换,无需手动修改环境变量或配置文件
- 多端点支持 — 每个 Provider 可配置多个端点,支持 API Key 管理与延迟测速
- Claude 模型映射 — Claude 支持主模型及 Haiku / Sonnet / Opus 默认模型映射
🛠️ MCP 服务器管理
- 跨应用统一管理 — 单面板管理 Claude / Codex / Gemini 三端的 MCP 服务器
- 三种传输类型 — 支持 stdio、HTTP、SSE(Server-Sent Events)
- 自动同步 — 统一导入导出 + 双向同步
💬 Prompts 管理
- 多预设系统提示词 — 无限预设、快速切换
- 跨应用支持 — Claude(
CLAUDE.md)、Codex(AGENTS.md)、Gemini(GEMINI.md) - Markdown 编辑器 — CodeMirror 6 + 实时预览
🌐 多平台支持
- 桌面应用 — Windows、macOS、Linux 原生安装包
- CLI(社区版) — 服务器 / SSH 环境可使用 SaladDay/cc-switch-cli
88API 接入方法
方式一:使用 CC Switch 内置的 88API 预设(推荐)
CC Switch 已内置 88API 预设,API 请求地址和模型都已填好,只需要粘贴 API Key。
-
选择工具并添加供应商 打开 CC Switch,在左侧选择要配置的工具(如 Codex、Claude Code),点击右上角「添加供应商」。
-
选择 88API 预设 在「第三方平台」中找到 88API(也可以在顶部搜索框输入
88API),点击它。如果找不到 88API,请先把 CC Switch 升级到最新版。
-
只填写 API Key 在「API Key」中粘贴在 88API 控制台「API 密钥」页面复制的密钥,然后点击右下角「添加」。名称、官网链接和 API 请求地址都由预设自动填好,不用修改;Codex 的请求地址是
https://api.88api.ai/v1,「完整 URL」保持关闭。
-
启用 88API 回到供应商列表,点击 88API 右侧的 ▶ 按钮启用,状态变为「使用中」即配置完成。

生效方式:Claude Code 立即生效;Codex 和 Gemini CLI 需要重启终端或对应的 CLI,Codex 桌面版需要完全退出后重新打开。
预设自带的 Codex 模型取决于 CC Switch 版本,部分版本为 gpt-5.6-sol(仍可正常使用)。我们推荐点击 88API 右侧的编辑按钮,把模型改为 gpt-6.1-sol。所选模型必须在该密钥的分组中可用。
如果需要不用预设、手动添加供应商,请注意 CC Switch 不会自动补全或去掉 /v1,各工具填写的地址不同:
| 工具 | API 地址 | 推荐模型 |
|---|---|---|
| Claude Code | https://api.88api.ai(不要带 /v1) | claude-sonnet-5-5(Opus 档 claude-opus-5-5,Haiku 档 claude-haiku-5-5) |
| Codex | https://api.88api.ai/v1(必须带 /v1) | gpt-6.1-sol |
| Gemini CLI | https://api.88api.ai(不要带 /v1) | gemini-3.8-flash |
OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 等其他工具也请直接选用内置的 88API 预设。
方式二:从 88API 控制台一键导入
也可以在 88API 控制台把某个 API 密钥一键导入 CC Switch。导入的名称、API 地址和模型与 CC Switch 内置的 88API 预设一致,不需要自己填写。
一键导入支持 Claude Code CLI、Codex、Gemini CLI、Grok Build。Claude Desktop、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 暂不支持一键导入,请用「方式一」添加。
前提:已按下方「安装方式」安装 CC Switch,并至少打开过一次(macOS 需先拖入「应用程序」文件夹再打开),否则浏览器无法唤起
ccswitch://链接。
-
打开导入窗口 在 88API 控制台「API 密钥」页面,点击目标密钥所在行最右侧的「⋯」按钮,选择 CC Switch,弹出「填入 CC Switch」窗口(此时还不会打开 CC Switch 应用)。
-
选择应用并核对信息 在「应用」中选择要导入的工具,窗口会显示导入后的名称(88API)、API 地址、默认模型和这个密钥的分组。


各应用导入的配置如下:
应用 API 地址 默认模型 Claude Code CLI https://api.88api.ai不指定,使用 Claude Code 自身的默认模型(与预设相同) Codex https://api.88api.ai/v1gpt-6.1-solGemini CLI https://api.88api.aigemini-3.8-flashGrok Build https://api.88api.ai/v1grok-4.7- 默认模型只是导入后的初始选择,之后可以改用该密钥分组内的任意模型。
- 请确认密钥分组:Claude Code CLI 需要分组提供 Claude 模型,Codex 需要 GPT 模型,Gemini CLI 需要 Gemini 模型,Grok Build 需要 Grok 模型,否则调用会失败。分组不对时,先在「API 密钥」页面编辑该密钥、更换分组。截图中的分组只是示例。
- 选择 Claude Desktop 时,按钮会变成「复制密钥」:复制后按「方式一」在 CC Switch 的 Claude Desktop 中选择 88API 预设,粘贴密钥并保存。
- 点击「应用」旁的 ⓘ 图标,可以查看其他工具的添加方法。
-
导入并生效 点击「打开 CC Switch」,浏览器询问是否打开 CC Switch 时选择允许。CC Switch 会弹出「确认导入供应商配置」窗口,核对供应商名称(88API)、API 端点和模型,保持「导入后立即切换到这个供应商」开启,然后点击「导入」。点击「取消」则放弃本次操作。
「API 端点」会列出两个地址:标为「主」的
https://api.88api.ai,以及备用的https://88api.ai(Codex 和 Grok Build 末尾都带/v1)。两个地址都可以用,不需要修改。生效方式与「方式一」相同。
用旧版控制台导入过的供应商(名称为 My Claude / My Codex / My Gemini)仍然可以使用;如果想统一,可以在 CC Switch 中删掉旧供应商,改用新导入的 88API。
在 CC Switch 中显示余额
CC Switch 可以在供应商卡片上直接显示 88API 账户的钱包余额(单位 CNY)。在 88API 控制台创建一个访问令牌,再填到 CC Switch 的用量查询里即可。
-
打开用量查询配置 在 CC Switch 中,鼠标移到 88API 卡片上,点击右侧的「⋯」,选择 「配置用量查询」(首次会弹出确认,点击继续)。

-
在 88API 控制台创建访问令牌 登录 88API 控制台,进入左侧 「安全与访问」,在「访问令牌」中点击 「创建访问令牌」。

-
设置名称和权限 「令牌名称」可填
余额查询;「过期时间」按需选择(选择「永不过期」时,令牌在撤销前一直有效,请妥善保管)。「权限」中勾选「个人」下的 个人资料、用量、钱包 三项的 「查看」,不要勾选「编辑」等其他权限,然后点击「创建访问令牌」,复制生成的令牌。
-
查看用户 ID 在控制台左侧进入 「个人资料」,名称旁边显示的 「用户 ID」 就是下一步要填的数字。

-
填写 NewAPI 模板 回到 CC Switch 的「配置用量查询」:打开 「启用用量查询」,预设模板选择 NewAPI,「请求地址」填
https://88api.ai,「访问令牌」粘贴第 3 步复制的令牌,「用户 ID」填第 4 步看到的数字。「自动查询间隔」按需设置(单位为分钟,填 0 不自动查询),然后点击「保存配置」。
-
把单位改成 CNY 保存后卡片会显示余额,但 NewAPI 模板默认把单位写成 USD。88API 的余额是人民币,数字本身是对的,只需要改一下单位。

再次打开「配置用量查询」,向下滚动到脚本,把
unit: "USD"改为unit: "CNY",点击「保存配置」。
卡片会显示「余额 ××× CNY」。

- 访问令牌可以查看账户信息,请勿分享;泄露后可在「安全与访问」中撤销并重新创建。
- 同一个令牌可以用于多个 88API 卡片,每张卡片都要分别配置一次。
小提示:在 CC Switch 的「设置」→「通用」→「额度显示」中,可以选择卡片显示「剩余」或「已用」额度。
安装方式
macOS(推荐 Homebrew)
brew install --cask cc-switchCC Switch 已进入 Homebrew 官方仓库,无需再执行 brew tap farion1231/ccswitch;该第三方 tap 已停止维护,之前添加过的可用 brew untap farion1231/ccswitch 移除。
Windows
从 Releases 下载 .msi 安装包或便携版 .zip。
Linux
从 Releases 下载 .deb、.rpm 或 .AppImage(x86_64 / arm64)。
ArchLinux 用户:
paru -S cc-switch-bin服务器 / SSH 环境(无图形界面)
CC Switch 官方只提供桌面版。服务器或 SSH 远程环境请使用官方 README 推荐的社区命令行版 CC Switch CLI(macOS / Linux):
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bashmacOS 也可使用 brew install cc-switch-cli。命令行版无法使用 88API 控制台的一键导入,请选择内置的 88API 预设,或按上文「方式一」表格中的地址手动填写。
