Codex et Claude Code : sous-agents en parallèle, prompts et réglages

L’idée répandue selon laquelle « Claude Code passe en parallèle tout seul, mais Codex ne le fait pas tant qu’on ne le lui demande pas » est vraie, sous conditions. L’application, la CLI et l’extension IDE de Codex lancent des exécutants parallèles (des sous-agents) quand vous le demandez, ou quand AGENTS.md ou une skill lui dit de répartir le travail entre sous-agents. Claude Code, lui, délègue aussi de sa propre initiative, en fonction du contenu de votre demande et de la description de chaque sous-agent.

Cet article compare la façon d’obtenir du travail en parallèle avec les deux outils, d’après la documentation officielle d’OpenAI et d’Anthropic (vérifiée le 26 octobre 2026), dans cet ordre : déclencheurs, rédaction des consignes, configuration, commandes et coût. Dans chaque section, les deux outils apparaissent dans le même ordre et avec les mêmes couleurs : Codex → Claude Code. Pour finir, je résume les leçons que ce site a tirées de l’exécution de sous-agents en parallèle avec Claude Code.

1. Ce qui déclenche le parallélisme, et ce qui se passe si vous ne dites rien

Un sous-agent est un exécutant distinct qui prend en charge une partie du travail de la conversation principale. Chacun mène des recherches ou des tests dans son propre contexte et ne renvoie qu’un résumé de ses résultats à la conversation principale. Les faire tourner en parallèle réduit l’attente et évite que la conversation principale se remplisse de journaux intermédiaires. Les deux outils partagent ce principe.

Ce qui diffère, c’est qui en prend l’initiative. Voici quatre situations.

Sources : OpenAI « Subagents » ; Anthropic « Create custom subagents ». Vérifié le 26 octobre 2026.

Selon la documentation officielle de Codex, les versions locales de Codex (application, CLI, extension IDE) délèguent « quand on le leur demande directement, ou quand des consignes pertinentes d’AGENTS.md ou d’une skill demandent de déléguer ». La fonction n’est pas désactivée : le système de sous-agents est activé par défaut dans les versions actuelles. La décision d’en lancer est laissée à vos consignes. Dans ChatGPT Work (web), la plupart des niveaux d’intelligence exigent une demande explicite, et seulement si vous choisissez Ultra (Ultra est réservé aux comptes éligibles et aux modèles compatibles), il peut déléguer de lui-même lorsque le parallélisme améliorerait nettement la vitesse ou la qualité.

La description officielle de Claude Code est qu’il « délègue automatiquement en fonction de la tâche demandée, de la description figurant dans la définition du sous-agent et du contexte en cours ». Pour les sous-agents que vous voulez voir utilisés plus volontiers, elle recommande de mettre des formules comme « use proactively » dans la description. Les sous-agents qui héritent de la conversation telle quelle (les forks) sont eux aussi lancés par Claude à sa discrétion par défaut.

Un point de détail : le changelog de Codex mentionne une modification qui permet à ceux qui intègrent Codex dans leurs propres produits (les clients app-server) de choisir la délégation parmi « désactivée, sur demande explicite uniquement, ou proactive » (Codex CLI 0.142.0, 22 juin 2026). Pour les utilisateurs de l’application, de la CLI et de l’IDE, le comportement est celui du tableau ci-dessus.

2. Le fonctionnement des deux outils, côte à côte

Voici comment s’écrivent les définitions de sous-agents, combien peuvent tourner en même temps, comment les répertoires de travail sont séparés, etc. Lorsque seule la documentation officielle d’un côté aborde un point, il est marqué « Non documenté ».

Sources : OpenAI « Subagents », « Configuration Reference », « Worktrees » ; Anthropic « Create custom subagents », « Run parallel sessions with worktrees ». Vérifié le 26 octobre 2026.

Il y a deux grandes différences. La première : peut-on empêcher un sous-agent d’écrire ? Codex reprend tel quel les permissions du parent, donc dire à un sous-agent « ne modifie rien » n’est qu’une demande. Claude Code peut retirer complètement à un sous-agent ses outils d’édition (Write, Edit). Pour bloquer aussi les écritures depuis le shell, retirez également Bash. La seconde : une copie de travail par sous-agent. Claude Code peut créer un git worktree (une copie de travail distincte du même dépôt) pour chaque sous-agent, tandis que les worktrees de Codex sont par chat.

