Définir un sous-agent
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change.
tools: Read, Grep, Glob, Bash(git diff *)
model: sonnet
---
You are a senior reviewer. Read the staged diff, list concrete defects with file:line,
flag untested paths, and stop. Do not edit files.name détermine comment vous l’appelez ; description détermine comment Claude décide de l’appeler de lui-même ; rédigez donc ce champ comme une règle de routage (« utiliser après toute modification non triviale ») plutôt que comme un intitulé de poste. tools limite ce qu’il peut faire — un agent de revue qui ne peut pas modifier les fichiers est plus sûr. model fixe un niveau : haiku pour l’exploration et la classification, sonnet pour la plupart des tâches, opus pour l’étape difficile, ou inherit pour suivre la session parente.
Agents de projet et agents utilisateur
Les fichiers dans .claude/agents/ appartiennent au dépôt et l’accompagnent — versionnez-les, et chaque membre de l’équipe disposera du même agent de revue, de rédaction de tests et de migration. Les fichiers dans ~/.claude/agents/ vous appartiennent et sont disponibles dans tous vos projets. Les agents de projet sont prioritaires en cas de conflit de noms. /agents dans une session permet de lister, de créer et de modifier les deux types sans manipuler les fichiers à la main.
Quand Claude délègue
De deux manières. Implicitement : l’agent principal lit la description de chaque sous-agent et délègue lorsqu’une tâche correspond — il n’est pas nécessaire de demander « exécute le sous-agent code-reviewer sur ceci » si la description indique déjà quand l’utiliser. Explicitement : nommez-le dans le prompt. Dans les deux cas, le sous-agent s’exécute dans son propre contexte, ne voit que ce qui lui est fourni et ce qu’il lit, puis renvoie un résultat que la session principale résume dans son propre historique. Les sous-agents ne lancent pas de sous-agents ; la hiérarchie ne comporte qu’un seul niveau.
Pourquoi ils limitent le coût des sessions
Chaque tour dans Claude Code renvoie l’intégralité de la conversation. Un sous-agent qui lit quarante fichiers le fait dans sa propre fenêtre de contexte ; le parent reçoit un paragraphe. Sans sous-agents, ces quarante fichiers resteraient dans le contexte principal jusqu’à la fin de la session et seraient renvoyés à chaque tour. Pour les grandes bases de code, la méthode est donc la suivante : explorer avec un sous-agent Haiku, réviser avec un sous-agent Sonnet et réserver le contexte du parent aux décisions. Chaque sous-agent facture ses propres tokens : ce n’est pas gratuit, mais le coût reste circonscrit.
Parallélisme et limites de débit
Plusieurs sous-agents peuvent fonctionner simultanément, chacun constituant une requête parallèle en streaming. C’est le moyen le plus rapide d’atteindre la limite de requêtes simultanées de n’importe quel point de terminaison. Avec un nouveau compte sur la passerelle, commencez donc par deux ou trois sous-agents en parallèle et demandez une limite de simultanéité plus élevée une fois la charge de travail réelle établie. Le guide des erreurs explique les 429 que vous obtenez dans le cas contraire.
Équipes d’agents
Les versions récentes de Claude Code ajoutent les équipes d’agents : au lieu d’un parent qui délègue à des sous-agents éphémères, plusieurs sessions se coordonnent comme des coéquipiers nommés, avec une liste de tâches partagée et des messages entre eux. Un responsable peut ainsi distribuer le travail, demander un état d’avancement et arrêter un coéquipier. Cette fonctionnalité expérimentale s’active par un paramètre et évolue d’une version à l’autre : consultez claude --help et le journal des modifications pour connaître l’option actuelle, plutôt qu’un article de blog. Le principe est le même que pour les sous-agents, avec la persistance et la communication en plus ; le modèle de coût est lui aussi identique, multiplié par le nombre de coéquipiers.
Sur la passerelle
Les sous-agents et les équipes utilisent le même point de terminaison et la même clé que la session parent, donc ANTHROPIC_BASE_URL=https://aiprimetech.io les couvre tous. Avec une formule illimitée à tarif forfaitaire, la question du parallélisme devient une question d’utilisation raisonnable plutôt que de facturation, ce qui explique pourquoi les utilisateurs intensifs de systèmes multi-agents finissent souvent par choisir cette formule.
| Plan | Durée | Prix |
|---|---|---|
| Illimité pendant 1 heure | 1 heure | $1 |
| Illimité pendant 24 heures | 24 heures | $10 |
| Illimité pendant 1 semaine | 1 semaine | $49 |
| Illimité pendant 15 jours | 15 jours | $89 |
Essayez gratuitement pour commencer
Les nouveaux comptes reçoivent 5 $ de crédit API offert avec le code CLAUDECODE — de quoi passer une soirée à utiliser Claude Code avec Sonnet — puis des crédits valant 7.69231× leur valeur nominale.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyQuestions fréquentes
Qu’est-ce qu’un sous-agent dans Claude Code ?
Un agent distinct, doté de ses propres instructions système, autorisations d’outils, choix de modèle et fenêtre de contexte, défini dans un fichier Markdown de .claude/agents/, auquel la session principale délègue des tâches.
Où trouver la documentation des sous-agents de Claude Code ?
La référence officielle se trouve dans la documentation Claude Code d’Anthropic, à la rubrique Sous-agents ; cette page en est la version pratique : le format des fichiers, les circonstances de la délégation et son coût.
Les sous-agents entraînent-ils un coût supplémentaire ?
Leurs propres tokens sont facturés comme pour toute requête. Ils permettent de réduire les coûts des longues sessions en gardant les lectures volumineuses hors du contexte parent, mais coûtent plus cher si vous en exécutez beaucoup en parallèle sur Opus.
Que sont les équipes d’agents ?
Une extension expérimentale dans laquelle plusieurs sessions Claude Code se coordonnent comme des coéquipiers nommés, avec une messagerie et une liste de tâches partagée, plutôt qu’un parent et des assistants éphémères.
Utilisez Claude Code sur la passerelle
Les mêmes modèles, deux variables d’environnement, des crédits valant 7.69231× leur valeur nominale — ou une offre illimitée à tarif forfaitaire. Nouveaux comptes : 5 $ de crédit API offert avec le code CLAUDECODE.
Obtenir une clé API Voir les offres illimitéesAI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.