Aller au contenu

Claude Code et Codex : migrer sans choisir son camp

Par Mise à jour le 4 min de lecture

À force d’entendre Codex par-ci, Codex par-là, et avec en prime une communication désastreuse d’Anthropic et des plafonds d’utilisation (encore) atteints, le moment est venu d’essayer Codex et les derniers modèles d’OpenAI, qui auraient rattrapé ceux d’Anthropic.

Claude Code et Codex ouverts côte à côte dans plusieurs terminaux

C’est donc parti pour migrer mes projets vers Codex, mais sans abandonner Claude Code.

La migration a demandé un peu plus qu’un prompt lancé en mode yolo : jusque-là, les skills et la documentation étaient organisés autour de Claude Code.

Cette réflexion prolonge mon audit de la mémoire de Claude Code, qui m’avait déjà conduit à déplacer les instructions structurantes vers des fichiers versionnés et relisibles.

L’objectif est donc d’entretenir une seule organisation, au lieu de deux configurations, pour pouvoir passer de l’un à l’autre.

La migration a suivi une règle : une seule source physique pour chaque instruction, et aussi peu d’adaptateurs que possible à la frontière de chaque outil.

Je vous détaille l’architecture obtenue et les erreurs rencontrées, puis comment j’utilise Claude Code et Codex sur les mêmes projets et lequel je préfère.

Deux outils, deux conventions

Claude Code et Codex savent tous les deux recevoir des instructions de projet et exécuter des workflows réutilisables, mais ils ne les cherchent pas aux mêmes endroits.

BesoinClaude CodeCodex
Instructions du projetCLAUDE.mdAGENTS.md
Skills du projet.claude/skills/.agents/skills/
Appel manuel d’un skill/mon-skill$mon-skill ou /skills
Exécution automatiséeclaude -pcodex exec

Codex charge les AGENTS.md du niveau global jusqu’au dossier courant. Chaque skill repose sur un dossier contenant un SKILL.md, éventuellement complété par des scripts, références, assets et métadonnées. Ce fonctionnement est détaillé dans la documentation officielle sur AGENTS.md et sur les skills Codex. Il fallait donc adapter les points d’entrée de mes workflows à chaque outil, sans les réécrire.

Garder ~/.claude comme dépôt Git commun

Mon dossier utilisateur ~/.claude était déjà versionné et synchronisé par Git. Je l’ai conservé comme dépôt canonique, lu directement par Claude Code pour ses réglages et ses skills.

Un script install.sh expose ensuite chaque skill compatible dans ~/.agents/skills/, via un lien symbolique vers son original :

~/.claude/skills/document/
              ↑
~/.agents/skills/document

Le lien garantit que ces deux chemins désignent le même skill. L’installateur est idempotent. Il préserve les skills Codex physiques et peut exclure un skill Claude avec .codex-skip, comme skill-creator.

Il fusionne aussi la configuration de la ligne de statut dans ~/.codex/config.toml sans écraser le reste de la configuration locale.

Sur une nouvelle machine :

git clone git@***/.claude.git ~/.claude
~/.claude/install.sh

Après l’installation de Codex sur un VPS, un skill poussé depuis mon poste y redevient disponible après git pull, puis install.sh.

Transformer les anciennes commandes en skills neutres

Mes anciennes commandes Claude ont été converties en skills, puis nettoyées :

  1. Suppression des champs model et version, qui liaient un workflow à un fournisseur.
  2. Remplacement des formulations impératives comme appelle /skill par des consignes neutres.
  3. Remplacement des références obligatoires à Claude in Chrome par une capacité de navigation, avec dev-browser comme implémentation portable.
  4. Ajout d’un contrôle distinct pour les skills strictement manuels.

Pour ce dernier point, Claude Code lit disable-model-invocation: true dans le fichier SKILL.md. Codex utilise allow_implicit_invocation: false dans agents/openai.yaml. Le workflow reste disponible, mais l’agent ne le lance pas seul.

Les autres skills peuvent être invoqués implicitement. Codex documente les deux modes d’activation : mention explicite avec $skill, ou sélection selon la description.

Un fichier d’instructions unique par projet

La même règle a été appliquée aux dépôts de projets :

AGENTS.md              fichier canonique
CLAUDE.md -> AGENTS.md lien symbolique

