Claude Code & Agent Tools Integration

Claude Code、OpenClaw、Cline、Roo Code、および任意のAnthropicプロトコル対応クライアントをTokenHubに接続します。

Anthropic-NativeMulti-Provider FallbackOne Key, Both Protocols

1. TokenHubがAnthropicと通信する仕組み

TokenHubは2つのプロトコルを同時に提供します。同じth- keyが両方で使えます — 課金、使用量、支出上限、プロバイダーフォールバックは統一されています。

プロトコル	エンドポイント	Base URL（クライアントに貼り付けてください）	代表的なクライアント
OpenAI-compatible	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK, LiteLLM, LangChain
Anthropic-native	POST /v1/messages	https://tokenhub.store/api	Claude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. 利用可能なClaudeモデル

以下のいずれかのIDを ANTHROPIC_MODEL または model フィールドとして使用できます。anthropic/ プレフィックスは省略可能です。TokenHubは両方の形式を受け付けます。

モデルID	Tier	入力 ($/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. 3ステップのクイックスタート

対応クライアントでは、必要な値はこの3つだけです。このページの残りは、それらをどこに設定するかの説明です。

1
Base URL → https://tokenhub.store/api
2
認証ヘッダー → あなたのTokenHub th- key（Anthropic keyではありません）
3
ANTHROPIC_API_KEY=""SDKがapi.anthropic.comへフォールバックしないように、ANTHROPIC_API_KEY="" を明示的に設定してください

4. クライアント別設定

インストール

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

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

オプション A — シェル環境変数（グローバル）

# ~/.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 の統合ターミナルが古い env を継承している可能性があります。

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.

リポジトリの smoke-test スクリプト

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 'No upstream API key'	この model 用の上流キーはまだ provision されていません	サポートにお問い合わせください
stream が途中で切れる	クライアントの HTTP アイドルタイムアウトが小さすぎます	アイドルタイムアウトを ≥ 120s に引き上げてください
/status にまだ api.anthropic.com が表示される	ANTHROPIC_API_KEY が未解除のまま、またはターミナルが再起動されていません	export ANTHROPIC_API_KEY="" を実行してからターミナルを再度開いてください
tool call がプレーンテキストを返す	tool_use のサポートが弱い上流にルーティングされています	claude-opus-4-6 / claude-sonnet-4-6 に切り替えるか、サポートにお問い合わせください

7. FAQ

お探しのものが見つかりませんか?

Claude を openai SDK で呼び出している場合は、代わりに OpenAI-compatible ガイドを使用してください。

Claude API (OpenAI-compatible) →