Skip to main content

​
Protéger votre API Key

Utilisez des variables d’environnement, sans jamais coder la Key en dur. Écrire votre API Key directement dans le code source ou les fichiers de configuration risque de l’exposer accidentellement dans le contrôle de version. Approche recommandée :
Pour Claude Code, gérez les secrets avec le champ env de settings.json plutôt que de les exposer dans votre configuration de shell :
Faites pivoter votre API Key périodiquement. Si vous suspectez une exposition, supprimez immédiatement la Key du Dashboard et générez-en une nouvelle.

​
Définir un délai d’attente suffisant

Les réponses de modèles d’IA peuvent prendre du temps, surtout pour les tâches de raisonnement complexes. Réglez le délai d’attente suffisamment haut pour éviter les déconnexions prématurées :
3000000 ms = 50 minutes. Cette valeur convient au raisonnement approfondi ou aux longues tâches agentiques.

​
Effacer les variables d’environnement en conflit

Si vous avez auparavant utilisé les API officielles Anthropic ou OpenAI, ou un autre service de relais, des variables d’environnement obsolètes peuvent remplacer votre configuration BetterToken et envoyer silencieusement les Request au mauvais endpoint. Avant de configurer BetterToken, vérifiez et effacez ces éléments :

​
Claude Code : vérifiez d’abord le fournisseur

Avec le fournisseur Claude, ne définissez pas ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL ni d’autres variables spécifiques au modèle. Avec le fournisseur GPT, ajoutez les mappages de modèles via ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL et ANTHROPIC_DEFAULT_OPUS_MODEL. Ne mélangez pas les deux configurations, sinon les Request peuvent être routées vers le mauvais modèle. Désactivez le trafic non essentiel. Définir CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 réduit les Request en arrière-plan de Claude Code et réserve votre quota API aux tâches de code réelles. N’ajoutez pas /v1 à Claude Code. ANTHROPIC_BASE_URL doit être https://www.bettertoken.ai.

​
Utiliser une API Key dans plusieurs outils

La même API Key fonctionne dans Claude Code, Codex et les outils externes. Le quota est partagé, ce qui simplifie la gestion centralisée. Mais l’endpoint doit correspondre au protocole :
  • Claude Code / ANTHROPIC_BASE_URL: https://www.bettertoken.ai
  • Codex / OPENAI_BASE_URL / external tools: https://www.bettertoken.ai/v1
Si vous devez suivre l’utilisation séparément par projet ou équipe, créez plusieurs API Key dans le Dashboard et attribuez-en une à chaque outil ou projet. Pour les outils externes, copiez le model ID du fournisseur GPT dans le model plaza.

​
Checklist de dépannage

  1. Confirmez que l’API Key est correcte — vérifiez le Dashboard, collez soigneusement sans espaces superflus
  2. Confirmez l’endpoint du protocole — Claude Code utilise https://www.bettertoken.ai ; Codex / outils externes utilisent https://www.bettertoken.ai/v1
  3. Vérifiez les variables d’environnement en conflit — exécutez echo $ANTHROPIC_AUTH_TOKEN, echo $OPENAI_BASE_URL et les commandes associées
  4. Vérifiez les exigences officielles de configuration de l’outil — pour les outils externes, vérifiez d’abord la Base URL, l’API Key, le model ID et la version de l’outil ; ajoutez des en-têtes supplémentaires uniquement lorsque la documentation officielle de l’outil ou votre passerelle en amont les exige explicitement
  5. Vérifiez votre solde — les Request sont refusées lorsque le solde est épuisé
  6. Contactez le support — si les étapes ci-dessus ne résolvent pas le problème