Intégration de Claude Code et des outils Agent

Connectez Claude Code, OpenClaw, Cline, Roo Code et tout client du protocole Anthropic à TokenHub.

Anthropic-natifSolution de secours multi-fournisseursUne seule clé, deux protocoles

1. Comment TokenHub parle Anthropic

TokenHub expose deux protocoles simultanément. La même clé th- fonctionne sur les deux — la facturation, l’utilisation, les plafonds de dépense et le fallback de fournisseur sont unifiés.

ProtocolePoint de terminaisonURL de base (collez ceci dans le client)Clients typiques
Compatible OpenAIPOST /v1/chat/completionshttps://tokenhub.store/api/v1openai SDK, LiteLLM, LangChain
Anthropic-natifPOST /v1/messageshttps://tokenhub.store/apiClaude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. Modèles Claude disponibles

Utilisez n’importe lequel des ID ci-dessous comme ANTHROPIC_MODEL ou dans le champ model. Le préfixe anthropic/ est facultatif — TokenHub accepte les deux formes.

ID du modèleNiveauEntrée ($/1M)Sortie ($/1M)
claude-opus-4-7Le plus performant$5.00$25.00
claude-opus-4-6Modèle phare principal$5.00$25.00
claude-sonnet-4-6Valeur par défaut en production$3.00$15.00
claude-haiku-4-5Léger, haut QPS$1.00$5.00
claude-opus-4-5Modèle phare principal$5.00$25.00
claude-sonnet-4-5Valeur par défaut en production$3.00$15.00

3. Démarrage rapide en trois étapes

Chaque client pris en charge se résume à ces trois valeurs. Le reste de cette page indique simplement où les placer.

  1. 1
    URL de base → https://tokenhub.store/api
  2. 2
    En-tête d’authentification → votre th- key TokenHub (PAS une clé Anthropic)
  3. 3
    ANTHROPIC_API_KEY=""Définissez explicitement ANTHROPIC_API_KEY="" pour éviter que le SDK ne bascule vers api.anthropic.com

4. Configuration par client

Installer

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

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

Option A — Variables d’environnement du shell (globales)

# ~/.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 — Configuration au niveau du projet

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

Vérifier avec /status

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

Si l’URL de base affiche toujours api.anthropic.com — ANTHROPIC_API_KEY n’est pas vide, le terminal n’a pas été redémarré, ou le terminal intégré de VSCode a hérité d’anciennes variables d’environnement.

5. Auto-test curl

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

Ordre des événements : message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

Script de smoke test du dépôt

Exécute 6 assertions en une seule fois (non-stream / Bearer / ordre SSE / erreurs d’auth / model non pris en charge / function calling).

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

6. Aide-mémoire de dépannage

SymptômeCause la plus probableCorrectif
401 / authentication_errorx-api-key non envoyé, ou une clé officielle Anthropic a été transmiseUtilisez une clé TokenHub th-
402 / permission_errorLe solde du compte est à 0, ou le plafond de dépenses de la clé est épuiséRecharger via Dashboard → Billing, ou supprimer le plafond de dépenses de la clé
400 'model not supported'Erreur de frappe dans l’ID du model / mauvaise casseVoir §2 — les deux formes, sans préfixe ou avec anthropic/, sont acceptées
503 « No upstream API key »La clé upstream pour ce model n’a pas encore été provisionnéeContactez le support
Le stream s’interrompt au milieuLe timeout d’inactivité HTTP du client est trop courtAugmentez le timeout d’inactivité à ≥ 120 s
/status affiche toujours api.anthropic.comANTHROPIC_API_KEY n’a pas été supprimée, ou le terminal n’a pas été redémarréExécutez export ANTHROPIC_API_KEY="" puis rouvrez le terminal
L’appel d’outil renvoie du texte brutRouté vers un upstream avec une prise en charge faible de tool_usePassez à claude-opus-4-6 / claude-sonnet-4-6, ou contactez le support

7. FAQ

Vous cherchez autre chose ?

Si vous appelez Claude avec le SDK OpenAI, utilisez plutôt le guide OpenAI-compatible.

API Claude (OpenAI-compatible) →