Aide-mémoire de l'API personnalisée pour les agents de codage : configurations copier-coller pour réduire votre facture de jetons

Chaque agent de développement populaire permet de remplacer le modèle sous-jacent, mais chacun cache ce paramètre dans un fichier, un nom de clé et un format d'URL différents. Résultat : les développeurs abandonnent et continuent de payer les tarifs des modèles « frontier », alors que les utilisateurs intensifs d'agents atteignent environ 13 USD par jour de développement actif 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, ainsi que la distinction clé qui explique chaque différence entre eux. Mettez cette page en favori, car sa valeur réside dans les blocs de code à copier-coller et les pièges à éviter, pas dans du 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 développement 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, tandis que Claude Code ne le demande pas.
• Chaque configuration nécessite trois éléments : une URL de base, une clé API et un identifiant de modèle. Seuls les noms des champs changent.
• Les modèles à poids ouverts sont la solution : DeepSeek V4 Flash coûte environ USD0.14 par million de jetons en entrée, contre plusieurs dollars pour les modèles « frontier » (Codersera, 2026).

Pourquoi une antisèche d'API personnalisée pour agent de développement est rentable

La raison est financière, et la cause est structurelle. Les agents renvoient leur contexte accumulé à chaque étape de raisonnement, consommant ainsi 10 à 100 fois plus de jetons qu'une fenêtre de chat pour la même tâche (LeanOps, 2026). Ce multiplicateur explique l'explosion des factures ; la solution efficace consiste donc à ajuster le coût des jetons plutôt qu'à réduire l'usage de l'agent. Une API personnalisée redirige votre agent vers un backend moins cher sans changer vos habitudes. Envoyez vos tâches de codage routinières vers un modèle à poids ouverts : 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 antisèche d'API personnalisée est essentielle car les économies sont réelles, mais la friction de configuration est ce qui bloque la plupart des gens, et cette friction tient presque entièrement au "quel fichier, quel champ, quelle URL".

Fonctionnement d'une entrée d'antisèche d'API pour agent

Avant les configurations, voici le concept central qui simplifie tout. Les agents de développement appartiennent à deux familles de protocoles, et l'appartenance d'un outil définit 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 type Anthropic. Tous les autres outils de cette antisèche (OpenClaw, Codex, OpenCode et Cursor) communiquent avec l'API Chat Completions compatible OpenAI ; ils utilisent donc une baseURL, une clé de type OpenAI et attendent le chemin /v1 sur le point de terminaison. Ce détail /v1 est la cause la plus fréquente d'échec silencieux d'une configuration. Une fois cette distinction comprise, chaque entrée ci-dessous représente les mêmes trois valeurs sous des formes différentes : une URL de base, une clé et un identifiant de modèle. Les exemples utilisent Atlas Cloud comme fournisseur car il prend en charge les deux familles de protocoles avec un seul compte. Ainsi, seule la syntaxe change selon l'outil, pas la clé. Tout fournisseur compatible fonctionne de la même manière ; il suffit de remplacer l'URL de base et la clé.

L'antisèche d'API pour agent, 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 que l'URL de base ne contient pas /v1. Modifiez ~/.claude/settings.json sur macOS/Linux, ou %USERPROFILE%.claude\settings.json sur Windows :

