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	等級	輸入（$/1M）	輸出（$/1M）
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
驗證標頭 → 你的 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"}]
  }'

Streaming 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。

Repo 煙霧測試腳本

一次執行 6 個斷言（non-stream / Bearer / SSE 順序 / 認證錯誤 / 不支援的 model / function calling）。

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「沒有上游 API Key」	此 model 的上游 Key 尚未配置	聯絡支援
stream 中途中斷	客戶端 HTTP idle timeout 設定過小	將 idle timeout 提高至 ≥ 120s
/status 仍顯示 api.anthropic.com	ANTHROPIC_API_KEY 尚未取消設定，或終端機尚未重新啟動	執行 export ANTHROPIC_API_KEY=""，然後重新開啟終端機
工具呼叫回傳純文字	路由到了 tool_use 支援較弱的上游	切換到 claude-opus-4-6 / claude-sonnet-4-6，或聯絡支援

7. 常見問題

還在找其他內容嗎？

如果你是使用 openai SDK 呼叫 Claude，請改看 OpenAI-compatible 指南。

Claude API (OpenAI-compatible) →