Introduction au concept de sous-agent Claude Code

##Présentation

Lorsque vous utilisez Claude Code pour gérer des tâches complexes, vous avez peut-être été confronté à un tel dilemme : le contexte de la conversation principale devient de plus en plus long, l'IA commence à « oublier » les informations importantes précédentes et la qualité de la réponse diminue progressivement.

Subagent est né pour résoudre ce problème.

Si Skills est le « manuel de travail » de Claude, alors le sous-agent est « l'employé à temps plein » que vous embauchez : ils ont leur propre poste de travail indépendant (contexte), se concentrent sur un type de travail spécifique et vous rapportent les résultats une fois terminé.

Comprendre le sous-agent

Imaginez que vous êtes le PDG d'une entreprise. Lorsque l’entreprise est petite, vous gérez tout vous-même. Mais à mesure que votre entreprise se développe, vous commencez à embaucher des employés à temps plein : des comptables pour les finances, des RH pour le recrutement et des ingénieurs pour le développement. Chaque employé travaille à son propre poste et vous rend compte une fois la tâche terminée.

Le sous-agent joue exactement ce rôle dans Claude Code.

D'un point de vue technique, les sous-agents sont des assistants IA spécialisés qui présentent les caractéristiques suivantes :

Pourquoi avons-nous besoin d'un contexte indépendant ?

Il s’agit du concept de conception de base de Subagent et mérite une compréhension approfondie.

Dans une conversation normale, toutes les informations sont empilées dans le même contexte. Lorsque Claude recherche la base de code, analyse les fichiers, puis apporte des modifications, tous ces traitements intermédiaires occupent de l'espace contextuel. À mesure que la conversation progresse et que le contexte devient plus chargé, Claude peut commencer à « oublier » des informations importantes antérieures.

Le sous-agent modifie les éléments suivants :

主对话（专注于高层目标）
│
├── 用户：帮我优化这个模块的性能
│
├── Claude：我来分析一下...
│   │
│   └── [调用 Explore Subagent]
│       │ 在独立上下文中：
│       ├── 搜索相关文件
│       ├── 分析代码结构
│       ├── 识别性能瓶颈
│       └── 返回：发现 3 个优化点...
│
└── Claude：根据分析，我发现 3 个优化点...

Le processus d'analyse du sous-agent ne pollue pas la conversation principale. Le dialogue principal n'a reçu que des résultats raffinés, tout en conservant clarté et concentration.

Type de sous-agent intégré

Claude Code fournit trois sous-agents intégrés puissants, couvrant les scénarios d'utilisation les plus courants :

Explorer le sous-agent

Ciblage : exploration rapide et en lecture seule de la base de code.

Caractéristiques :

• Utiliser le modèle Haiku (rapide, faible latence)
• Strictement en lecture seule - les fichiers ne peuvent pas être créés, modifiés ou supprimés
• Outils disponibles : Glob, Grep, Read, Bash (opérations en lecture seule)

Quand utiliser : Lorsque vous posez des questions exploratoires telles que « Où cette fonction est-elle implémentée ? et "Comment les erreurs sont-elles gérées ?" Claude appellera automatiquement le sous-agent Explore.

Niveau de détail :

Sous-agent du plan

Positionnement : Étudiez la base de code et préparez un plan de mise en œuvre.

Caractéristiques :

