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

第一部分 · 网站使用文档

这一部分将随网站功能(注册、充值、令牌、监控、邀请)逐步上线，目前留位待补。 先用第二部分的 Agent 配置指南即可开始接入。
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
切到 vip 分组，或联系客服调整速率上限。
Claude Code 黄字警告 / 异常退出
确认设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1， 否则会向 anthropic.com 发遥测请求被中转拒绝。