Ir al contenido
Mastering Claude

El curso175 lecciones

Inicio / Varios agentes y verificación adversa

Varios agentes y verificación adversa9 minAplicación

Orquestar varios modelos en Claude Code, con un kit listo para instalar

Reparte los modelos por rol, pequeño para recopilar, mediano para ejecutar, grande para juzgar a ciegas, y declara esa elección en las skills y los subagentes: ningún hook cambia el modelo de la sesión principal.

En una sesión larga, el coste y la calidad dependen primero de quién hace qué. Un modelo pequeño lee y extrae sin juzgar, uno mediano ejecuta una instrucción ya decidida y el más capaz juzga a ciegas, recibiendo el entregable y los criterios, nunca el razonamiento del autor. Un kit listo para instalar, probado en Windows con Claude Code 2.1.326, aplica este reparto en Claude Code y, como plugin, en Cowork.

Quién hace qué

El recolector corre en Haiku con solo las herramientas Read, Grep y Glob: devuelve datos en bruto y no concluye nada. El ejecutor corre en Sonnet y aplica una instrucción precisa. El juez corre en Opus, en solo lectura, y devuelve un veredicto (véanse la lección sobre la verificación adversarial y la lección sobre el enrutamiento por coste).

El planificador de recurso corre en Fable, en solo lectura: cuando el mismo error vuelve dos veces, devuelve un plan nuevo sin ejecutar nada, dos veces por sesión como máximo (lección sobre limitar un bucle de jueces). fallbackModel, en cambio, solo cubre la indisponibilidad del modelo principal.

Tres formas de cambiar de modelo sin pensarlo

Primera forma: el campo model: (y effort:) en la cabecera de una skill, como model: haiku en la skill releve-brut del kit. Segunda forma: el mismo campo en la definición de un subagente, aquí el juez del kit (descripción abreviada):

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

CLAUDE_CODE_SUBAGENT_MODEL solo fija el valor por defecto: la definición del agente y el modelo pasado en la llamada prevalecen. Tercera forma: el alias opusplan, Opus en modo plan, Sonnet para ejecutar.

Un hook, en cambio, no cambia el modelo de la sesión principal: el del kit rechaza el lanzamiento de un subagente sin modelo explícito y no elige nada. Cambiar de modelo a mitad de sesión también hace perder la caché del prompt: prefiere subagentes y skills con model: (lección sobre el coste de un subagente).

El hook choix-skills, en UserPromptSubmit, señala en cada mensaje las tres skills cuya descripción coincide con la petición, sin elegir en lugar de Claude. La skill sync-memoire vuelca al final del lote los hechos duraderos en la memoria, una nota por tema.

Compactación a 600 000 tokens y reanudación

autoCompactWindow admite un entero de 100000 a 1000000 en settings.json; CLAUDE_CODE_AUTO_COMPACT_WINDOW prevalece si está definida (lección sobre el umbral de autocompactación). Un extracto del fragmento del kit (el instalador sustituye __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\"" }
        ]
      }
    ]
  }
}

Antes de cada compactación, PreCompact escribe una nota de reanudación y pide al resumen dos secciones, nota de reanudación y hechos duraderos; PostCompact guarda ese resumen en memoire/. Después, SessionStart hace lanzar sync-memoire y retomar en el paso siguiente. Está probado en una compactación manual real, aún no en una automática.

Instalar y verificar

Como plugin: claude --plugin-dir en Claude Code, subida del archivo en Cowork, donde el kit aún no se ha probado. Si no, node installer.mjs instala solo para Claude Code. Las pruebas (solo en Windows) se lanzan así:

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

Una prueba real las completa: con claude -p "/releve-brut" --model sonnet, modelUsage nombra solo claude-sonnet-5-5 sin línea model:, y solo claude-haiku-5-5 con model: haiku (un lanzamiento por tiempo).

Un CLAUDE.md listo para copiar

El zip incluye también CLAUDE.md (enlace directo: español, francés, inglés), una base de cincuenta reglas de trabajo numeradas: prueba antes de toda afirmación de éxito, autonomía acotada, modelos repartidos por rol, reanudación tras la compactación.

El instalador no lo copia: fusiónalo con tus instrucciones personales en lugar de sustituirlas, en ~/.claude/CLAUDE.md o en la raíz de un proyecto; tus reglas prevalecen en caso de conflicto. Completa la sección 1 y cambia una regla solo después de un problema real.

Figura 1

Los tres roles del kit

RolModeloHerramientasLo que devuelve
RecolectorHaikuRead, Grep, GlobDatos en bruto con ruta y línea, «manquant» si falta
EjecutorSonnetRead, Grep, Glob, Edit, Write, BashUna tarea decidida, con la línea decisiva de su verificación
JuezOpusRead, Grep, GlobUn veredicto: CONFORME, NON CONFORME o NON VÉRIFIABLE
La tabla da, para cada subagente del kit, su modelo, sus herramientas y lo que devuelve.
Figura 2

Compactación y reanudación

01
PreCompact
El hook escribe .claude/etat-reprise.md: objetivo, archivos modificados, fecha.
02
Compactación
Claude Code resume la conversación y el hook no puede bloquearla.
03
SessionStart compact
El hook reinyecta el estado y la orden de retomar en el paso siguiente.
04
Reanudación
El trabajo continúa; /goal lo prolonga de un turno al siguiente hasta la condición de cumplimiento.
La figura sigue un estado escrito antes de la compactación, reinyectado después, y la continuación del trabajo.
Figura 3

La prueba de cambio de modelo por una skill

SkillModelo pedido a la sesiónModelo nombrado por modelUsage
Sin línea model:sonnetsolo claude-sonnet-5-5
model: haikusonnetsolo claude-haiku-5-5
Un lanzamiento por fila, mismo proyecto desechable, Claude Code 2.1.325, 2026-11-16: el modelo que nombra modelUsage cambia solo con el campo model:.
Calíbralo tú mismo

Un equipo instala el kit para el usuario con node installer.mjs y luego ejecuta node tests/essais.mjs, cuya última línea es TOUS LES ESSAIS PASSENT (116 vérifications). Después trabaja en un proyecto con autoCompactWindow en 600000. La sesión llega a una compactación automática, el archivo .claude/etat-reprise.md aparece en el proyecto con el objetivo y la lista de archivos modificados, y la sesión termina la tarea pedida.

Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.

Lo que hay que recordar
  • El modelo pequeño recopila sin juzgar, el mediano ejecuta una instrucción decidida y el grande juzga a ciegas sobre el entregable y los criterios.
  • Un modelo de recurso se justifica por un fallo comprobado y limitado, mientras que fallbackModel solo cubre la indisponibilidad del modelo principal.
  • El frontmatter de una skill, la definición de un subagente y el alias opusplan cambian el modelo según la tarea, sin que tengas que intervenir; una prueba en dos tiempos muestra el efecto del campo model: de una skill (solo Sonnet sin él, solo Haiku con él), con una sola skill.
  • Un hook puede rechazar un lanzamiento o añadir contexto, pero no cambia el modelo de la sesión, y cambiarlo a mano hace perder la caché del prompt.
  • La reanudación tras la compactación se apoya en un estado escrito antes y reinyectado después, y en /goal para durar de un turno al siguiente; el kit no está probado con una compactación real a 600 000 tokens.
Hazlo ahora

Descarga el kit, descomprímelo en una carpeta desechable, sitúate en la carpeta que contiene installer.mjs, ejecuta node installer.mjs --essai para leer el plan sin escribir nada, luego node tests/essais.mjs y comprueba que la última línea anuncia 67 verificaciones superadas.

Verificar en la fuente

Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.