Claude Code dispose d’autres moyens de travailler en parallèle que les sous-agents (l’agent view, qui fait tourner des sessions distinctes sur un même écran, et les agent teams, où les exécutants communiquent entre eux). Les différences sont expliquées dans « Subagents vs Agent Teams dans Claude Code » et « L’agent view de Claude Code ».

3. Rédiger les consignes, avec des prompts prêts à l’emploi

La documentation officielle de Codex recommande qu’un bon prompt précise comment répartir le travail, s’il faut attendre tous les agents avant de continuer et ce qu’il faut renvoyer. D’après notre expérience des sous-agents en parallèle sur ce site, ajouter deux points de plus réduit les accidents.

1. Comment répartir le travailPar préoccupation (sécurité, tests, maintenabilité), par emplacement (répertoire, module), etc. Répartissez de sorte que deux sous-agents n’examinent jamais la même chose
2. Ce qu’ils ont le droit de toucher« Lecture seule », ou « tu ne peux modifier que ce répertoire ». Ne laissez jamais deux sous-agents toucher au même fichier
3. Faut-il attendre tout le monde ?Ne combiner qu’une fois tous les résultats arrivés, ou autoriser à avancer en cours de route
4. Ce qu’il faut renvoyerFormat et longueur (« moins de 10 lignes avec les noms de fichiers », etc.). Les réponses longues remplissent vite le contexte principal
5. Ce qu’il ne faut pas faireCommit, push, sous-agents qui lancent d’autres sous-agents, etc. Si on ne leur dit pas ce qui est interdit, les sous-agents le feront avec les meilleures intentions

Recherche et revues en lecture seule (commencez par là)

Passe cette branche en revue par rapport à main. Lance trois sous-agents en parallèle :
un pour les problèmes de sécurité, un pour les tests manquants et un pour la maintenabilité.
Aucun d’eux ne doit modifier de fichier.
Attends que les trois aient terminé, puis résume par préoccupation, avec les noms de fichiers et les lignes concernées.

Étudie les modules d’authentification, de base de données et d’API en parallèle avec des sous-agents distincts.
Chaque sous-agent doit seulement lire, sans modifier aucun fichier.
Demande à chacun de renvoyer « fichiers d’entrée, flux de traitement principal, points d’attention » en moins de 10 lignes,
et ne combine le tout qu’une fois tous les résultats arrivés.

Répartir un travail qui modifie des fichiers

Les deux documentations officielles traitent avec prudence le travail parallèle qui écrit beaucoup. Donnez à chaque sous-agent sa propre zone modifiable et, dans Claude Code, séparez aussi les copies de travail.

Trouve pourquoi l’enregistrement échoue sur la page des paramètres, et corrige-le.
Demande à browser_debugger de reproduire le problème dans le navigateur et de noter les étapes,
et à code_mapper de trouver où se trouve le code en cause (ces deux-là ne doivent rien modifier).
Une fois la cause connue, demande à ui_fixer d’apporter la correction minimale. Ne touche pas aux fichiers sans rapport.

/batch migre le JavaScript de src/ vers TypeScript

Ne pas avoir à le répéter à chaque fois

Si devoir demander le parallélisme à chaque fois dans Codex vous pèse, écrivez des règles de délégation dans le fichier AGENTS.md du projet. La documentation officielle indique qu’il délègue lorsque des consignes pertinentes existent dans AGENTS.md ou une skill. Elle ne dit pas quelle formulation le déclenche à coup sûr ; après avoir écrit les règles, vérifiez donc une fois si des sous-agents démarrent pour vos demandes habituelles.

## Utilisation des sous-agents
- Pour une recherche couvrant trois répertoires ou plus, lancer un sous-agent par répertoire et chercher en parallèle
- Ne pas laisser les sous-agents modifier des fichiers. Faire toutes les modifications dans le fil principal
- Attendre que tous les résultats soient arrivés, puis ne rapporter que l’essentiel

Dans Claude Code, si vous voulez qu’un sous-agent donné soit davantage utilisé, écrivez dans sa description quand l’utiliser, avec « use proactively » (voir un exemple de définition dans la section suivante). À l’inverse, s’il délègue trop, ajouter Agent à permissions.deny l’empêche de lancer des sous-agents.

4. Configuration et fichiers de définition des sous-agents

Codex config.toml et .codex/agents/

