Coûts et limites

Comment configurer ANTHROPIC_BASE_URL et la clé API dans Claude Code

Configurez ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN dans Claude Code, évitez les conflits de réglages et testez la connexion sans exposer votre clé API.

BetterToken

Équipe éditoriale

14 août 20266 min de lecture

Comment configurer ANTHROPIC_BASE_URL et la clé API dans Claude Code

Pour utiliser Claude Code avec BetterToken, définissez ANTHROPIC_BASE_URL=https://bettertoken.ai — sans /v1 — et transmettez votre clé API via ANTHROPIC_AUTH_TOKEN. Le plus simple est de conserver ces valeurs dans le fichier utilisateur ~/.claude/settings.json : elles s’appliqueront à tous vos projets sans avoir à ajouter la clé dans chaque dépôt.

La documentation BetterToken à jour pour Claude Code contient un exemple pris en charge ainsi que les options pour VS Code. Dans cette configuration, BetterToken fournit un accès API distinct, facturé à l’usage ; une clé API ne devient pas pour autant un abonnement Claude et les règles du compte Anthropic ne changent pas.

Si vous n’avez pas encore de clé, connectez-vous d’abord au Workspace BetterToken, créez votre propre API Key, puis vérifiez dans le guide actuel le group ou le mapping requis pour le modèle choisi. N’utilisez ni une clé d’équipe partagée ni un ancien group repris d’un autre exemple : la suite suppose que vous disposez déjà d’une clé personnelle adaptée.

Les deux valeurs à renseigner

Champ	Valeur pour BetterToken	Erreur fréquente
`ANTHROPIC_BASE_URL`	`https://bettertoken.ai`	Ajouter `/v1`, destiné aux clients OpenAI-compatible
`ANTHROPIC_AUTH_TOKEN`	`YOUR_API_KEY`	Coller la clé avec un espace, des guillemets issus du gestionnaire de mots de passe ou dans un fichier public

