教程文档 - Vibe SubsAPI

配置总览

Vibe-SUBSAPI 是给开发工具填写的 API 接口，不是单独的聊天网页。新手只要按顺序填好 Base URL、API Key 和模型名，就能让工具通过我们的中转站调用模型。

支持的工具

命令行工具：Claude Code、OpenCode、Codex、Aider。
VS Code 插件：Continue、Cline、Cody 等支持自定义端点的插件。
独立编辑器：Cursor、Windsurf。
桌面客户端：Cherry Studio、Chatbox、NextChat。
AI 框架：OpenClaw、Hermes。

快速开始

注册或登录 Vibe-SUBSAPI。
充值或兑换，确认余额可用。
进入 API Key 页面，创建并复制密钥。
选择你要用的工具，按对应教程填写配置。
先发一句短问题测试，再开始正式任务。

注册账号并获取 API Key

这一步只确认三件事：能登录、余额可用、Key 能复制。API Key 只给自己的工具使用，不要发到群里、截图里或公开仓库。

1

打开官网

访问 https://vibe-subsapi.com，点击右上角“开始接入”，进入注册或登录页面。

2

确认余额

进入充值或兑换页面，确认余额到账后再继续配置工具。余额不足时请求会直接失败。

3

创建 API Key

进入控制台的 API Key 页面，新建一个密钥。建议按用途命名，例如 claude-code-mac 或 cursor-work。

4

复制并保存

密钥通常只展示一次。复制后保存到本机密码管理器或环境变量，不要写进前端代码。

Base URL 规则

大多数接入失败不是模型坏了，而是 Base URL、API Key、模型名或协议类型填错。先按下面这张表填。

工具类型	填写内容	适用场景
OpenAI Compatible	`https://api.vibe-subsapi.com`	OpenAI 兼容工具。
Anthropic Compatible	`https://api.vibe-subsapi.com`	Claude 工具链。
OpenAI API 密钥	`你的 API 密钥`	OpenAI 工具。
Claude API 密钥	`你的 API 密钥`	Claude 工具。

常用模型名

claude-opus-4.6
claude-opus-4.7
chatgpt-5.5
模型名必须按控制台展示复制，不要自己改大小写或符号。

curl · 最小测试

curl https://api.vibe-subsapi.com/chat/completions \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chatgpt-5.5",
    "messages": [
      {"role": "user", "content": "你好，简单回复一句"}
    ]
  }'

多个模型怎么配

大多数工具可以同时添加多个模型。
Name / Title 只是显示名，可以写得好认一点。
Provider、Base URL、Model 三项要匹配协议。
Claude 模型走 Anthropic；ChatGPT 模型走 OpenAI Compatible。

通用模型配置示例

{
  "models": [
    {
      "name": "Vibe Claude Opus 4.7",
      "provider": "anthropic",
      "model": "claude-opus-4.7",
      "apiKey": "你的API密钥",
      "apiBase": "https://api.vibe-subsapi.com"
    },
    {
      "name": "Vibe ChatGPT 5.5",
      "provider": "openai",
      "model": "chatgpt-5.5",
      "apiKey": "你的API密钥",
      "apiBase": "https://api.vibe-subsapi.com"
    }
  ]
}

应用下载

这里先解决“去哪下载、该选哪个文件”。安装后的 Base URL、API Key 和模型配置继续看后面的对应章节。

安全下载 只用官方页面、官方文档或 GitHub Release。不要从搜索广告、镜像站、网盘转发包下载安装。

01

基础环境及依赖

只放底层运行环境。Node.js 负责运行命令行工具，Git 负责代码拉取和 Windows Bash 环境；优先复制对应系统的一行命令。

Node.js:

Windows PowerShell

