##快速开始（Claude Code）

两个环境变量，完事。模型行为与官方完全一致，含完整 Prompt Caching 与流式输出。

# macOS / Linux
export ANTHROPIC_BASE_URL="https://api.tokenbrain.cn"
export ANTHROPIC_AUTH_TOKEN="sk-tb-你的密钥"
claude

# Windows (PowerShell)
$env:ANTHROPIC_BASE_URL = "https://api.tokenbrain.cn"
$env:ANTHROPIC_AUTH_TOKEN = "sk-tb-你的密钥"
claude

密钥在 控制台 → API 密钥 创建。接口同时接受 x-api-key 与 Authorization: Bearer 两种鉴权头。

##Anthropic 原生接口（/v1/messages）

与 Anthropic Messages API 完全同构，官方 SDK 直改 base_url 即可。

curl https://api.tokenbrain.cn/v1/messages \
  -H "x-api-key: sk-tb-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5.5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

# Python (anthropic SDK)
from anthropic import Anthropic
client = Anthropic(base_url="https://api.tokenbrain.cn",
                   api_key="sk-tb-你的密钥")
msg = client.messages.create(model="claude-sonnet-5.5",
                             max_tokens=1024,
                             messages=[{"role": "user", "content": "你好"}])

##OpenAI 兼容接口（/v1/chat/completions）

Claude / Gemini 模型同样可通过 OpenAI 格式调用。

# Python (openai SDK)
from openai import OpenAI
client = OpenAI(base_url="https://api.tokenbrain.cn/v1",
                api_key="sk-tb-你的密钥")
r = client.chat.completions.create(model="gemini-4-argon",
                                   messages=[{"role": "user", "content": "hi"}])
print(r.choices[0].message.content)

##模型列表

curl https://api.tokenbrain.cn/v1/models -H "Authorization: Bearer sk-tb-你的密钥"

返回含实时价格（人民币/百万tokens）。无需鉴权的公开版本：GET /api/models。

##速率限制

超限返回 429，响应头含 Retry-After。

##错误码