plaintextCopy
1{
2  "env": {
3    "ANTHROPIC_AUTH_TOKEN": "your-atlas-api-key",
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 Haiku et Sonnet par défaut sur le même modèle permet aux appels de fond de Claude Code de passer par votre modèle, évitant ainsi les erreurs dues à un modèle indisponible par défaut.

OpenClaw

OpenClaw est le plus simple grâce à son assistant. 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é, entrez l'identifiant du modèle et choisissez le protocole OpenAI-compatible. Lorsqu'il affiche Verification successful, nommez le point de terminaison et c'est terminé. Si vous modifiez ~/.openclaw/openclaw.json manuellement : OpenClaw nécessite une configuration en deux étapes. Vous définissez le fournisseur dans models.providers, puis vous devez autoriser le modèle dans agents.defaults.models en utilisant la clé provider-name/model-name, sinon l'agent le rejettera (docs OpenClaw, 2026). L'oubli de cette liste d'autorisation est la cause principale de l'erreur "model not allowed".

Codex

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

plaintextCopy
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

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

plaintextCopy
1{ "OPENAI_API_KEY": "your-atlas-api-key" }

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) :

plaintextCopy
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": "your-atlas-api-key"
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 (Settings), allez dans Models, ajoutez votre identifiant de modèle par son nom, définissez l'URL de base OpenAI personnalisée sur https:​//api.atlascloud.ai/v1 et collez votre clé. Comme Cursor suit le modèle compatible OpenAI, l'URL de base et la clé fonctionnent sans modification.

Choisir un modèle : L'autre moitié de l'antisèche

Le choix du modèle détermine vos économies. La stratégie efficace consiste à privilégier un modèle ouvert puissant et bon marché pour le codage quotidien, et de garder un modèle « frontier » en réserve pour les raisonnements complexes. L'écart de capacité est plus faible que l'écart de prix : sur SWE-Bench Pro, les meilleurs modèles ouverts obtiennent des scores élevés (proches de 70) contre environ 91 pour les meilleurs modèles frontier (Codersera, 2026), ce qui est à peine perceptible sur les tâches routinières. Chez un fournisseur basé sur les crédits, chaque modèle a un multiplicateur qui convertit l'utilisation des jetons en crédits :

Une seule clé API pour tous les agents

Le tableau de l'antisèche le montre : la même clé et les mêmes identifiants de modèles fonctionnent partout. C'est l'argument en faveur d'un fournisseur unifié. Si vous connectez chaque outil à un fournisseur différent, vous multipliez les clés, les tableaux de bord et les factures. Centraliser chez un seul fournisseur permet de gérer une seule réserve de crédits et de changer de modèle en un clic.

Erreurs courantes

La confusion sur le /v1. L'erreur la plus fréquente. Les outils compatibles OpenAI veulent le suffixe /v1 ; Claude Code ne le veut pas. Mauvais type de clé. Votre clé de fournisseur n'est pas votre clé Anthropic. Cela provoque une erreur d'authentification. Oubli de la liste d'autorisation OpenClaw. Si vous voyez "model not allowed", le modèle est absent de la liste ou il y a une faute de frappe dans la clé provider-name/model-name. Modèles de fond non définis dans Claude Code. Si vous réglez le modèle principal mais laissez Haiku/Sonnet pointer vers des modèles indisponibles, les appels de fond échoueront. Réglez les trois.

FAQ

Cette antisèche nécessite-t-elle de changer d'outils ? Non. Vous gardez l'agent que vous utilisez déjà (Claude Code, OpenClaw, etc.). Il s'agit d'une modification de configuration, pas d'une migration. Pourquoi l'URL de base change-t-elle selon l'outil ? À cause de la famille de protocole. Claude Code utilise l'API Anthropic et prend le domaine brut, les autres attendent le chemin /v1. Combien peut-on économiser ? Beaucoup. Envoyer le travail courant vers un modèle ouvert réduit généralement la facture de 70 % ou plus. L'antisèche est-elle réversible ? Oui. Chaque configuration est réversible. Restaurez l'URL d'origine ou supprimez le bloc fournisseur.

Conclusion

L'intérêt de cette antisèche est de ne plus avoir à mémoriser quel fichier ou quelle URL chaque outil exige. Une fois les deux familles de protocoles identifiées, chaque configuration devient identique. Choisissez un modèle à poids ouverts, copiez le bon bloc, respectez la règle du /v1, et conservez votre agent tout en payant une fraction des prix habituels. Si vous voulez un budget unifié, configurez le tout via la console Atlas Cloud.