$ver=(Invoke-RestMethod https://nodejs.org/dist/index.json | Where-Object { $_.lts -ne $false } | Select-Object -First 1).version; curl.exe -L "https://nodejs.org/dist/$ver/node-$ver-x64.msi" -o "$env:USERPROFILE\Downloads\node-$ver-x64.msi"

macOS Bash / Zsh

ver=$(curl -fsSL https://nodejs.org/dist/index.json | sed -n 's/.*"version":"\([^"]*\)".*"lts":"[^"]*".*/\1/p' | head -n 1); curl -L "https://nodejs.org/dist/$ver/node-$ver.pkg" -o "$HOME/Downloads/node-$ver.pkg"

Linux Bash

ver=$(curl -fsSL https://nodejs.org/dist/index.json | sed -n 's/.*"version":"\([^"]*\)".*"lts":"[^"]*".*/\1/p' | head -n 1); arch=$(uname -m); case "$arch" in x86_64) platform=linux-x64;; aarch64|arm64) platform=linux-arm64;; *) echo "Unsupported arch: $arch"; exit 1;; esac; curl -L "https://nodejs.org/dist/$ver/node-$ver-$platform.tar.xz" -o "$HOME/Downloads/node-$ver-$platform.tar.xz"

Git:

Windows PowerShell

$url=([regex]::Match((Invoke-WebRequest -UseBasicParsing https://git-scm.com/install/windows).Content,'href="([^"]*/Git-[^"]*-64-bit\.exe)"')).Groups[1].Value; curl.exe -L $url -o "$env:USERPROFILE\Downloads\$(Split-Path $url -Leaf)"

macOS Bash / Zsh

xcode-select --install

Linux Bash

if command -v apt >/dev/null 2>&1; then sudo apt update && sudo apt install -y git; elif command -v dnf >/dev/null 2>&1; then sudo dnf install -y git; elif command -v yum >/dev/null 2>&1; then sudo yum install -y git; elif command -v pacman >/dev/null 2>&1; then sudo pacman -Sy --needed git; elif command -v zypper >/dev/null 2>&1; then sudo zypper install -y git; else echo "请打开 https://git-scm.com/downloads 按系统安装 Git"; fi

JS Node.js 官方下载页不会用命令行时，从这里手动下载安装包。 打开 GT Git 官方下载页Windows 下载安装包；macOS / Linux 按官方系统方式安装。 打开

02

代码编辑器 / IDE

适合直接打开项目、写代码和安装插件。

VS VS Code通用代码编辑器，插件生态最完整。 下载 CU Cursor自带 AI 能力的代码编辑器。 下载

03

编辑器插件 / 编程助手

适合已经在 VS Code 或 Cursor 里工作，只想加一个编程代理插件。

CL ClineVS Code / Cursor 编程代理。 安装 CT ContinueOpenAI 兼容编程助手插件。 安装

04

终端编程代理

安装方式和配置更新较快，这里只放官方文档入口；Vibe SubsAPI 接入方式看后面的专门章节。

CC Claude CodeAnthropic 终端编程代理。 文档 CX Codex CLIOpenAI Codex 命令行工具。 文档 OC OpenCode终端 AI 编程代理。 文档 GM Gemini CLIGoogle Gemini 命令行工具。 GitHub

05

桌面端 AI 工作台

适合想用图形界面完成聊天、项目操作或本地工作流的人。

CD Claude DesktopClaude 官方桌面客户端。 下载 XD Codex DesktopOpenAI Codex 桌面入口。 打开 OD OpenCode DesktopOpenCode 官方入口。 打开

06

API 客户端 / 聊天调试工具

适合填 Base URL 和 API Key，测试模型、聊天和调试接口。

CS Cherry StudioOpenAI Compatible 桌面客户端。 下载 CB Chatbox桌面 / 移动 AI 客户端。 下载 NC NextChat网页聊天客户端。 GitHub

07

配置与切换工具

这里只放真正负责 Key、Base URL 和多工具配置切换的工具。CC Switch 下载文件按当前 Release 文件名选择，不写死版本号。

WINWindows 安装版选 CC-Switch-*-Windows.msi

ZIPWindows 免安装选 CC-Switch-*-Windows-Portable.zip

MACmacOS选 CC-Switch-*-macOS.dmg

APPLinux 通用版选 CC-Switch-*-Linux-x86_64.AppImage

DEBUbuntu / Debian选 CC-Switch-*-Linux-x86_64.deb

RPMFedora / RHEL / openSUSE选 CC-Switch-*-Linux-x86_64.rpm

只有 ARM Linux 设备才选文件名里带 Linux-arm64 的版本。.sig 是签名校验文件，Source code 不是安装包，新手都不用下载。

准备 Node.js

Claude Code、OpenCode、Codex 等命令行工具通常需要 Node.js。新手建议安装 Node.js 20 LTS 或更高版本，安装后重开终端再检查版本。

检查版本

node -v
npm -v

# 国内网络慢时可切换 npm 镜像
npm config set registry https://registry.npmmirror.com
npm config get registry

# 安装异常时切回官方源
npm config set registry https://registry.npmjs.org
npm config get registry

系统建议

macOS / Linux：直接用系统终端。
Windows：优先使用 WSL2，兼容性更稳。
如果必须用 Windows 原生命令行，建议使用 PowerShell 7 或 Windows Terminal。
如果命令提示找不到 npm，先重启终端。
如果切换镜像后安装异常，切回官方 npm 源再试。
不要在不清楚权限含义时反复使用 sudo npm install -g。

准备 Git

Git 负责拉取代码、管理项目版本，也会影响 VS Code、Claude Code、Codex 等工具识别项目状态。新手安装后重开终端，再检查版本。

检查版本

git --version

# 常用身份配置
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

# 检查配置
git config --global --list

系统建议

macOS：优先用 xcode-select --install 安装命令行工具。
Linux：优先使用系统包管理器安装 Git。
Windows：安装 Git for Windows，并勾选加入 PATH。
如果 VS Code 或命令行提示找不到 git，先重启终端或 VS Code。
不要在不清楚项目状态时随意执行 git reset --hard。

Windows PowerShell

winget install --id Git.Git -e
git --version

macOS / Linux

# macOS
xcode-select --install

# Ubuntu / Debian
sudo apt update
sudo apt install -y git

git --version

Claude Code 终端版

Claude Code 适合写代码、改项目和跑长任务。新手先用环境变量配置，跑通后再考虑图形化切换工具。

写入配置前先看这里

Claude Code 主要读取三个环境变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。
ANTHROPIC_BASE_URL 固定写 https://api.vibe-subsapi.com，不要加 /v1。
ANTHROPIC_AUTH_TOKEN 填 Vibe 控制台生成的 API 密钥，不是 Claude 官方账号密码。
Windows 下面的 PowerShell 命令会写入当前用户环境变量；执行后必须关闭旧终端，重新打开一个新终端才会生效。
macOS / Linux / WSL2 下面临时执行 export，只对当前终端窗口生效。
想长期生效，把同样三行保存到 shell 配置文件里。常见位置： ~/.zshrc~/.bashrc~/.bash_profile

安装

npm install -g @anthropic-ai/claude-code
claude --version

macOS / Linux / WSL2

export ANTHROPIC_BASE_URL="https://api.vibe-subsapi.com"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export ANTHROPIC_MODEL="claude-opus-4.7"

cd /path/to/your-project
claude

macOS / Linux 长期保存

如果你用的是 macOS 默认终端，通常把三行 export 保存到 ~/.zshrc。
如果你用的是 bash，通常保存到 ~/.bashrc 或 ~/.bash_profile。
保存后运行 source ~/.zshrc 或重新打开终端，再执行 claude。

Windows PowerShell

[Environment]::SetEnvironmentVariable(
  "ANTHROPIC_BASE_URL",
  "https://api.vibe-subsapi.com",
  "User"
)
[Environment]::SetEnvironmentVariable(
  "ANTHROPIC_AUTH_TOKEN",
  "你的API密钥",
  "User"
)
[Environment]::SetEnvironmentVariable(
  "ANTHROPIC_MODEL",
  "claude-opus-4.7",
  "User"
)

验证方式

终端进入一个测试项目目录。
输入 claude 启动。
让它回答一句话或解释一个小文件。
如果 401，先检查 Key；如果 404，先检查模型名和 Base URL。
开始正式任务前，可以输入 /cost 看当前会话用量。

Claude 桌面 App

桌面版适合日常对话和轻量代码任务。配置前先完整退出 App，再改本机 JSON 配置；不要在 App 运行时直接覆盖文件。

准备步骤

从 Claude 官方下载页安装桌面 App。
先用 Vibe 控制台创建一个专门给桌面 App 使用的 Key。
确认当前网络能访问 Claude 首次启动需要的 workspace 资源。
修改配置前先备份原来的配置文件。

要写入哪几个文件

claude_desktop_config.json 用来告诉 Claude Desktop 进入本地 3P 配置模式。
configLibrary/_meta.json 用来指定当前启用哪一份网关配置。
UUID 网关配置文件才是填写 Vibe Base URL、API 密钥和可用模型的地方。
configLibrary/00000000-0000-4000-8000-000000000001.json
_meta.json 里的 appliedId 必须和第三个 JSON 文件名一致；新手不要改这串 UUID。
如果原来已经有这些文件，先复制一份备份，再按教程覆盖；不要把 Vibe API 密钥填进 Claude 官方登录页。

Windows

左侧点击 Windows，查看 Windows 专用配置文件和启动验证步骤。
当前推荐使用 C:\Users\你的用户\AppData\Local\Claude-3p 下的三文件配置方式。

macOS / Linux

左侧点击 macOS / Linux，查看对应配置目录说明。
目录结构和 Windows 一致，但基础路径不同。

Claude 桌面 App · Windows

Windows 版使用本机 Claude-3p 配置目录。先完全退出 Claude App，再写入下面三个文件。

配置步骤

打开任务管理器，确认所有 Claude 进程都已经结束。
按 Win + R，输入 %LOCALAPPDATA%\Claude-3p 打开配置目录；如果提示不存在，就手动创建这个目录。
在 Claude-3p 目录下创建 configLibrary 子目录。
打开资源管理器的“查看”，勾选“文件扩展名”，避免保存成 .json.txt。
按下面三个路径分别新建 JSON 文件，复制对应代码块内容粘贴进去。
只把 你的API密钥 替换成 Vibe 控制台创建的 Key，其它字段先不要改。

PowerShell 创建并打开三个文件

New-Item -ItemType Directory -Force "$env:LOCALAPPDATA\Claude-3p\configLibrary"
notepad "$env:LOCALAPPDATA\Claude-3p\claude_desktop_config.json"
notepad "$env:LOCALAPPDATA\Claude-3p\configLibrary\_meta.json"
notepad "$env:LOCALAPPDATA\Claude-3p\configLibrary\00000000-0000-4000-8000-000000000001.json"

粘贴时注意

每个文件只粘贴它下面对应的代码块，不要把文件路径也粘进 JSON 里。
JSON 必须使用英文双引号，最后一行不要多逗号。
第三个文件里的 inferenceGatewayApiKey 才需要改成你的 API 密钥。
保存三个文件后再启动 Claude Desktop；如果已经打开过 Claude，需要完全退出后重新打开。

C:\Users\你的用户\AppData\Local\Claude-3p\claude_desktop_config.json

claude_desktop_config.json

{
  "deploymentMode": "3p",
  "_cfprefsMigrated": true
}

C:\Users\你的用户\AppData\Local\Claude-3p\configLibrary\_meta.json

configLibrary\_meta.json

{
  "appliedId": "00000000-0000-4000-8000-000000000001",
  "entries": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "name": "Vibe-SUBSAPI",
      "provider": "gateway",
      "note": "local config"
    }
  ],
  "isManaged": false,
  "platform": "win32"
}

C:\Users\你的用户\AppData\Local\Claude-3p\configLibrary\00000000-0000-4000-8000-000000000001.json

configLibrary\00000000-0000-4000-8000-000000000001.json

{
  "inferenceProvider": "gateway",
  "inferenceGatewayBaseUrl": "https://api.vibe-subsapi.com",
  "inferenceGatewayApiKey": "你的API密钥",
  "inferenceGatewayAuthScheme": "bearer",
  "inferenceModels": [
    "claude-opus-4-6",
    "claude-sonnet-4-6"
  ],
  "deploymentOrganizationUuid": "00000000-0000-4000-8000-000000000001",
  "disableDeploymentModeChooser": true,
  "disableAutoUpdates": true,
  "disableNonessentialServices": true,
  "disableNonessentialTelemetry": true,
  "disableEssentialTelemetry": true
}

启动验证

保存配置文件后重新启动 Claude App。
如果看到 Code 可以进入，说明 3P 配置已被读取。
如果仍显示网络错误，优先检查网关是否兼容 Claude 的 /v1/messages 接口。
如果仍走官方登录链路，重新检查 _meta.json 的 appliedId 和配置文件名是否一致。

Virtual Machine Platform 是什么

Virtual Machine Platform 是 Windows 的虚拟化组件，用来让本机虚拟机、轻量容器或工作区环境正常启动。
Claude Desktop 的 Code / Cowork 工作区在 Windows 上可能会依赖它；它不是 API 密钥、不是 Base URL，也不是模型名称，不需要写进上面的 JSON 配置。
只有在 Claude 提示缺少虚拟机能力、workspace 启动失败，或 Windows 明确提示需要 Virtual Machine Platform 时再开启；如果 Claude 已经能正常使用，不需要反复执行。
开启后必须重启电脑，然后再重新打开 Claude Desktop。

图形界面开启

按 Windows 键搜索 启用或关闭 Windows 功能 并打开。
勾选 Virtual Machine Platform。
如果之后仍提示缺少虚拟化组件，再勾选 Windows Hypervisor Platform。
点击确定，等待 Windows 安装完成后重启电脑。
如果系统提示虚拟化不可用，需要进入 BIOS / UEFI 开启 Intel VT-x 或 AMD-V。

管理员 PowerShell

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:HypervisorPlatform /all /norestart
bcdedit /set hypervisorlaunchtype auto
shutdown /r /t 0

Claude 桌面 App · macOS / Linux

macOS / Linux 版同样使用本机 Claude-3p 配置目录。先完全退出 Claude App，再写入下面三个文件。

配置步骤

完全退出 Claude App；macOS 可在活动监视器确认没有 Claude 进程，Linux 可用系统监视器或 ps 检查。
按自己的系统打开本机 Claude-3p 配置目录；没有就手动创建。
在配置目录下创建 configLibrary 子目录。
按下面三个文件分别写入配置，把 你的API密钥 换成 Vibe 控制台创建的 Key。
macOS 路径里有空格，终端命令必须给路径加引号；Linux 路径没有空格，但文件名也必须完全一致。

配置目录

macOS:
~/Library/Application Support/Claude-3p

Linux:
~/.config/Claude-3p

创建目录

# macOS
mkdir -p "$HOME/Library/Application Support/Claude-3p/configLibrary"

# Linux
mkdir -p "$HOME/.config/Claude-3p/configLibrary"

打开三个文件写入配置

# macOS
open -a TextEdit "$HOME/Library/Application Support/Claude-3p/claude_desktop_config.json"
open -a TextEdit "$HOME/Library/Application Support/Claude-3p/configLibrary/_meta.json"
open -a TextEdit "$HOME/Library/Application Support/Claude-3p/configLibrary/00000000-0000-4000-8000-000000000001.json"

# Linux
nano "$HOME/.config/Claude-3p/claude_desktop_config.json"
nano "$HOME/.config/Claude-3p/configLibrary/_meta.json"
nano "$HOME/.config/Claude-3p/configLibrary/00000000-0000-4000-8000-000000000001.json"

粘贴时注意

每个文件只粘贴它下面对应的代码块，路径说明不要粘进 JSON 内容里。
macOS 的 platform 写 darwin，Linux 的 platform 写 linux。
第三个文件里的 inferenceGatewayApiKey 才需要替换成你的 Vibe API 密钥。
保存后完全退出并重新打开 Claude Desktop。

claude_desktop_config.json

macOS:
~/Library/Application Support/Claude-3p/claude_desktop_config.json

Linux:
~/.config/Claude-3p/claude_desktop_config.json

{
  "deploymentMode": "3p",
  "_cfprefsMigrated": true
}

configLibrary/_meta.json

macOS:
~/Library/Application Support/Claude-3p/configLibrary/_meta.json

Linux:
~/.config/Claude-3p/configLibrary/_meta.json

{
  "appliedId": "00000000-0000-4000-8000-000000000001",
  "entries": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "name": "Vibe-SUBSAPI",
      "provider": "gateway",
      "note": "local config"
    }
  ],
  "isManaged": false,
  "platform": "darwin"
}

platform 字段

macOS 使用 "platform": "darwin"。
Linux 使用 "platform": "linux"。
如果 App 提示的实际配置目录不同，以 App 提示的目录为准，但文件名和内容保持一致。

configLibrary/00000000-0000-4000-8000-000000000001.json

macOS:
~/Library/Application Support/Claude-3p/configLibrary/00000000-0000-4000-8000-000000000001.json

Linux:
~/.config/Claude-3p/configLibrary/00000000-0000-4000-8000-000000000001.json

{
  "inferenceProvider": "gateway",
  "inferenceGatewayBaseUrl": "https://api.vibe-subsapi.com",
  "inferenceGatewayApiKey": "你的API密钥",
  "inferenceGatewayAuthScheme": "bearer",
  "inferenceModels": [
    "claude-opus-4-6",
    "claude-sonnet-4-6"
  ],
  "deploymentOrganizationUuid": "00000000-0000-4000-8000-000000000001",
  "disableDeploymentModeChooser": true,
  "disableAutoUpdates": true,
  "disableNonessentialServices": true,
  "disableNonessentialTelemetry": true,
  "disableEssentialTelemetry": true
}

启动验证

保存三个配置文件后重新启动 Claude App。
如果看到 Code 可以进入，说明 3P 配置已被读取。
如果仍显示网络错误，优先检查网关是否兼容 Claude 的 /v1/messages 接口。
如果仍走官方登录链路，重新检查 _meta.json 的 appliedId 和 UUID 配置文件名是否一致。

首次启动

首次如果卡在 workspace 初始化，先切换到能正常下载资源的网络。
完成一次初始化后，再回到常用网络。
不要把 Vibe 的 API Key 填到 Claude 官方登录流程里。

Claude VS Code 插件

Claude Code for VS Code 是 Anthropic 官方插件，适合在编辑器里直接让 Claude 读代码、改文件和执行开发任务。先安装插件，再写入 Claude Code 的本机配置文件。

安装插件

打开 VS Code 左侧扩展面板。
搜索 claude。
选择 Claude Code for VS Code，发布者应为 Anthropic。
点击 Install 安装，安装后重启 VS Code。

配置方式

Claude VS Code 插件和 Claude Code 终端版共用 ~/.claude/settings.json。
Windows 和 macOS / Linux 只是配置文件路径不同，JSON 内容相同。
把 你的API密钥 换成 Vibe 控制台创建的 Key。
不要把 Vibe 的 API Key 填到 Claude 官方登录流程里。
如果 settings.json 已经有内容，不要直接整文件覆盖；只添加或替换里面的 env 配置块。

VS Code 扩展市场搜索 Claude 并安装 Claude Code for VS Code — 1
**在扩展市场安装 Claude Code** 左侧点击扩展图标，搜索 `claude`，选择 Anthropic 发布的 `Claude Code for VS Code`，点击 `Install`。

Claude VS Code 插件 · Windows

Windows 版先安装 VS Code 插件，再修改当前用户目录下的 Claude Code 配置文件。保存后重启 VS Code，让插件读取新配置。

配置步骤

关闭所有 VS Code 窗口，避免旧插件进程继续使用旧配置。
打开 C:\Users\你的用户\.claude；没有就手动创建。
新建或编辑 settings.json。
写入下面内容，把 你的API密钥 换成 Vibe 控制台创建的 Key。

settings.json 怎么写

如果文件是空的，直接粘贴下面完整 JSON。
如果文件里已经有其它设置，保留原内容，只在最外层对象里添加或替换 "env": { ... }。
如果已经存在 env，只替换 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 这三项。
保存后关闭所有 VS Code 窗口，再重新打开项目。

PowerShell 创建目录

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

配置文件路径

C:\Users\你的用户\.claude\settings.json

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.vibe-subsapi.com",
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_MODEL": "claude-opus-4.7"
  }
}

