AIPUT 文档
工具接入

CC Switch

用 CC Switch 一键把 AIPUT 配置到 Claude Code、Codex 等工具。

更新于

模型调用暂未开放

本页内容用于接入准备。调用开放后,请使用你自己的可用 Key,并把示例中的模型占位值换成模型广场中实际开放的型号。

CC Switch 是一个桌面应用,可以集中管理 Claude Code、Codex、OpenCode、OpenClaw、Hermes 等工具的服务商配置,不用手动改配置文件。它会改写这些工具的配置文件;第一次启动时,会把你原有的 Claude Code、Codex 等工具的配置保存为名为 default 的供应商,切换回去即可恢复。

需要哪种接口

取决于你用它配置哪个工具:

  • Claude Code:Anthropic,在模型广场的「端点类型」里选择 Anthropic
  • Codex:Responses,选择 Response
  • OpenCode、OpenClaw、Hermes:普通对话,选择 Chat

开始之前

  1. 完成实名认证,认证通过后重新登录一次。
  2. 在主站「API 密钥」页面创建一把 Key,复制并妥善保存。
  3. 在模型广场的「端点类型」筛选里选择 Chat(窄屏时点“筛选”按钮),从列出的模型中复制模型 ID。

上面第 3 步按你要配置的工具选择对应的「端点类型」。另外需要先安装好 CC Switch。

方式一:从控制台一键导入

  1. 打开主站「API 密钥」页面,在要使用的 Key 右侧打开操作菜单,选择 CC Switch。
  2. 在弹出的"填入 CC Switch"窗口中,选择要配置的应用(Claude 即 Claude Code,或 Codex),并选好模型。
  3. 点击 打开 CC Switch。浏览器会询问是否打开 CC Switch,确认后,在 CC Switch 的确认框里核对信息并导入。
  4. 在 CC Switch 中启用这个供应商。Claude Code 不用重启;Codex 需要重新打开终端。

一键导入填入的地址是 https://aiput.top,和 https://api.aiput.top 一样可以使用。导入链接里带有你的 Key,不要把它发给别人。

方式二:在 CC Switch 中手动添加

选择工具

在 CC Switch 侧栏中,选择要配置的工具。

添加供应商

点击页面右上角的 添加供应商(带 + 号),选择 自定义配置。

填写地址、Key 和模型

  • 请求地址:Claude Code 填 https://api.aiput.top,Codex、OpenCode 等填 https://api.aiput.top/v1
  • API Key:你的 AIPUT Key
  • 模型:模型广场里的模型 ID

填好后点击页脚的 添加。

启用

在供应商卡片上点击 启用(OpenCode、OpenClaw、Hermes 等可同时添加多个供应商的工具,按钮是"添加")。

让只支持普通对话的模型也能给 Codex 用

Codex 只支持 Responses 格式。CC Switch 提供"本地路由",可以在你的电脑上把请求转换成普通对话格式,再发给 AIPUT。这项功能由 CC Switch 提供,开启方法和限制以 CC Switch 官方说明为准。

怎样确认配置成功

启用后打开对应的工具,发一句简短的问题,能收到回复就说明配置成功。各工具自身的检查方法,见对应的工具页面,例如 Claude Code。

常见问题

现象处理
点击"打开 CC Switch"没有反应确认已安装 CC Switch,并允许浏览器打开它
工具仍在用旧的服务商在 CC Switch 中确认 AIPUT 已启用;Codex 需要重新打开终端
想恢复原来的配置在 CC Switch 中切换回 default 或官方供应商

本页按 2026 年 10 月的 CC Switch 版本编写,界面和配置项可能随版本变化,以 CC Switch 官方说明为准。CC Switch 的名称和商标归其所有者所有,这里只表示兼容。