Cheat sheet de l'API personnalisée pour Coding Agent : copiez-collez ces configurations pour réduire votre facture de jetons

Chaque agent de codage populaire permet de remplacer le modèle qu'il utilise, mais chacun cache ce paramètre dans un fichier différent, avec un nom de clé et un format d'URL différents. Résultat : les gens abandonnent et continuent de payer les tarifs des modèles « frontier », alors même que les utilisateurs intensifs d'agents atteignent environ 13 USD par développeur actif et par jour sur les modèles par défaut (CloudZero, 2026). Cette page résout ce problème. Il s'agit d'une référence unique contenant la configuration API personnalisée exacte pour Claude Code, OpenClaw, Codex, OpenCode et Cursor, avec la seule distinction qui explique chaque différence entre eux. Mettez-la en favori, car ici, ce qui a de la valeur, ce sont les blocs à copier-coller et les pièges à éviter, pas le remplissage. À la fin, vous serez capable de rediriger n'importe lequel de ces agents vers un modèle moins coûteux en quelques minutes, et vous comprendrez pourquoi l'URL change d'un outil à l'autre.

Points clés

• Les agents de codage se divisent en deux familles de protocoles. Claude Code utilise l'API Anthropic ; OpenClaw, Codex, OpenCode et Cursor utilisent l'API compatible OpenAI.
• L'indice pratique est l'URL : les outils compatibles OpenAI exigent un suffixe /v1, contrairement à Claude Code.
• Chaque configuration nécessite les trois mêmes éléments : une URL de base, une clé API et un ID de modèle. Seuls les noms des champs changent.
• Les modèles à poids ouverts (open-weight) sont payants : DeepSeek V4 Flash coûte environ 0,14 USD par million de jetons en entrée, contre plusieurs dollars pour les modèles « frontier » (Codersera, 2026).

Pourquoi une fiche de configuration API personnalisée pour agent de codage est rentable

La raison pour laquelle il faut s'en soucier est le coût, et la cause est structurelle. Les agents renvoient leur contexte accumulé à chaque étape de raisonnement ; ils consomment donc 10 à 100 fois plus de jetons qu'une fenêtre de chat pour la même tâche (LeanOps, 2026). Ce multiplicateur explique pourquoi les factures des agents explosent, et c'est aussi pourquoi ajuster le coût des jetons, plutôt que d'utiliser moins l'agent, est la stratégie qui fonctionne réellement. Une API personnalisée redirige votre agent vers un backend moins cher sans changer votre façon de travailler. Envoyez le codage de routine vers un modèle à poids ouverts et le coût par jeton chute drastiquement, souvent de 70 % ou plus, tandis que l'écart de qualité sur les tâches quotidiennes reste minime. Une fiche de configuration API pour agent de codage est utile car les économies sont réelles, mais c'est la difficulté de configuration qui freine la plupart des gens, une difficulté qui se résume presque entièrement à : « quel fichier, quel champ, quelle URL ».

Comment fonctionne une fiche de configuration API personnalisée pour agent de codage

Avant de passer aux configurations, voici l'idée maîtresse qui simplifie tout. Les agents de codage appartiennent à deux familles de protocoles, et la famille à laquelle un outil appartient détermine la forme de sa configuration. Claude Code communique avec l'API Messages d'Anthropic ; il lit donc son backend via ANTHROPIC_BASE_URL et s'authentifie avec un jeton de style Anthropic. Tout le reste dans cette fiche — OpenClaw, Codex, OpenCode et Cursor — communique avec l'API Chat Completions compatible OpenAI ; ils utilisent donc une baseURL, une clé de style OpenAI et attendent le chemin /v1 sur le point de terminaison. Ce détail /v1 est la raison la plus fréquente pour laquelle une configuration échoue silencieusement. Une fois que vous avez compris cette distinction, chaque entrée ci-dessous représente les trois mêmes valeurs sous des formes différentes : une URL de base, une clé et un ID de modèle. Les exemples utilisent Atlas Cloud comme fournisseur, car il prend en charge les deux familles de protocoles à partir d'un seul compte. Ainsi, la seule chose qui change entre les outils est la syntaxe, et non la clé que vous copiez. Tout fournisseur compatible fonctionne de la même manière ; il suffit de substituer l'URL de base et la clé.

La fiche de configuration API personnalisée pour agent de codage, outil par outil

Voici d'abord le tableau de référence rapide, puis le bloc de configuration complet pour chaque outil. Préparez votre clé API avant de commencer. Sur Atlas Cloud, créez-en une en sélectionnant Coding Plan comme type de clé, ce qui la lie au quota de codage basé sur les crédits.

Claude Code

Claude Code est l'exception de la famille Anthropic ; notez donc que l'URL de base ne contient pas /v1. Modifiez ~/.claude/settings.json sur macOS ou Linux, ou %USERPROFILE%.claude\settings.json sur Windows :