启动验证

重新打开 VS Code。
打开一个项目文件夹。
从插件入口启动 Claude Code。
让它解释当前文件或回答一句简单问题。

排查

如果仍要求官方登录，先确认安装的是 Anthropic 的 Claude Code for VS Code。
如果 401，检查 ANTHROPIC_AUTH_TOKEN 是否是 Vibe 的有效 Key。
如果 404，检查模型名是否在 Vibe 控制台可用。
如果改完不生效，关闭 VS Code 后重新打开。

Claude VS Code 插件 · macOS / Linux

macOS / Linux 版配置文件在用户主目录的 ~/.claude/settings.json。插件和 Claude Code 终端版会读取同一份配置。

配置步骤

关闭 VS Code，避免旧插件进程继续使用旧配置。
打开终端，创建 ~/.claude 目录。
新建或编辑 settings.json。
写入下面内容，把 你的API密钥 换成 Vibe 控制台创建的 Key。

settings.json 怎么写

如果文件是空的，直接粘贴下面完整 JSON。
如果文件里已经有其它设置，保留原内容，只在最外层对象里添加或替换 "env": { ... }。
如果已经存在 env，只替换 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 这三项。
保存后完全退出 VS Code，再重新打开项目，让插件重新读取配置。

Terminal 创建目录

