Claude Code et Codex : deux assistants, un même métier

Pourquoi cette formation

Ma chaîne de vidéos pour développeurs tourne avec Claude Code. Quand j'ai préparé la série « Un skill, deux IA », j'ai relu la documentation de Claude Code et celle de Codex côte à côte, réglage par réglage.

Les deux documentations sont bonnes. Mais chacune part de son outil. Ici, on part de ton dépôt : un seul projet, deux assistants, et ce qu'il faut savoir pour que les deux y travaillent sans se contredire.

Deux outils, deux entreprises

• Claude Code est l'assistant de code d'Anthropic. Sa documentation le décrit comme un outil qui lit ta base de code, modifie des fichiers, lance des commandes et s'intègre à tes outils de développement.
• Codex est l'assistant de code d'OpenAI. Sa version en ligne de commande inspecte ton code, fait des modifications, lance des commandes et automatise le travail répétitif, sans quitter le terminal.

On dit de ces outils qu'ils sont « agentiques » : ils ne se contentent pas de répondre à une question. Ils agissent sur tes fichiers et ton terminal, puis vérifient le résultat.

Les deux existent en plusieurs versions : le terminal, une extension pour ton éditeur de code, une application de bureau et une exécution dans le cloud. Dans cette formation, je parle surtout du terminal. C'est là que les réglages se voient le mieux, et ce sont les mêmes fichiers qui servent partout.

Ce qu'ils ont en commun

• Ils travaillent dans ton dépôt. Ils lisent tes fichiers, les modifient et lancent les outils déjà installés sur ta machine : tests, git, gestionnaire de paquets.
• Ils lisent un fichier d'instructions au démarrage. Un fichier Markdown à la racine du projet, où tu écris les commandes, les conventions et les pièges connus. Tu n'as plus à tout réexpliquer à chaque session.
• Ils acceptent des skills. Un skill est un dossier qui contient un fichier SKILL.md : un nom, une description, des instructions. Les deux outils suivent le même standard ouvert, Agent Skills (la formation Les skills y est consacrée).
• Ils se branchent sur d'autres outils par MCP. MCP (Model Context Protocol) est un standard ouvert pour connecter une IA à une source externe : une documentation, un gestionnaire de tickets, une base de données (c'est le sujet de la formation MCP).
• Ils demandent la permission avant certaines actions, selon des règles que tu choisis.
• Ils ont les mêmes grands outils de travail : un mode plan pour réfléchir avant d'agir, des sous-agents pour isoler un travail, des hooks pour lancer une commande à un moment précis, une commande de relecture de code, et un mode sans interface pour les scripts (claude -p d'un côté, codex exec de l'autre).

Ce qui les distingue vraiment

1. Le fichier d'instructions

Codex lit AGENTS.md. Claude Code lit CLAUDE.md, et sait aussi lire AGENTS.md, mais pas dans tous les cas. Par défaut, si un CLAUDE.md existe dans ton dossier de travail ou au-dessus, c'est lui seul qui compte, et ton AGENTS.md est ignoré.

C'est le piège numéro un quand une équipe mélange les deux outils. On le règle proprement au chapitre 2.

2. Le format de configuration

• Claude Code se règle avec des fichiers JSON : ~/.claude/settings.json pour toi, .claude/settings.json pour le projet.
• Codex se règle avec un fichier TOML : ~/.codex/config.toml pour toi, et .codex/config.toml dans un projet, chargé seulement si tu as déclaré ce projet de confiance.

3. Le dossier et l'appel des skills

• Claude Code range un skill dans .claude/skills/<nom>/SKILL.md et l'appelle avec /nom.
• Codex le range dans .agents/skills/<nom>/SKILL.md et l'appelle avec $nom, ou le choisit dans la liste /skills.

Le fichier est le même. Le dossier et le préfixe changent.

4. La façon de protéger ta machine

• Codex part d'un bac à sable. Un bac à sable (sandbox en anglais), c'est une zone où les commandes tournent avec des droits limités, imposés par le système d'exploitation. Dans un dossier suivi par git, Codex recommande le préréglage « Auto » : il écrit dans ton dossier de travail, sans accès réseau, et te demande avant d'en sortir.
• Claude Code part de modes de permission et de règles « autoriser, demander, interdire ». Il a aussi un bac à sable pour les commandes shell, mais il faut l'activer avec /sandbox, et il ne tourne pas sous Windows sans WSL2.

Même nom, pas toujours même effet

Beaucoup de commandes portent le même nom des deux côtés : /init, /plan, /compact, /review, /mcp, /skills, /permissions. C'est pratique, mais trompeur.

Un exemple : /init crée un CLAUDE.md chez Claude Code, et un AGENTS.md chez Codex. Lancé dans les deux outils sur le même dépôt, il te laisse avec deux fichiers d'instructions qui vont vivre chacun leur vie.

Ce qu'il te faut

• Un ordinateur sous macOS, Linux ou Windows, avec une connexion internet. Claude Code demande au minimum macOS 13, Windows 10 (version 1809), Ubuntu 20.04 ou Debian 10, et 4 Go de mémoire. Pour Codex sous Windows, sa documentation conseille Windows 11 ; Windows 10 version 1809 ou plus récent marche « au mieux ». Pas de carte graphique : les modèles tournent sur les serveurs d'Anthropic et d'OpenAI.
• Un compte pour Claude Code : un abonnement Claude Pro, Max, Team ou Enterprise, ou un compte Claude Console (les offres).
• Un compte pour Codex : un abonnement ChatGPT Plus ou Pro, un espace Business, Edu ou Enterprise où Codex est activé, ou une clé d'API OpenAI facturée à l'usage (les offres).
• Git, sur git-scm.com/downloads.

L'installation des deux outils, pas à pas pour chaque système, ouvre le chapitre 2. Pour vérifier où tu en es, tape dans ton terminal :

claude --version
codex --version
git --version

Ce que la suite t'apporte

La prochaine leçon, gratuite elle aussi, ouvre un vrai projet dans les deux outils : ce site-ci. Tu verras ce que chacun lit au démarrage, les gestes du quotidien côte à côte, et une surprise dans mon propre dépôt.

Ensuite, le chapitre 2 prend chaque équivalence une par une, avec les fichiers à copier : installer et configurer le second outil, un seul fichier d'instructions pour les deux, les skills partagés, les permissions et le bac à sable. Le chapitre 3 les fait travailler ensemble : l'un écrit, l'autre relit, et tu choisis l'outil de chaque tâche avec des critères concrets.

Sources : configuration requise de Claude Code, Codex CLI, offres de Codex et Codex sous Windows, vérifiées le 19 octobre 2026.