Migrer de Claude Code à Codex : skills, MCP et historique

Documentation Ailoot : API, clés et configuration.

Pourquoi l’outil de migration de Codex est-il nécessaire ?#

OpenAI a ajouté cette fonctionnalité à Codex début juin 2026. Le changelog officiel la résume ainsi :

Autrement dit, lors du premier lancement de l’application Codex ou depuis les paramètres d’un client déjà en cours d’exécution, un assistant démarre et lit les configurations locales d’un autre agent. Claude Code et Claude Cowork sont actuellement pris en charge.

La raison pour laquelle OpenAI fait cela est claire. Après le lancement de Sites et la mise à jour de l’application Codex en mai–juin 2026, Codex a acquis tout ce que Claude Code avait auparavant sur OpenAI : un terminal, des plugins, de longues sessions et de l’orchestration. La migration supprime le dernier obstacle pour les équipes qui ont déjà intégré Claude Code à leur stack : « les réglages pris en charge peuvent être importés puis comparés à l’inventaire d’origine ».

La raison pour laquelle vous pourriez en avoir besoin est moins évidente. Je les ai comparés directement dans le guide Codex vs. Claude Code : Claude reste meilleur pour les longues discussions d’architecture et le mode Plan, tandis que Codex est plus rapide pour les tâches autonomes et les PR parallèles. Si vous avez décidé de changer complètement, poursuivez votre lecture. Si vous envisagez une combinaison, les modèles de collaboration pourraient vous être plus utiles.

Que transfère automatiquement l’outil de migration ?#

Je vais passer en revue ces groupes et expliquer exactement ce qu’il advient de chaque élément de ~/.claude.

1. Instructions et contexte. Les fichiers CLAUDE.md — le fichier global dans ~/.claude/ et les fichiers de projet dans les dépôts — sont convertis au format AGENTS.md. Le fichier global se retrouve dans ~/.codex/AGENTS.md ; les fichiers de projet restent à la racine du dépôt et dans ses sous-dossiers. Le format AGENTS.md est essentiellement le même type de fichier Markdown contenant des règles ; les différences sont surtout cosmétiques — noms de sections et quelques directives spécifiques. J’ai expliqué ce qu’est AGENTS.md et pourquoi Codex en a besoin.

2. Skills. Le dossier ~/.claude/skills/ est entièrement analysé ; chaque skill est adapté à la structure de Codex et placé dans $HOME/.agents/skills. Les skills de projet du dossier .claude/skills/ d’un dépôt sont déplacés vers .agents/skills. Le format SKILL.md avec frontmatter est transféré presque tel quel. Si un skill utilise des déclencheurs propres à Claude, il est signalé pour vérification.

3. Serveurs MCP. La configuration .mcp.json (globale et au niveau du projet) est importée au format Codex. Les noms des serveurs, les commandes de lancement et les chemins sont préservés. Ce qui n’est pas transféré : les jetons et les variables d’environnement. Pour des raisons de sécurité, Codex vous redemandera les clés API et les mots de passe afin qu’ils ne soient pas exposés pendant la migration. C’est une tâche ponctuelle : ouvrez la section MCP dans l’application Codex et saisissez les jetons que vous avez déjà dans votre gestionnaire de mots de passe.

4. Hooks. C’est le groupe compliqué. Les hooks à logique déterministe (bloquer rm -rf, signaler les chemins ressemblant à des identifiants, consigner des preuves) sont transférés intégralement. Les hooks dont les déclencheurs n’ont pas d’équivalent dans Codex (par exemple, certains événements du cycle de vie propres à Claude Code) sont marqués « vérification manuelle » et ne sont pas activés automatiquement. J’ai expliqué en détail le fonctionnement des hooks dans Claude Code, comme point de référence — Codex en propose moins de types.

5. Historique de session. Jusqu’aux 30 derniers jours d’activité dans Claude Code sont importés comme référence. Cela ne signifie pas « reprendre exactement là où vous en étiez », mais vos conversations passées seront visibles dans Codex afin que vous puissiez retrouver rapidement le contexte du projet sans tout réexpliquer.

L’outil de migration ne fait pas la différence entre les fichiers actifs et les artefacts expérimentaux : il transfère tout. Après la migration, il est utile de faire manuellement le ménage dans les éléments que vous n’avez pas utilisés au cours des six derniers mois.

Qu’est-ce qui n’est PAS transféré, et pourquoi ?#

Je vais passer en revue chaque groupe sous l’angle de « ce qu’il faut faire après la migration ».

