sub2api 教程中心

这是我们最推荐的无感接入方式。你不必四处寻找文本框也不用理解什么叫 BaseURL，只要一键点击就好。请按下面顺序操作，不要跳过安装版、浏览器和重启检查这三件事。

• 下载并安装客户端版本

  请前往 CC-Switch Releases 页面 下载适合你系统的安装版 / 桌面客户端，例如 Windows 用户优先找 .exe 或 .msi，macOS 用户找 .dmg。不要只打开 GitHub 网页，也不要下载源码压缩包后就以为已经安装完成。安装后手动打开一次 CC-Switch，确认它的窗口或系统托盘图标已经出现，并保持它在后台运行。

• 创建具备明确分组权限的密钥

  在开始前，请先进入我们控制台的 API 密钥 页面。点击界面左上角的【添加新密钥 / 创建密钥】，务必在弹窗中为您将要生成的新接口提供合适的分组（决定了您能使用哪种模型组合）。

• 用系统浏览器执行一键同步

  请使用 Chrome、Edge、Safari、Firefox 等系统浏览器打开控制台，不要用微信自带浏览器、QQ 内置浏览器或其他 App 内嵌网页。内置浏览器经常会拦截 ccs:// 这类本地唤醒链接，表现为点了按钮没有反应。创建密钥后，在你的 API Keys 信息列表旁边找到 【导入到 CCS】 按钮并按下；如果浏览器弹出“是否打开 CC-Switch / 是否允许打开外部应用”，请选择允许。

• 导入失败时完整重启 CCS

  如果点击后没有弹出 CC-Switch、导入列表没有新增配置，或者页面提示导入失败，请先完全退出 CCS再试一次。Windows 用户可以先在右下角系统托盘找到 CC-Switch 图标并选择退出；如果不确定是否真的退出，直接打开任务管理器，把 CC-Switch、CCS 或相关残留进程全部结束。然后重新打开 CC-Switch，等窗口或托盘图标出现后，再回到系统浏览器里点击 【导入到 CCS】。

• 导入成功后完全重启 Codex / 编辑器

  CCS 能自动反向将我们的接口数据推送到你在用的 VSCode、Cursor、Cline、Continue、Codex 等第三方生产力插件中。导入完成后，不要只关掉一个聊天窗口，也不要只刷新插件页面；请完全退出 Codex，或者完全退出承载插件的编辑器，再重新打开。Windows 用户不确定是否退干净时，打开任务管理器，结束 Codex、Code、Cursor、Trae 等相关进程；macOS 用户可以使用 Command + Q 退出应用，必要时在活动监视器里结束残留进程。重开后再发一条简单消息测试是否已经走新配置。

• 原理解构与异常恢复 (非常重要)

  CC-Switch 的核心底层原理是自动为您修改并代理相关插件的 config.toml 或类似的独立配置文件。如果您后续想恢复原来的旧设置或彻底清理隔离，只需前往编辑器里对应插件存放配置的目录下，找到该配置文件直接删除或手动涂改即可。
  
  ⚠️ 记录如何找回与究极破局思路：切换接口可能会导致插件机制变动而让您觉得“以前记录不见了”。别慌，记录本身全盘存在您的电脑本地，不主动删除就永远不可能消失！
  🔑 找回动作：点开 CC-Switch 客户端，在右上角点击【会话管理】按钮。里面留存了所有过往记录，找到你想恢复的那条，直接复制它后面专用的唤醒代码（长得类似这样：codex resume 019d420d-a0e1-76e3-bc5d-f6b647e8325d），在编辑器插件命令行里执行这串代码即可断点接续！
  如果上面这套行不通，发挥最强战力吧：把你的异状或这段 resume 代码喂给 Codex 或豆包等 AI，甩手让大模型直接手把手教你在当前版本下怎样敲脚本抢救回来！

这部分只针对 CC-Switch 里的 Anthropic/Kiro 供应商配置。它仍然使用本站 API 域名：https://api.xxxaicode.com。不要改成 kiro 子域名，不要补 /v1，也不要在末尾加斜杠。

