SUBTOKEN logo

DOC / CC SWITCH / API KEY

CC Switch 接入指南

FOR CLAUDE / CODEX / GEMINI USERS

把你的 SUBTOKEN API Key 接到 CC Switch

这页文档专门讲两件事：怎么用 CC Switch 接入 SUBTOKEN，以及如果你不用 CC Switch，怎么直接把 Claude Code 指到我们的 API。

先看一键导入 看手动配置

Claude Code Base URL

https://subtoken.vip

Docs URL

https://subtoken.vip/doc/ 给 Website URL 或后台文档链接时就填这个

Support

QQ 1819409756 连接异常或导入失败时可直接核对 endpoint / key
00

你需要先准备什么

  1. 登录 SUBTOKEN 后台，进入 API Keys 页面。
  2. 确认你已经有一个可用的 API Key；没有就先创建一个。
  3. 本地安装并打开 CC Switch。
  4. 推荐优先使用 Import to CC Switch 一键导入。
  5. 如果一键导入不可用，再使用本文的手动配置方案。
01

平台自动映射规则

SUBTOKEN Key 平台 CC Switch 目标 App 导入行为
Anthropic Claude Code 直接导入 Claude Code 供应商
OpenAI Codex 直接导入 Codex Provider
Gemini Gemini 直接导入 Gemini Provider
Antigravity Claude 或 Gemini 导入时会让你二选一

如果你不确定自己的 key 属于哪个平台，最简单的办法就是先在 SUBTOKEN 的 API Keys 页面点一键导入，让系统自动选。

02

方法 1：一键导入到 CC Switch

推荐度最高

平台映射、endpoint 和 app 类型都由 SUBTOKEN 自动填好。

你需要做的事很少

只要 CC Switch 已安装并允许打开 ccswitch:// 协议。

适合大多数用户

尤其适合 OpenAI / Codex、Anthropic / Claude、Gemini 三类常见 key。

  1. 打开 SUBTOKEN，登录后进入 API Keys。
  2. 找到你要使用的 key。
  3. 点击该行的 Import to CC Switch。
  4. 如果浏览器或系统询问是否打开 CC Switch，选择允许。
  5. 导入完成后，回到 CC Switch 的 provider 列表确认新条目已出现。
  6. 把它设为当前使用后，再用 CC Switch 内置测试或实际 Claude / Codex / Gemini 调用验证。
CC Switch provider list screenshot 1 2 3 4
截图来自 CC Switch 官方在线页面；右侧说明按 SUBTOKEN 接入流程标注。
1 右上角橙色 +：手动新增供应商入口；一键导入失败时从这里开始。
2 顶部应用切换：Anthropic key 对应 Claude Code，OpenAI key 对应 Codex。
3 供应商列表：导入成功后，新的 SUBTOKEN 条目会出现在这里。
4 当前使用状态：确认 SUBTOKEN 已成为当前 provider，再做模型联通测试。

如果点击一键导入没反应

  • 确认 CC Switch 已安装且当前处于运行状态。
  • 确认系统没有拦截 ccswitch:// 协议。
  • 如果你当前设备不能直接打开协议，改用下面的手动配置流程。
03

方法 2：手动新增 CC Switch 供应商

Provider Type

Claude Code 供应商 如果你是在接 Anthropic-compatible 的 Claude 流量，进入这个添加页面。

Provider Name / 供应商名称

SUBTOKEN 名字随你，但建议直接写 SUBTOKEN，后续排查最省事。

Website URL / 官网链接

https://subtoken.vip/doc/ 这个字段不是必须，但建议填文档地址，后续从 provider 内跳转最方便。

API Endpoint / Base URL

https://subtoken.vip Claude Code 供应商这里不要带 /v1，也不要额外拼 /messages。

API Key

你的 SUBTOKEN API Key 直接从 API Keys 页面复制粘贴。

Full URL Toggle

保持关闭 / off 如果你的 CC Switch 版本显示这个开关，正常接入不要打开。
  1. 打开 CC Switch，点击右上角橙色 +。
  2. 进入 Claude Code 供应商 页面。
  3. 选择 自定义配置。
  4. 先按截图填 供应商名称 和 官网链接，再继续向下填 API Key 与 API Endpoint。
  5. 如果页面出现 Full URL 开关，保持关闭状态。
  6. 点 添加 保存；保存后回列表设为当前使用并做一次联通测试。
CC Switch add provider form screenshot 1 2 3 4
官方截图只展示到官网链接；下面的文字卡片补齐 SUBTOKEN 必填值。
1 选择 自定义配置，不要选其他预设供应商。
2 供应商名称 建议填 SUBTOKEN。
3 官网链接 建议填 https://subtoken.vip/doc/。
4 填完所有必填项后点 添加。
继续向下填写

API Key

你的 SUBTOKEN API Key

从 SUBTOKEN 后台 API Keys 页面复制，不要填账号密码。

最关键

API Endpoint

https://subtoken.vip

Claude Code 会自己请求 /v1/messages，这里不要带 /v1。

保持默认

Full URL

关闭 / off

让 CC Switch 自动拼接 Claude API 路径。

04

不用 CC Switch？直接接 Claude Code 也可以

