Claude Code- & Agent-Tools-Integration

Verbinde Claude Code, OpenClaw, Cline, Roo Code und jeden Anthropic-Protokoll-Client mit TokenHub.

Anthropic-nativMulti-Provider-FallbackEin Key, beide Protokolle

1. Wie TokenHub Anthropic unterstützt

TokenHub stellt zwei Protokolle gleichzeitig bereit. Derselbe th- Key funktioniert für beide — Billing, Nutzung, Ausgabenlimits und Provider-Fallback sind vereinheitlicht.

Protokoll	Endpunkt	Base URL (füge dies in den Client ein)	Typische Clients
OpenAI-kompatibel	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK, LiteLLM, LangChain
Anthropic-nativ	POST /v1/messages	https://tokenhub.store/api	Claude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. Verfügbare Claude-Modelle

Verwende eine der folgenden IDs als ANTHROPIC_MODEL oder im model-Feld. Das Präfix anthropic/ ist optional — TokenHub akzeptiert beide Formen.

Model-ID	Stufe	Input ($/1 Mio.)	Output ($/1 Mio.)
claude-opus-4-7	Am leistungsfähigsten	$5.00	$25.00
claude-opus-4-6	Haupt-Flaggschiff	$5.00	$25.00
claude-sonnet-4-6	Produktionsstandard	$3.00	$15.00
claude-haiku-4-5	Leichtgewichtig, hohe QPS	$1.00	$5.00
claude-opus-4-5	Haupt-Flaggschiff	$5.00	$25.00
claude-sonnet-4-5	Produktionsstandard	$3.00	$15.00

3. Schnellstart in drei Schritten

Jeder unterstützte Client reduziert sich auf diese drei Werte. Der Rest dieser Seite zeigt nur, wohin du sie eintragen musst.

1
Base URL → https://tokenhub.store/api
2
Auth-Header → dein TokenHub th- Key (NICHT ein Anthropic-Key)
3
ANTHROPIC_API_KEY=""Setze ANTHROPIC_API_KEY="" explizit, damit das SDK nicht auf api.anthropic.com zurückfällt

4. Konfiguration pro Client

Installieren

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

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

Option A — Shell-Umgebungsvariablen (global)

# ~/.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

Option B — Konfiguration auf Projektebene

.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": ""
  }
}

Mit /status prüfen

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

Wenn die Basis-URL weiterhin api.anthropic.com anzeigt — ANTHROPIC_API_KEY ist nicht leer, das Terminal wurde nicht neu gestartet oder das integrierte VSCode-Terminal hat veraltete Umgebungsvariablen übernommen.

5. curl-Selbsttest

Ohne Streaming

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"}]}'

Reihenfolge der Events: message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

Smoke-Test-Skript für das Repo

Führt 6 Assertions in einem Durchlauf aus (non-stream / Bearer / SSE-Reihenfolge / Auth-Fehler / nicht unterstütztes model / Function Calling).

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

6. Troubleshooting-Spickzettel

Symptom	Wahrscheinlichste Ursache	Lösung
401 / authentication_error	x-api-key wurde nicht gesendet oder ein offizieller Anthropic-Schlüssel wurde übergeben	Verwende einen TokenHub th- Schlüssel
402 / permission_error	Kontostand ist 0 oder das Ausgabenlimit des Schlüssels ist erschöpft	Lade Guthaben über Dashboard → Billing auf oder entferne das Ausgabenlimit des Schlüssels
400 'model not supported'	Tippfehler bei der Model-ID / falsche Groß- und Kleinschreibung	Siehe §2 — sowohl ohne Prefix als auch mit anthropic/ Prefix akzeptiert
503 'No upstream API key'	Upstream-Key für dieses model ist noch nicht bereitgestellt	Support kontaktieren
stream bricht mitten im Verlauf ab	HTTP-Idle-Timeout des Clients ist zu klein	Idle-Timeout auf ≥ 120s erhöhen
/status zeigt weiterhin api.anthropic.com an	ANTHROPIC_API_KEY nicht entfernt oder Terminal nicht neu gestartet	export ANTHROPIC_API_KEY="" ausführen und dann das Terminal erneut öffnen
Tool-Aufruf gibt Klartext zurück	An ein Upstream mit schwacher tool_use-Unterstützung weitergeleitet	Zu claude-opus-4-6 / claude-sonnet-4-6 wechseln oder Support kontaktieren

7. FAQ

Suchen Sie nach etwas anderem?

Wenn Sie Claude mit dem openai SDK aufrufen, verwenden Sie stattdessen die OpenAI-compatible-Anleitung.

Claude API (OpenAI-compatible) →