mkdir -p "$HOME/.claude"
nano "$HOME/.claude/settings.json"

配置文件路径

~/.claude/settings.json

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.vibe-subsapi.com",
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_MODEL": "claude-opus-4.7"
  }
}

启动验证

重新打开 VS Code，或从终端用 code /path/to/project 打开项目。
在项目里启动 Claude Code 插件。
让它解释当前文件或回答一句简单问题。
能正常返回，说明插件已经读到 Vibe 配置。

排查

如果命令行 claude 能用但 VS Code 插件不能用，先重启 VS Code。
如果 401，检查 ANTHROPIC_AUTH_TOKEN 是否是 Vibe 的有效 Key。
如果 404，检查模型名是否在 Vibe 控制台可用。
不要同时在多个插件里填不同的 Claude Key，避免排查时混淆。

CC Switch配置

如果你不想手动改环境变量，可以用 CC Switch 管理 Claude Code、Codex 等工具的 API 配置。

CC Switch 是什么

CC Switch 是一个本地 API 配置切换工具，用来统一管理不同 AI 工具的服务商、Base URL 和 API Key。
你可以把 Vibe-SUBSAPI 保存成一个可启用的供应商配置，需要切换时直接点选，不用反复修改环境变量。
它适合同时使用 Claude Code、Codex、VS Code 插件和桌面端工具的用户，把接入信息集中放在一个地方管理。
配置完成后，可以直接使用 Codex Desktop、Codex CLI、Claude Code、VS Code 插件版 Codex 和 Claude Code，不用再手动修改配置文件。

添加 Vibe 配置

新建配置或切换配置前，先关闭正在使用的 Codex、Claude Code、VS Code 插件或相关桌面端应用，避免它们继续读取旧配置。
打开 CC Switch，新增一个 Anthropic 或其他大模型厂商配置。
Name 填 Vibe-SUBSAPI，方便识别。
Base URL 填 https://api.vibe-subsapi.com。
API Key 粘贴控制台创建的 Key。
保存后点击启用，再重新打开对应的终端、桌面端或 VS Code 插件，让 Codex、Claude Code 等应用读取新配置。

验证

终端输入 claude。
问一句短问题，例如“你能正常回复吗”。
能回复说明配置已生效。
如果仍走官方账号，检查当前启用的是不是 Vibe 配置。

