Claude Code et Codex : synchroniser règles et compétences

Mise à jour (9 novembre 2026) : Claude Fable 5.2 et Mythos 5.2 sont sortis - prix, accès et benchmarks dans mon guide Claude Fable 5.2.

👁 113 lectures

Quand j’ai commencé à travailler en parallèle avec Claude Code et Codex, chaque changement de règles exigeait deux modifications. J’ajoutais une règle à la mémoire de Claude, puis je me rappelais que Codex ne la connaissait pas. Je cherchais donc un outil qui conserverait une seule version des règles, des compétences et des serveurs MCP, puis les distribuerait automatiquement. J’en ai trouvé plusieurs, tous gratuits et sous licence MIT. Je n’en ai installé aucun.

Voici les quatre options les plus intéressantes, et pourquoi un petit script m’a suffi avec un seul utilisateur et deux outils, tandis que je choisirais autrement pour une équipe.

Une seule source de vérité

Tous ces outils fonctionnent sur le même principe. Vous conservez règles, compétences et définitions des serveurs MCP au même endroit, puis le programme les enregistre dans les formats attendus par chaque outil : CLAUDE.md et un fichier JSON pour Claude Code, AGENTS.md et config.toml pour Codex, des fichiers de règles séparés pour Cursor. Ils se distinguent par l’emplacement de cette source unique, le nombre d’outils pris en charge et leur façon de distribuer les fichiers : copies ou liens.

rulesync prend en charge le plus grand nombre d’éléments : règles, commandes, MCP, fichiers d’exclusion, sous-agents et compétences. Sa liste comprend des dizaines d’outils, dont Claude Code et Codex CLI. L’installation se fait avec npm install -g rulesync. Pour commencer, la commande rulesync import --targets claudecode importe le CLAUDE.md existant dans le dossier .rulesync/ ; ensuite, rulesync generate distribue le tout.

Ruler fonctionne à l’échelle du projet. Vous rédigez les règles dans des fichiers Markdown du dossier .ruler/, et vous placez les paramètres et les serveurs MCP dans ruler.toml. La commande ruler apply les enregistre dans les agents. Codex reçoit un fichier AGENTS.md, les paramètres MCP dans .codex/config.toml et les compétences dans .agents/skills/. L’auteur qualifie la prise en charge des compétences d’expérimentale. Ruler nécessite Node.js en version 20.19 ou ultérieure.

agentsync est conçu autour de paramètres globaux plutôt que d’un projet unique. Vous disposez d’un fichier AGENTS.md, d’un dossier skills/ et d’un fichier mcp.json. Le programme les relie à une vingtaine d’outils pris en charge, s’il les trouve sur l’ordinateur. Il crée des liens plutôt que des copies : toute modification apportée à un endroit est donc immédiatement visible partout. Il propose une prévisualisation sans écriture (--check), un mode de surveillance des changements (--watch) et un retour à la dernière sauvegarde (--rollback latest). Sous Windows, les liens vers des dossiers nécessitent le mode développeur si le système refuse les liens symboliques classiques. L’auteur recommande également de ne pas placer mcp.json dans un dépôt partagé, car le fichier peut contenir des jetons.

agent-rules-sync va plus loin. Vous l’installez avec pip install agent-rules-sync et il fonctionne comme un service système : modifiez une règle dans l’un des outils, et il la distribue aux autres. Il synchronise les règles et les compétences dans les deux sens, transfère les paramètres de la configuration globale de Claude vers les dépôts sélectionnés et fusionne les listes de serveurs MCP.

Codex fait déjà la moitié du travail

Avant d’installer un outil de cette liste, demandez-vous de quoi vous avez réellement besoin. Codex propose deux options intégrées qui ont réglé chez moi la majeure partie du problème. La première est project_doc_fallback_filenames = ["CLAUDE.md"] dans ~/.codex/config.toml : Codex lit alors le fichier CLAUDE.md partout où il ne trouve pas de fichier AGENTS.md. Les règles du projet sont ainsi partagées sans avoir à les copier. La deuxième concerne le format des compétences : un dossier contenant un fichier SKILL.md fonctionne dans les deux outils ; seul l’emplacement où ils le lisent change.

Il me restait les règles globales et les compétences. J’ai rédigé une seule fois le fichier AGENTS.md global et j’y ai indiqué à Codex le dossier de mémoire de Claude comme base de connaissances, ce qui permet aussi de partager les notes sur les projets. Pour les compétences, un script qui les copie de ~/.claude/skills vers ~/.agents/skills m’a suffi ; il laisse intactes celles que j’avais créées manuellement dans Codex. Je le partage avec la description de toute la procédure dans l’article [pwlink slug= »claude-code-do-codexa »]Comment passer de Claude Code à Codex[/pwlink].

J’ai six compétences personnelles, je suis seul au clavier et j’utilise deux outils. Un programme fonctionnant en arrière-plan aurait résolu un problème que je n’ai pas, tout en ajoutant un nouvel élément susceptible de tomber en panne. J’ai d’ailleurs eu une mésaventure avec l’importateur officiel de Codex : il a échoué sur les caractères polonais du premier fichier.

Quand choisir un outil dédié

La situation change dans trois cas :

• Une équipe utilise différents outils. Une personne travaille dans Cursor, une autre dans Claude Code et une troisième dans Codex, mais les règles du projet doivent être identiques partout. Dans ce cas, rulesync ou Ruler dans le dépôt permettent de mettre de l’ordre, ce que personne ne parviendrait à maintenir manuellement.
• Plus de trois outils sur le même ordinateur. Avec Claude Code, Codex, Gemini CLI et Cursor, les liens créés par agentsync évitent beaucoup de travail.
• Des changements fréquents de serveurs MCP. Chaque outil les enregistre dans un format différent : Codex en TOML, Claude en JSON. Les recopier à la main finit vite par poser problème.

Avec deux outils et une seule personne, je commencerais par les options intégrées de Codex. Si vous utilisez aussi Claude Code avec Codex dans l’autre sens, l’article sur le [pwlink slug= »wtyczka-codex-claude-code »]module officiel Codex pour Claude Code[/pwlink] peut vous être utile. Un outil dédié devient intéressant quand vous en avez assez de surveiller manuellement deux emplacements. De mon côté, après avoir modifié une compétence, une seule commande suffit : python sync-skills.py.

Sources

• rulesync : https://github.com/dyoshikawa/rulesync
• Ruler : https://github.com/intellectronica/ruler
• agentsync : https://github.com/x0c/agentsync
• agent-rules-sync : https://github.com/dhruv-anand-aintech/agent-rules-sync
• OpenAI, instructions personnalisées avec AGENTS.md : https://learn.chatgpt.com/docs/agent-configuration/agents-md
• OpenAI, Agent Skills : https://learn.chatgpt.com/docs/build-skills

// lire la suitePlugin Codex pour Claude Code : commandes, installation et limitesOutils d'IAGPT-Image-2.6 dans Codex : fonctionnement et comparaison avec l’APIOutils d'IAClaude Design : comment ça marche et combien ça coûteOutils d'IA