Comparatif · IA & agents
Claude Code et Codex CLI : équivalences de configuration
Trouvez le fichier Codex qui correspond à chaque réglage Claude Code, avec les portées, différences clés et fonctions sans équivalent direct.

Passer de Claude Code à Codex CLI ne consiste pas à renommer .claude en .codex. Les deux outils couvrent des besoins proches, mais leurs fichiers, leurs portées et leurs règles de priorité diffèrent. Cette page sert de table de traduction pour la configuration locale et projet. Elle ne compare ni les modèles, ni les prix, ni la qualité du code produit.
En bref. Gardez
AGENTS.mdcomme socle commun lorsque les deux outils travaillent sur le même dépôt. Traduisez les réglages Claude Code desettings.jsonversconfig.tomlau cas par cas. Les skills et MCP ont des concepts proches, mais pas toujours les mêmes chemins ni les mêmes options. Les sous-agents, la mémoire automatique et les plugins ne sont pas interchangeables ligne pour ligne.
Verdict de configuration
- Utilisez
AGENTS.mdpour les consignes partagées. Claude Code sait le lire, tandis que Codex en fait son fichier d’instructions principal. - Conservez les extensions propres à chaque client dans
.claude/et.codex/. Une conversion globale produirait des réglages invalides ou plus permissifs que prévu. - Marquez explicitement les absences. Quand une fonction n’a pas d’équivalent direct, il vaut mieux garder deux configurations que fabriquer une correspondance trompeuse.
Pour choisir entre les deux outils au-delà de la configuration, Claude Code ou Codex compare prix, quotas et profils d'usage, et la grille des outils IA pour développeurs élargit à d'autres assistants. La présente page reste centrée sur les fichiers à maintenir.
Table d’équivalences Claude Code et Codex CLI
Table vérifiée le 4 novembre 2026 dans les documentations officielles Anthropic et OpenAI. « Partiel » signifie que l’objectif est proche mais que le format, la portée ou l’exécution diffère. « Absence » signifie qu’aucune fonction documentée ne permet une traduction fidèle.
| Besoin | Claude Code | Codex CLI | Correspondance |
|---|---|---|---|
| Réglages personnels | ~/.claude/settings.json | ~/.codex/config.toml | Partielle : JSON contre TOML, clés différentes |
| Réglages partagés du dépôt | .claude/settings.json | .codex/config.toml | Partielle : priorité et confiance du dépôt différentes |
| Surcharges personnelles pour un dépôt | .claude/settings.local.json | Pas de fichier config.local.toml documenté | Absence directe ; utiliser un profil, le fichier utilisateur ou un drapeau ponctuel |
| Instructions globales | ~/.claude/CLAUDE.md ou ~/.claude/AGENTS.md | ~/.codex/AGENTS.md | Proche, avec découverte différente |
| Instructions du dépôt | CLAUDE.md, CLAUDE.local.md, .claude/rules/ et AGENTS.md accepté | AGENTS.md, AGENTS.override.md et noms de secours configurables | Partielle |
| Réglage ponctuel au lancement | --settings, drapeaux et variables d’environnement | --config ou -c, drapeaux et --profile | Proche, syntaxe différente |
| Permissions d’outils | permissions.allow, permissions.ask, permissions.deny | approval_policy, profils de permissions, sandbox et politique de projet | Partielle : pas de traduction règle pour règle |
| Isolation du système de fichiers | Sandbox Claude Code et répertoires autorisés | sandbox_mode, racines accessibles et profils de permissions | Partielle |
| Serveurs MCP | .mcp.json, ~/.claude.json, commandes claude mcp | tables [mcp_servers.*] dans config.toml, commandes codex mcp | Proche pour STDIO et HTTP, options différentes |
| Hooks | hooks dans les settings ou fichiers de plugin | .codex/hooks.json ou tables [hooks] | Partielle : événements et contrats de sortie différents |
| Skills du dépôt | .claude/skills/<nom>/SKILL.md | .agents/skills/<nom>/SKILL.md | Proche au niveau SKILL.md, chemins et extensions différents |
| Sous-agents du dépôt | .claude/agents/<nom>.md | .codex/agents/<nom>.toml | Partielle : Markdown/YAML contre TOML, capacités différentes |
| Mémoire écrite automatiquement | Répertoire de mémoire géré par Claude Code | Fonction Memories expérimentale, activable dans config.toml | Partielle, aucune migration de format documentée |
| Distribution d’un ensemble | Plugin Claude Code avec manifest, skills, agents, hooks et MCP | Plugin OpenAI pouvant empaqueter skills et connexions | Partielle : formats et catalogues distincts |
| Règles par chemin | .claude/rules/*.md avec portée par fichiers | AGENTS.md imbriqués et fichiers AGENTS.override.md | Partielle : même objectif, mécanisme différent |
| Paramètres administrés | Sources gérées Anthropic et managed-settings.json | requirements.toml, politiques gérées et configuration système | Partielle, réservée à l’administration |
La table indique où commencer, pas quoi copier. Ouvrez toujours les deux références avant de traduire une clé de sécurité.
Les fichiers de réglages ne se convertissent pas automatiquement
Claude Code lit des fichiers JSON. Les trois portées locales courantes sont le fichier utilisateur ~/.claude/settings.json, le fichier partagé .claude/settings.json et la surcharge personnelle .claude/settings.local.json. Anthropic documente aussi des sources administrées. Sa priorité générale place la politique administrée au-dessus du lancement en ligne de commande, puis du fichier local au projet, du fichier partagé et du fichier utilisateur.[1]

Codex utilise TOML. Les valeurs de lancement passent en premier, suivies des .codex/config.toml découverts depuis la racine du projet jusqu’au dossier courant. Viennent ensuite le profil sélectionné, le fichier utilisateur, les valeurs gérées dans le cloud, le fichier système et les valeurs intégrées.[2] Un projet non approuvé ne charge pas ses couches .codex/.
La différence la plus concrète concerne la surcharge locale. Claude Code a un fichier dédié, .claude/settings.local.json, prévu pour les choix personnels d’un dépôt et normalement tenu hors de Git. La documentation Codex ne décrit pas de .codex/config.local.toml. Pour obtenir une variation personnelle, utilisez plutôt ~/.codex/config.toml, un profil sélectionné avec --profile, ou une surcharge ponctuelle avec -c.[2]
N’essayez donc pas de traduire ceci par remplacement de texte :
.claude/settings.json -> .codex/config.toml
La flèche indique une intention voisine, pas une compatibilité de syntaxe. Repartez des besoins : modèle par défaut, approbations, sandbox, MCP, hooks et variables transmises aux commandes.
CLAUDE.md, AGENTS.md et les règles imbriquées
Claude Code charge CLAUDE.md comme contexte persistant. Il accepte aussi AGENTS.md, distingue les instructions écrites par l’équipe de sa mémoire automatique et permet de placer des règles ciblées dans .claude/rules/.[3] Ces instructions orientent l’agent, mais ne constituent pas une interdiction technique.
Codex construit une chaîne d’instructions au début du run. Il lit d’abord AGENTS.override.md ou AGENTS.md dans son répertoire utilisateur. Dans le projet, il parcourt chaque dossier de la racine jusqu’au dossier courant. À chaque niveau, AGENTS.override.md passe avant AGENTS.md. Les fichiers les plus proches du code arrivent en dernier dans la chaîne.[4]
Pour un dépôt utilisé par les deux clients, une organisation sobre fonctionne bien :
AGENTS.md règles communes au dépôt
services/api/AGENTS.md consignes propres à l’API
.claude/rules/ règles Claude Code ciblées
.claude/settings.json comportement Claude Code partagé
.codex/config.toml comportement Codex partagé
Gardez dans AGENTS.md les commandes de validation, les limites de périmètre et les conventions qui valent pour les deux outils. Placez dans CLAUDE.md seulement ce qui dépend de Claude Code. Pour approfondir cette séparation, Comment écrire un bon CLAUDE.md couvre la structure des instructions, et Créer un workflow IA de développement traite le partage des règles entre outils.
Une règle d’instructions ne remplace pas une politique. Pour empêcher une lecture de secret ou une commande dangereuse, configurez les permissions et l’isolation du client concerné.
Permissions et sandbox : objectifs proches, modèles différents
Claude Code organise les décisions avec des règles allow, ask et deny, associées à des outils et parfois à des motifs de commande. Les fichiers de plusieurs portées peuvent contribuer aux listes. La confiance du dossier intervient aussi avant l’application de certains réglages partagés.[1]
Codex sépare notamment approval_policy, sandbox_mode et les profils de permissions. Le mode workspace-write borne les écritures à l’espace autorisé, tandis que d’autres profils peuvent être plus restrictifs ou accorder un accès complet. Une organisation peut imposer des contraintes qui interdisent les combinaisons les plus ouvertes.[2]
Il n’existe pas de conversion fiable de chaque règle Claude Code vers une clé Codex. Une règle comme Bash(npm test *) exprime une permission liée à l’outil Bash de Claude Code. Dans Codex, le même résultat dépend du sandbox, de la politique d’approbation et, si nécessaire, d’un hook. Traduisez le risque à contrôler, puis vérifiez le comportement dans un dépôt sans données sensibles.
Le guide Gérer les permissions d’un agent IA donne une grille indépendante du produit. Pour Claude Code, Sécuriser permissions, secrets et commandes détaille les contrôles propres au client.
MCP : même protocole, stockage différent
Les deux clients prennent en charge des serveurs MCP locaux par STDIO et des serveurs distants par HTTP. Cette proximité permet souvent de conserver le serveur, mais pas son bloc de configuration.
Claude Code peut enregistrer un serveur avec claude mcp add. La portée project écrit dans .mcp.json, la portée user vise l’utilisateur et la portée locale reste liée au projet courant. Les serveurs de projet demandent une approbation. Anthropic recommande HTTP pour les serveurs distants et documente STDIO pour les processus locaux.[5]
Codex stocke les serveurs dans ~/.codex/config.toml ou .codex/config.toml. Chaque entrée utilise une table [mcp_servers.<nom>]. Le CLI et l’extension IDE partagent ces couches. OpenAI documente des listes d’outils activés ou désactivés, des délais, un mode d’approbation par défaut et des surcharges par outil.[6]
Exemple de forme, sans prétendre que les options sont identiques :
{
"mcpServers": {
"documentation": {
"type": "http",
"url": "https://mcp.example.com/mcp"
}
}
}
[mcp_servers.documentation]
url = "https://mcp.example.com/mcp"
Ne recopiez pas un jeton dans l’un de ces fichiers. Utilisez les mécanismes d’environnement ou d’authentification décrits par le client, puis limitez les outils disponibles. Utiliser MCP avec Claude Code présente une mise en place progressive.
Hooks : une équivalence seulement partielle
Claude Code et Codex ont tous deux des hooks de cycle de vie. Les noms SessionStart, PreToolUse, PostToolUse, UserPromptSubmit, SubagentStart, SubagentStop et Stop existent dans les deux documentations.[7][8] Cette intersection ne rend pas les fichiers compatibles.
Claude Code place les hooks dans ses settings ou dans un plugin. Les gestionnaires peuvent être des commandes, des points HTTP, des appels MCP, des invites ou des sous-agents selon l’événement et la surface. Certains événements Claude Code n’ont pas de ligne correspondante dans la table Codex, par exemple InstructionsLoaded, ConfigChange, FileChanged, WorktreeCreate ou PreModelSwitch.[7]
Codex charge .codex/hooks.json ou des tables [hooks] dans config.toml. Il fusionne les hooks actifs de plusieurs couches. Les hooks non administrés doivent être relus et approuvés, et une modification de leur définition demande une nouvelle confiance. La documentation indique que les gestionnaires command et mcp_tool sont pris en charge, tandis que prompt et agent sont analysés mais ignorés.[8]
Pour migrer un hook, comparez quatre éléments : l’événement, le matcher, le JSON reçu et la décision retournée. Si l’un manque, marquez la migration comme absente au lieu de déplacer le script sans contrôle.
Skills : un standard commun, des chemins différents
Les deux produits utilisent un dossier de skill contenant SKILL.md, avec des instructions chargées lorsque la tâche le demande. Les deux documentations rattachent ce format au standard Agent Skills et décrivent un chargement progressif.[9][10]
Claude Code découvre notamment les skills personnels dans ~/.claude/skills/ et ceux du projet dans .claude/skills/. Une skill peut être appelée avec /nom-skill, chargée automatiquement d’après sa description et étendue par des fichiers de référence ou des scripts.[9]
Codex découvre les skills utilisateur dans ~/.agents/skills et les skills du dépôt dans les dossiers .agents/skills rencontrés entre le dossier courant et la racine. Dans le CLI, une skill peut être mentionnée avec $nom-skill; /skills ouvre aussi le sélecteur.[10]
Le contenu principal d’une skill simple peut souvent être partagé. Les extensions propres à Claude Code, les métadonnées OpenAI dans agents/openai.yaml, les chemins de scripts et les dépendances d’outils demandent une relecture. Le plus sûr est de garder une source commune puis de produire deux emballages minces, plutôt que de relier aveuglément les dossiers.
Sous-agents : même mot, contrats distincts
Claude Code définit un sous-agent dans un fichier Markdown avec front matter YAML. Les emplacements courants sont .claude/agents/ pour le dépôt et ~/.claude/agents/ pour l’utilisateur. La définition peut préciser les outils, le modèle, le mode de permission, les skills, des serveurs MCP ou une isolation par worktree.[11]
Codex utilise des fichiers TOML dans .codex/agents/ ou ~/.codex/agents/. name, description et developer_instructions sont obligatoires. Le modèle et l’effort peuvent être ajustés, mais le sous-agent hérite des permissions, du fournisseur et des serveurs MCP du parent. Une consigne « ne modifie rien » ne crée donc pas un sandbox séparé en lecture seule.[12]
La correspondance est partielle. Vous pouvez conserver le rôle et les critères de sortie, mais vous devez réécrire la définition. Une restriction d’outils Claude Code ne se transforme pas automatiquement en isolation Codex. Pour les travaux parallèles, séparez aussi les fichiers attribués afin d’éviter que deux agents écrivent au même endroit.
Mémoire et plugins : ne pas inventer d’équivalent
Claude Code distingue CLAUDE.md de la mémoire automatique qu’il écrit à partir des corrections et préférences. Les deux sont chargés au début d’une conversation, mais les instructions restent du contexte et non une politique.[3]
Codex documente une fonction memories expérimentale dans ses options. Cette présence ne prouve pas que le format, la sélection ou la persistance correspondent à la mémoire Claude Code.[2] Aucune procédure officielle de migration directe n’est documentée. Conservez les faits durables dans des instructions versionnées et traitez les mémoires automatiques comme des données propres à chaque client.
Les plugins suivent la même prudence. Un plugin Claude Code peut réunir manifest, skills, agents, hooks et serveurs MCP.[13] Les plugins OpenAI distribuent aussi des skills et des connexions, mais leur format et leur catalogue sont distincts.[10] Une équipe qui vise les deux clients doit partager les procédures au niveau SKILL.md lorsque le standard le permet, puis maintenir les manifests et extensions séparément.
Méthode de migration sans fausse équivalence
- Inventoriez chaque fichier sous
.claude/, ainsi queCLAUDE.md,AGENTS.mdet.mcp.json. - Classez chaque entrée : instruction, réglage, permission, hook, skill, agent, serveur MCP ou mémoire.
- Cherchez le mécanisme Codex officiel correspondant. Notez « absence » si seule une approximation est disponible.
- Recréez les clés dans TOML sans copier de secret. Commencez avec un sandbox restrictif et des approbations visibles.
- Vérifiez les instructions chargées, les serveurs connectés et les hooks approuvés dans un dépôt témoin.
- Conservez les deux dossiers tant que chaque client reste utilisé. Le fichier commun doit contenir seulement les règles réellement communes.
Cette méthode évite deux erreurs fréquentes : croire qu’un nom identique implique le même contrat, ou supprimer une protection parce que sa traduction n’est pas immédiate.
Questions fréquentes
Peut-on utiliser seulement AGENTS.md avec Claude Code et Codex ?
Oui pour une base d’instructions commune, car les deux clients savent lire AGENTS.md. Vous aurez encore besoin de fichiers propres à chaque outil pour les permissions, le sandbox, les hooks et certaines extensions.
Faut-il copier .mcp.json dans .codex/config.toml ?
Non. Reprenez l’adresse ou la commande du serveur après vérification, puis réécrivez l’entrée au format Codex. Revoyez séparément l’authentification, les délais et les outils autorisés.
Les mêmes SKILL.md fonctionnent-ils partout ?
Le noyau du format est commun, mais les chemins de découverte et certaines métadonnées diffèrent. Une skill purement instructionnelle est la meilleure candidate au partage. Une skill qui dépend d’extensions propres au client demande deux variantes.
Une règle deny Claude Code a-t-elle un équivalent Codex ?
Pas nécessairement. Codex combine approbations, sandbox, profils de permissions et exigences administrées. Reformulez d’abord le risque à bloquer, puis implémentez le contrôle avec les mécanismes Codex documentés.
Les sous-agents conservent-ils leurs restrictions en migrant ?
Non par défaut. Claude Code permet de limiter des outils dans la définition du sous-agent. Codex indique que ses sous-agents héritent du sandbox et des permissions du parent. Revérifiez donc les limites dans la session principale avant toute délégation.
Sources
- [1] Anthropic, paramètres Claude Code, consulté le 4 novembre 2026.
- [2] OpenAI, configuration de base de Codex, consulté le 4 novembre 2026.
- [3] Anthropic, mémoire et fichiers d’instructions, consulté le 4 novembre 2026.
- [4] OpenAI, instructions AGENTS.md, consulté le 4 novembre 2026.
- [5] Anthropic, MCP dans Claude Code, consulté le 4 novembre 2026.
- [6] OpenAI, MCP dans Codex, consulté le 4 novembre 2026.
- [7] Anthropic, référence des hooks, consulté le 4 novembre 2026.
- [8] OpenAI, hooks Codex, consulté le 4 novembre 2026.
- [9] Anthropic, skills Claude Code, consulté le 4 novembre 2026.
- [10] OpenAI, créer des skills, consulté le 4 novembre 2026.
- [11] Anthropic, sous-agents Claude Code, consulté le 4 novembre 2026.
- [12] OpenAI, sous-agents Codex, consulté le 4 novembre 2026.
- [13] Anthropic, plugins Claude Code, consulté le 4 novembre 2026.