CC Switch 供应商列表和新增按钮位置 — 1
**进入供应商管理并新增配置** 顶部工具栏里先切到供应商管理区域，再点击右上角的加号。已有的 Vibe-SUBSAPI 配置会在列表中高亮显示，方便确认当前启用的是哪一个。

CC Switch 添加 Vibe-SUBSAPI 供应商表单 — 2
**填写 Vibe-SUBSAPI 供应商信息** 供应商名称填 `Vibe-SUBSAPI`，官网链接填 `https://vibe-subsapi.com`，API Key 填控制台生成的密钥，请求地址填 `https://api.vibe-subsapi.com`。

OpenClaw

OpenClaw 可以把模型能力接到自己的代理、面板或聊天入口。新手先走配置向导；向导跑不通时，再检查配置文件。

官方下载

安装包和最新安装方式以官方 GitHub 为准。进入仓库后按 README 或 Releases 里的系统说明下载。

OpenClaw 官方 GitHub 查看最新版下载和安装说明 打开

配置向导

Provider 选择 Anthropic 或 Anthropic Compatible。
API Key 填 Vibe 控制台创建的 Key。
Base URL 优先填 https://api.vibe-subsapi.com。
模型填 claude-opus-4.7 或控制台可用模型。
Gateway 密码自己保存好，用于进入控制面板。

常用命令

openclaw configure
openclaw gateway restart
openclaw dashboard
openclaw status
openclaw doctor
openclaw gateway logs

~/.openclaw/openclaw.json

{
  "models": {
    "mode": "merge",
    "providers": {
      "vibe": {
        "baseUrl": "https://api.vibe-subsapi.com",
        "apiKey": "你的API密钥",
        "api": "anthropic-messages",
        "models": [
          {"id": "claude-opus-4.7", "name": "Claude Opus 4.7"},
          {"id": "claude-opus-4.6", "name": "Claude Opus 4.6"}
        ]
      }
    }
  }
}

缓存排错

如果改了模型仍然报旧模型错误，检查 OpenClaw 的模型缓存。
可查看 ~/.openclaw/agents/main/agent/models.json 是否残留旧配置。
改配置后重启 Gateway，再打开 dashboard 验证状态。

OpenCode

OpenCode 的配置文件通常在 ~/.config/opencode/opencode.json，新版本可能是 opencode.jsonc。Claude 模型优先走 Anthropic 协议。

安装 / 启动

curl -fsSL https://opencode.ai/install | bash

# 或者使用 npm
npm install -g opencode-ai

opencode

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.vibe-subsapi.com",
        "apiKey": "你的API密钥"
      }
    }
  },
  "model": "anthropic/claude-opus-4.7",
  "small_model": "anthropic/claude-opus-4.6"
}

注意

Claude 模型不要强行按 OpenAI 协议接，容易出现调用格式错误。
如果工具要求 provider/model 格式，可用 anthropic/claude-opus-4.7。
OpenCode 的 provider baseURL 通常填到 /v1；Claude Code 环境变量不要加 /v1。
启动后先发一个短问题，确认不是 Key、Base URL 或模型名错误。

工具预设

Cursor、Windsurf、Aider、Cherry Studio、Chatbox 这类工具，本质都是选协议、填地址、填 Key、填模型。

工具	Provider	Base URL	模型建议
Cursor / Continue	OpenAI Compatible	`https://api.vibe-subsapi.com`	`chatgpt-5.5`
Cursor / Windsurf	Anthropic	`https://api.vibe-subsapi.com`	`claude-opus-4.7`
Cherry Studio / Chatbox	自定义 OpenAI	`https://api.vibe-subsapi.com`	`chatgpt-5.5`
Cline	Anthropic Compatible	`https://api.vibe-subsapi.com`	`claude-opus-4.7`
Aider	OpenAI Compatible	`https://api.vibe-subsapi.com`	`chatgpt-5.5`
Gemini CLI	Google Gemini	`https://api.vibe-subsapi.com`	`gemini-2.0-flash`
Hermes	Custom Provider	`https://api.vibe-subsapi.com`	`gpt-5.5`

不要混协议

OpenAI 工具一般需要 https://api.vibe-subsapi.com。
Anthropic / Claude 工具一般需要 https://api.vibe-subsapi.com。
一个工具如果只有 OpenAI Compatible，就优先用 ChatGPT 模型测试。
一个工具如果明确支持 Anthropic Messages，再填 Claude 模型。

Aider · OpenAI Compatible

export OPENAI_API_KEY="你的API密钥"
export OPENAI_API_BASE="https://api.vibe-subsapi.com"
aider --model openai/chatgpt-5.5

Hermes · ~/.hermes/config.yaml

model:
  provider: custom
  default: gpt-5.5
  base_url: https://api.vibe-subsapi.com
  api_key: 你的API密钥

Cherry Studio · 自定义 OpenAI

Provider: OpenAI Compatible
API 地址: https://api.vibe-subsapi.com
API 密钥: 你的API密钥
模型名称: chatgpt-5.5

Codex Desktop · Windows

Windows 版 Codex Desktop 接入 Vibe 中转站，核心是把当前用户目录下的 .codex 配置改成 Vibe 的 API 地址和 API 密钥。下面按“关闭 App、找到目录、创建 auth.json、创建 config.toml、重启验证”的顺序操作。

1. 完全退出 Codex Desktop

先关闭 Codex Desktop 窗口。
在任务栏右下角托盘里确认没有 Codex 仍在后台运行。
如果不确定是否已经退出，可以打开任务管理器，结束仍在运行的 Codex 相关进程。
不要在 Codex Desktop 正在运行时覆盖配置文件，否则 App 可能继续使用旧配置。

2. 找到 .codex 配置目录

Windows 的配置目录通常是 C:\Users\你的用户名\.codex。
最快方式是在资源管理器地址栏输入 %USERPROFILE%\.codex 并回车。
如果提示目录不存在，就手动新建一个名为 .codex 的文件夹。
如果看不到文件扩展名，先在资源管理器里打开“查看文件扩展名”，避免把文件建成 auth.json.txt。

PowerShell 打开配置目录

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
explorer "$env:USERPROFILE\.codex"

3. 创建 auth.json 文件

删除 C:\Users\你的用户名\.codex 下已经存在的 auth.json 文件，或者先改名备份。
新建一个文件，文件名必须是 auth.json。
把下面内容粘贴进去，只把 你的API密钥 替换成 Vibe 控制台创建的 API 密钥。
保存后确认文件类型仍然是 JSON 文件，不是 TXT 文本文档。

C:\Users\你的用户名\.codex\auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

4. 创建 config.toml 文件

删除同目录下已经存在的 config.toml 文件，或者先改名备份。
新建一个文件，文件名必须是 config.toml。
下面内容可以直接原样粘贴；base_url 已经是 Vibe 中转站地址。
如果控制台给你的推荐模型不是 gpt-5.5，只改 model 和 review_model 两行。

C:\Users\你的用户名\.codex\config.toml

model_provider = "vibe_subsapi"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
preferred_auth_method = "apikey"

