Configuration de l'API personnalisée Claude Code

Claude Code peut acheminer ses requêtes de modèle via la passerelle API Anthropic Claude Messages de TokenHub. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.

L’endpoint TokenHub utilisé dans ce guide est https://us-api.tokenhub.com/v1/messages.

Quand l’utiliser

Commencez dans un petit dépôt ou un projet de test. Demandez d’abord à l’outil de lire des fichiers, expliquer le code ou proposer un plan, puis activez les modifications.

Installer ou ouvrir l’outil

Suivez la documentation officielle Claude Code pour installer ou ouvrir l’outil. Si les menus changent, suivez la version actuelle de la documentation.

Pour les outils CLI, vérifiez que l’exécutable fonctionne avant d’ajouter les identifiants TokenHub :

claude --version

Préparer les identifiants TokenHub

Créez une clé API TokenHub et choisissez dans la liste des modèles TokenHub un modèle adapté à cet outil.

export TOKENHUB_API_KEY="sk-..."

Conservez la clé dans votre shell local, le stockage secret de l’IDE ou le champ API key sécurisé de l’outil. Ne la commitez pas dans le dépôt.

Configurer le fournisseur TokenHub

Dans les réglages Models, Providers, API Keys ou OpenAI Compatible, renseignez les valeurs ci-dessous.

Valeurs du provider

Emplacements des réglages

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4",
  "env": {
    "ANTHROPIC_BASE_URL": "__API_BASE_URL__",
    "ANTHROPIC_AUTH_TOKEN": "sk-..."
  }
}

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "__API_BASE_URL__"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-..."
    }
  ]
}

Si l’outil sépare chat, edit, apply et fast models, utilisez le même modèle TokenHub pour le premier test. Séparez-les ensuite selon le coût, la latence et la capacité de raisonnement.

Variables temporaires pour le diagnostic

Utilisez les variables temporaires seulement pour vérifier la clé, le réseau et le nom du modèle. Après validation, déplacez les mêmes valeurs dans la configuration persistante ci-dessus.

export TOKENHUB_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="__API_BASE_URL__"
export ANTHROPIC_AUTH_TOKEN="$TOKENHUB_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4"

Vérifier la connexion

Testez d’abord avec une consigne en lecture seule pour confirmer que le modèle lit le contexte sans modifier les fichiers. Testez ensuite les actions d’édition ou d’agent.

Lis le README du projet et résume-le en trois phrases. Ne modifie aucun fichier.

Après un prompt réussi, consultez les logs TokenHub pour vérifier le modèle, l’endpoint, les tokens consommés et le groupe de facturation.

Dépannage