INTRO

接入概览

Zhongzhuan Token 通过统一的 OpenAI 兼容协议 + Anthropic 原生协议 双通道，将 Claude 与 GPT-5 全系模型暴露在同一域名下。下面这两个 base_url 覆盖了所有客户端需要的接入方式:

OpenAI 兼容(Codex / openai SDK)
https://zhongzhuantoken.com/v1
Anthropic 原生(Claude Code / anthropic SDK)
https://zhongzhuantoken.com
末尾不带 /v1，SDK 自己会补

API Key 请先在控制台「令牌管理」生成。下文示例中所有的 YOUR_KEY 替换为你自己的 Key 即可。

PART 01

第一部分 · 网站使用文档

从零到第一次成功调用，大概需要 5 分钟。下面 6 步走完就能用。

1

注册账号

访问 /register， 填邮箱 + 用户名 + 密码，点「发送验证码」会收到一封 6 位字符(字母+数字)的验证码邮件。 填进验证码后点注册，几秒后跳转到控制台。

没收到?检查垃圾邮件;或换一个常用邮箱重试。

2

充值余额

控制台点「充值」或直接访问 /console/topup。 定价非常简单:

充值汇率 ¥0.42 = $1 美元额度
即:充 ¥42 = $100 美元额度。最低充值 $10($10 ≈ ¥4.20)。

支持支付宝、微信。支付完成后页面会自动刷新余额，几秒内到账。 如果显示"暂无充值记录"但余额已涨，说明记录还在同步，刷新页面即可。

3

创建 API Token

控制台点「令牌管理」(/console/token), 点「新建 Token」。每个 token 必须绑定一个「分组通道」, 决定了它能调哪些模型、按什么倍率扣费。

关于分组通道

同一个模型(尤其是 Claude)在不同分组下走不同的上游通道，倍率、稳定性、可用性都不一样。 我们目前提供 4 个分组，按需挑一个绑给 token:

GPT / Gemini×2
官方直连

OpenAI 与 Google 全系，所有 GPT / Gemini token 都用这个。

Claude Lite×0.8最划算
第三方渠道，性价比之选

Claude 倍率低于 1，单价比官方 USD 还便宜，预算敏感场景首选。

Claude Plus×1.8
AWS 逆向号池

Claude 全系含 Haiku，稳定性优先，适合中长期生产使用。

Claude Max×3
官方满血 Max 直连

Claude 官方直连通道，倍率最高，可用性最好。

同一账号可创建多个 token 分别绑不同分组，按项目和用途隔离。 完整模型清单和实时倍率见 价格表。

填以下字段:

  • 名称:给 token 取个标识，比如 claude-code-mac
  • 分组:按上面说明挑一个。调 GPT/Gemini 选 GPT/Gemini;调 Claude 按预算/稳定性挑 Lite / Plus / Max
  • 额度:这个 token 最多能用多少美元。建议设 $20-50 限额，避免单个 token 泄露损失太大
  • 过期时间:可选「永不过期」或具体天数

创建后立即复制并保存 API Key — 出于安全考虑，后续只能看到 masked 版本。 如果丢了就重新创建一个，Key 形如 sk-xxxxxxxxxxxx。

4

对接 SDK / Agent

拿到 Key 后，跳到下面「第二部分 · Agent 接入配置」,选你用的工具(Claude Code / Codex / Cursor / OpenAI SDK / Anthropic SDK 等), 复制对应的环境变量贴到你的 shell / 配置文件里。

核心两个 base_url:OpenAI 兼容走 https://zhongzhuantoken.com/v1, Anthropic 原生走 https://zhongzhuantoken.com(末尾不带 /v1)。

5

监控用量

控制台首页(/console) 展示 4 张卡片:可用余额、累计消耗、Token 数、邀请奖励 —— 美元为主，人民币为辅。 下方有 7 天用量曲线和 Top 5 模型消费分布。

「日志」/console/log 是每一次 API 调用的明细: 模型 / 输入输出 token / 单次费用 / 用时 / IP。可按时间、模型、token 名筛选。

6

邀请奖励(可选)

「个人设置」/console/personal页面底部有你的邀请链接和二维码。被邀请的用户首次充值后，你按规则获得一笔美元奖励，可随时「转入账户余额」用于扣费。

常见问题

模型为什么扣费看起来比官方标价多?
每个 token 绑定一个「分组通道」，每个分组有独立倍率。 实扣美元 = 官方美元标价 × 分组倍率，再按 ¥0.42/$1 折算成人民币。 同一模型在不同分组下倍率不同，可在创建 token 时选择; 各分组的完整倍率和示例见 价格表。
账户余额能提现吗?
不支持提现。充值进的是 API 调用余额，只能用于扣费。 所以建议按需充值，先充 $10-25 试用，确认体验后再加额度。
我充值后没收到充值记录怎么办?
先看 /console 首页可用余额有没有涨;涨了就是到账了，只是「充值记录」列表可能在同步，刷新即可。 如果余额没涨且过了 5 分钟，联系客服并把支付凭证发过来，我们会人工核对。
Token 泄露了怎么办?
去 /console/token 找到对应 token,点「禁用」或「删除」立即失效，然后重新创建一个新的。 所以建议给每个客户端 / 项目用独立 token,泄露的影响只限于那一个。
可以同时绑定多个邮箱吗?
不可以。一个账号对应一个邮箱，可在「个人设置」里换绑(需要新邮箱验证码)。
PART 02