[model_providers.vibe_subsapi]
name = "vibe_subsapi"
base_url = "https://api.vibe-subsapi.com"
wire_api = "responses"
requires_openai_auth = true

5. 重启并验证

保存两个文件后，重新打开 Codex Desktop。
打开一个测试项目目录，让 Codex 总结项目结构，确认它能正常响应。
如果提示认证失败，优先检查 auth.json 是否少了引号、逗号，或 API 密钥是否复制完整。
如果仍然没有走 Vibe 网关，确认 config.toml 的位置就是当前 Windows 用户的 .codex 目录。

Codex Desktop · macOS / Linux

macOS / Linux 版同样通过当前用户主目录下的 ~/.codex 配置接入 Vibe API。配置完成后必须完全退出并重新打开 Codex Desktop。

1. 退出应用并准备目录

先完全退出 Codex Desktop，避免配置文件保存后仍被旧进程占用。
打开 Terminal，创建 ~/.codex 目录。
如果已有旧配置，先备份再覆盖，避免误删自己需要的自定义设置。

打开配置目录

mkdir -p ~/.codex
open ~/.codex 2>/dev/null || xdg-open ~/.codex 2>/dev/null || ls -la ~/.codex

2. 创建 auth.json

删除或备份 ~/.codex/auth.json。
新建 auth.json，把 Vibe 控制台创建的 API 密钥填进去。
字段名保持 OPENAI_API_KEY 不变。

~/.codex/auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

3. 创建 config.toml

删除或备份 ~/.codex/config.toml。
新建 config.toml，直接粘贴下面配置。
base_url 使用 https://api.vibe-subsapi.com，不要加 /v1。

~/.codex/config.toml

model_provider = "vibe_subsapi"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
preferred_auth_method = "apikey"

[model_providers.vibe_subsapi]
name = "vibe_subsapi"
base_url = "https://api.vibe-subsapi.com"
wire_api = "responses"
requires_openai_auth = true

4. 重启并验证

重新打开 Codex Desktop。
选择一个测试项目，让 Codex 总结项目结构或修改一个无风险文件。
如果认证失败，先检查 JSON / TOML 格式，再确认 API 密钥和模型名是否可用。

Codex CLI · Windows

Codex CLI 是命令行工具，适合在 PowerShell、Windows Terminal 或 WSL 里使用。下面按“安装官方包、创建配置目录、写入密钥、写入网关配置、重启终端验证”的顺序操作。

1. 安装官方 Codex CLI

先安装 Node.js LTS，并确认 node 和 npm 在 PowerShell 里可用。
打开新的 PowerShell，执行官方 npm 安装命令。
如果已经安装过旧版，可以再次执行安装命令覆盖更新。

PowerShell 安装与版本检查

node -v
npm -v
npm install -g @openai/codex
codex --version

2. 创建 .codex 配置目录

配置目录位于当前 Windows 用户目录下：C:\Users\你的用户名\.codex。
如果目录里有旧的错误配置，先备份后再清理；不要删除你还需要的会话或自定义文件。
下面命令会重建最小配置目录，适合首次配置或确认旧配置已经不需要的情况。

重建配置目录

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
explorer "$env:USERPROFILE\.codex"

3. 创建 API 密钥文件

进入 Vibe 控制台的「API 密钥」页面，创建并复制一个新的 API 密钥。
在 %USERPROFILE%\.codex 下新建 auth.json。
把下面内容粘贴进去，只替换 你的API密钥，不要改字段名。

%USERPROFILE%\.codex\auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

4. 创建 config.toml

在同一个目录下新建 config.toml。
base_url 填完整网关地址：https://api.vibe-subsapi.com。
下面配置可以直接粘贴使用；后续只需要按实际可用模型调整 model。

%USERPROFILE%\.codex\config.toml

model_provider = "vibe_subsapi"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
preferred_auth_method = "apikey"

[model_providers.vibe_subsapi]
name = "vibe_subsapi"
base_url = "https://api.vibe-subsapi.com"
wire_api = "responses"
requires_openai_auth = true

5. 重启终端并开始使用

关闭所有 PowerShell / Windows Terminal 窗口，再重新打开一个新终端。
先运行 codex --version，确认命令能被识别。
进入你的项目目录后运行 codex，再发送一个简单问题测试是否能正常响应。
如果提示认证失败，优先检查 auth.json 是否是合法 JSON，以及 API 密钥是否属于可用分组。

启动 Codex

cd C:\path\to\your-project
codex

Codex CLI · macOS / Linux

macOS / Linux 推荐直接在系统终端里安装 Codex CLI。流程和 Windows 一样，但配置目录位于 ~/.codex，命令使用 Bash / Zsh 写法。

1. 安装官方 Codex CLI

先确认本机已经安装 Node.js LTS 和 npm。
macOS 用户如果习惯 Homebrew，也可以使用 brew install codex。
Linux 用户优先使用 npm 全局安装；如果权限报错，先修复 npm 全局目录权限，不建议直接滥用 sudo。

Bash / Zsh 安装与版本检查

node -v
npm -v
npm install -g @openai/codex
# 或者 macOS 使用 Homebrew
brew install codex

codex --version

2. 创建 .codex 配置目录

配置目录位于当前用户主目录：~/.codex。
首次配置可以直接创建目录；如果之前配置错了，先备份再清理。
下面命令会重建目录，适合确认旧配置已经不需要时使用。

重建配置目录

rm -rf ~/.codex
mkdir -p ~/.codex
open ~/.codex 2>/dev/null || xdg-open ~/.codex 2>/dev/null || ls -la ~/.codex

3. 创建 API 密钥文件

在 Vibe 控制台「API 密钥」页面创建新的 API 密钥。
在 ~/.codex 下新建 auth.json。
只替换下面的 你的API密钥，保留 OPENAI_API_KEY 字段名。

~/.codex/auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

4. 创建 config.toml

在 ~/.codex 下新建 config.toml。
base_url 使用 https://api.vibe-subsapi.com，不要再加 /v1。
如果控制台展示的推荐模型不同，只改 model 和 review_model 即可。

~/.codex/config.toml

model_provider = "vibe_subsapi"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
preferred_auth_method = "apikey"

[model_providers.vibe_subsapi]
name = "vibe_subsapi"
base_url = "https://api.vibe-subsapi.com"
wire_api = "responses"
requires_openai_auth = true

5. 重启终端并开始使用

关闭当前终端窗口，重新打开 Terminal、iTerm、Bash 或 Zsh。
运行 codex --version 确认命令可用。
进入项目目录后运行 codex，让它总结项目结构作为第一次验证。
如果提示找不到命令，检查 npm 全局 bin 目录是否在 PATH 中。

启动 Codex

cd /path/to/your-project
codex

VS Code 插件 · Windows

Codex VS Code 插件和 Codex CLI 共用同一套配置。Windows 上优先写 %USERPROFILE%\.codex 里的配置文件，这比只依赖环境变量更稳定。

VS Code 扩展市场搜索 codex 并安装 OpenAI Codex 插件 — 1
**在扩展市场安装 Codex** 打开 VS Code 左侧扩展面板，搜索 `codex`，选择 OpenAI 发布的 `Codex – OpenAI’s coding agent`，点击 `Install`。