Les réglages globaux se placent sous [agents] dans config.toml (personnel : ~/.codex/config.toml, projet : .codex/config.toml).

# .codex/config.toml
[agents]
max_concurrent_threads_per_session = 4     # Nombre max de threads de sous-agents ouverts à la fois (thread principal non compté)
default_subagent_model = "gpt-6-luna"      # Modèle par défaut des sous-agents
default_subagent_reasoning_effort = "high" # Effort de raisonnement par défaut des sous-agents

Source : OpenAI « Configuration Reference ». Vérifié le 26 octobre 2026. Le « multi agent v2 » que l’on voit souvent dans les résultats de recherche est la version actuelle de ce système ; d’après le changelog, il est devenu stable dans Codex CLI 0.145.0 (21 juillet 2026) (Changelog). Dans les versions actuelles, il est activé sans que vous ayez à écrire multi_agent = true.

Les agents personnalisés se placent dans .codex/agents/, un fichier TOML par agent. Le nom de l’agent vient de name, pas du nom du fichier.

# .codex/agents/reviewer.toml
name = "reviewer"
description = "Relecteur centré sur l’exactitude, la sécurité et les tests manquants"
model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
developer_instructions = """
Ne modifie aucun fichier.
Priorité à l’exactitude, à la sécurité, aux régressions de comportement et aux tests manquants.
Ne fais de remarques purement stylistiques que si elles masquent un vrai bug.
"""

Adapté de l’exemple officiel. Les noms de modèles proviennent de l’exemple officiel ; les modèles disponibles varient selon le compte et l’espace de travail. La recommandation officielle est gpt-6.1-sol pour les agents qui prennent beaucoup de décisions délicates et gpt-6-luna pour les agents légers au périmètre bien délimité. Des réglages comme sandbox_mode, approval_policy et mcp_servers sont écrasés par ceux du parent, même si vous les écrivez dans le fichier de l’agent.

Claude Code .claude/agents/ et settings.json

Les sous-agents se trouvent dans .claude/agents/ au format Markdown. Vous pouvez aussi simplement demander à Claude de « créer un sous-agent qui fait X » et le laisser écrire le fichier.

---
name: test-runner
description: Lance la suite de tests et ne signale que les tests en échec avec leurs erreurs. Use proactively après toute modification du code.
tools: Read, Grep, Glob, Bash
model: haiku
---

Lance les tests et ne renvoie que les noms des tests en échec et l’essentiel de leurs erreurs.
Ne corrige pas le code. Ne renvoie pas la liste des tests réussis.

Comme tools ne contient ni Write ni Edit, ce sous-agent ne peut, selon la documentation officielle, ni modifier ni écrire de fichiers. Bash est toutefois conservé pour qu’il puisse lancer les tests, ce qui laisse la possibilité d’écrire via des commandes shell. « Ne corrige pas le code » dans le corps sert de rappel à ce sujet. model accepte sonnet, opus, haiku, fable, un identifiant de modèle ou inherit (le même que la conversation principale). Le choix d’un modèle par sous-agent est expliqué dans « Claude Code : exécuter les sous-agents sur un autre modèle ».

La limite de simultanéité et la profondeur d’imbrication se règlent par des variables d’environnement, que vous pouvez placer sous env dans settings.json.

{
  "env": {
    "CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS": "5",
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "1"
  }
}

Sources : Anthropic « Create custom subagents », « Orchestrate teams of Claude Code sessions ». Vérifié le 26 octobre 2026.

5. Aide-mémoire des commandes

Voici les commandes pour suivre les sous-agents en cours, séparer les copies de travail, faire bifurquer une conversation, etc. Certaines portent le même nom mais font des choses différentes : attention.

Sources : OpenAI « Command line options, Slash commands », « Subagents » ; Anthropic « Commands », « Run agents in parallel », « Create custom subagents » (essayer plusieurs approches avec des forks). Vérifié le 26 octobre 2026.

Celle qui prête à confusion, c’est /agents, parce que les noms sont identiques. Dans Codex, /agents est la liste des chats sur le serveur (le centre de commande). Dans Claude Code, /agents vous indique où se trouvent les définitions de sous-agents, et la liste des sessions s’obtient avec claude agents (lancé depuis le shell).

6. Les tâches qui se prêtent au parallélisme, et celles qui ne s’y prêtent pas

Les deux documentations officielles disent à peu près la même chose : commencez par du travail en lecture seule, et soyez prudent avec le travail qui écrit beaucoup.

