Créer une équipe de sous-agents pour Claude Code et Codex

Un agent seul peut faire beaucoup, mais il aborde tout sous le même angle. Une équipe de sous-agents spécialisés travaille mieux : l’un planifie, un autre relit, un troisième écrit les tests. Claude Code et Codex savent tous deux le faire, et la mise en place est plus simple qu’il n’y paraît.

Ce qu’est un sous-agent

Un sous-agent est un agent distinct, avec sa propre tâche, ses propres instructions et, si vous le souhaitez, des droits restreints. L’agent principal lui confie une sous-tâche ; le sous-agent travaille dans son propre contexte et renvoie son résultat. Cela présente deux avantages : l’agent principal reste concentré sur sa tâche, et un relecteur qui n’a que le droit de lire ne peut rien casser.

Les sous-agents dans Claude Code

Claude Code lit les sous-agents dans des fichiers Markdown :

~/.claude/agents/ s’applique à tous les projets de la machine.
.claude/agents/ dans le dépôt ne s’applique qu’à ce projet et suit le code.

Un fichier ressemble à ceci :

---
name: reviewer
description: "Relit les modifications à la recherche de bugs, de tests manquants et de failles de sécurité. À utiliser de manière proactive avant chaque commit."
tools: Read, Grep, Glob, Bash
model: inherit
---

Tu es le relecteur de l’équipe. Tu ne modifies aucun fichier …

C’est la description qui compte : Claude Code choisit lui-même les sous-agents en fonction de cette description. Des formulations comme « À utiliser de manière proactive quand … » y aident. Vous pouvez aussi confier une tâche directement à un sous-agent : « Demande au reviewer de vérifier les dernières modifications. » La commande /agents vous permet de les gérer dans Claude Code.

Les sous-agents dans Codex

Codex utilise des fichiers TOML, selon le même principe :

~/.codex/agents/ pour tous les projets,
.codex/agents/ dans le dépôt.

name = "reviewer"
description = "Relit les modifications à la recherche de bugs, de tests manquants et de failles de sécurité."
sandbox_mode = "read-only"
developer_instructions = '''
Tu es le relecteur de l’équipe. Tu ne modifies aucun fichier …
'''

Avec sandbox_mode = "read-only", l’agent ne peut que lire. Contrairement à Claude Code, Codex ne fait généralement appel aux sous-agents que si vous ou une instruction le demandez. C’est pourquoi une courte liste de l’équipe a sa place dans AGENTS.md, par exemple : « reviewer : faire relire après chaque modification du code et avant chaque commit. » Codex lance les sous-agents en parallèle et synthétise leurs résultats.

Une équipe de départ pertinente

planer (planification) : lit le code et fournit, avant les tâches importantes, un plan en petites étapes (lecture seule).
reviewer (relecture) : vérifie les modifications avant le commit (lecture seule).
tester (tests) : écrit des tests et exécute la suite de tests.
sicherheit (sécurité) : cherche des failles dans l’authentification, les paiements, les téléversements et les saisies des utilisateurs (lecture seule).
debugger (débogage) : cherche la cause des erreurs et sécurise la correction par un test.
doku (documentation) : maintient le README et les guides à jour par rapport au code.

Sur chaque euhost Box, cette équipe est déjà configurée, pour Claude Code et pour Codex. Vous trouverez les fichiers dans ~/.claude/agents/ et ~/.codex/agents/ et pouvez les adapter ou les supprimer.

Conseils pratiques

Les agents propres à un projet ont leur place dans le dépôt (.claude/agents/, .codex/agents/). Toute votre équipe dispose alors des mêmes agents, et les modifications passent par Git.
Rédiger des descriptions précises. « Vérifie le code » est trop vague ; « avant chaque commit, en se concentrant sur les tests manquants et la gestion des erreurs » est juste.
Limiter les droits. Un agent qui doit seulement vérifier n’obtient qu’un accès en lecture.
Les agents en parallèle consomment des tokens. Chaque sous-agent utilise une partie du quota de votre abonnement Claude ou OpenAI. Pour les petites modifications, l’agent principal suffit.