Principes de base de l'agent

Problème : Dans un vrai projet, on a souvent besoin de plusieurs paires d'yeux. Une pour la sécurité. Une pour les performances. Quelqu'un pour vérifier la cohérence de la documentation. Assumer tous ces rôles dans un seul chat, ça te fait perdre ta concentration et te fait perdre du temps.

Solution rapide : confie une tâche parallèle à un sous-agent. Il s'exécute tout seul, puis renvoie ses résultats dans ta session principale.

Compréhension : Claude Code te propose plusieurs façons d'obtenir un comportement de type agent, des sous-agents intégrés à tes propres commandes slash. Chacune a son utilité pour des tâches différentes. Maîtrise les bases avant de te lancer dans les modèles plus sophistiqués.

Voici les cinq voies proposées par Claude Code, côte à côte :

Chaque approche a ses avantages et ses inconvénients. Les sous-agents sont plus performants pour le travail en parallèle. Les définitions d'.claude/agents/s donnent aux sous-agents un nom qui reste. Les commandes slash brillent par leur réutilisabilité.

Utilise cette page pour déterminer quelle primitive te convient le mieux. Si tu sais déjà que tu veux plusieurs agents et que la question qui reste en suspens est celle de la forme de coordination, lis Modèles d'agents. Si tu as besoin de plusieurs sessions Claude collaborant en tant que pairs plutôt que de sous-agents relevant d'un chef, passe à Équipes d'agents Claude.

Une échelle de décision simple

Si tu ne sais pas quelle voie choisir, ne commence pas par la plus sophistiquée. Descends cette échelle :

1. S'agit-il simplement d'un changement de perspective ponctuel ?

Utilise les invites de perspective.

1. S'agit-il d'un workflow reproductible que tu souhaites déclencher à la demande ?

Utilise une commande slash.

1. S'agit-il d'un spécialiste permanent vers lequel Claude devrait pouvoir rediriger automatiquement ?

Utilise l'.claude/agents/

1. As-tu besoin d'un travail en parallèle ou d'un contexte isolé dès maintenant ?

Utilise un sous-agent via l'outil Tâche.

1. La règle doit-elle s'appliquer à toutes les sessions du dépôt ?

Place-la dans « CLAUDE.md ».

Cet ordre est important, car il t'évite de surdévelopper. La plupart des équipes devraient progresser progressivement, des invites aux commandes puis aux agents persistants, sans passer directement à une gigantesque flotte de spécialistes.

L'outil Task

Au sein de ta session, l'outil Task lance de petites instances de Claude Code. Chaque sous-agent dispose d'une nouvelle fenêtre de contexte, fonctionne de manière indépendante et renvoie ses résultats à l'orchestrateur.

Pourquoi les sous-agents sont importants :

• Un contexte isolé empêche le travail sur une tâche de déborder sur la suivante
• Les exécutions parallèles réduisent le temps réel nécessaire à l'analyse de plusieurs fichiers
• Si un sous-agent échoue, il n'entraîne pas la session principale dans sa chute
• Le mode arrière-plan te permet de continuer à travailler pendant qu'ils s'exécutent (appuie sur Ctrl+B)

Nouveau : les sous-agents créés par Claude peuvent désormais rester en arrière-plan. Appuie surCtrl+B , et l'agent principal reste libre pour d'autres discussions. Les résultats s'affichent dès qu'ils ont terminé. Guide complet dans le guide des workflows asynchrones.

Pour des modèles d'orchestration plus avancés, consulte Modèles d'agents.

Définitions personnalisées de sous-agents

Les sous-agents peuvent également être stockés sur le disque. Place un fichier Markdown dans un répertoire dédié agents/, avec un frontmatter YAML en haut, et tu obtiens une définition de sous-agent personnalisée. Il ne s'agit pas de commandes slash. Les commandes slash sont des invites que tu appelles manuellement. Une définition d'agent configure un sous-agent persistant que l'orchestrateur de Claude récupère de lui-même lorsque la tâche s'y prête.

Deux portées pour les définitions d'agent :

• Agents de projet (.claude/agents/) - Spécifiques à ton dépôt, partageables avec ton équipe via git
• Agents utilisateur (~/.claude/agents/) - Disponibles dans tous tes projets, personnels à ta machine

Un sous-agent déclaré dans .claude/agents/ lit le fichier CLAUDE.md de ton projet, tout comme le fait la session principale. Les normes de codage, les conventions et les règles du projet sont toutes reprises sans configuration supplémentaire.

Contrôler le modèle du sous-agent : configure CLAUDE_CODE_SUBAGENT_MODEL dans ton environnement pour diriger les sous-agents vers un modèle spécifique. Utile pour réduire les coûts (un modèle plus léger pour les sous-agents) ou pour des tâches qui bénéficient d'un raisonnement plus poussé.

