Source: https://aiprimetech.io/fr/learn/use-claude-api-with-codex/ [Accueil](/fr/) / [Apprendre](/fr/learn/) / Codex CLI avec un fournisseur personnalisé : config.toml, modèles GPT et Claude, extension pour IDE et correctifs # Codex CLI avec un fournisseur personnalisé : config.toml, modèles GPT et Claude, extension IDE et correctifs Codex lit un seul fichier, ~/.codex/config.toml, partagé par la CLI, codex exec et l’extension pour IDE. Un fournisseur personnalisé défini dans ce fichier dirige Codex vers cette passerelle, où la même configuration permet d’utiliser des modèles GPT et Claude. Les versions actuelles de Codex utilisent uniquement la Responses API (wire_api = "responses"), de sorte que les anciens guides qui utilisent wire_api = "chat" ne fonctionnent plus. ## Installer Codex terminalCopier ``` # macOS / Linux curl -fsSL https://chatgpt.com/codex/install.sh | sh # or with a package manager npm install -g @openai/codex brew install --cask codex codex --version ``` Windows PowerShellCopier ``` powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" ``` L’extension Codex pour VS Code, Cursor et Windsurf s’installe depuis la place de marché des extensions de l’éditeur et utilise le même ~/.codex/config.toml que la CLI ; tout ce qui suit s’applique donc aux deux. ## Utiliser une clé du bon groupe Une clé de passerelle appartient à un groupe, et ce groupe détermine les modèles qu’elle peut appeler. Pour les modèles GPT, créez la clé dans le groupe **Codex** du tableau de bord. Pour les modèles Claude, toute clé Claude avec paiement à l’usage convient. Une clé d’un groupe Unlimited nécessite une offre active ; sans celle-ci, chaque requête échoue avec No active subscription found for this group. ~/.bashrc ou ~/.zshrcCopier ``` export AIPRIME_CODEX_KEY=key_from_the_codex_group # GPT models export AIPRIME_CLAUDE_KEY=key_from_a_claude_group # Claude models ``` WindowsCopier ``` setx AIPRIME_CODEX_KEY "key_from_the_codex_group" setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group" # open a new terminal afterwards ``` ## config.toml pour les modèles GPT ~/.codex/config.tomlCopier ``` model_provider = "aiprime" model = "gpt-6-astra" model_reasoning_effort = "high" [model_providers.aiprime] name = "AI Prime Tech" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CODEX_KEY" wire_api = "responses" supports_websockets = false ``` | Définir | Pourquoi | [model_providers.aiprime] | Tout identifiant sauf l’identifiant réservé openai, ollama et lmstudio | base_url = "https://aiprimetech.io/v1" | Codex ajoute /responses à cette valeur | env_key | Le **nom** de la variable d’environnement contenant la clé, et non la clé elle-même | wire_api = "responses" | La seule valeur acceptée par les versions actuelles de Codex | supports_websockets = false | Maintient Codex en streaming HTTP simple, qui fonctionne avec n’importe quel proxy ou VPN N’ajoutez pas requires_openai_auth = true ou experimental_bearer_token à ce fournisseur. Avec requires_openai_auth = true Codex ignore env_key et envoie à la place vos identifiants de connexion ChatGPT ou OpenAI, que la passerelle refuse. ## Utiliser Codex avec les modèles Claude La passerelle accepte les requêtes Responses API pour les modèles Claude et les convertit, ce qui permet à Codex de piloter également Claude. Ajoutez un second fournisseur qui utilise votre clé Claude, puis un profil pour basculer vers celui-ci. ~/.codex/config.toml (à ajouter sous le premier fournisseur)Copier ``` [model_providers.aiprime_claude] name = "AI Prime Tech (Claude)" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CLAUDE_KEY" wire_api = "responses" supports_websockets = false ``` ~/.codex/claude.config.tomlCopier ``` model_provider = "aiprime_claude" model = "claude-sonnet-5" model_reasoning_effort = "high" ``` terminalCopier ``` codex --profile claude codex exec --profile claude "review the last commit for bugs" ``` Depuis Codex 0.134.0, chaque profil dispose de son propre fichier, ~/.codex/.config.toml, avec ses clés au niveau racine ; [profiles.] les tables dans config.toml ne sont plus lues. Les profils et les fournisseurs ne peuvent être définis que dans votre configuration utilisateur : le fichier du projet .codex/config.toml ignore model_provider et model_providers. ## Modèles et effort de raisonnement | Identifiant du modèle | Fournisseur | À utiliser pour | gpt-6-astra | Clé du groupe Codex | Le modèle GPT le plus puissant de la passerelle ; longues tâches d’agent | gpt-6-sol | Clé du groupe Codex | Un modèle GPT plus rapide et moins cher pour la programmation courante | gpt-5.6-terra | Clé du groupe Codex | Tâches simples et modifications rapides | claude-sonnet-5 | Clé Claude | Le modèle Claude par défaut pour les tâches de programmation | claude-opus-5-5 | Clé Claude | Raisonnement plus complexe et refactorisations importantes | claude-fable-5-1 | Clé Claude | Le plus performant et le plus cher model_reasoning_effort accepte low, medium, high, xhigh ou max, selon le modèle. Ne définissez pas none : ces modèles refusent cette valeur avec 'none' is not supported. review_model définit un modèle différent pour /review si vous le souhaitez. Le tableau de bord affiche tous les modèles que le groupe de votre clé peut appeler. ## Extension pour IDE et codex exec L’extension pour IDE lit le même config.toml, mais env_key est résolu à partir de l’environnement propre à l’éditeur. Un éditeur lancé depuis le Dock ou le menu Démarrer ne voit pas les variables exportées dans .bashrc, et Codex échoue alors avec Invalid API key alors que la CLI fonctionne. Définissez la variable au niveau du système (sous Windows, setx permet de le faire), ou lancez l’éditeur depuis un terminal, par exemple code .. codex exec exécute une seule tâche sans interface interactive, ce qui convient aux scripts et à la CI. Il utilise la même configuration et les mêmes profils : terminalCopier ``` codex exec "write unit tests for utils.py" codex exec --profile claude "summarise the changes on this branch" codex login status # which authentication method is active ``` ## Nouvelles tentatives et délais d’attente Chaque fournisseur possède ses propres paramètres de nouvelle tentative et de streaming. Les valeurs par défaut sont de 4 nouvelles tentatives de requête, 5 reconnexions du flux et un délai d’inactivité de 5 minutes par flux. Les longues phases de raisonnement peuvent rester silencieuses pendant un certain temps ; augmenter le délai d’inactivité est donc utile pour les niveaux d’effort élevés. ~/.codex/config.tomlCopier ``` [model_providers.aiprime] # ...settings from above... request_max_retries = 6 stream_max_retries = 8 stream_idle_timeout_ms = 600000 ``` ## Dépannage : erreurs rencontrées par les utilisateurs de Codex Les erreurs ci-dessous sont celles que les clients Codex produisent réellement sur cette passerelle, classées de la plus courante à la moins courante. | Ce que vous voyez | Cause | Solution | 403 No active subscription found for this group | La clé appartient à un groupe Unlimited sans offre active | Utilisez une clé d’un groupe avec paiement à l’usage (Codex pour GPT), ou souscrivez une offre | 401 Invalid API key | La variable est vide dans le processus qui exécute Codex (souvent l’IDE), ou requires_openai_auth = true a amené Codex à envoyer d’autres identifiants de connexion | echo $AIPRIME_CODEX_KEY ; supprimez requires_openai_auth ; redémarrez l’éditeur | 404 Model "..." is not supported by any configured account in this group | Le modèle n’appartient pas au groupe de la clé, par exemple un modèle Claude avec une clé GPT | Changez de fournisseur ou de profil pour que la clé corresponde au modèle | 426 WebSocket upgrade required | Le transport WebSocket est activé, mais la connexion n’a pas été mise à niveau | supports_websockets = false, et supprimez responses_websockets_v2 de [features] | 403 Your API key has expired | La clé a été créée avec une date d’expiration | Créez une nouvelle clé dans le tableau de bord | 'none' is not supported | Effort de raisonnement défini sur none | Utilisez low ou un niveau supérieur | 404 page not found | base_url contient /v1 deux fois | Utilisez exactement https://aiprimetech.io/v1 | Erreur de configuration concernant wire_api après une mise à niveau | A wire_api = "chat" ligne provenant d’un ancien guide | Définissez wire_api = "responses" | Your balance is used up | Le solde est nul | [Recharger](/fr/topup/) | Concurrency limit exceeded for user | Plusieurs agents ou fenêtres Codex fonctionnent en même temps | Réduisez le nombre d’exécutions en parallèle ou demandez au support une limite de concurrence plus élevée Vous comparez Codex et Claude Code avant de choisir ? Consultez [Claude Code vs Codex](/fr/claude-code/vs-codex/). ## Questions fréquentes Où se trouve le fichier de configuration de Codex ? ~/.codex/config.toml (ou $CODEX_HOME/config.toml). La CLI, codex exec et l’extension IDE le lisent tous. Le fichier .codex/config.toml d’un projet ne peut pas définir de fournisseurs. La CLI Codex peut-elle utiliser les modèles Claude ? Oui, via une passerelle qui accepte les requêtes Responses API pour les modèles Claude. Ajoutez un fournisseur avec une clé Claude et définissez model sur un identifiant tel que claude-sonnet-5. wire_api = "chat" fonctionne-t-il encore dans Codex ? Non. La référence de configuration de Codex indique que responses est la seule valeur prise en charge ; c’est aussi la valeur par défaut lorsque le paramètre est omis. Pourquoi l’extension Codex pour VS Code indique-t-elle que la clé API est invalide alors que la CLI fonctionne ? env_key est lu dans l’environnement de l’éditeur. Définissez la variable au niveau du système ou lancez l’éditeur depuis un terminal où elle est exportée. Que signifie « Aucun abonnement actif trouvé pour ce groupe » dans Codex ? La clé appartient à un groupe d’abonnement (Unlimited) sans forfait actif. Utilisez une clé d’un groupe avec paiement à l’usage ou achetez un forfait. Commencez à utiliser Claude en quelques minutes Obtenez une clé API — aucun compte Anthropic ni inscription sur liste d’attente requis.[Obtenir votre clé API](/register) AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs. Guides des API Codex et GPT: [Clé API et accès à Codex](/fr/codex-api/) · [API compatible avec OpenAI](/fr/openai-api/) · [Configuration de Codex CLI](/fr/docs/guides/codex-cli/) · [Comparaison des modèles GPT-6](/fr/blog/gpt-6-models-for-codex/) ## Autres guides sur l’API Claude [Comment obtenir une clé API Claude](/fr/learn/how-to-get-a-claude-api-key/)[Comprendre la tarification de l’API Claude](/fr/learn/claude-api-pricing-explained/)[La façon la moins chère d’utiliser l’API Claude](/fr/learn/cheapest-way-to-use-claude-api/)[Cursor illimité avec l’API Claude](/learn/use-claude-api-with-cursor/)[Accès illimité à Claude Code](/fr/learn/use-claude-api-with-claude-code/)[Passerelle API Claude ou accès direct à Anthropic](/fr/learn/claude-api-vs-anthropic-direct/)[Utiliser Claude via une API compatible avec OpenAI](/fr/learn/openai-compatible-claude-api/)[Comprendre les modèles Claude : comparaison de Claude Opus, Sonnet, Haiku et Fable — tous les modèles de l’API Claude, noms des modèles Anthropic et prix (2026)](/fr/learn/claude-api-models-compared/)[Payer l’API Claude en cryptomonnaies](/fr/learn/claude-api-with-crypto-payment/)[Accéder à l’API Claude sans liste d’attente](/fr/learn/claude-api-without-waitlist/)[Comment réduire la consommation de tokens de Claude](/fr/learn/how-to-reduce-claude-token-usage/)[Cline illimité avec l’API Claude](/fr/learn/use-claude-api-with-cline/)[Roo Code illimité avec l’API Claude](/fr/learn/use-claude-api-with-roo-code/)[Claude illimité dans les IDE JetBrains](/fr/learn/use-claude-api-with-jetbrains/)[Utiliser Aider sans limites avec l’API Claude](/fr/learn/use-claude-api-with-aider/)[Claude illimité dans VS Code](/fr/learn/use-claude-api-with-vscode/)[Configuration d’OpenCode pour Claude : paramètres d’opencode.json, modèles et erreurs courantes](/fr/learn/use-claude-api-with-opencode/)[Exécuter un agent Hermes sans limites sur Claude](/fr/learn/run-hermes-agent-with-claude-api/)[Utiliser OpenClaw sans limites avec Claude](/fr/learn/run-openclaw-with-claude-api/)[Ce que signifie une API compatible avec Anthropic](/fr/learn/anthropic-compatible-api/)[Clé API Claude Code — ANTHROPIC_API_KEY : comment l’obtenir, la configurer et quand utiliser claude setup-token à la place](/fr/learn/claude-code-api-key-setup/)[Coûts de l’API Claude Code — Tarifs et moyens de les réduire](/fr/learn/claude-code-api-costs/)[Les erreurs de l’API Claude expliquées : erreur serveur 500, surcharge 529, limite de débit 429, requête incorrecte 400 — et le correctif pour chacune](/fr/learn/claude-api-errors-troubleshooting/)[Comment acheter des crédits pour l’API Claude — et pourquoi un crédit Claude vaut mieux que toute offre d’« achat de compte Claude »](/fr/learn/buy-claude-api-credits/)[API Claude gratuite : existe-t-il une clé API Claude gratuite, et qu’est-ce qui est réellement gratuit en 2026 ?](/fr/learn/claude-api-free-trial/)[API Claude ou abonnement Claude Pro/Max — Que choisir](/fr/learn/claude-api-vs-subscription/)[Connecter Claude à n8n](/fr/learn/use-claude-api-with-n8n/)[Router LiteLLM vers Claude](/fr/learn/use-claude-api-with-litellm/)[Utiliser Claude dans Kilo Code](/fr/learn/use-claude-api-with-kilo-code/)[Intégrer Claude à GitHub Copilot](/fr/learn/use-claude-api-with-github-copilot/)[Connecter Zed à Claude via la passerelle](/fr/learn/use-claude-api-with-zed/)[Connecter Cherry Studio à Claude](/fr/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic dans LangChain : importation, base_url, streaming, outils et erreurs](/fr/learn/use-claude-api-with-langchain/)[SDK Python Anthropic : installation, configuration de base_url, streaming et gestion des erreurs](/fr/learn/anthropic-python-sdk/)[Claude avec Vercel AI SDK : baseURL de createAnthropic, streaming et corrections](/fr/learn/use-claude-api-with-vercel-ai-sdk/)[Utiliser Factory Droid avec Claude](/fr/learn/use-claude-api-with-factory-droid/)[L’API de Claude Code expliquée](/fr/learn/claude-code-api/)[Intégrer l’API Claude à votre application](/fr/learn/claude-api-integration/)[Comment utiliser Claude sans limites — et pourquoi il n’existe pas de « Claude Code piraté »](/fr/learn/get-unlimited-claude-usage/)