Sources : OpenAI « Subagents » (Why subagent workflows help) ; Anthropic « Create custom subagents » (Choose between subagents and main conversation) et « agent teams » (Avoid file conflicts). Vérifié le 26 octobre 2026.

7. L’impact sur le coût (limites d’utilisation)

Le parallélisme va plus vite, mais il consomme davantage de votre quota d’utilisation, parce que chaque sous-agent fait ses propres appels au modèle et utilise ses propres outils.

Sources : OpenAI « Subagents », « Changelog » ; Anthropic « Manage costs effectively », « Create custom subagents ». Vérifié le 26 octobre 2026.

Autre point facile à négliger : les réponses des sous-agents atterrissent elles aussi dans le contexte principal. La documentation de Claude Code prévient que faire tourner de nombreux sous-agents qui renvoient des résultats détaillés peut consommer une grande partie du contexte principal. Fixer un format de retour comme « moins de 10 lignes » aide aussi pour le coût. Les économies de tokens en général dans Claude Code sont abordées dans « Astuces pour économiser les tokens dans Claude Code ».

8. Leçons tirées de la pratique (exemples de ce site)

Ce site (AI Arte) fonctionne en confiant la traduction et les vérifications des articles à des sous-agents Claude Code en parallèle. La recherche et le brouillon de cet article ont eux aussi été rédigés par l’un des sous-agents envoyés par la session principale. Voici ce qui s’est réellement produit, avec la manière de l’éviter. Tout cela provient de Claude Code ; rien n’a été reproduit dans Codex. Cela dit, les conflits sur un même fichier et les rapports inexacts sur ce qui sort du périmètre d’un sous-agent méritent aussi d’être surveillés dans Codex, dont le mécanisme est similaire.

1. Juillet 2026Réglez le nombre en simultané selon vos propres limites

   Ce qui s’est passé

   En lancer six ou plus à la fois a fait échouer des sous-agents sur des limites de débit

   Comment l’éviter

   Plafonnez à 5 à la fois, et traitez les gros travaux par lots successifs de 5. Fixez un plafond adapté à vos propres limites, en dessous du plafond par défaut de Claude Code (20)

2. 22 septembre 2026Ne laissez pas les sous-agents lancer d’autres sous-agents

   Ce qui s’est passé

   Un sous-agent chargé d’un travail en 10 langues a lancé 5 sous-agents de traduction de son propre chef. Avec les 5 du parent, cela faisait 10 en même temps : la limite d’utilisation a été atteinte et tous se sont arrêtés en cours de route

   Comment l’éviter

   Sous « ce qu’il ne faut pas faire » dans les consignes, écrivez « Ne lance pas de sous-agents. C’est le parent qui répartit le travail. » Claude Code laisse par défaut les sous-agents lancer des sous-agents (jusqu’à 3 niveaux) ; vous pouvez donc aussi bloquer l’imbrication avec CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1

3. 22 août 2026Ne laissez jamais deux sous-agents toucher au même fichier

   Ce qui s’est passé

   Une phrase que le parent avait ajoutée à la fin d’un chapitre de cours a été supprimée par un autre sous-agent comme « absente des consignes », puis rajoutée, encore et encore

   Comment l’éviter

   Attribuez à chaque sous-agent les fichiers qu’il peut toucher. Pour tout ce que le parent ajoutera en bloc plus tard, mentionnez-le aussi dans les consignes des sous-agents, ou ajoutez-le une fois que tout le monde a terminé

4. 22 septembre 2026Séparez aussi l’emplacement des fichiers temporaires

   Ce qui s’est passé

   Un script temporaire qu’un sous-agent avait placé directement dans le dossier de travail temporaire avait été écrasé par un fichier du même nom créé par un autre sous-agent. Les sous-agents lancés depuis la même conversation voient le même dossier temporaire

   Comment l’éviter

   Dans les consignes, attribuez à chaque sous-agent son propre sous-dossier

5. 5 septembre 2026Ne commitez pas tout d’un coup pendant que des sous-agents tournent

   Ce qui s’est passé

   Pendant que 5 tournaient, une modification sans rapport a été commitée avec git add -A (toutes les modifications), embarquant 100 fichiers terminés par les sous-agents dans un commit sans rapport

   Comment l’éviter

   Commitez en indiquant les fichiers. Dites aussi aux sous-agents que les opérations qui regroupent toutes les modifications ou qui annulent des modifications sont interdites

