API Claude Code et Codex : protocole, configuration et premier test
Une méthode pratique pour valider les contrats API distincts de Claude Code et Codex.
Sommaire
API Claude Code et Codex : protocole, configuration et premier test
Voir « OpenAI-compatible » ne suffit pas pour configurer Claude Code et Codex de la même façon. Claude Code attend le contrat Anthropic Messages ; un fournisseur Codex personnalisé utilise l’API OpenAI Responses. Vérifiez d’abord la documentation, la Base URL, le champ d’authentification et le Model ID actuel, puis seulement le prix.
Pour tester BetterToken, partez du guide Claude Code ou du guide Codex. Les deux parcours emploient des endpoints distincts selon le protocole et une clé créée dans votre propre compte. Après un appel court, Dashboard permet de contrôler le statut, le modèle, les tokens input/output/cache et le débit.
Deux contrats client différents
| Client | Ce qu’il faut valider | Valeur BetterToken à contrôler |
|---|---|---|
| Claude Code | Accès Anthropic-compatible Messages et variables d’authentification documentées | https://bettertoken.ai; Claude Code ajoute /v1/messages |
| Codex CLI/App | Fournisseur personnalisé basé sur Responses, pas seulement Chat Completions | https://www.bettertoken.ai/v1 avec wire_api = "responses" |
Le guide Claude Code actuel indique ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN. N’ajoutez pas /v1 à cette Base URL : le client ajoute lui-même le chemin Messages. Codex lit un fournisseur personnalisé dans ~/.codex/config.toml et la clé dans BETTERTOKEN_API_KEY.
La référence de configuration Codex d’OpenAI et la documentation Claude Code sont les sources primaires pour les clients. Les valeurs propres au fournisseur doivent être relues dans sa documentation actuelle.
Vérification minimale
model_provider = "custom"
model = "YOUR_MODEL_ID"
[model_providers.custom]
base_url = "https://www.bettertoken.ai/v1"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = falseYOUR_MODEL_ID est volontairement un emplacement réservé : disponibilité et identifiants évoluent. Copiez un ID complet depuis le catalogue ou l’écran de configuration du moment, et ne placez pas une clé de fournisseur personnalisé dans ~/.codex/auth.json.
Pour Claude Code, vérifiez plutôt :
{
"env": {
"ANTHROPIC_BASE_URL": "https://bettertoken.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
}
}Le guide actuel précise le fichier et les variables optionnelles. Une clé API ne doit jamais figurer dans un prompt, une issue, une capture ou un dépôt.
Faire un premier test avant la charge réelle
- Ouvrez le guide actuel de la version exacte du client.
- Créez une clé de test personnelle, pas un accès partagé.
- Copiez Base URL et Model ID depuis la documentation ou Dashboard.
- Pour Claude Code, contrôlez route et variables ; pour Codex, fournisseur, variable d’environnement et
wire_api = "responses". - Travaillez dans un dépôt vide, sans secret de production.
- Envoyez une tâche courte et bornée.
- Relevez statut, modèle, tokens, éventuelles reprises et débit final, puis répétez une tâche représentative identique.
Coût et erreurs du premier appel
Le prix du token input seul ne représente pas une tâche d’agent : contexte, sorties d’outils, cache, reprises et longueur de réponse changent la facture. Pour chaque candidat, notez Model ID, tokens input/output/cache, nombre de requêtes, erreurs, reprises et montant final. Consultez la page de prix actuelle de BetterToken ; les chiffres anciens sont historiques.
| Symptôme | Vérification prioritaire |
|---|---|
401 | Clé, nom du champ et absence d’espace collé |
404 / échec de connexion | Base URL du bon protocole, pas un chemin HTTP complet |
model not found | Model ID complet et actuel, même fournisseur et groupe de clés |
| Erreur de mode Codex | wire_api = "responses", pas un réglage Chat Completions seul |
429 | Limite de l’endpoint, Retry-After et sûreté de la reprise |
| Streaming interrompu | Support du streaming, réseau et statut de la requête |
| Débit incompréhensible | Modèle, tokens et reprises dans l’historique |
Ne modifiez qu’un paramètre à la fois. Vous saurez ainsi si l’origine est l’URL, la clé, le modèle ou le client.
Décider sur un test enregistré
Ce contrôle ne classe ni vitesse, ni stabilité, ni prix minimal. Il valide deux contrats client différents. Relisez les documents le jour du test, exécutez une même tâche de dépôt et choisissez à partir du résultat, des erreurs, des tokens et du débit final.
Ouvrez le guide BetterToken Claude Code ou Codex, créez une clé distincte et vérifiez le premier appel dans Dashboard avant tout travail de production.
