Configuration des Coding Agents

Installation de Claude Code, API Key, Base URL et modèles

Connectez Claude Code avec une BetterToken API Key, une Base URL et un Model ID. Choisissez le modèle au démarrage ou changez avec /model en session.

Connectez Claude Code avec votre BetterToken API Key, la Base URL https://bettertoken.ai et le Model ID souhaité. Copiez le Model ID exact depuis la model plaza.

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai`
Model	`YOUR_MODEL_ID`

Prérequis

Installez Claude Code
Installez Node.js si vous utilisez le script de configuration automatique BetterToken ; l’installation avec npm nécessite Node.js 22 ou une version ultérieure
Créez et copiez une BetterToken API Key

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Installation

Anthropic recommande l’installateur natif, qui ne nécessite pas Node.js. Si vous préférez npm, installez Node.js 22 ou une version ultérieure, puis exécutez :

npm install -g @anthropic-ai/claude-code

Configuration par la ligne de commande

Le script de configuration automatique BetterToken écrit la configuration du fournisseur Claude Code. Il nécessite Node.js et demande l’API Key si elle n’est pas transmise en argument.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-claudecode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-claudecode-provider.ps1" -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"

Une fois le script terminé, vérifiez ~/.claude/settings.json (ou %USERPROFILE%\.claude\settings.json sous Windows), puis redémarrez complètement Claude Code. Utilisez la configuration manuelle ci-dessous pour contrôler chaque champ.

Configuration manuelle

Système	Fichier
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

Copiez le Model ID exact depuis la model plaza.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

Remplacez YOUR_MODEL_ID par l’ID copié. ANTHROPIC_MODEL définit le modèle principal et les trois variables ANTHROPIC_DEFAULT_*_MODEL définissent les alias Haiku, Sonnet et Opus. Vous pouvez utiliser un même modèle ou un modèle différent pour chaque rôle.

Les exemples incluent le réglage facultatif CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1. Il désactive les mises à jour automatiques, les rapports d’erreur, certaines vérifications de disponibilité et fonctions du compte ; il n’est pas nécessaire à l’authentification. Pour une mise à jour manuelle, exécutez claude update, ou utilisez votre gestionnaire de paquets s’il gère l’installation. Consultez les instructions de mise à jour et les effets du réglage.

Extension VS Code

L’extension utilise le fichier VS Code settings.json. Ajoutez une configuration claudeCode.environmentVariables distincte :

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "YOUR_MODEL_ID"
    }
  ]
}

Vérifier la connexion

Lancez Claude Code dans votre projet :

claude

Envoyez un court message. Une réponse normale sans erreur 401, de connexion ou de modèle confirme la configuration. Dans la session interactive, exécutez /status et vérifiez deux lignes :

Anthropic base URL doit afficher la Base URL de BetterToken : https://bettertoken.ai. Si cette ligne est absente, la variable n’a pas été transmise à la session actuelle. Vérifiez le chemin de settings.json et redémarrez complètement Claude Code.
La ligne d’authentification doit afficher ANTHROPIC_AUTH_TOKEN, plutôt qu’une connexion avec un compte claude.ai.

Pour vérifier la connexion depuis un script, envoyez un court prompt :

claude -p "Reply with only: OK"

Une réponse normale OK confirme que la connexion fonctionne.

Conflits avec une connexion existante

Les identifiants définis dans les variables d’environnement ont priorité sur une connexion claude.ai enregistrée. Si un avertissement signale deux sources d’identifiants au démarrage, supprimez l’une d’elles. Pour conserver uniquement votre BetterToken API Key, exécutez /logout. Si votre interpréteur de commandes définit aussi ANTHROPIC_API_KEY, supprimez d’abord cette variable.

Changer de modèle

Modifiez le Model ID dans la configuration et redémarrez Claude Code. Pour changer en cours de session, utilisez /model YOUR_MODEL_ID.

Pour d’autres alias, comme fable avec ANTHROPIC_DEFAULT_FABLE_MODEL, suivez la correspondance officielle des alias et utilisez un Model ID disponible. Si Claude Code attribue une fenêtre de contexte incorrecte à un ID personnalisé, suivez les instructions pour les modèles personnalisés en utilisant la limite confirmée du modèle.

Afficher les modèles BetterToken dans /model (facultatif)

Utilisez une version récente de Claude Code. Ajoutez "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1" au bloc env existant dans ~/.claude/settings.json, puis redémarrez complètement Claude Code. Au démarrage, Claude Code interroge /v1/models à l’adresse https://bettertoken.ai pour obtenir les modèles disponibles. Consultez le guide officiel de configuration de la passerelle.

Pour confirmer la découverte, lancez claude --debug et recherchez les lignes [gatewayDiscovery] dans ~/.claude/debug/<session-id>.txt. Une ligne indiquant la mise en cache des modèles confirme que la découverte a réussi.

Claude Code n’affiche que les modèles de la passerelle dont le Model ID contient claude ou anthropic (sans distinction de casse), comme le décrit son protocole de passerelle. Les autres modèles renvoyés par /v1/models, dont les modèles GPT, n’apparaissent pas dans /model, même si BetterToken les propose. Claude Code peut toujours les appeler si vous définissez directement leur Model ID ; lors des tests avec Claude Code 2.1.309, un modèle GPT spécifié ainsi a répondu aux requêtes de texte et de lecture de fichiers via Anthropic Messages.

Erreurs fréquentes

Erreur	Solution
`401` ou échec de l’authentification	Vérifiez `ANTHROPIC_AUTH_TOKEN` et supprimez les espaces autour de l’API Key.
`ConnectionRefused`	Utilisez exactement `https://bettertoken.ai` ; n’ajoutez pas `/v1`.
Model ID	Vérifiez le Model ID exact dans la model plaza et saisissez-le dans les paramètres du modèle du client.
Configuration non appliquée	Vérifiez le chemin du fichier, supprimez les variables d’environnement conflictuelles et redémarrez complètement Claude Code.
Avertissement sur deux sources d’identifiants en conflit au démarrage	Supprimez l’une des sources ou exécutez `/logout`.
Erreur de certificat / TLS, fréquente avec un proxy d’entreprise	Définissez `NODE_EXTRA_CA_CERTS` avec le chemin du fichier de certificat de l’AC et redémarrez Claude Code.
`400` mentionnant un champ inconnu, comme `Extra inputs are not permitted`	Ajoutez `"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"` dans `env` et redémarrez complètement Claude Code. Si l’erreur persiste, contactez l’assistance.
Contexte trop long pendant une longue session	Exécutez `/compact` pour compresser la session.

Fonctions indisponibles avec une API Key

Le contrôle à distance (Remote Control) et la saisie vocale nécessitent une connexion avec un compte claude.ai. Ils sont indisponibles avec une BetterToken API Key et une Base URL personnalisée. Il s’agit d’une limite du client Claude Code, sans effet sur les conversations de programmation habituelles.

Configuration avancée

Pour gérer plusieurs configurations dans une application, consultez CC Switch.

Questions associées

Détails techniques

Protocole et endpoint

Claude Code utilise Anthropic Messages. Définissez ANTHROPIC_BASE_URL sur https://bettertoken.ai ; le client ajoute /v1/messages, vous ne devez donc pas ajouter /v1 à la Base URL.