Inicio / Varios agentes y verificación adversa
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.
Los tres roles del kit
| Rol | Modelo | Herramientas | Lo que devuelve |
|---|---|---|---|
| Recolector | Haiku | Read, Grep, Glob | Datos en bruto con ruta y línea, «manquant» si falta |
| Ejecutor | Sonnet | Read, Grep, Glob, Edit, Write, Bash | Una tarea decidida, con la línea decisiva de su verificación |
| Juez | Opus | Read, Grep, Glob | Un veredicto: CONFORME, NON CONFORME o NON VÉRIFIABLE |
Compactación y reanudación
La prueba de cambio de modelo por una skill
| Skill | Modelo pedido a la sesión | Modelo nombrado por modelUsage |
|---|---|---|
| Sin línea model: | sonnet | solo claude-sonnet-5-5 |
| model: haiku | sonnet | solo claude-haiku-5-5 |
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 esto establece: Establece que las 67 verificaciones del kit se superaron, que hubo una compactación automática en este proyecto, que el estado de reanudación se escribió con el objetivo y los archivos modificados, y que la tarea pedida terminó.
Lo que esto no establece: No establece que el estado se reinyectara tras la compactación, ni que la reanudación se hiciera en el paso correcto gracias a él, ni que el kit funcione en otros proyectos u otras compactaciones: la situación describe una sola compactación y no dice nada de la reinyección.
Los tres calibrados falsos más frecuentes
- Demasiado amplio El kit está probado para cualquier compactación a 600000 tokens, en cualquier proyecto.
- Demasiado estrecho Solo cuentan las 67 verificaciones, y el archivo de estado escrito no prueba nada sobre el funcionamiento del hook.
- Fuera de tema Que se escriba el archivo de estado confirma que cada agente del kit corre en el modelo de su rol.
- 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.
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.
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.
- Registro de cambios de Claude Code (autoCompactWindow, /goal, hooks de compactación, model: en la cabecera de skills y subagentes, opusplan, CLAUDE_CODE_SUBAGENT_MODEL) consultada el 2026-11-16
- Claude Code, configuración de modelos (opusplan) consultada el 2026-11-16
- Claude Code, referencia de hooks consultada el 2026-11-16
- Claude Code, subagentes consultada el 2026-11-16
- Claude Code, caché de prompt (cambio de modelo) consultada el 2026-11-16