• Utiliser le modèle Sonnet (capacités d'inférence plus fortes)
• Uniquement les outils d'exploration : Read, Glob, Grep, Bash
• Appelé automatiquement en mode planification

Quand utiliser : Lorsque vous entrez en mode planification et que Claude doit effectuer des recherches avant de proposer un plan, le sous-agent Plan collectera automatiquement des informations, puis proposera des suggestions de plan basées sur les résultats de la recherche.

Sous-agent à usage général

Positionnement : gérez des tâches complexes en plusieurs étapes.

Caractéristiques :

• Utiliser le modèle Sonnet
• Accès à tous les outils (y compris la lecture et l'écriture)
• Convient aux tâches complexes nécessitant une exploration et une modification

Quand utiliser : Lorsque la tâche implique plusieurs étapes, nécessite une recherche avant de la modifier, ou la recherche initiale peut échouer et plusieurs stratégies doivent être essayées.

Ma compréhension et ma pratique

Si vous observez attentivement les trois sous-agents intégrés officiels, vous découvrirez une chose en commun : Ce sont tous des tâches de recherche et de planification. Explore est responsable de l'exploration de la base de code, Plan est responsable de l'élaboration des plans et même General-Purpose est principalement utilisé pour la recherche et l'analyse. Aucun d’entre eux n’est spécifiquement conçu pour écrire du code.

Cela confirme ma compréhension de Subagent : La valeur fondamentale de Subagent n'est pas un "contexte propre", mais de permettre à l'agent principal de se concentrer sur ses tâches.

Mode de division du travail

Ma méthode d'utilisation est très simple : le sous-agent est responsable du travail de « collecte d'informations » tel que la recherche, la planification et l'examen, et l'agent principal est responsable de l'exécution réelle.

Subagent（调研员）          主 Agent（执行者）
     │                           │
     ├── 探索代码库结构            │
     ├── 分析依赖关系              │
     ├── 制定实施计划              │
     └── 返回精炼的上下文 ──────────→ 基于上下文执行任务
                                  │
                                  ├── 编写代码
                                  ├── 修改文件
                                  └── 运行测试

Pourquoi ne pas laisser le sous-agent écrire du code ?

Certaines personnes aiment que l'agent principal planifie plusieurs sous-agents pour écrire du code. Je pense que ce n'est pas fiable. La raison est simple : Le contexte manque cruellement.

Le contexte du sous-agent est indépendant. Il ne sait pas ce qui a été discuté, quelles décisions ont été prises et quelles contraintes ont été imposées lors de la conversation principale. Lui demander d'écrire du code, c'est comme demander à un nouvel employé d'accomplir une tâche sans aucune information de base : le code produit ne correspondra probablement pas à vos attentes.

Au contraire, il est bien plus raisonnable de positionner Subagent en « chercheur » :

• La tâche de recherche elle-même ne nécessite pas beaucoup de contexte
• Les informations sont renvoyées à la place du code, qui peut être utilisé par l'agent principal en fonction du contexte complet
• Même si les résultats de l'enquête sont biaisés, l'agent principal peut les corriger

Mon utilisation quotidienne

1. Avant de démarrer une nouvelle tâche : laissez l'agent Explore comprendre rapidement la structure du code concerné
2. Planification de tâches complexes : laissez l'agent du plan analyser les exigences et formuler les étapes de mise en œuvre
3. Code Review : laissez l'agent Review vérifier la qualité du code et les problèmes de sécurité.
4. Codage réel : l'agent principal écrit du code en fonction du contexte collecté

Voici la liste des agents que j'utilise actuellement :

L'avantage est que la fenêtre contextuelle de l'agent principal reste propre, avec uniquement « les informations dont j'ai besoin » au lieu de « un ensemble de résultats intermédiaires générés lors du processus de recherche du sous-agent ».

Comparaison avec d'autres fonctions

Subagent vs Skills

C'est la confusion la plus courante. Différence fondamentale : Les compétences injectent des connaissances à Claude ; Le sous-agent crée des travailleurs indépendants.

Pour le dire au sens figuré : les compétences sont comme du matériel de formation, permettant à Claude d'apprendre à faire quelque chose ; Le sous-agent est comme un employé à temps plein, qui accomplit la tâche de manière indépendante sur son poste de travail et rend compte des résultats.

Les deux peuvent être combinés : un sous-agent de révision de code peut charger la compétence de spécification de code pour obtenir l'effet combiné de « connaissances expertes et professionnelles ».

Commande sous-agent vs slash

La commande slash est une touche de raccourci et vous entrez /review pour déclencher une opération prédéfinie ; Le sous-agent est un travailleur indépendant qui peut effectuer des tâches complexes en plusieurs étapes de manière autonome.

Subagent vs Plugin

Le plugin est un concept de « conteneur », qui peut contenir des sous-agents :

Plugin（容器）
├── Commands（快捷命令）
├── Skills（知识包）
├── Agents（子代理）← 这就是 Subagent
└── Hooks（事件钩子）

Vous pouvez définir un sous-agent dans le répertoire agents/ du plugin et le distribuer avec le plugin.

Modèle de conception agent

Anthropic résume six modèles de conception agents de base dans sa documentation officielle. Comprendre ces modèles peut aider à mieux concevoir les systèmes de sous-agents :

Ces modes peuvent être utilisés en combinaison. Par exemple, un système de qualité de code peut utiliser à la fois :

• Parallélisation : exécutez simultanément des analyses de sécurité et des analyses de performances.
• Orchestre-Ouvriers : Maître Claude coordonne plusieurs sous-agents spécialisés
• Evaluator-Optimizer : vérifiez le code immédiatement après la génération

Avantages principaux

Protection du contexte

La plus grande valeur du sous-agent réside dans la protection du contexte de la conversation principale. Les processus intermédiaires tels que la recherche de code et l'analyse de fichiers ne seront pas accumulés dans le dialogue principal, permettant au dialogue principal de toujours se concentrer sur des objectifs de haut niveau.

Capacités de spécialisation

Vous pouvez créer des sous-agents spécialisés pour des domaines spécifiques, configurés avec des instructions détaillées et des outils appropriés. Un sous-agent spécialisé est plus performant dans une tâche spécifique qu'un Claude polyvalent.

Contrôle des autorisations flexible

Chaque sous-agent peut avoir des droits d'accès aux outils différents. Par exemple, la classe d'exploration Subagent n'accorde que des autorisations en lecture seule et la classe de modification Subagent n'accorde que des autorisations en écriture. Ce contrôle précis améliore la sécurité.

Réutilisabilité

Une fois créé, le sous-agent peut être réutilisé dans plusieurs projets ou partagé avec les équipes via des plugins.

Quand utiliser le sous-agent

Scénarios appropriés pour l'utilisation du sous-agent :

• Nécessite un contexte indépendant pour exécuter des tâches
• Les tâches sont des flux de travail complexes en plusieurs étapes
• Nécessite un ensemble d'outils différent de celui de la conversation principale
• Les tâches peuvent prendre beaucoup de temps à s'exécuter

Scénarios non adaptés à l'utilisation du sous-agent :

• Requête unique et simple
• Nécessite une interaction étroite avec le dialogue principal
• Les missions peuvent être accomplies rapidement

Scénarios d'application typiques

Révision du code

代码审查 Subagent
├── 专门的审查提示
├── 只读工具（Read, Grep, Glob）
└── 输出：结构化的审查报告

Lorsque vous complétez un morceau de code, vous pouvez demander au sous-agent Code Review de l'examiner dans un contexte indépendant sans interférer avec votre travail de développement principal.

Analyse de débogage

调试 Subagent
├── 错误分析专家提示
├── 读写工具
└── 输出：根因分析 + 修复方案

Lorsqu'une erreur est rencontrée, le sous-agent de débogage peut analyser en profondeur la cause de l'erreur, essayer diverses hypothèses et enfin fournir des suggestions de réparation.

Exploration de la base de code

探索 Subagent
├── Haiku 模型（快速）
├── 只读工具
└── 输出：代码结构概览

Lorsque vous débutez dans un nouveau projet, Explore Subagent peut rapidement cartographier votre base de code sans encombrer votre conversation principale avec des tonnes de résultats de recherche.

Ressources d'apprentissage

Ressources officielles

Ressources communautaires

Résumé

Claude Code Subagent est essentiellement un assistant d'IA spécialisé et indépendant du contexte. Il résout le problème de la surcharge d'informations dans les tâches complexes grâce à l'isolation du contexte, gardant la conversation principale claire et ciblée à tout moment.

Retenez trois mots clés :

Après avoir compris le concept, le prochain article "Claude Code Subagent Practical Guide" vous amènera à la pratique : création d'un sous-agent personnalisé, configuration des autorisations de l'outil et bonnes pratiques dans les projets réels.

Si vous souhaitez connaître les compétences que le sous-agent peut charger, veuillez lire "Que sont les compétences de Claude". Si vous souhaitez packager Subagent pour la distribution, veuillez lire "Qu'est-ce que le plugin Claude Code".