Claude Code utilise le protocole Anthropic. Son adresse diffère donc de celle de Codex et des autres clients OpenAI-compatible, qui ont généralement besoin de `https://www.bettertoken.ai/v1%60.?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka

Étape 1. Supprimer les variables conflictuelles

Avant toute modification, vérifiez si d’anciennes valeurs sont encore présentes :


printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"

N’affichez jamais le token lui-même. Si ces variables sont définies dans le shell actuel et doivent laisser la priorité au fichier de configuration, supprimez-les :


unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN

Vérifiez ensuite ~/.zshrc, ~/.bashrc, les fichiers .env, les réglages de l’IDE et tout gestionnaire de fournisseurs. Un processus déjà lancé peut continuer à utiliser les variables héritées au démarrage, même après la modification du fichier.

Étape 2. Ajouter la configuration utilisateur

Selon la documentation officielle de Claude Code, les réglages utilisateur se trouvent dans ~/.claude/settings.json, ceux du projet dans .claude/settings.json et les réglages locaux du projet dans .claude/settings.local.json.

Pour BetterToken, ajoutez ce bloc :


{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai/?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

Remplacez uniquement YOUR_API_KEY. Si le fichier contient déjà permissions, hooks, plugins ou d’autres champs, ne l’écrasez pas entièrement : ajoutez ou fusionnez l’objet env tout en conservant un JSON valide.

Limitez l’accès au fichier, puis vérifiez que les droits ont bien été appliqués :


chmod 600 ~/.claude/settings.json
ls -l ~/.claude/settings.json

La sortie ne doit accorder aucun droit de lecture ou d’écriture au groupe ni aux autres utilisateurs. Ne joignez pas le fichier complet à une issue. Pour une configuration en équipe, ne publiez pas un token de travail commun : chaque personne doit disposer de sa propre clé.

Étape 3. Redémarrer Claude Code

Arrêtez complètement le processus en cours, puis relancez claude. Ouvrir un nouvel onglet de terminal ne suffit pas si Claude Code tourne encore : le processus conserve l’environnement reçu au démarrage.

L’extension VS Code possède son propre point de configuration, claudeCode.environmentVariables, dans le fichier settings.json de VS Code. Ne partez pas du principe que le shell du terminal et l’extension lisent toujours les mêmes variables.

Étape 4. Tester la connexion avec une petite tâche

Lancez Claude Code dans un dossier de test et envoyez une requête sans risque :


Réponds sur une seule ligne : CLAUDE_PROVIDER_OK. Ne modifie aucun fichier et n’exécute aucune commande.

Avant d’envoyer la requête, notez l’heure actuelle. La configuration fonctionne si :

la réponse arrive sans erreur 401, 403, ConnectionRefused ni model not found ;
une nouvelle entrée apparaît dans le Workspace BetterToken avec une heure postérieure au lancement du test ;
cette entrée indique le modèle attendu, le statut et la consommation ;
Claude Code ne revient pas à l’ancien fournisseur après le redémarrage.

Une réponse réussie ne prouve pas à elle seule le routage : en cas de conflit, Claude Code a pu utiliser un autre provider. La nouvelle entrée de la requête de test dans le Workspace constitue la confirmation. N’ouvrez le dépôt de travail qu’après avoir confirmé qu’une nouvelle entrée horodatée après le lancement du test apparaît dans le Workspace.

Repérer les conflits de configuration

Ne supposez pas qu’il existe un ordre de priorité universel : la configuration effective dépend du mode de lancement, des managed policies et de l’environnement déjà hérité par le processus. Commencez par repérer toutes les sources qui contiennent les noms concernés :


printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
grep -lE '"ANTHROPIC_(BASE_URL|AUTH_TOKEN)"' \
  ~/.claude/settings.json \
  .claude/settings.json \
  .claude/settings.local.json 2>/dev/null

La commande affiche uniquement les noms de fichiers, jamais la valeur du token. Vérifiez également les managed settings de l’organisation, l’extension VS Code et tout gestionnaire de fournisseurs externe utilisé au démarrage. Modifiez ensuite une seule source à la fois, redémarrez complètement le client et répétez la petite requête en vérifiant la nouvelle entrée dans le Workspace.

Erreurs fréquentes

`ConnectionRefused` ou connexion au mauvais endpoint

Vérifiez l’adresse caractère par caractère : https://bettertoken.ai, sans /v1, sans /messages et sans espace final. Le client ajoute lui-même le chemin nécessaire.

`401` ou `authentication failure`

Créez une nouvelle clé si vous soupçonnez une fuite, copiez-la sans espaces et vérifiez que vous utilisez bien ANTHROPIC_AUTH_TOKEN, et non une variable prévue pour un autre client. N’envoyez jamais le token en clair au support.

Les modifications ne sont pas prises en compte

Fermez tous les processus Claude Code, recherchez les anciennes valeurs avec printenv, puis relancez le client. Dans VS Code, exécutez Reload Window ou redémarrez l’extension.

`model not found`

N’utilisez pas un Model ID pris au hasard dans un ancien article. Si la clé ou le modèle exige un mapping explicite, copiez l’ID actuel depuis Setup ou depuis la documentation Claude Code à jour.

Liste de contrôle rapide

La Base URL de Claude Code ne contient pas /v1.
La véritable clé ne se trouve ni dans Git ni dans une capture d’écran.
Toutes les anciennes sources de configuration ont été repérées et vérifiées une par une.
Le client a été complètement redémarré.
La petite requête en lecture seule est visible dans le Workspace.

Lorsque ces cinq points sont validés, passez à la tâche réelle. Sinon, ouvrez le guide pas à pas de configuration de Claude Code, sélectionnez votre client et vérifiez chaque champ séparément au lieu de remplacer toute la configuration.

Prêt à optimiser votre workflow LLM ?

Connectez vos modèles via une API unique, gérez les clés et maîtrisez vos dépenses d’IA.