SUBTOKEN 当前给 Claude Code 的标准接法就是下面这些环境变量。 这里用的是站点自身生成的配置规范，不是额外编的示例。

macOS / Linux 
export ANTHROPIC_BASE_URL="https://subtoken.vip"
export ANTHROPIC_AUTH_TOKEN="YOUR_SUBTOKEN_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
PowerShell 
$env:ANTHROPIC_BASE_URL="https://subtoken.vip"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_SUBTOKEN_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
~/.claude/settings.json 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://subtoken.vip",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_SUBTOKEN_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

这三点最容易填错

  • Claude Code Base URL 是 https://subtoken.vip，不要带 /v1。
  • Auth Token 用你自己的 SUBTOKEN API Key，不是账号密码。
  • 如果你用的是 CC Switch 的 Claude Code 供应商，通常不需要再单独手工配环境变量。
05

推荐验证顺序

  1. 先确保 provider 已保存。
  2. 回到 provider 列表，把 SUBTOKEN 设为当前使用。
  3. 再用 CC Switch 内置测试或实际模型调用验证。
  4. 能测试通过，再去实际启动 Claude / Codex / Gemini。
  5. 如果你是从 SUBTOKEN 一键导入的，优先相信自动生成配置，少手改。
06

排障清单

  • 导入没反应：CC Switch 没装好，或者系统没允许 ccswitch:// 协议。
  • 401 / 403：API Key 粘错了，或该 key 已失效。
  • 测试失败：Claude Code 先看 Base URL 是否写成了 https://subtoken.vip。
  • 仍然不通：重新复制一个新的 API Key，再测一次。
  • 手动配置时路径乱了：把 Full URL 关掉，用标准 endpoint 即可。
07

图像生成怎么用

想出图别往聊天接口硬塞。图像模型走独立的 /v1/images/generations，用你的 SUBTOKEN API Key 就能调。 下面按「能直接复制跑」的方式写。

A

先记这三样

  1. Base URL：https://subtoken.vip/v1
  2. 鉴权头：Authorization: Bearer 你的APIKey
  3. 接口：POST /images/generations（不是 chat/completions）

最容易踩的坑

  • 把 grok-imagine-image 丢进聊天接口 → 会报「不支持文本对话」或类似错误。
  • Base URL 少写了 /v1，或 Key 前后带了空格。
  • 模型名写错；先看后台可用模型，常见是 grok-imagine-image / grok-imagine-image-quality。
B

请求体长什么样

最少只要模型和提示词。需要多张图时再加 n。

JSON body 
{
  "model": "grok-imagine-image",
  "prompt": "一只红苹果放在白桌上，产品摄影，干净光线",
  "n": 1
}
  • model：图像模型名
  • prompt：画面描述，中英文都行，写清楚主体、光线、风格
  • n：张数，默认 1 就够试通
curl 一把梭 
curl -sS https://subtoken.vip/v1/images/generations \
  -H "Authorization: Bearer YOUR_SUBTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "一只红苹果放在白桌上，产品摄影，干净光线",
    "n": 1
  }'
Python（openai SDK） 
from openai import OpenAI

client = OpenAI(
    base_url="https://subtoken.vip/v1",
    api_key="YOUR_SUBTOKEN_API_KEY",
)

resp = client.images.generate(
    model="grok-imagine-image",
    prompt="一只红苹果放在白桌上，产品摄影，干净光线",
    n=1,
)

item = resp.data[0]
# 可能是 url，也可能是 b64_json，两种都兜一下
if getattr(item, "url", None):
    print("图片地址:", item.url)
elif getattr(item, "b64_json", None):
    import base64
    open("out.png", "wb").write(base64.b64decode(item.b64_json))
    print("已保存 out.png")
C

返回结果怎么读

成功时大致是 OpenAI 兼容结构，重点看 data[0]：

常见响应 
{
  "created": 1784158286,
  "data": [
    {
      "url": "https://.../v1/media/images/img_xxx",
      "mime_type": "image/jpeg"
    }
  ]
}
  • 有 url：直接浏览器打开或 curl -L -o out.jpg "URL"
  • 有 b64_json：Base64 解码后写成图片文件
  • 网关返回的 media 地址通常比上游临时链更稳，优先用返回给你的那个
D

提示词别太玄

  1. 先写清「主体 + 场景 + 光线/风格」。
  2. 一次只盯一个画面，别在一句里塞十个剧情转折。
  3. 要产品图就写「白底、产品摄影、无水印」；要插画就写「扁平插画、粗描边」。
  4. 试通之后再加细节，比一上来写小说更省配额。

改图？

若后台开了 grok-imagine-image-edit，走 POST /v1/images/edits，JSON 里带原图 URL 和新提示词。 没开这个模型就先别硬调。

E

出图排障速查

  • 401：Key 错了或过期，回 API Keys 重新复制。
  • 404 / 模型不存在：当前 key 没开这个图像模型，换一个可用模型名。
  • 400 说不支持 chat：你打错接口了，改到 /v1/images/generations。
  • 超时或一直没图：先把 prompt 缩短重试；仍不行就换 grok-imagine-image-quality 或换时段再试。
  • 有 url 但打不开：确认是完整返回地址，下载时带上需要的鉴权/直链头；优先用响应里的 media 链接。