Jetons MCP et clés API. C’est la partie la plus prévisible. Après l’analyse, Codex vous affichera la liste de tous les serveurs MCP trouvés dans Claude. Il vous demandera les clés et jetons de chacun. Le plus simple est d’avoir votre gestionnaire de mots de passe sous la main et de parcourir tous les serveurs en une seule fois. Ensuite, MCP fonctionne de la même manière dans Codex et Claude Code. Vérifiez la commande et les paramètres de connexion du serveur MCP choisi à l’aide de sa documentation.

Commandes slash /name. Dans Claude Code, vous avez l’habitude d’appeler un skill avec /skill-name. Dans Codex, l’invocation canonique est différente : $skill-name. Considérer les commandes /name comme la preuve que les skills sont chargés est une erreur de migration fréquente.

Après la migration, testez quelques skills importants avec $skill-name dans Codex. S’ils fonctionnent, la migration a vraiment réussi. Ne vous fiez pas à la case « skills migrés » de l’assistant : vérifiez en les invoquant.

Hooks sans équivalent dans Codex. Si vous aviez un hook pour des événements spécifiques de Claude Code — par exemple, sur pre-tool-use pour une combinaison particulière d’outils — ce déclencheur n’existe peut-être pas dans Codex. L’outil de migration les signalera et les laissera inactifs. Vous devrez décider s’il faut les réécrire pour obtenir un équivalent dans Codex, les supprimer ou les conserver dans Claude Code (si vous l’exécutez en parallèle). Voici une bonne règle : ne transférez que les hooks déterministes ; tout le reste est une raison de ne pas reproduire l’échelle dans le nouvel outil.

Workflows d’équipe fondés sur des sous-agents. J’ai expliqué ce que sont les sous-agents dans Claude Code et comment utiliser des sous-agents imbriqués. Dans Codex, les sous-agents sont organisés au moyen de profils et de rôles (voir ci-dessous). Si vous aviez dans Claude un pipeline complexe composé de plusieurs sous-agents en chaîne, vous devrez le réécrire autour du concept de profil de Codex. L’outil de migration signale ces configurations comme « nécessitant une refonte architecturale ».

Fichiers CLAUDE.md volumineux et propres à Claude. Si un fichier a atteint 2 000–3 000 lignes avec des sections pour chaque projet, Codex peut l’accepter, mais ce n’est pas une bonne pratique. AGENTS.md est conçu pour être compact et réparti : les règles globales dans ~/.codex/AGENTS.md, les règles propres au projet à la racine du dépôt et les dérogations ciblées dans les sous-dossiers. Après la migration, ne laissez pas CLAUDE.md sous la forme d’un « fichier d’instructions géant » ; répartissez son contenu entre les différents niveaux. J’ai expliqué comment configurer correctement CLAUDE.md ; la même approche s’applique à AGENTS.md.

Étape par étape : 4 actions dans l’application Codex#

Voici la liste de contrôle détaillée.

1. Étape 1 : mettez à jour l’application Codex vers la version 26.608 ou ultérieure

   L’outil de migration est apparu dans la version 26.608 (publiée le 9 juin 2026). Sur macOS, ouvrez l’application Codex et recherchez les mises à jour. Faites de même sur Windows. Si vous utilisez la Codex CLI, assurez-vous qu’elle est compatible avec l’application actuelle. Sans la dernière version, « Importer la configuration d’un autre agent » n’apparaîtra pas dans les paramètres.

2. Étape 2 : lancez l’importation depuis les paramètres

   Dans l’application Codex, ouvrez les paramètres et cherchez « Importer la configuration d’un autre agent ». Si vous venez d’installer l’application Codex, l’assistant vous proposera la migration pendant l’intégration. Une fois lancé, l’assistant analyse le système de fichiers : ~/.claude/ et les dépôts contenant CLAUDE.md ou .claude/. L’analyse dure de 30 secondes à plusieurs minutes, selon le nombre de fichiers.

3. Étape 3 : confirmez le plan de migration

   Après l’analyse, Codex affiche un inventaire : le nombre de skills trouvés, le nombre de serveurs MCP, le nombre de fichiers CLAUDE.md repérés, les hooks admissibles à la migration et le nombre de jours d’historique de session disponibles. Vous pouvez décocher les groupes que vous ne souhaitez pas transférer. Par défaut, tout ce que Codex considère sûr à importer est sélectionné.

4. Étape 4 : attendez la fin et saisissez les jetons

   L’importation prend 1–5 minutes. Lorsqu’elle est terminée, Codex ouvre une fenêtre de suivi : « voici ce que je n’ai pas pu transférer automatiquement ; vérifiez-le manuellement ». Il s’agit généralement d’une liste de serveurs MCP nécessitant des jetons. Ouvrez votre gestionnaire de mots de passe et saisissez les clés dans le formulaire Codex. La majeure partie de la migration est alors terminée.

