À 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.

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.
| Besoin | Claude Code | Codex |
|---|---|---|
| Instructions du projet | CLAUDE.md | AGENTS.md |
| Skills du projet | .claude/skills/ | .agents/skills/ |
| Appel manuel d’un skill | /mon-skill | $mon-skill ou /skills |
| Exécution automatisée | claude -p | codex 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 :
- Suppression des champs
modeletversion, qui liaient un workflow à un fournisseur. - Remplacement des formulations impératives comme
appelle /skillpar des consignes neutres. - Remplacement des références obligatoires à Claude in Chrome par une capacité de navigation, avec dev-browser comme implémentation portable.
- 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.