88API88API
使用指南AI 应用API 文档帮助支持

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 编程助手之间自由切换,无需手动编辑配置文件。

核心特性

🔌 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。

  1. 选择工具并添加供应商 打开 CC Switch,在左侧选择要配置的工具(如 Codex、Claude Code),点击右上角「添加供应商」。

  2. 选择 88API 预设 在「第三方平台」中找到 88API(也可以在顶部搜索框输入 88API),点击它。如果找不到 88API,请先把 CC Switch 升级到最新版。

    在 CC Switch 预设中选择 88API

  3. 只填写 API Key 在「API Key」中粘贴在 88API 控制台「API 密钥」页面复制的密钥,然后点击右下角「添加」。名称、官网链接和 API 请求地址都由预设自动填好,不用修改;Codex 的请求地址是 https://api.88api.ai/v1,「完整 URL」保持关闭。

    在 88API 预设中填写 API Key

  4. 启用 88API 回到供应商列表,点击 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 Codehttps://api.88api.ai(不要带 /v1)claude-sonnet-5-5(Opus 档 claude-opus-5-5,Haiku 档 claude-haiku-5-5)
Codexhttps://api.88api.ai/v1(必须带 /v1)gpt-6.1-sol
Gemini CLIhttps://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:// 链接。

  1. 打开导入窗口 在 88API 控制台「API 密钥」页面,点击目标密钥所在行最右侧的「⋯」按钮,选择 CC Switch,弹出「填入 CC Switch」窗口(此时还不会打开 CC Switch 应用)。

  2. 选择应用并核对信息 在「应用」中选择要导入的工具,窗口会显示导入后的名称(88API)、API 地址、默认模型和这个密钥的分组。

    填入 CC Switch 窗口:选择 Claude Code CLI

    填入 CC Switch 窗口:选择 Codex

    各应用导入的配置如下:

    应用API 地址默认模型
    Claude Code CLIhttps://api.88api.ai不指定,使用 Claude Code 自身的默认模型(与预设相同)
    Codexhttps://api.88api.ai/v1gpt-6.1-sol
    Gemini CLIhttps://api.88api.aigemini-3.8-flash
    Grok Buildhttps://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 预设,粘贴密钥并保存。
    • 点击「应用」旁的 ⓘ 图标,可以查看其他工具的添加方法。
  3. 导入并生效 点击「打开 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 的用量查询里即可。

  1. 打开用量查询配置 在 CC Switch 中,鼠标移到 88API 卡片上,点击右侧的「⋯」,选择 「配置用量查询」(首次会弹出确认,点击继续)。

    在 CC Switch 的 88API 卡片菜单中选择配置用量查询

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

    在安全与访问页面点击创建访问令牌

  3. 设置名称和权限 「令牌名称」可填 余额查询;「过期时间」按需选择(选择「永不过期」时,令牌在撤销前一直有效,请妥善保管)。「权限」中勾选「个人」下的 个人资料、用量、钱包 三项的 「查看」,不要勾选「编辑」等其他权限,然后点击「创建访问令牌」,复制生成的令牌。

    创建访问令牌:填写名称并勾选查看权限

  4. 查看用户 ID 在控制台左侧进入 「个人资料」,名称旁边显示的 「用户 ID」 就是下一步要填的数字。

    在个人资料页查看用户 ID

  5. 填写 NewAPI 模板 回到 CC Switch 的「配置用量查询」:打开 「启用用量查询」,预设模板选择 NewAPI,「请求地址」填 https://88api.ai,「访问令牌」粘贴第 3 步复制的令牌,「用户 ID」填第 4 步看到的数字。「自动查询间隔」按需设置(单位为分钟,填 0 不自动查询),然后点击「保存配置」。

    选择 NewAPI 模板并填写请求地址、访问令牌和用户 ID

  6. 把单位改成 CNY 保存后卡片会显示余额,但 NewAPI 模板默认把单位写成 USD。88API 的余额是人民币,数字本身是对的,只需要改一下单位。

    NewAPI 模板默认单位显示为 USD

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

    在脚本中把 unit 改为 CNY

    卡片会显示「余额 ××× CNY」。

    88API 卡片显示人民币余额

  • 访问令牌可以查看账户信息,请勿分享;泄露后可在「安全与访问」中撤销并重新创建。
  • 同一个令牌可以用于多个 88API 卡片,每张卡片都要分别配置一次。

小提示:在 CC Switch 的「设置」→「通用」→「额度显示」中,可以选择卡片显示「剩余」或「已用」额度。

CC Switch 设置中的额度显示选项

安装方式

macOS(推荐 Homebrew)

brew install --cask cc-switch

CC 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 | bash

macOS 也可使用 brew install cc-switch-cli。命令行版无法使用 88API 控制台的一键导入,请选择内置的 88API 预设,或按上文「方式一」表格中的地址手动填写。

相关链接