Pour les skills locaux, l’un des deux dossiers contient les fichiers physiques et l’autre pointe vers lui. Selon l’historique du projet, le lien porte sur tout le dossier ou sur chaque skill.

La configuration des hooks fait exception à cette règle : elle doit être adaptée séparément pour Claude Code et Codex.

Rendre les appels automatisés interchangeables

Partager les fichiers ne suffisait pas. Plusieurs applications lançaient directement claude -p depuis PHP, Node.js, Bash, cron ou systemd.

Chaque appel a été placé derrière un adaptateur piloté par une variable commune :

AI_AGENT_PROVIDER=codex

Ce choix vit désormais dans le fichier .env de chaque projet. Les services systemd et les lignes cron restent neutres : ils lancent l’application, puis l’adaptateur lit uniquement les clés AI_AGENT_* autorisées. Les autres secrets du .env ne sont pas transmis au sous-processus agent.

Pour tester ponctuellement l’autre fournisseur, une variable passée devant la commande reste prioritaire sur le fichier :

AI_AGENT_PROVIDER=claude ./script/ma-tache

Pour Codex, les tâches non interactives utilisent codex exec, la commande prévue pour les scripts et la CI. La documentation de la CLI décrit aussi les modes de sandbox read-only, workspace-write et danger-full-access.

Cette migration a surtout retiré de mes workflows leurs hypothèses spécifiques à Claude. Le portage de Claude vers Codex n’en était que le point de départ.

J’en retiens deux principes d’organisation :

  1. Git synchronise les machines, les liens symboliques garantissent l’unicité locale. L’un ne remplace pas l’autre.
  2. Les instructions métier doivent être neutres. Le fournisseur, le modèle, le sandbox et le format de sortie appartiennent à l’adaptateur.

Côté publication, un agent ne doit pas contrôler toute la chaîne de publication. Une réparation probabiliste peut alimenter une procédure déterministe, pas la remplacer.

Je peux maintenant ouvrir le même dépôt avec Claude Code ou Codex et y invoquer les mêmes skills. Mes automatisations tournent avec l’un ou l’autre. Codex est devenu l’agent actif sur le serveur, sans transformer Claude Code en ancien système à supprimer.

Le résultat le plus précieux : le prochain changement coûtera beaucoup moins cher.

Claude Code ou Codex : mon retour d’expérience après une journée de test

Même si ce n’est pas le cœur de cet article, voici mon retour personnel après une journée d’utilisation, pour ceux qui hésitent à migrer :

J’avais déjà comparé Claude Code et OpenCode. Le passage à Codex ajoute cette fois un changement de modèle et d’écosystème, pas seulement d’interface.

L’interface CLI de Claude Code est beaucoup plus agréable et mieux travaillée que celle de Codex. Ce confort tient à quelques détails très concrets :

  • le dernier prompt envoyé reste visible sur une ligne. Un clic me ramène au message complet dans l’historique ;
  • le champ de saisie peut s’agrandir et je peux y placer le curseur à la souris ;
  • Claude Code pose des questions interactives, avec des réponses à sélectionner (boutons radio), des cases à cocher et/ou un champ de réponse libre ;
  • depuis peu, les chats peuvent échanger des messages entre différentes sessions. Je m’en sers notamment entre une session consacrée à un projet précis et une autre consacrée à un socle commun à plusieurs projets.

Pour le reste, je n’ai pas encore de conclusion. J’utilise Opus 5 face à GPT-5.6-sol, avec un niveau de raisonnement high ou xhigh, mais cette section ne cherche pas à comparer les modèles. Une journée ne me suffit pas pour trancher sur la vitesse, la qualité du code ou le débogage.

Je vais utiliser Codex intensivement pendant un mois avant de décider s’il devient mon interface principale ou si, fin septembre, je repasse chez Anthropic. Je consignerai la suite dans mon parcours d’adoption de l’IA, que je mets régulièrement à jour.

Consultation stratégique et technique

Une migration d'agents à cadrer ?

Séparez vos instructions métier du fournisseur, estimez l'effort de portage et sécurisez la transition avant de déplacer vos automatisations.

Email • RSS • Twitter

Être notifié des nouvelles publications

Poursuivre votre lecture