Aller au contenu
Mastering Claude

Le cours175 leçons

Accueil / Plusieurs agents et vérification adverse

Plusieurs agents et vérification adverse9 minApplication

Orchestrer plusieurs modèles dans Claude Code, avec un dossier prêt à installer

Répartissez les modèles par rôle, petit pour collecter, moyen pour exécuter, grand pour juger en aveugle, et déclarez ce choix dans les skills et les sous-agents : aucun crochet ne change le modèle de la session principale.

Dans une session longue, le coût et la qualité dépendent d'abord de qui fait quoi. Un petit modèle lit et extrait sans rien juger, un modèle moyen exécute une consigne arrêtée, le plus capable juge en aveugle, sur le livrable et les critères. Un dossier prêt à installer, testé sous Windows sur Claude Code 2.1.326, applique cette répartition dans Claude Code et, en plugin, dans Cowork.

Qui fait quoi

Le collecteur tourne sur Haiku avec les seuls outils Read, Grep et Glob : il rend des données brutes, sans conclure. L'exécutant tourne sur Sonnet et applique une consigne précise. Le juge tourne sur Opus, en lecture seule, et rend un verdict (voir la vérification adversariale et le routage par coût).

Le planificateur de recours tourne sur Fable, en lecture seule : quand la même erreur revient deux fois, il rend un nouveau plan sans rien exécuter, deux fois par session au plus (leçon sur le plafonnement d'une boucle de juges). fallbackModel, lui, ne couvre que l'indisponibilité du modèle principal.

Trois façons de changer de modèle sans y penser

Première façon : le champ model: (et effort:) dans l'en-tête d'une skill, comme model: haiku dans la skill releve-brut du kit. Deuxième façon : le même champ dans la définition d'un sous-agent, ici le juge du kit (description abrégée) :

---
name: juge
description: Vérification en aveugle, en lecture seule. […]
tools: Read, Grep, Glob
model: opus
effort: high
---

CLAUDE_CODE_SUBAGENT_MODEL ne fixe que le défaut : la définition de l'agent et le modèle passé à l'appel l'emportent. Troisième façon : l'alias opusplan, Opus en mode plan, Sonnet pour exécuter.

Un crochet, lui, ne change pas le modèle de la session principale : celui du kit refuse un lancement de sous-agent sans modèle explicite, il ne choisit rien. Changer de modèle en cours de session fait aussi perdre le cache de prompt : préférez des sous-agents et des skills à model: (leçon sur le coût d'un sous-agent).

Le crochet choix-skills, sur UserPromptSubmit, signale à chaque message les trois skills dont la description recoupe la demande, sans choisir à la place de Claude. La skill sync-memoire verse en fin de lot les faits durables dans la mémoire, une note par sujet.

Compaction à 600 000 jetons, puis reprise

autoCompactWindow prend un entier de 100000 à 1000000 dans settings.json ; CLAUDE_CODE_AUTO_COMPACT_WINDOW l'emporte si elle est posée (leçon sur le seuil d'auto-compactage). Extrait du fragment du kit (l'installateur remplace __HOOKS_DIR__) :

{
  "autoCompactWindow": 600000,
  "model": "opus[1m]",
  "fallbackModel": ["sonnet"],
  "hooks": {
    "PreCompact": [
      {
        "matcher": "auto|manual",
        "hooks": [
          { "type": "command", "command": "node \"__HOOKS_DIR__/avant-compaction.mjs\"" }
        ]
      }
    ],
    "SessionStart": [
      {
        "matcher": "compact",
        "hooks": [
          { "type": "command", "command": "node \"__HOOKS_DIR__/apres-compaction.mjs\"" }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Agent|Task",
        "hooks": [
          { "type": "command", "command": "node \"__HOOKS_DIR__/garde-modele.mjs\"" }
        ]
      }
    ]
  }
}

Avant chaque compaction, PreCompact écrit une note de reprise et demande au résumé deux sections, note de reprise et faits durables ; PostCompact verse ce résumé dans memoire/. Ensuite, SessionStart fait lancer sync-memoire, puis reprendre à l'étape suivante. Prouvé sur une compaction manuelle réelle, pas encore automatique.

Installer et vérifier

En plugin : claude --plugin-dir dans Claude Code, téléversement dans Cowork, où le kit n'est pas encore essayé. Sinon node installer.mjs installe pour Claude Code seul. Les essais (Windows seulement) se lancent ainsi :

node tests/essais.mjs
TOUS LES ESSAIS PASSENT (116 vérifications)

Un essai réel les complète : avec claude -p "/releve-brut" --model sonnet, modelUsage ne nomme que claude-sonnet-5-5 sans ligne model:, et que claude-haiku-5-5 avec model: haiku (un lancement par volet).

Un CLAUDE.md prêt à copier

Le zip contient aussi CLAUDE.md (en lien direct : français, anglais, espagnol), une base de cinquante règles de travail numérotées : preuve avant toute affirmation de succès, autonomie bornée, modèles répartis par rôle, reprise après compaction.

L'installateur ne le copie pas : fusionnez-le avec vos instructions personnelles plutôt que de les remplacer, dans ~/.claude/CLAUDE.md ou à la racine d'un projet ; vos règles l'emportent en cas de conflit. Remplissez la section 1, et ne changez une règle qu'après un vrai problème.

Figure 1

Les trois rôles du kit

RôleModèleOutilsCe qu'il rend
CollecteurHaikuRead, Grep, GlobDonnées brutes avec chemin et ligne, « manquant » si absent
ExécutantSonnetRead, Grep, Glob, Edit, Write, BashUne tâche arrêtée, avec la ligne décisive de sa vérification
JugeOpusRead, Grep, GlobUn verdict : CONFORME, NON CONFORME ou NON VÉRIFIABLE
Le tableau donne, pour chaque sous-agent du kit, son modèle, ses outils et ce qu'il rend.
Figure 2

Compaction puis reprise

01
PreCompact
Le crochet écrit .claude/etat-reprise.md : objectif, fichiers modifiés, date.
02
Compaction
Claude Code résume la conversation, sans que le crochet puisse la bloquer.
03
SessionStart compact
Le crochet réinjecte l'état et la consigne de reprendre à l'étape suivante.
04
Reprise
Le travail continue ; /goal le poursuit d'un tour à l'autre jusqu'à la condition d'achèvement.
La figure suit un état écrit avant la compaction, réinjecté après, puis la poursuite du travail.
Figure 3

L'essai de bascule par une skill

SkillModèle demandé à la sessionModèle nommé par modelUsage
Sans ligne model:sonnetclaude-sonnet-5-5 seul
model: haikusonnetclaude-haiku-5-5 seul
Un lancement par ligne, même projet jetable, Claude Code 2.1.325, le 2026-11-16 : le modèle nommé par modelUsage change avec le champ model: seul.
Calibrez vous-même

Une équipe installe le kit au niveau utilisateur avec node installer.mjs, puis lance node tests/essais.mjs, dont la dernière ligne est TOUS LES ESSAIS PASSENT (116 vérifications). Elle travaille ensuite sur un projet avec autoCompactWindow à 600000. La session atteint une compaction automatique, le fichier .claude/etat-reprise.md apparaît dans le projet avec l'objectif et la liste des fichiers modifiés, et la session termine la tâche demandée.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Ce qu’il faut retenir
  • Le petit modèle collecte sans juger, le moyen exécute une consigne arrêtée, le grand juge en aveugle sur le livrable et les critères.
  • Un modèle de recours se justifie par un échec constaté et plafonné, alors que fallbackModel ne couvre que l'indisponibilité du modèle principal.
  • Le frontmatter d'une skill, la définition d'un sous-agent et l'alias opusplan changent le modèle selon la tâche, sans geste de votre part ; un essai à deux volets montre l'effet du champ model: d'une skill (Sonnet seul sans lui, Haiku seul avec), sur une seule skill.
  • Un crochet peut refuser un lancement ou ajouter du contexte, il ne change pas le modèle de la session, et basculer cette session fait perdre le cache de prompt.
  • La reprise après compaction repose sur un état écrit avant, réinjecté après, et sur /goal pour durer d'un tour à l'autre ; le kit n'est pas prouvé sur une compaction réelle à 600 000 jetons.
À faire maintenant

Téléchargez le kit, décompressez-le dans un dossier jetable, placez-vous dans le dossier qui contient installer.mjs, lancez node installer.mjs --essai pour lire le plan sans rien écrire, puis node tests/essais.mjs et vérifiez que la dernière ligne annonce 67 vérifications passées.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.