• 请求地址保持 api 域名

  进入 CC-Switch 的供应商编辑页后，请求地址填写当前站点对应的 API 域名。例如本站就是 https://api.xxxaicode.com。这里是兼容 Claude API 的服务端点地址，截图里也明确提示不要以斜杠结尾。

  

• 展开高级选项并确认认证字段

  点击高级选项展开后，认证字段选择 ANTHROPIC_AUTH_TOKEN。这决定 CC-Switch 写入配置时使用哪个环境变量名；选错后 Claude Code 可能拿不到你的密钥。

• 模型映射可以一键获取

  在模型映射区点击获取模型列表，让 CC-Switch 自动读取当前可用模型；如果自动获取失败，再手动填写 Sonnet、Opus、Haiku 的显示名称和实际请求模型。默认兜底模型可填 claude-sonnet-4.6 或管理员指定的默认模型。

  

• 保存后重启 Claude Code

  供应商保存后，完全退出 Claude Code 或承载插件的编辑器再重新打开。只刷新窗口通常不够，因为旧进程可能已经缓存了旧的环境变量或模型映射。

Cherry Studio 是当下最为流行的桌面本地端，能将你所有的 GPT 归集一处管理。设置极其简单，请打开软件跟我一步步“照葫芦画瓢”。

• 找到入口

  在 Cherry Studio 界面左下角点击 ⚙️设置图标，在弹出侧边栏点击 【提供商】(Providers)，然后点击右上角的 ➕添加自定义提供商。

• 类型严格选取

  在弹出的提供商类型选择中，请 **务必** 选择 OpenAI 或 OpenAI Compatible (OpenAI 兼容协议)。我们的接口全程对齐此国际主干道协议。

• 见招拆招：对照填写如下表单

  请将下方深色区域对应的文本无脑复制并贴在你的 Cherry Studio 界面表单中：

  模拟的 Cherry Studio 设置表单界面

  名称 (Name) :

  sub2api

  复制

  API 根地址 :

  https://api.xxxaicode.com/v1

  复制

  API 密钥 (Key) :

  sk-你的真实API-Key

  ----

  避坑指南：API 根地址务必携带 /v1 后缀。如果你发现点刷新拉取不到模型列表，请检查你的网络环境是否拦截请求，最后核对上方的复制文本里面绝对不能含有不小心多加的空格！

网页版的双霸天软件，操作非常类似。只需要重定向 OpenAI 官方的 API 域名到我们这里即可使用。

• 进入设置

  在左下角点击打开【设置】（LobeChat）或【设置 -> 语言模型 -> OpenAI】（NextChat）。

• 填写自定义地址

  打开【自定义接口地址】或【使用代理地址】开关。

  网页端配置项目

  接口代理地址 :

  https://api.xxxaicode.com/v1

  复制

  API Key :

  sk-你的真实API-Key

  ----

  💡 温馨提示：输入这行链接后，如果遇到 404，在 LobeChat 下也可不带 `/v1`，直接填写 `https://api.xxxaicode.com` 后点击保存即可测通连通性。

利用极其便宜的 GPT 模型帮你做网页双语对照翻译的神级插件。消耗 Token 极大，对接我们是降本奇招。

• 定位设置项

  鼠标点击浏览器右上角的【沉浸式翻译】插件图标打开面板 -> 单击左下角【设置】 -> 点击左侧导航【翻译服务】 -> 在服务列表中选择 OpenAI。

• 非常特殊的填写要求

  注意！因为沉浸式插件内置底层请求逻辑的特殊性，它强迫您填写包含最尾端 /chat/completions 的完整端点。请完全参照下表填写：

  请点击左下角按钮展开【更多设置项】后填写

  自定义 API URL :

  https://api.xxxaicode.com/v1/chat/completions

  复制

  API Key :

  sk-你的API-Key

  ----

  自定义模型名字 :

  gpt-5.4-mini

  复制

OpenClaw 是现在最潮的个人 AI 助理框架。跟着指令复制粘贴 3 步起飞！

• 终端执行安装 (推荐 Node 24 环境)

  在你的电脑终端窗口原封不动敲打下边命令（安装过则跳过）：
  npx @openclaw/cli onboard
  碰到系统询问回答 y 或摁下回车耐心等待即可。