JSONCopy
1{
2  "env": {
3    "ANTHROPIC_AUTH_TOKEN": "votre-cle-api-atlas",
4    "ANTHROPIC_BASE_URL": "https://api.atlascloud.ai",
5    "ANTHROPIC_MODEL": "zai-org/glm-5.1",
6    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "zai-org/glm-5.1",
7    "ANTHROPIC_DEFAULT_SONNET_MODEL": "zai-org/glm-5.1",
8    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
9  }
10}

Définir les modèles par défaut Haiku et Sonnet sur le même modèle permet également aux appels d'arrière-plan de Claude Code d'utiliser votre modèle, plutôt que d'échouer sur un modèle par défaut indisponible.

OpenClaw

OpenClaw est le plus simple grâce à son assistant de configuration. Dans un terminal, exécutez openclaw onboard, puis choisissez Yes, QuickStart et Custom Provider. Entrez l'URL de base https:​//api.atlascloud.ai/v1, collez votre clé, collez l'ID du modèle et choisissez le protocole OpenAI-compatible. Lorsqu'il affiche Verification successful, nommez le point de terminaison et vous avez terminé. Ce qu'il faut savoir si vous modifiez ~/.openclaw/openclaw.json manuellement : la configuration d'OpenClaw se fait en deux étapes. Vous définissez le fournisseur sous models.providers, puis vous devez ajouter le modèle à la liste blanche sous agents.defaults.models en utilisant la clé nom-fournisseur/nom-modele, sinon l'agent le rejettera (documentation OpenClaw, 2026). L'oubli de cette liste blanche est la première cause de l'erreur « model not allowed ». L'assistant effectue les deux étapes pour vous, c'est pourquoi il est le chemin recommandé.

Codex

Codex utilise deux fichiers. Placez le fournisseur dans ~/.codex/config.toml :

TOMLCopy
1model_provider = "atlas_coding_plan"
2model = "zai-org/glm-5.1"
3
4[model_providers.atlas_coding_plan]
5name = "atlascloud"
6base_url = "https://api.atlascloud.ai/v1"
7wire_api = "chat"
8requires_openai_auth = true

Ensuite, placez la clé dans ~/.codex/auth.json :

JSONCopy
1{ "OPENAI_API_KEY": "votre-cle-api-atlas" }

Exécutez codex dans votre terminal, ignorez l'invite de mise à jour, et vous êtes connecté.

OpenCode et Cursor

OpenCode lit ~/.config/opencode/opencode.json (sur Windows, \Users\votre-nom.config\opencode\opencode.json) :

JSONCopy
1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "atlascloud": {
5      "npm": "@ai-sdk/openai-compatible",
6      "name": "atlascloud",
7      "options": {
8        "baseURL": "https://api.atlascloud.ai/v1",
9        "apiKey": "votre-cle-api-atlas"
10      },
11      "models": {
12        "zai-org/glm-5.1": { "name": "glm-5.1" }
13      }
14    }
15  }
16}

Cursor n'a pas de fichier de configuration pour cela. Ouvrez les paramètres, accédez aux modèles, ajoutez votre ID de modèle par nom, puis définissez l'URL de base personnalisée OpenAI sur https:​//api.atlascloud.ai/v1 et collez votre clé. Comme Cursor suit le modèle compatible OpenAI, la même URL de base et la même clé provenant des autres outils fonctionnent sans modification.

---

Choisir un modèle : L'autre moitié de la fiche de configuration API pour agent de codage

Câbler le point de terminaison n'est que la moitié du travail. Le modèle que vous choisissez détermine les économies réalisées. La stratégie qui fonctionne consiste à utiliser par défaut un modèle ouvert puissant et bon marché pour le codage quotidien, et à garder un modèle « frontier » en réserve pour les raisonnements les plus complexes. L'écart de capacité est plus faible que l'écart de prix : sur SWE-Bench Pro, les meilleurs modèles ouverts atteignent des scores élevés (autour de 70) contre environ 91 pour les meilleurs modèles « frontier » (Codersera, 2026), ce qui se remarque à peine sur le travail de routine et les refactorisations. Sur un fournisseur basé sur des crédits, chaque modèle possède un multiplicateur qui mappe l'utilisation des jetons aux crédits, donc le coût relatif est facile à lire :

Source : Règles de crédit Atlas Cloud Coding Plan. Coût en crédits = jetons entrée × multiplicateur entrée + jetons sortie × multiplicateur sortie. Un choix par défaut pratique : GLM-5.1 ou Kimi K2.6 pour le codage interactif, DeepSeek V4 Flash pour les tâches à haut volume ou en arrière-plan, et un modèle « frontier » uniquement pour les rares cas qu'un modèle ouvert ne peut résoudre. L'échange se fait en une ligne en modifiant l'ID du modèle dans l'une des configurations ci-dessus.

