Token Gateway

快速开始

安装 AI 开发工具

Token Gateway 专注提供 Claude API 访问，完美兼容 Claude Code。

前置条件：安装 Node.js

Claude Code 需要 Node.js 运行环境：

  • macOS：brew install node 或从 nodejs.org 下载
  • Windows：从 nodejs.org 下载安装包，或使用 winget install OpenJS.NodeJS.LTS
  • Linux：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - && sudo apt install -y nodejs
# 验证 Node.js 已安装
node --version  # 需要 v18+

安装 Claude Code（Anthropic 官方 CLI）

# 所有平台通用（macOS / Windows / Linux）
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

详见 官方文档

快速测试

注册并获取 API Key 后，复制以下命令即可验证：

curl https://api.token-gateway.com/v1/messages \
  -H "x-api-key: tf_sk_your_key_here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":100,"messages":[{"role":"user","content":"hello"}]}'
1. 获取 API Key

前往 API 密钥 页面创建密钥并立即复制，密钥仅在创建时显示一次。

密钥格式如：tf_sk_abc123...

2. 配置 Claude Code

设置以下环境变量后，推荐使用 claude --bare 启动，以确保 Claude Code 只使用 Token Factory 的外部 API Key，而不读取本机已有的 Claude 登录态。

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.token-gateway.com
export ANTHROPIC_API_KEY=tf_sk_your_key_here

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.token-gateway.com"
$env:ANTHROPIC_API_KEY = "tf_sk_your_key_here"

Windows (CMD)

set ANTHROPIC_BASE_URL=https://api.token-gateway.com
set ANTHROPIC_API_KEY=tf_sk_your_key_here

推荐启动方式

# 强制 Claude Code 仅使用上面的环境变量
claude --bare
注意：Anthropic SDK 的 base URL 不含 /v1 后缀（SDK 自动拼接），与 OpenAI SDK 不同。
如果你直接运行 claude 且本机已登录 Claude Max / claude.ai，Claude Code 可能优先读取本地登录态。此时请改用 claude --bare。
3. 持久化配置（推荐）

将环境变量写入 shell 配置文件，重启终端后永久生效。

macOS / Linux — 添加到 ~/.zshrc 或 ~/.bashrc

export ANTHROPIC_BASE_URL=https://api.token-gateway.com
export ANTHROPIC_API_KEY=tf_sk_your_key_here

保存后执行 source ~/.zshrc 立即生效。

Windows — 设置系统环境变量（PowerShell）

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.token-gateway.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "tf_sk_your_key_here", "User")

设置后需重启终端或应用才能生效。

Claude Code 常见问题

1. 已设置环境变量，但 Claude Code 仍然走官方 claude.ai

# 推荐：直接这样启动
claude --bare

如果本机已登录 Claude 账号，claude 可能继续使用本地登录态；--bare 会强制只使用环境变量中的外部 API Key。

2. 想切回官方 Claude / claude.ai

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
claude auth login

Windows PowerShell 可改用 Remove-Item Env:ANTHROPIC_BASE_URL、Remove-Item Env:ANTHROPIC_API_KEY。

3. 检查当前 Claude Code 正在使用哪种认证方式

claude auth status
4. 代码中使用 Anthropic SDK

Anthropic SDK（Python / Node.js）

# Python
from anthropic import Anthropic
client = Anthropic(
    base_url="https://api.token-gateway.com",
    api_key="tf_sk_your_key_here"
)

# Node.js
import Anthropic from '@anthropic-ai/sdk'
const client = new Anthropic({
    baseURL: 'https://api.token-gateway.com',
    apiKey: 'tf_sk_your_key_here'
})
6. 使用 cc-switch

如果你使用 cc-switch，可将 Token Factory 添加为自定义服务商：

{
  "name": "Token Factory",
  "baseUrl": "https://api.token-gateway.com",
  "apiKey": "tf_sk_your_key_here",
  "models": [
    "gpt-5.4",
    "gpt-5.4-mini",
    "gpt-5.4-nano",
    "gpt-5.3-codex",
    "gpt-5.1-codex-mini",
    "claude-opus-4-7",
    "claude-opus-4-6",
    "claude-sonnet-4-6",
    "claude-haiku-4-5"
  ]
}
认证方式

所有端点均支持以下三种认证方式（任选其一）：

Header格式
AuthorizationBearer tf_sk_...
X-TF-Keytf_sk_...
x-api-keytf_sk_...

每个请求返回 tf-request-id 响应头，联系客服时请提供此 ID。

API 端点与模型映射

OpenAI Chat Completions

POST /v1/chat/completions

适用于：gpt-5.4、gpt-5.4-mini、gpt-5.4-nano

OpenAI Responses API

POST /v1/responses

适用于：gpt-5.3-codex、gpt-5.1-codex-mini

Anthropic Messages

POST /v1/messages

适用于：claude-opus-4-7、claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5

模型列表

GET /v1/models

无需认证，返回所有可用模型及定价。

Claude 模型必须使用 /v1/messages，GPT 模型使用 /v1/chat/completions，Codex 模型使用 /v1/responses。混用会返回 400 错误。
可用模型与定价

OpenAI

模型输入 /M tokens输出 /M tokens
加载中...

Anthropic

模型输入 /M tokens输出 /M tokens
加载中...

价格实时获取，以上为默认等级 (Default) 售价。

功能支持
  • 流式输出（SSE Streaming）
  • Tool Calling / Function Calling
  • Web Search（OpenAI 内置搜索）
  • Vision（图像输入）
  • JSON Mode / Structured Output
  • Extended Thinking（Claude）

API 为透明代理，所有 provider 原生功能均完整支持。

计费说明
  • 预充值余额，按实际 Token 用量扣费
  • 最低充值 $5.00，支持信用卡和支付宝
  • 请求时系统会预扣一定额度，完成后按实际用量结算，余额可能短暂波动
  • 余额不足时请求将返回 HTTP 402，请及时充值
  • 速率限制：每用户 60 请求/分钟，超限返回 HTTP 429
错误码参考
HTTP 状态码类型说明
400invalid_request_error请求格式错误或模型与端点不匹配
401authentication_errorAPI Key 无效或已停用
402billing_error余额不足，请充值
429rate_limit_error超过速率限制（60 次/分钟）
502api_error上游 provider 不可达
订阅计划说明

Token Gateway 提供两种计费模式：

1. 订阅套餐（推荐）

按月付费，获得日/周/月 API 用量限额。限额以 API 调用成本价值（含 15% 平台费）计算。3 个等级：Basic ($39.9/月)、Standard ($149.9/月)、Pro ($249.9/月)。

2. 按量付费

预充值余额，按实际 token 用量扣费。适合偶尔使用或想先体验的用户。

3. 超限机制

订阅用户达到限额后，默认暂停服务。可在控制台开启"超限后使用余额"，从预充值余额继续扣费。也可升级到更高等级的套餐。

4. 两种模式可以同时使用吗？

可以。订阅用户在限额内不消耗余额。开启超限扣费后，超出部分从余额扣除。余额可随时充值。

客服支持

如有问题，请发送邮件至 support@token-gateway.com，并附上 tf-request-id 以便排查。