Codex fonctionnait autrefois comme serveur MCP pour Claude Code, mais la commande codex mcp-server a été retirée de la CLI. Cet article explique ce qui a cassé, quelles solutions fonctionnent aujourd’hui, les commandes d’installation exactes, les réglages du bac à sable et les corrections des erreurs courantes.
Si vous avez tapé codex mcp-server dans un terminal et obtenu Error: stdin is not a terminal, votre machine n’est pas en cause. La commande a disparu. Pendant un temps, Codex MCP pour Claude Code désignait une seule configuration : lancer Codex comme serveur MCP, l’enregistrer dans Claude Code et laisser un agent de code demander l’avis d’un deuxième agent. OpenAI a depuis retiré cette sous-commande, et chaque tutoriel qui la montre mène à une impasse.
Cet article explique ce qui a changé, quelles solutions fonctionnent aujourd’hui et les commandes exactes pour chacune. Vous obtenez le plugin officiel, un wrapper MCP communautaire, une solution provisoire avec une ancienne CLI et la configuration inverse, où Codex appelle Claude Code. Chaque commande provient de la documentation d’OpenAI, du dépôt du plugin ou du README du wrapper, pour que vous puissiez la copier sans deviner.
💡 En bref : installez le plugin Codex officiel pour Claude Code. Choisissez un wrapper MCP communautaire seulement si vous voulez que Codex apparaisse comme de vrais outils MCP.
La CLI Codex embarquait autrefois une sous-commande, codex mcp-server, qui démarrait Codex comme serveur MCP stdio. Claude Code pouvait le lancer comme n’importe quel autre serveur, si bien qu’une seule ligne claude mcp add transformait Codex en outil. Le serveur exposait deux outils :
| Outil | Ce qu’il faisait | Entrées principales |
|---|---|---|
codex | Lançait une nouvelle session Codex | prompt, approval-policy, sandbox |
codex-reply | Poursuivait une session existante | prompt, threadId |
Le premier appel renvoyait un threadId. Le transmettre à codex-reply faisait continuer la conversation : Claude Code pouvait confier une tâche à Codex, lire la réponse, puis relancer dans la même session. Le champ approval-policy acceptait untrusted, on-request ou never, et sandbox acceptait read-only, workspace-write ou danger-full-access.
L’ancien enregistrement ressemblait à la ligne ci-dessous. Elle ne fonctionne plus sur une CLI actuelle :
claude mcp add codex -- codex mcp-server
La documentation MCP d’OpenAI indique désormais que la commande codex mcp-server et le binaire autonome codex-mcp-server ont été supprimés. Sur une CLI actuelle, mcp-server n’est pas une sous-commande reconnue : la CLI traite le mot comme un prompt et tente d’ouvrir son interface interactive. Claude Code lance les serveurs via un tube, sans terminal attaché, si bien que la CLI s’arrête avec Error: stdin is not a terminal. Un rapport de bug du projet Quest attribue la panne exactement à ce repli.
Dans Claude Code, le symptôme est un serveur qui apparaît comme failed dans /mcp, sans aucun outil listé. Rien dans votre configuration n’est faux. Ce vers quoi elle pointe n’existe plus.
Un retour d’expérience sur une migration date l’avis de dépréciation à Codex CLI 0.149.1, publiée le 24 août 2026. Des rapports de bug émanant de plusieurs projets qui dépendaient de la commande, dont Quest et la compétence second-opinion de Trail of Bits, citent Codex CLI 0.154.0 comme la version où elle a disparu. Vérifiez ce que vous utilisez :
codex --version
Toute version à partir de 0.154.0 ne contient plus la sous-commande, donc aucune modification de configuration ne la fera revenir.
Choisissez selon la manière dont vous voulez que Codex apparaisse dans Claude Code. Le tableau résume le compromis d’un coup d’œil :
| Option | Maintenue par | Apparaît comme | Point faible |
|---|---|---|---|
| Plugin Codex pour Claude Code | OpenAI | Commandes slash telles que /codex:review | Pas des outils MCP |
| Wrapper MCP communautaire | Un tiers | Outils MCP tels que ask-codex | Non officiel, enveloppe codex exec |
| Ancienne CLI Codex | OpenAI, figée | Les outils codex et codex-reply d’origine | Aucune mise à jour, casse à la mise à niveau |
Si votre objectif est un second avis sur du code, le plugin est le chemin le plus court. Si vous avez déjà des prompts, des scripts ou des sous-agents qui appellent des outils MCP par leur nom, le wrapper conserve cette structure avec le moins de réécriture.
OpenAI publie openai/codex-plugin-cc. Il enveloppe le serveur d’application Codex via le binaire codex déjà présent sur votre machine, si bien qu’il réutilise votre connexion et votre configuration Codex. Il nécessite Node.js 18.18 ou supérieur ainsi qu’un abonnement ChatGPT (la formule gratuite convient) ou un token d’API OpenAI. Le compromis : vous obtenez des commandes slash et des tâches en arrière-plan, pas des outils MCP.
@cexll/codex-mcp-server conserve la structure MCP. Il appelle codex exec en coulisses et expose les outils ask-codex, brainstorm, ping et help. Il nécessite Node.js 18 ou supérieur et une CLI Codex installée et connectée. Comme il s’agit de code tiers qui s’exécute sur votre dépôt, lisez-le avant de lui faire confiance, et attendez-vous à ce qu’il accuse un retard de quelques jours ou semaines sur les évolutions de la CLI Codex.
Vous pouvez installer une version de la CLI Codex antérieure au retrait et garder codex mcp-server opérationnel :
npm install -g @openai/codex@<a-version-before-0.154.0>
Vérifiez que la sous-commande existe avant de la brancher. Cela ne fait que gagner du temps : vous passez à côté des nouveaux modèles et des corrections, et la prochaine mise à niveau casse à nouveau la configuration.
💡 Considérez l’ancienne CLI comme un pont pour une semaine, pas comme une architecture.
Installez d’abord la CLI Codex. Le plugin dépend de ce binaire global et utilise la connexion déjà enregistrée dans celui-ci.
Depuis un shell normal, installez la CLI :
npm install -g @openai/codex
Puis exécutez ces commandes dans Claude Code, une à la fois :
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
/codex:setup vérifie que Codex est installé et authentifié. S’il signale un problème, réglez-le avant tout le reste, car toutes les autres commandes en dépendent.
Le plugin ajoute une petite famille de commandes /codex: :
| Commande | À utiliser pour |
|---|---|
/codex:review | Une revue standard, en lecture seule, de vos modifications |
/codex:adversarial-review | Une revue orientable qui remet en question les choix de conception |
/codex:rescue | Confier une tâche bloquée à Codex via un sous-agent |
/codex:transfer | Créer un fil Codex persistant à partir de la session en cours |
/codex:status | Lister les tâches Codex en cours et récentes |
/codex:result | Afficher la sortie finale d’une tâche terminée |
/codex:cancel | Arrêter une tâche en arrière-plan active |
/codex:setup | Vérifier l’installation et la connexion |
Une habitude efficace : une fois que Claude Code a terminé une modification, lancez /codex:review pour obtenir l’avis d’un second modèle avant de valider. Utilisez /codex:rescue quand Claude Code tourne en rond sur le même bug, et surveillez /codex:status pendant que la tâche s’exécute en arrière-plan.
Choisissez cette voie lorsque vous avez besoin de vrais outils MCP. Le wrapper se place entre Claude Code et la CLI Codex, en traduisant les appels d’outils en exécutions de codex exec.
npm install -g @openai/codex
claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server
Tapez ensuite /mcp dans Claude Code. Le serveur doit apparaître comme connecté, avec ses outils listés en dessous. claude mcp list affiche la même chose depuis le shell.
Ajoutez --scope project à la commande claude mcp add et Claude Code écrit le serveur dans .mcp.json à la racine du dépôt, si bien que toute l’équipe obtient la même configuration :
{
"mcpServers": {
"codex-cli": {
"command": "npx",
"args": ["-y", "@cexll/codex-mcp-server"]
}
}
}
Claude Code demande à chaque membre de l’équipe d’approuver un serveur de projet avant son exécution, ce qui est le comportement attendu pour un outil capable de modifier des fichiers.
Le wrapper transmet les contrôles de sécurité de Codex, si bien que vous décidez de la latitude accordée à Codex. Le README présente ces options :
| Réglage | Options |
|---|---|
| Sandbox | read-only, workspace-write, danger-full-access |
| Politique d’approbation | never, on-request, on-failure, untrusted |
💡 Commencez par
read-onlypour les revues et les questions. Passez àworkspace-writeseulement lorsque vous voulez que Codex modifie des fichiers. Associerdanger-full-accessàneversupprime tous les freins, donc gardez cette combinaison hors des dépôts partagés.
Le README mentionne aussi des valeurs par défaut intelligentes depuis la version 1.2 : le wrapper choisit workspace-write quand une tâche en a besoin, pour éviter les erreurs de permission. Vérifiez le mode réellement utilisé lors d’une exécution avant de supposer qu’elle est restée en lecture seule.
La connexion fonctionne dans les deux sens. Claude Code peut appeler Codex, et Codex peut appeler Claude Code ou tout autre serveur MCP de confiance.
Codex utilise nativement les serveurs MCP. Ajoutez-en un depuis la CLI :
codex mcp add my-server -- npx -y your-mcp-server-package
Ou écrivez-le dans config.toml sous forme de table [mcp_servers.<name>] :
[mcp_servers.my-server]
command = "npx"
args = ["-y", "your-mcp-server-package"]
startup_timeout_sec = 20
tool_timeout_sec = 120
Les serveurs stdio acceptent aussi env, cwd, enabled_tools et disabled_tools, ce qui permet de masquer les outils que Codex ne doit jamais appeler. Les serveurs HTTP prennent une url ainsi que des options d’authentification.
Claude Code peut exposer ses propres outils via MCP avec claude mcp serve. Enregistrez cette commande dans Codex :
codex mcp add claude-code -- claude mcp serve
Codex voit alors les outils de Claude Code, comme la lecture de fichiers, les modifications et l’accès au shell, comme des outils MCP. Essayez d’abord dans un dépôt jetable, car deux agents disposant d’un accès en écriture peuvent écraser mutuellement leurs modifications.
La plupart des échecs entrent dans cinq catégories. Repérez le symptôme, puis appliquez la solution :
| Symptôme | Cause probable | Solution |
|---|---|---|
Error: stdin is not a terminal | La sous-commande mcp-server a été supprimée | Passer au plugin ou au wrapper |
Serveur affiché comme failed dans /mcp | CLI Codex absente du PATH ou non connectée | Exécuter codex --version, se connecter, redémarrer Claude Code |
Commandes /codex: absentes | Plugin non rechargé | Exécuter /reload-plugins, puis /codex:setup |
npx échoue sous Windows natif | npx est un shim .cmd | Enregistrer avec cmd /c npx -y @cexll/codex-mcp-server |
| Le serveur expire au premier démarrage | npx télécharge le paquet au premier lancement | L’installer globalement, ou augmenter MCP_TIMEOUT |
Une vérification express de 30 secondes repère presque tout le reste :
codex --version pour confirmer que la CLI est installée et récente.claude mcp list pour confirmer que le serveur est enregistré et connecté.ping (wrapper) ou d’exécuter /codex:setup (plugin).Si les trois vérifications passent et qu’une tâche échoue encore, le problème vient de la tâche, pas de l’infrastructure. Restreignez le prompt, repassez le bac à sable sur read-only, et relancez.
Quand une configuration échoue encore, un modèle de code performant peut analyser l’erreur avec vous. GPT 5.6 Sol sur PicassoIA est conçu pour le code, la rédaction technique et le raisonnement en plusieurs étapes, et il lit les images, donc une capture d’écran du terminal en erreur fonctionne aussi.
codex --version et la commande qui a échoué dans le champ du prompt.high pour les problèmes complexes. La valeur par défaut, none, privilégie la vitesse.low si vous ne voulez que la commande corrigée, et sur high si vous voulez le raisonnement détaillé.Voici comment les réglages correspondent à ce type de tâche :
| Réglage | Valeurs | Idéal pour |
|---|---|---|
reasoning_effort | none, low, medium, high, xhigh | none pour des recherches rapides, high pour les conflits de configuration |
verbosity | low, medium, high | low lorsque vous n’avez besoin que de la commande |
max_completion_tokens | Entier | À augmenter en même temps que l’effort |
system_prompt | Texte | Définir un rôle et une règle sur les suppositions |
image_input | Liste d’images | Captures d’écran de terminal et schémas |
Pour comparer les réponses, lancez le même prompt sur Claude Sonnet 5 ou Claude Fable 5, tous deux dans la catégorie Large Language Models. Deux modèles qui ne s’accordent pas sur votre configuration sont un signal utile pour lire vous-même la documentation.
Les articles de configuration et les README gagnent à être accompagnés de visuels : une photo d’en-tête, un schéma de la connexion entre deux agents, un court clip pour une note de version. PicassoIA propose aussi sa propre API pour développeurs et son connecteur MCP, si bien que la même session Claude Code peut demander des images sans quitter le terminal.
L’API est calquée sur Replicate : l’URL de base est https://api.picassoia.com/v1, les requêtes portent un token Bearer qui commence par pia_sk_, et les tâches sont asynchrones : vous créez une prédiction, l’interrogez, puis récupérez le résultat. Un compte peut lancer 5 prédictions simultanées, partagées entre les tokens et les connexions MCP. Quatre modèles sont disponibles via l’API et le connecteur MCP :
Consultez la page des tarifs pour savoir ce que comprend votre formule, car l’accès à l’API et au MCP en dépend.
Choisissez une section de cet article, rédigez un prompt photo de 50 mots pour elle, et générez votre première image sur PicassoIA. Ensuite, donnez cette image à un modèle vidéo et transformez-la en un clip de cinq secondes. Une après-midi d’essais vous montrera quel modèle convient à votre documentation, et le prompt que vous obtiendrez mérite d’être sauvegardé pour le prochain article.
Choisissez votre langue