• 直接替换配置文件

  使用记事本打开 ~/.openclaw/openclaw.json 文件。把下面的完整片段强行粘进你的 Providers 配置位置里即可。这已经排除了因为名字前缀带来的识别错误，它是一个极度标准的 OpenAI JSON体！
  🚨 关键阻断警报：复制下方代码块粘贴后，请绝对务必要把 "sk-你的-sub2api-key" 这串占位字符，自行修改成你系统里真正拿到的 API 秘钥，否则百分之百会报错！

  ~/.openclaw/openclaw.json 标准覆盖方案 复制整个片段

  {
    "agents": {
      "models": {
        "providers": {
          "openai": {
            "api": "openai-completions",
            "baseUrl": "https://api.xxxaicode.com/v1",
            "apiKey": "sk-你的-sub2api-key",
            "headers": {
              "User-Agent": "OpenClaw/JS 2026.3.28"
            },
            "models": [
              { "id": "gpt-5.4", "contextWindow": 128000 }
            ]
          }
        }
      },
      "defaults": {
        "model": {
          "primary": "gpt-5.4"
        }
      }
    }
  }

  💡 底层原理解密：为什么要添加 headers / User-Agent？
  包括您正在访问的 API 在内，世界主流的高级安全网关或 Cloudflare 会拦截没有正常身份标识的空请求以抵御 DDoS 恶意扫描工具（这是 OpenClaw 报错 403 Forbidden 的元凶）。通过显式注入 User-Agent 头，即可完美伪装成合规浏览器流量，瞬间穿透防火墙！

• 重启与享用

  在终端打入 openclaw gateway restart，然后大摇大摆关掉终端窗口，你已经在 AI 超车道上了。

在 Cursor 和 VSCode 等旗舰级代码编辑器中，我们主推全量使用 **Codex 插件**。因为它可以跟 CC-Switch 完美打通结对，让你不需要每次都陷入手动修改底层参数的泥潭！

• 利用 CCS 自动下盘

  参考顶部的 CC-Switch 教程，当您点击了网站上的“一键导入”之后，CC-Switch 已经神不知鬼不觉地为您把本地电脑里 Codex 的 config.toml 配置文件改成了正确的地址和您的秘钥。

• 退出并重启编辑器 (极其关键)

  很多人配置完了说不生效，因为编辑器还保留着热缓存！请完全退出您的 VSCode 或 Cursor，然后重新打开。重启之后，插件就会顺理成章地装载最新的模型通道，满血开始工作。

• 手工检查防呆（可选）

  如果你信不过自动配置流，或者依然没有反应，你可以手动点开 Codex 插件的高级设置，确保它指向了 https://api.xxxaicode.com/v1 并且使用了正确的我们的 Key。

自己编写爬虫、分析统计程序？完全脱离开 UI 界面的限制！你仅需要给官方的连接库强行写入一个 base_url 环境变量覆写指令。

• Python 环境方案

  from openai import OpenAI
  
  # 第一步就是最核心的操作！
  client = OpenAI(
      api_key="sk-你的真实API-Key",
      base_url="https://api.xxxaicode.com/v1" 
  )
  
  # 剩下的调用一切照旧，不用修改
  response = client.chat.completions.create(
      model="gpt-5.4",
      messages=[
          {"role": "user", "content": "写一个贪吃蛇游戏"}
      ]
  )
  print(response.choices[0].message.content)

• Node.js 环境方案

  import OpenAI from 'openai';
  
  // 初始化客户端时加上 baseURL
  const openai = new OpenAI({
      apiKey: 'sk-你的真实API-Key',
      baseURL: 'https://api.xxxaicode.com/v1',
  });
  
  async function main() {
      const chatCompletion = await openai.chat.completions.create({
          messages: [{ role: 'user', content: 'Say hello to sub2api' }],
          model: 'gpt-5.4',
      });
      console.log(chatCompletion.choices[0].message.content);
  }
  main();

我们专注深耕完全对齐 OpenAI 协议的高端模型。您能使用的模型取决于当前 Key 绑定的确切套餐。目前提供的模型如下表，可以直接复制填入任意上述客户端即可调用：