Claude Code 与 Agent 工具集成

将 Claude Code、OpenClaw、Cline、Roo Code 以及任何 Anthropic-protocol 客户端连接到 TokenHub。

Anthropic 原生多提供方回退一个 Key，双协议

1. TokenHub 如何对接 Anthropic

TokenHub 同时暴露两种协议。同一个 th- key 可在两者中使用——计费、用量、支出上限和提供方回退均已统一。

协议	端点	Base URL（粘贴到客户端中）	常见客户端
OpenAI-compatible	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK、LiteLLM、LangChain
Anthropic 原生	POST /v1/messages	https://tokenhub.store/api	Claude Code、OpenClaw、Cline、Roo Code、anthropic SDK

2. 可用的 Claude 模型

可将下列任意 ID 作为 ANTHROPIC_MODEL 或 model 字段使用。anthropic/ 前缀可选——TokenHub 两种写法都支持。

模型 ID	等级	输入（$/100万）	输出（$/100万）
claude-opus-4-7	能力最强	$5.00	$25.00
claude-opus-4-6	主力旗舰	$5.00	$25.00
claude-sonnet-4-6	生产默认	$3.00	$15.00
claude-haiku-4-5	轻量，高 QPS	$1.00	$5.00
claude-opus-4-5	主力旗舰	$5.00	$25.00
claude-sonnet-4-5	生产默认	$3.00	$15.00

3. 三步快速开始

所有受支持的客户端最终都只需要这三个值。本页其余内容只是告诉你把它们填到哪里。

1
Base URL → https://tokenhub.store/api
2
Auth header → 你的 TokenHub th- key（不是 Anthropic key）
3
ANTHROPIC_API_KEY=""显式设置 ANTHROPIC_API_KEY=""，避免 SDK 回退到 api.anthropic.com

4. 按客户端配置

安装

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# or via npm
npm install -g @anthropic-ai/claude-code

选项 A — Shell 环境变量（全局）

# ~/.zshrc or ~/.bashrc
export ANTHROPIC_BASE_URL="https://tokenhub.store/api"
export ANTHROPIC_AUTH_TOKEN="th-your-tokenhub-key"
export ANTHROPIC_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_API_KEY=""    # must be empty, otherwise SDK falls back to api.anthropic.com

# then reopen the terminal and run:
cd /path/to/your/project
claude

选项 B — 项目级配置

.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenhub.store/api",
    "ANTHROPIC_AUTH_TOKEN": "th-your-tokenhub-key",
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_API_KEY": ""
  }
}

使用 /status 验证

> /status
Auth token:        ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://tokenhub.store/api

如果 base URL 仍显示 api.anthropic.com — 说明 ANTHROPIC_API_KEY 不是空值、终端未重启，或者 VSCode 集成终端继承了旧的环境变量。

5. curl 自测

非流式

curl -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 128,
    "messages": [{"role":"user","content":"say hi"}]
  }'

流式 SSE

curl -N -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-6","stream":true,"max_tokens":128,"messages":[{"role":"user","content":"count 1 to 3"}]}'

事件顺序：message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop。

仓库烟雾测试脚本

一次运行 6 项断言（非 stream / Bearer / SSE 顺序 / 认证错误 / 不支持的 model / 函数调用）。

BASE_URL=https://tokenhub.store TOKENHUB_API_KEY=th-xxxx \
  bash scripts/test-messages-api.sh

6. 故障排查速查表

现象	最可能原因	解决方法
401 / authentication_error	未发送 x-api-key，或传入了 Anthropic 官方 key	使用 TokenHub th- key
402 / permission_error	账户余额为 0，或 key 的消费上限已耗尽	通过 Dashboard → Billing 充值，或移除该 key 的消费上限
400 'model not supported'	model ID 拼写错误 / 大小写不正确	查看 §2 — 纯粹填写或 anthropic/ 前缀都可以
503 "No upstream API key"	该 model 的上游 key 尚未配置	联系 support
流在中途断开	客户端 HTTP 空闲超时时间太短	将空闲超时时间提高到 ≥ 120s
/status 仍显示 api.anthropic.com	ANTHROPIC_API_KEY 未清空，或者终端未重启	运行 export ANTHROPIC_API_KEY=""，然后重新打开终端
tool 调用返回纯文本	路由到了对 tool_use 支持较弱的上游	切换到 claude-opus-4-6 / claude-sonnet-4-6，或联系 support

7. 常见问题

还在找别的内容？

如果你是通过 openai SDK 调用 Claude，请使用 OpenAI-compatible 指南。

Claude API (OpenAI-compatible) →