2. 打开 Codex 配置目录

先关闭所有 VS Code 窗口，避免插件正在读取旧配置。
配置目录是 C:\Users\你的用户名\.codex，也就是 %USERPROFILE%\.codex。
如果 Codex 面板已经能打开，也可以点右上角齿轮，选择 Codex Settings > Open config.toml。

PowerShell 创建并打开目录

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
explorer "$env:USERPROFILE\.codex"

3. 写入 API 密钥

在 .codex 目录里新建 auth.json。
复制下面内容，只把 你的API密钥 改成你在 Vibe-SUBSAPI 创建的密钥。
这个文件是 JSON，双引号和花括号都要保留。

%USERPROFILE%\.codex\auth.json

auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

4. 写入网关配置

在同一个 .codex 目录里新建或编辑 config.toml。
base_url 固定写 https://api.vibe-subsapi.com，不要额外加 /v1。
下面配置可以直接使用；如果控制台给你的模型名不同，只改 model 和 review_model。

%USERPROFILE%\.codex\config.toml

config.toml

model_provider = "vibe_subsapi"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
preferred_auth_method = "apikey"

[model_providers.vibe_subsapi]
name = "vibe_subsapi"
base_url = "https://api.vibe-subsapi.com"
wire_api = "responses"
requires_openai_auth = true

5. 重启 VS Code 验证

完全退出 VS Code，再重新打开你的项目文件夹。
打开 Codex 侧边栏，选择 API Key 登录或让插件读取本地配置。
让 Codex 总结当前项目目录，能正常回复就说明配置已经生效。
如果认证失败，优先检查 auth.json 是否是合法 JSON、config.toml 是否误写成 JSON、密钥是否属于可用分组。

VS Code 插件 · macOS / Linux

macOS / Linux 上同样建议写 ~/.codex/auth.json 和 ~/.codex/config.toml。Codex CLI 和 VS Code 插件会共用这套配置。

2. 打开 Codex 配置目录

先退出 VS Code，避免插件继续使用旧配置。
配置目录是当前用户主目录下的 ~/.codex。
如果 Codex 面板已经能打开，也可以点右上角齿轮，选择 Codex Settings > Open config.toml。

Terminal 创建并打开目录

mkdir -p ~/.codex
open ~/.codex 2>/dev/null || xdg-open ~/.codex 2>/dev/null || ls -la ~/.codex

3. 写入 API 密钥

在 ~/.codex 下新建 auth.json。
复制下面内容，只把 你的API密钥 改成你在 Vibe-SUBSAPI 创建的密钥。
这个文件是 JSON；如果最后多了逗号，插件可能会读取失败。

~/.codex/auth.json

auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

4. 写入网关配置

在同一个目录下新建或编辑 config.toml。
base_url 写 https://api.vibe-subsapi.com，不要额外加 /v1。
下面配置可以直接使用；如果控制台给你的模型名不同，只改 model 和 review_model。

~/.codex/config.toml

config.toml

model_provider = "vibe_subsapi"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
preferred_auth_method = "apikey"

[model_providers.vibe_subsapi]
name = "vibe_subsapi"
base_url = "https://api.vibe-subsapi.com"
wire_api = "responses"
requires_openai_auth = true

5. 重启 VS Code 验证

完全退出 VS Code，再从项目目录重新打开。
打开 Codex 侧边栏，选择 API Key 登录或让插件读取本地配置。
让 Codex 总结当前项目目录，能正常回复就说明配置已经生效。
如果认证失败，优先检查 auth.json 是否是合法 JSON、config.toml 是否误写成 JSON、密钥是否属于可用分组。

从项目目录打开 VS Code

cd /path/to/your-project
code .

Gemini CLI

Gemini CLI 走 Google 原生 /v1beta 路由。Vibe 的配置方式是把根地址写进 GOOGLE_GEMINI_BASE_URL，不要手动拼成 /api/gemini。

安装

npm install -g @google/gemini-cli
gemini --version

macOS / Linux / WSL2

export GOOGLE_GEMINI_BASE_URL="https://api.vibe-subsapi.com"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-2.0-flash"

gemini

Windows PowerShell

[Environment]::SetEnvironmentVariable(
  "GOOGLE_GEMINI_BASE_URL",
  "https://api.vibe-subsapi.com",
  "User"
)
[Environment]::SetEnvironmentVariable(
  "GEMINI_API_KEY",
  "你的API密钥",
  "User"
)
[Environment]::SetEnvironmentVariable(
  "GEMINI_MODEL",
  "gemini-2.0-flash",
  "User"
)

启动检查

重开终端后运行 gemini。
如果出现登录方式选择，选择 API Key 模式。
输入 /model，确认模型名来自 Vibe 控制台可用列表。
如果报分组平台错误，给 Gemini CLI 换一个 Gemini 可用分组的 Key。

API 示例

工具配置跑通后，开发者可以直接用标准 OpenAI、Anthropic 或 Responses 端点接入。生产环境请在服务端保存 API Key，不要让前端浏览器直接携带密钥。

OpenAI Chat Completions

curl https://api.vibe-subsapi.com/chat/completions \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chatgpt-5.5",
    "messages": [{"role": "user", "content": "你是谁？"}],
    "stream": true
  }'

Anthropic Messages

curl https://api.vibe-subsapi.com/messages \
  -H "x-api-key: 你的API密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.7",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Responses API

curl https://api.vibe-subsapi.com/responses \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chatgpt-5.5",
    "input": [{
      "role": "user",
      "content": [{"type": "input_text", "text": "Hello, what can you do?"}]
    }],
    "stream": true,
    "reasoning": {"effort": "high"}
  }'

API 参考

这一节保留原开发文档的端点、参数、错误码和 SDK 说明。旧链接里的 #openai、#anthropic、#params、#errors、#sdk 会继续落到对应位置。

OpenAI 兼容

原 OpenAI SDK 项目优先改两项：apiKey 和 baseURL。

端点

POST /v1/chat/completions
POST /v1/responses
GET /v1/models
支持非流式与 SSE 流式输出。

Python

from openai import OpenAI

client = OpenAI(
    api_key="你的API密钥",
    base_url="https://api.vibe-subsapi.com"
)

response = client.chat.completions.create(
    model="chatgpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
    temperature=0.7,
    max_tokens=1024
)

Anthropic 兼容

Claude 工具链使用 Messages API，保留 anthropic-version 头。

Messages

curl https://api.vibe-subsapi.com/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: 你的API密钥" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4.7",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

能力

system 系统提示词。
tools 工具调用。
stream 流式输出。
文本与图片混合 content。

Gemini 兼容

Gemini 原生接口使用 /v1beta 路径，认证优先使用 x-goog-api-key，也兼容 Bearer 和 x-api-key。

generateContent

curl https://api.vibe-subsapi.combeta/models/gemini-2.0-flash:generateContent \
  -H "x-goog-api-key: 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "用一句话介绍 Vibe SubsAPI"}]
    }]
  }'