Vérifiez ensuite le résultat. Ouvrez un projet sur lequel vous travailliez habituellement dans Claude Code et vérifiez les points suivants :

• cat ~/.codex/AGENTS.md — vos règles globales s’y trouvent-elles ?
• Exécutez un skill : $skill-name. Il devrait se charger.
• Ouvrez .mcp.json dans le projet et vérifiez que les serveurs requis fonctionnent.
• Démarrez une conversation qui reflète votre manière habituelle de travailler. Codex indiquera les hooks importés qu’il ne peut pas utiliser ; ce sont des éléments précis de l’inventaire à traiter manuellement ; aucune proportion fixe n’est établie.

Hooks et sous-agents : équivalents dans Codex et éléments à réécrire#

Hooks. Dans Claude Code, vous pouvez associer une commande shell à chaque événement du cycle de vie (pre-tool-use, post-tool-use, on-error, on-context-load, etc.). Codex propose un ensemble d’événements plus restreint : il peut vérifier avant l’exécution, consigner des preuves et bloquer les commandes dangereuses. Si vous aviez un hook pre-tool-use qui filtrait une combinaison particulière, dans Codex vous devrez l’intégrer à une vérification générale avant exécution ou le supprimer. J’ai expliqué en détail l’architecture des hooks de Claude Code ; si vous les utilisiez beaucoup, listez chaque déclencheur et effet requis, identifiez un équivalent pris en charge et vérifiez-le avant activation.

Sous-agents. Dans Claude Code, un sous-agent est un contexte distinct doté de son propre prompt système, lancé via une /command ou depuis la conversation principale. Codex propose un concept similaire avec les profils : vous pouvez définir un profil comprenant un ensemble précis de skills, d’autorisations et de règles d’approbation. Les profils répondent à peu près au même besoin — isoler le contexte pour une catégorie de tâches donnée — mais par le biais de paramètres plutôt que d’un appel explicite à un agent.

En pratique, cela signifie que :

• Si vous aviez un sous-agent « security-reviewer » avec son propre prompt, créez dans Codex un profil security-review avec les autorisations nécessaires et un effort de raisonnement plus élevé.
• Si vous aviez un sous-agent « feature-developer », il s’agit simplement d’un profil de travail par défaut ; rien de particulier n’est nécessaire.
• Si vous utilisiez des sous-agents imbriqués, cela ne fonctionnera pas à l’identique dans Codex ; repensez le fonctionnement au moyen d’une chaîne de profils ou de skills explicites.

L’outil de migration tentera de créer des profils à partir des noms de vos sous-agents et signalera les déclencheurs qui n’ont pas été transférés. Le travail dépend du nombre de rôles, déclencheurs, permissions et dépendances ; testez chaque pipeline requis avant de le considérer migré.

Quand migrer complètement et quand conserver les deux outils#

Un filtre de décision simple :

Passer entièrement à Codex est pertinent si :

• Vous effectuez surtout des PR autonomes et des tâches parallèles.
• Votre workflow GitHub est profondément intégré et Codex Cloud Agent gère 80 % du travail.
• Vous consacrez peu de temps aux discussions d’architecture et au mode Plan.
• Vous voulez payer un seul outil plutôt que deux.

Conserver Claude Code et Codex ensemble si :

• Vous utilisez régulièrement le mode Plan pour de longues décisions d’architecture.
• Vous avez besoin de travail en parallèle : Codex s’exécute dans le cloud sur une tâche tandis que Claude Code conserve le contexte d’une autre.
• Vous réalisez beaucoup de hacks ponctuels et de microprojets pour lesquels le mode Plan est excessif.
• Vous avez un pipeline complexe de sous-agents impossible à réécrire en une soirée.

Personnellement, j’utilise les deux : Claude Code gère la longue conversation, tandis que Codex s’occupe de « corriger N bugs en parallèle » ou de « réviser une PR ». J’ai expliqué plus en détail ce fonctionnement dans le guide de collaboration entre Claude Code et Codex.

Voici ce que je dirais essentiellement de la migration : l’outil supprime l’obstacle technique au changement, mais ne répond pas à la question de savoir si vous devez changer d’outil. Décidez d’abord du type de travail que vous faites. Choisissez ensuite l’outil.

Si vous avez besoin d’accéder à des réseaux neuronaux via Ailoot, consultez Ailoot.