第二部分 · Agent 接入配置

下面所有 agent 都用同一个 YOUR_KEY 即可。 本站统一使用 https://zhongzhuantoken.com 作为根域名， 不同 agent 对路径前缀的预期不同(部分自动补 /v1， 部分需要你显式写)，按下方示例直接复制即可。

AGENT · 01

Claude Code

Anthropic 官方 CLI，默认走 Anthropic 原生协议。把 base_url 指向本站即可，模型名直接用 claude-opus-4-7 等。

1

安装(若已安装跳过)

bash
# macOS / Linux
sudo npm install -g @anthropic-ai/claude-code

# Windows (PowerShell 管理员)
npm install -g @anthropic-ai/claude-code

# 验证
claude --version
2

配置环境变量

bash
# macOS / Linux，加入 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_BASE_URL="https://zhongzhuantoken.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# 加载
source ~/.zshrc
powershell
# Windows PowerShell(永久写入用户环境变量)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://zhongzhuantoken.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_KEY", "User")
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")
# 关掉当前终端，重开 PowerShell 让变量生效
3

开始使用

bash
cd your-project
claude
# 进入交互式 REPL，直接对话
AGENT · 02

Codex (OpenAI)

OpenAI 官方 CLI，走 OpenAI Chat Completions 协议。base_url 要带 /v1，模型名用 gpt-5.5 等。

1

安装

bash
# macOS / Linux
sudo npm install -g @openai/codex@latest

# Windows
npm install -g @openai/codex@latest

# 验证
codex --version
2

创建 config.toml

bash
# 重置配置目录
rm -rf ~/.codex && mkdir -p ~/.codex

# 写入配置
cat > ~/.codex/config.toml << 'EOF'
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "medium"

[model_providers.OpenAI]
name = "Zhongzhuan Token"
base_url = "https://zhongzhuantoken.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
EOF

# 设置 API Key
export OPENAI_API_KEY="YOUR_KEY"
echo 'export OPENAI_API_KEY="YOUR_KEY"' >> ~/.zshrc
3

开始使用

bash
codex
# 进入 Codex 交互模式
AGENT · 03

OpenClaw

开源双协议 agent，同一个客户端可以在 Anthropic 通道和 OpenAI 通道间切换。 本站两个通道分别如下:

  • Anthropic(Claude)通道 base_url:https://zhongzhuantoken.com— 不带 /v1，示例模型 claude-opus-4-7
  • OpenAI(Codex)通道 base_url:https://zhongzhuantoken.com/v1— 必须带 /v1，示例模型 gpt-5.5
1

按通道配置环境变量

bash
# Anthropic 通道
export ANTHROPIC_BASE_URL="https://zhongzhuantoken.com"
export ANTHROPIC_API_KEY="YOUR_KEY"
openclaw --provider anthropic --model claude-opus-4-7

# OpenAI 通道
export OPENAI_BASE_URL="https://zhongzhuantoken.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
openclaw --provider openai --model gpt-5.5
AGENT · 04

Hermes

轻量级编程 agent，默认走 OpenAI 兼容协议，也支持切换 Anthropic 通道。

1

写入 ~/.hermes/config.yaml

bash
mkdir -p ~/.hermes
cat > ~/.hermes/config.yaml << 'EOF'
provider: openai
base_url: https://zhongzhuantoken.com/v1
api_key: YOUR_KEY
model: gpt-5.5
EOF
2

启动

bash
hermes
# 启动后即可对话
SDK

SDK 直调

如果你在自己写 agent 或集成到现有项目，直接用官方 SDK 改 base_url 即可。下面三种最常见。

1

Node.js · openai 包(GPT / Claude 共用)

ts
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://zhongzhuantoken.com/v1",
});

const res = await client.chat.completions.create({
  model: "gpt-5.5",                  // 或 "claude-opus-4-7"
  messages: [{ role: "user", content: "你好" }],
});
console.log(res.choices[0].message.content);
2

Python · openai 包

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_KEY",
    base_url="https://zhongzhuantoken.com/v1",
)

res = client.chat.completions.create(
    model="gpt-5.5",                 # 或 "claude-opus-4-7"
    messages=[{"role": "user", "content": "你好"}],
)
print(res.choices[0].message.content)
3

Node.js · @anthropic-ai/sdk(走原生 Anthropic 协议)

ts
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
  baseURL: "https://zhongzhuantoken.com",      // 注意不带 /v1
});

const msg = await client.messages.create({
  model: "claude-opus-4-7",
  max_tokens: 1024,
  messages: [{ role: "user", content: "你好" }],
});
console.log(msg.content);
4

cURL · 快速测试

bash
# OpenAI 协议
curl https://zhongzhuantoken.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

# Anthropic 协议
curl https://zhongzhuantoken.com/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-7","max_tokens":1024,"messages":[{"role":"user","content":"hi"}]}'
TROUBLESHOOT

常见问题

返回 401 / Invalid token
检查 API Key 是否复制完整、是否被环境变量覆盖。控制台「令牌管理」可重新生成。
返回 404 / Endpoint not found
确认 base_url 是否带 /v1。OpenAI 协议要带，Anthropic 原生协议不带。
返回 429 / Rate limit
换一个更高倍率的分组通道(Claude 系列可从 Lite → Plus → Max)，或联系客服调整速率上限。
Claude Code 黄字警告 / 异常退出
确认设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1， 否则会向 anthropic.com 发遥测请求被中转拒绝。