Restriction de l'accès des sous-agents à l'aide de règles d'autorisation

Tu peux indiquer à Claude quels sous-agents il est autorisé à appeler, en utilisant les règles d'autorisation d'Task(AgentName). Ajoute-les dans le tableau deny de ton fichier settings.json, ou transmets-les en ligne de commande via --disallowedTools.

Cela empêche le sous-agent Explore d'être lancé. Les noms d'agents intégrés couvrent Explore, Plan et Verify. Les agents peuvent également être désactivés au démarrage.

Utilise cette option dans les environnements sensibles où tu souhaites contrôler plus étroitement le comportement des agents, ou lorsque l'exploration autonome consomme trop de jetons.

Commandes slash personnalisées

Les commandes slash réutilisables sont stockées sous forme de fichiers Markdown dans .claude/commands/. Exécute /project:security-review src/auth/ et ton spécialiste se met au travail.

Emplacements des commandes :

• .claude/commands/ - Spécifiques au projet, partageables via git
• ~/.claude/commands/ - Personnelles, disponibles partout

Personnages CLAUDE.md

Chaque interaction dans ton projet passe par ce qui se trouve dans CLAUDE.md. Le fichier finit par définir la façon dont Claude s'affiche par défaut. Une cohérence de type agent, sans jamais appeler l'agent par son nom.

Invites de perspective : changements de contexte rapides

Pour un aperçu ponctuel, demande à Claude d'adopter une perspective spécifique. Aucune configuration. Une analyse spécialisée immédiate.

Quand utiliser quoi

Utilise des sous-agents lorsque : tu souhaites des exécutions parallèles, ou si tu as besoin d'un contexte isolé sur plusieurs tâches.

Utilise l'.claude/agents/e lorsque : tu souhaites des agents spécialisés nommés qui restent disponibles, et que l'orchestrateur de Claude les sélectionne automatiquement en fonction du type de tâche.

Utilise les commandes slash lorsque : le même workflow revient régulièrement d'une session à l'autre, ou que tu souhaites le partager avec l'équipe.

Utilise CLAUDE.md lorsque : le comportement doit s'appliquer partout, à chaque interaction, automatiquement.

Utilise les invites de perspective lorsque : tu veux un avis rapide et ponctuel sous un angle différent.

Trois configurations pratiques

1. Révision de sécurité sans charge de travail permanente

Si tu souhaites parfois un deuxième regard sur l'authentification, les vérifications d'autorisation ou la gestion des secrets :

• garde ta session normale
• lance un sous-agent dédié à la sécurité
• demande-lui de ne rapporter que ses conclusions

C'est mieux qu'une définition d'agent permanente si le besoin est occasionnel.

2. Workflow de contenu que tu exécutes chaque semaine

Si tu continues à rédiger des documents, des journaux de modifications ou des articles de blog avec les mêmes critères de qualité :

• utilise une commande slash
• charge la voix, le workflow et la checklist là-bas
• n'impose pas ce contexte de contenu à chaque session de codage

C'est le juste milieu, propre et réutilisable.

3. Spécialiste du domaine vers lequel tu veux que Claude t'oriente naturellement

Si ton dépôt comporte des tâches récurrentes liées au front-end, au back-end, à la base de données ou à la sécurité :

• définis des spécialistes permanents dans .claude/agents/
• garde les règles de domaine à proximité de l'agent
• laisse l'orchestrateur les sélectionner lorsque la tâche s'y prête

C'est là que les agents persistants commencent à porter leurs fruits.

En pratique, les configurations Claude Code bien développées exécutent les cinq à la fois. Des définitions persistantes pour les rôles de spécialistes. Des commandes slash pour les workflows récurrents. CLAUDE.md pour les normes à l'échelle du projet. Des sous-agents pour les tâches parallèles. Le ClaudeFast Code Kit comprend 18 agents préconfigurés (de l'auditeur de sécurité au spécialiste front-end), ainsi que les commandes slash et les règles de routage déjà en place, ce qui te permet de voir les modèles avant de créer les tiens.

Prochaine étape : choisis un workflow que tu exécutes souvent, et transforme-le en commande slash sous .claude/commands/. À partir de là, explore les stratégies de distribution nécessaires aux tâches d'orchestration plus complexes.

Découvre d'autres concepts liés aux agents :

• Meilleures pratiques pour les sous-agents - Quand utiliser l'exécution parallèle, séquentielle ou en arrière-plan
• Conception des sous-agents - Modèles d'architecture pour orchestrer plusieurs agents
• Agents personnalisés - Crée des agents spécialisés avec des commandes slash
• Modèles d'agents - Modèles de conception éprouvés pour les systèmes d'agents
• Agents de type humain - Crée des agents dotés de personnalités distinctes