端点

GET /v1beta/models
GET /v1beta/models/{model}
POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent?alt=sse

参数表

常用请求参数如下；模型特有参数以控制台和上游能力为准。

参数	类型	说明
`model`	string	控制台可用模型 ID。
`messages`	array	对话消息列表，OpenAI/Anthropic 按各自格式传入。
`temperature`	number	采样温度，常用范围 0 到 2。
`max_tokens`	integer	最大输出 token 数。
`stream`	boolean	为 true 时返回 SSE 增量输出。
`tools`	array	函数或工具调用定义，按模型能力支持。

错误与限速

客户端应按状态码处理，而不是无差别重试所有失败请求。

状态	类型	处理方式
400	`invalid_request_error`	检查参数、模型名、消息格式。
401	`authentication_error`	检查 Key 是否有效。
402	`insufficient_quota`	充值或降低调用量。
429	`rate_limit_error`	读取 `retry-after`，指数退避。
500/529	`server_error`	短暂重试，持续失败则切换模型或告警。

SDK

优先使用官方 SDK 的自定义 Base URL 配置。

安装

pip install openai
pip install anthropic
pip install google-genai
npm i openai
npm i @anthropic-ai/sdk
npm i @google/genai

retry

for attempt in range(3):
    try:
        return client.chat.completions.create(...)
    except RateLimitError:
        time.sleep(2 ** attempt)
    except APIStatusError as e:
        if e.status_code >= 500:
            time.sleep(2 ** attempt)
        else:
            raise

OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="你的API密钥",
    base_url="https://api.vibe-subsapi.com"
)

response = client.responses.create(
    model="gpt-5.5",
    input="Hello from Vibe"
)

Gemini SDK

from google import genai
from google.genai import types

client = genai.Client(
    api_key="你的API密钥",
    http_options=types.HttpOptions(
        base_url="https://api.vibe-subsapi.com"
    )
)

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="Hello from Gemini"
)

计费说明

Vibe-SUBSAPI 按实际用量计费。页面里的“1 美金”指上游模型账单口径的 1 美金消耗，不是固定套餐。实际扣费、余额和明细以控制台为准。

模型	线路说明	计价口径
Claude Opus 4.6	第三方纯血	1 元 = 1 美金
Claude Opus 4.7	官方 Max 纯血	2 元 = 1 美金
ChatGPT 5.5	官方 Plus 纯血	0.35 元 = 1 美金
ChatGPT 5.5	官方 Pro 纯血	0.5 元 = 1 美金

省钱方式

先用短问题测试，不要一上来跑长任务。
切换任务前用 /clear 清空上下文。
上下文很长时先用 /compact 压缩历史。
让工具先读必要文件，别全项目扫描。
大任务分阶段，让模型先给计划再执行。

费用检查

Claude Code 内输入 /cost 查看当前会话用量。
控制台调用记录可以看 Key 维度消耗。
如果发现异常，立刻停用相关 API Key。
重新创建 Key，只给可信工具使用。

安装排错

安装失败先看系统环境，不要反复运行同一个失败命令。新手优先确认 Node.js、npm、网络和 PATH。

现象	常见原因	处理
`command not found`	全局安装目录不在 PATH。	检查 `npm prefix -g`，把对应 `bin` 目录加入 shell 配置后重开终端。
`syntax error near unexpected token <`	安装脚本下载成 HTML，通常是网络或地区问题。	检查网络；可换官方包管理器安装；不要执行未知网页内容。
`curl: (56)`	下载中断或写入失败。	换稳定网络，或先下载脚本到本地再执行。
TLS / SSL 错误	系统证书或 TLS 版本过旧。	更新证书；Windows PowerShell 可先启用 TLS 1.2。
Linux 安装被 `Killed`	内存不足，被系统终止。	增加 Swap，或换内存更高的机器。
Windows 要求 git-bash	缺少 Git for Windows。	安装 Git for Windows，并勾选加入 PATH。

使用排错

运行阶段优先排查 Key、余额、Base URL、模型名、协议类型。顺序不要乱，先确认最基础的四项。

现象	原因	处理
401 / Authentication failed	API Key 错误、过期、没复制完整。	重新复制 Key；确认没有多余空格；必要时删除旧 Key 再创建。
402 / insufficient_quota	余额不足或兑换未到账。	确认余额，充值后再测试。
404 / model_not_found	模型名填错，或工具不支持该协议。	复制控制台模型名；OpenAI 工具优先用 `chatgpt-5.5`。
Connection timeout / ECONNREFUSED	网络、代理、防火墙或 Base URL 错误。	用 `curl -sI https://api.vibe-subsapi.com` 测试连通性。
429 / rate_limit_error	请求太频繁或并发太高。	降低并发，隔几秒重试。
overloaded_error / 503	上游临时繁忙。	等待 1 到 2 分钟；连续失败再换模型或联系客服。
Claude Code 对话变慢	上下文太长。	输入 `/compact` 压缩，或 `/clear` 开新会话。
VS Code 插件连接失败	插件未继承终端环境变量。	重启 VS Code，或在 settings.json 里显式填写环境变量。
OpenClaw 启动失败	配置或缓存错误。	运行 `openclaw doctor` 和 `openclaw gateway logs`。
Base URL 不知道要不要加 /v1	协议混淆。	OpenAI Compatible 加 `/v1`；Claude / Anthropic 通常不加。

Vibe-SUBSAPI 教程文档

配置总览

支持的工具

快速开始

注册账号并获取 API Key

打开官网

确认余额

创建 API Key

复制并保存

Base URL 规则

常用模型名

多个模型怎么配

应用下载

基础环境及依赖

Node.js:

Git:

代码编辑器 / IDE

编辑器插件 / 编程助手

终端编程代理

桌面端 AI 工作台

API 客户端 / 聊天调试工具

配置与切换工具

准备 Node.js

系统建议

准备 Git

系统建议

Claude Code 终端版

写入配置前先看这里

macOS / Linux 长期保存

验证方式

Claude 桌面 App

准备步骤

要写入哪几个文件

Windows

macOS / Linux

Claude 桌面 App · Windows

配置步骤

粘贴时注意

启动验证

Virtual Machine Platform 是什么

图形界面开启

Claude 桌面 App · macOS / Linux

配置步骤

粘贴时注意

platform 字段

启动验证

首次启动

Claude VS Code 插件

安装插件

配置方式

Claude VS Code 插件 · Windows

配置步骤

settings.json 怎么写

启动验证

排查

Claude VS Code 插件 · macOS / Linux

配置步骤

settings.json 怎么写

启动验证

排查

CC Switch配置

CC Switch 是什么

添加 Vibe 配置

验证

OpenClaw

官方下载

配置向导

缓存排错

OpenCode

注意

工具预设

不要混协议

Codex Desktop · Windows

1. 完全退出 Codex Desktop

2. 找到 .codex 配置目录

3. 创建 auth.json 文件

4. 创建 config.toml 文件

5. 重启并验证

Codex Desktop · macOS / Linux

1. 退出应用并准备目录