6. 22 août 2026Recomptez tout ce que les sous-agents rapportent hors de leur périmètre

   Ce qui s’est passé

   Deux sous-agents ont rapporté « 24 éléments échouent à la vérification » et « 28 », mais le nombre réel était de 16. Ils avaient deviné l’état de fichiers qu’ils n’avaient pas touchés

   Comment l’éviter

   Le parent vérifie les nombres et les cibles en lançant lui-même les vérifications. Les constats faits dans le périmètre d’un sous-agent sont très fiables ; on peut s’y fier

Tiré des journaux d’exploitation de ce site (juillet à septembre 2026). Seuls les chiffres qui figurent dans ces journaux sont repris.

En rassemblant ces leçons, les consignes que vous distribuez ressemblent à ceci. Les sous-agents ne connaissent pas le reste de la conversation ; rédigez-les donc de façon à ce que les consignes suffisent à elles seules pour terminer le travail.

[Tâche] Faire la recherche pour l’article 273 et rédiger le brouillon ja
[Ce qu’il ne faut pas faire]
- Opérations git (add, commit, checkout, restore, stash, push)
- Ne pas lancer de sous-agents (c’est le parent qui répartit le travail)
- Ne pas modifier d’autres articles
- Placer les fichiers temporaires dans scratch-folder/a273/
[Méthode de recherche] À partir du texte original de la documentation officielle (noter les URL et les dates de vérification)
[Ce qu’il faut renvoyer] Fichiers créés, titre, tout ce qui n’a pas pu être vérifié

Le squelette (résumé) des consignes reçues par le sous-agent qui a écrit cet article, avec deux des leçons ci-dessus (ne pas lancer de sous-agents, emplacement des fichiers temporaires). Le même format convient aux consignes destinées aux sous-agents dans Codex comme dans Claude Code.

En résumé

Pour les différences générales entre les deux outils (tarifs, limites, où ils s’exécutent), voir « Claude Code vs Codex : lequel choisir ? », et pour les réglages qui rapprochent les sous-agents de la lecture seule, voir « Codex et Claude Code en lecture seule ».

FAQ

Q. Combien de sous-agents Codex peuvent tourner en même temps ?

R. Vous fixez le plafond avec agents.max_concurrent_threads_per_session dans config.toml (le thread principal n’est pas compté). Si vous ne le précisez pas, Codex décide, et cette valeur par défaut n’est pas publiée. Les exemples de configuration officiels utilisent 6 ou 8. Pour Claude Code, la valeur par défaut est de 20 à la fois, modifiable avec CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. Avec les deux outils, plus vous en lancez, plus vos limites d’utilisation s’épuisent vite.

Q. Puis-je utiliser un modèle moins cher uniquement pour les sous-agents ?

R. Oui. Dans Codex, réglez-le avec default_subagent_model sous [agents], ou avec model et model_reasoning_effort dans le fichier de l’agent. Sans indication, le modèle du parent est hérité. Dans Claude Code, réglez model dans la définition du sous-agent (haiku, etc.) ou utilisez la variable d’environnement CLAUDE_CODE_SUBAGENT_MODEL.

Q. Dois-je écrire « multi_agent = true » dans ma configuration ?

R. Pas dans la version actuelle de Codex. Dans la référence de configuration, features.multi_agent est stable et activé par défaut, et agents.enabled vaut aussi true par défaut. D’après le changelog, multi-agent V2 est arrivé comme système optionnel (opt-in) et est devenu stable dans Codex CLI 0.145.0 (21 juillet 2026). Les étapes « pour l’activer » des anciens guides aboutissent désormais au même état que si vous n’écriviez rien. Pour le désactiver, écrivez enabled = false sous [agents].

Q. Comment empêcher Claude Code de lancer des sous-agents de lui-même ?

R. Pour bloquer complètement les sous-agents, ajoutez Agent à permissions.deny dans vos réglages de permissions. Pour bloquer uniquement les sous-agents qui héritent de la conversation (forks), utilisez Agent(fork) ou la variable d’environnement CLAUDE_CODE_FORK_SUBAGENT=0. Si les agent teams sont activées, un sous-agent désigné par son nom peut démarrer comme membre d’une équipe ; laissez donc les agent teams désactivées si vous ne les utilisez pas.