Une seule clé API pour tous les agents de codage

Remarquez ce que le tableau de la fiche montre discrètement : la même clé et les mêmes ID de modèle apparaissent dans chaque configuration. C'est le véritable argument en faveur d'un fournisseur unifié. Si vous connectez chaque outil à un fournisseur différent, vous vous retrouvez avec des clés distinctes, des tableaux de bord séparés, des factures multiples et vous perdez toute vision unifiée des dépenses. Les pointer tous vers un seul fournisseur centralise cela dans un pool de crédits unique et un seul endroit pour changer de modèle. Cela facilite également la budgétisation, ce que la facturation au jeton rend réellement difficile. Un plan qui renouvelle une allocation quotidienne de crédits fixe à minuit limite les dommages causés par une boucle d'agent incontrôlée, tandis que les packs prépayés absorbent les pics occasionnels. Les plans d'Atlas Cloud commencent à 10 USD par mois, ses packs prépayés offrent une remise de 41 % et les mises à niveau en milieu de cycle sont proratisées, de sorte que changer de niveau ne coûte que la différence plutôt qu'un plan entier.

Fiche de configuration API pour agent de codage : Erreurs courantes

Presque toutes les configurations échouées se résument à l'un de ces points, et tous sont rapides à corriger. Le mélange du /v1. L'erreur la plus fréquente dans toute cette fiche. Les outils compatibles OpenAI veulent le suffixe /v1 ; Claude Code ne le veut pas. Une erreur de connexion signifie généralement que le chemin est incorrect pour la famille de cet outil. L'utilisation du mauvais type de clé. Votre clé fournisseur n'est pas votre clé Anthropic, et inversement. Coller la mauvaise entraîne une erreur d'authentification plus confuse qu'elle ne devrait l'être. L'oubli de la liste blanche OpenClaw. Définir le fournisseur n'est que la moitié de la configuration d'OpenClaw. Si vous voyez « model not allowed », le modèle est absent de la liste blanche ou la clé nom-fournisseur/nom-modele contient une faute de frappe. Laisser les modèles d'arrière-plan non définis dans Claude Code. Si vous ne définissez que le modèle principal mais laissez les valeurs par défaut Haiku et Sonnet pointer vers des modèles indisponibles, les petits appels d'arrière-plan échoueront. Définissez les trois.

FAQ : Fiche de configuration API pour agent de codage

Cette fiche de configuration nécessite-t-elle de changer d'outils ?

Non. Le but est justement de garder l'agent que vous utilisez déjà, qu'il s'agisse de Claude Code, OpenClaw, Codex, OpenCode ou Cursor. Une API personnalisée est une modification de configuration, pas une migration ; votre flux de travail reste donc identique tandis que le backend et la facture changent.

Pourquoi l'URL de base dans la fiche change-t-elle selon l'outil ?

À cause de la famille de protocole. Claude Code utilise l'API Anthropic et prend le domaine nu, tandis que les outils compatibles OpenAI attendent le chemin /v1. Même fournisseur, même clé, chemin différent. Cette seule différence explique la plupart des échecs de configuration.

Combien une configuration API personnalisée peut-elle vous faire économiser ?

Beaucoup, selon le modèle. DeepSeek V4 Flash coûte environ 0,14 USD par million de jetons d'entrée contre plusieurs dollars pour les modèles « frontier » (Codersera, 2026). Envoyer le travail de routine vers un modèle ouvert réduit généralement la facture par jeton de 70 % ou plus sans changer votre façon de coder.

Avec quel modèle dois-je commencer à partir de la fiche ?

Pour le codage interactif, GLM-5.1 ou Kimi K2.6 sont des choix par défaut solides et abordables. Pour les tâches à haut volume ou en arrière-plan, DeepSeek V4 Flash est moins cher. Gardez un modèle « frontier » en réserve uniquement pour les tâches qu'un modèle ouvert ne peut vraiment pas gérer.

La configuration API personnalisée est-elle réversible ?

Oui. Chaque configuration est réversible. Restaurez l'URL de base d'origine ou supprimez le bloc fournisseur, et l'agent pointera à nouveau vers sa valeur par défaut. De nombreux développeurs conservent les deux configurations et changent selon la tâche.

Conclusion

La raison pour laquelle cette fiche vaut la peine d'être conservée est que la partie difficile n'a jamais été le concept, mais de se rappeler quel fichier et quelle URL chaque outil exige. Une fois que vous voyez les deux familles de protocoles, chaque configuration est la même URL de base, clé et ID de modèle sous une syntaxe différente. Choisissez un modèle à poids ouverts, collez le bon bloc, respectez la règle du /v1 et vous gardez l'agent que vous aimez tout en payant une fraction des prix « frontier ». Si vous voulez une seule clé et un seul budget pour tous, vous pouvez tout configurer via la console Atlas Cloud Coding Plan et changer de modèle dès que la tâche change.