Delega una tarea de código de Claude Code de Opus a Haiku y verifica el resultado

Claude Code permite asignar a un subagente del proyecto su propio modelo y herramientas mientras la conversación principal se ocupa de planificar y revisar. Para un cambio autorizado del repositorio, esto permite que un proceso principal Opus encargue a Haiku una implementación limitada. El resultado útil es un cambio de código comprobado y un registro de los modelos que se ejecutaron. Elegir un modelo más barato no demuestra por sí solo un ahorro.

El gran cambio

• Qué cambió: Un archivo de agente del proyecto puede solicitar model: haiku para un ejecutor de código con nombre propio mientras la sesión principal utiliza Opus.
• Por qué importa: El proceso principal puede revisar una tarea más pequeña, pero el desarrollador sigue decidiendo si el diff cumple la comprobación de aceptación original.
• Qué vigilar: Las sustituciones de modelo, las políticas de la organización, los permisos, la revisión y los reintentos pueden cambiar el modelo real y el uso total. Compruébalos antes de afirmar una ventaja de costes.

Empieza por una tarea bajo tu responsabilidad

Necesitas un repositorio Git propio, permiso para modificarlo, acceso de Claude Code a ambas familias de modelos y un cambio autorizado lo bastante pequeño como para evaluarlo mediante su diff. Anota el commit inicial, los archivos o comportamientos incluidos, la orden de aceptación existente y qué significa superar la prueba. Usa una copia de trabajo limpia. La orden debe proceder de tu proyecto; esta guía no puede proporcionar una prueba significativa para un repositorio desconocido.

Comprueba claude --version, tu proveedor y modalidad de facturación, así como las restricciones efectivas de modelos antes de comenzar. En la API de Anthropic, los alias actuales opus y haiku corresponden a Opus 5.5 (claude-opus-5-5) y Haiku 5.5 (claude-haiku-5-5); esa pareja requiere Claude Code v2.1.293 o posterior. Otros proveedores pueden asignar esos mismos alias a generaciones anteriores. La política availableModels de una organización puede bloquear o sustituir una selección. Usa /model en la sesión principal y registra el modelo principal exacto que aparezca. Decide el presupuesto autorizado y examina los controles reales de la cuenta o del proveedor; una instrucción al modelo no garantiza un límite de gasto. La configuración de modelos de Anthropic documenta las correspondencias y restricciones actuales.

1. Define un ejecutor Haiku del proyecto

Crea en el proyecto un archivo con nombre único, como .claude/agents/bounded-code-worker.md, revísalo y después inicia el proceso principal Opus con claude --model opus o selecciona Opus mediante /model. Este ejemplo define un ejecutor, no una tarea de prueba:

---
name: bounded-code-worker
description: Implements one explicitly bounded, authorized repository change and reports the diff and checks for parent review.
model: haiku
tools: Read, Glob, Grep, Edit, Bash
permissionMode: default
---

Añade esta instrucción de sistema en lenguaje natural inmediatamente después del --- de cierre del archivo del agente: Implementa únicamente la tarea y el alcance de archivos que te indique el proceso principal. Antes de editar, examina el código pertinente y la comprobación de aceptación indicada. Si falta la tarea, el permiso o una entrada necesaria, detente e informa de la carencia. Realiza el cambio pertinente más pequeño. Ejecuta la comprobación original cuando tengas permiso; comunica su orden exacta y resultado. Devuelve los archivos modificados, la finalidad del diff, los fallos pendientes y el trabajo que no pudiste verificar. No hagas commits, publiques, despliegues ni amplíes la tarea sin autorización explícita.

La lista tools hace disponibles las herramientas; no limita las lecturas o las órdenes de shell a las rutas indicadas. Antes de delegar, comprueba los permisos efectivos del proyecto y la organización, especialmente el acceso a shell. Mantén el proceso principal en modo Manual/default para este procedimiento: Anthropic documenta que un proceso principal en acceptEdits, auto o bypassPermissions sustituye la configuración permissionMode del ejecutor. Si es el primer archivo de un directorio de agentes recién creado, reinicia Claude Code si el agente no aparece. El manual de subagentes describe estos controles.

La opción isolation: worktree proporciona al ejecutor una copia de trabajo separada. Su punto de partida documentado es la rama predeterminada del repositorio, que puede diferir del commit actual del proceso principal. Comprueba esa revisión inicial frente a la base registrada para la tarea antes de usar o comparar sus cambios. Sigue siendo necesaria una copia limpia y autorizada para ejecutar la comprobación original.

2. Delega, examina y después acepta o rechaza

Dale al proceso principal una instrucción vinculada a la tarea real, con tus límites de archivos y tu orden de comprobación:

Planifica brevemente este cambio autorizado. Delega únicamente la implementación indicada a bounded-code-worker. Conserva los criterios de aceptación originales y la revisión final bajo tu responsabilidad. Cuando termine el ejecutor, muéstrame su diff exacto y el resultado de la comprobación. No aceptes ni amplíes el cambio hasta que los haya revisado.

Mientras se ejecuta, abre /tasks y registra el modelo mostrado en su fila. Esa es la comprobación durante la ejecución; la palabra haiku en un archivo de agente o en una instrucción es solo una petición. Claude Code v2.1.242 o posterior muestra allí el modelo en ejecución. Una tarea en segundo plano terminada permanece en /tasks unos 30 segundos, así que revísala pronto y conserva su transcripción. Si no ves la fila a tiempo, registra la verificación del modelo como incompleta sin deducirlo del archivo.

Lee el diff real, examina cada archivo cambiado y ejecuta personalmente la orden de aceptación original en la copia de trabajo propia. Añade comprobaciones específicas si el cambio lo justifica. Acepta solo si comportamiento, alcance y comprobaciones coinciden con la tarea. Si el ejecutor se detiene antes o devuelve trabajo parcial, revisa lo modificado antes de continuar o reparar. Si usó un worktree separado, revisa esos cambios antes de incorporarlos a la copia principal.

Para otra forma de comprobar un fallo de repositorio con un asistente de IA, consulta nuestra guía de reparación y verificación con AI Goal. Ese flujo no configura la delegación de Opus a Haiku utilizada aquí.

Si /tasks muestra otro modelo o un aviso de sustitución, comprueba el argumento de modelo de la invocación, los metadatos del agente, CLAUDE_CODE_SUBAGENT_MODEL y la lista de modelos administrada. En Claude Code actual, el modelo de la invocación tiene prioridad sobre los metadatos, después el valor del entorno y después el modelo principal; antes de v2.1.251, la configuración del entorno tenía prioridad. CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 (v2.1.257+) puede sustituir la definición, y el hook agent.spawn de un mod instalado puede sustituir el modelo de la invocación. Corrige el origen real de la sustitución o detén la ejecución. No presentes un resultado de otro modelo como si fuera Haiku.

3. Registra el uso sin inventar un ahorro

Toma lecturas de /usage antes y después de esta sesión controlada. Registra por modelo los tokens de entrada, salida y caché, el coste estimado mostrado, el proveedor o plan, el diff aceptado, el resultado de la comprobación original y la revisión o reparación necesaria. El bloque Session agrega toda la sesión por modelo; no es una factura precisa de este ejecutor con nombre propio. Los porcentajes de atribución del plan son un historial local aproximado diario o semanal, no una medición de esta tarea. Para una cuenta API, Claude Console es la fuente autorizada de facturación. En una suscripción, la estimación en dólares de la sesión no es una factura adicional. Marca como desactualizada una lectura de uso que muestre el último estado conocido.

Para afirmar que la delegación ahorró dinero en esta tarea, compárala con una ejecución de modelo único autorizada por separado, desde la misma revisión inicial limpia y con la misma tarea y criterios. Cuenta la planificación y revisión del proceso principal, las llamadas del ejecutor, los reintentos y las reparaciones; compara únicamente resultados aceptados. Una pareja de ejecuciones sigue siendo una observación específica de esa tarea. Sin esa referencia, informa de la ruta de modelos verificada y del resultado del código; el ahorro se desconoce. La guía de costes de Anthropic explica la visualización del uso y los límites de facturación.

Este procedimiento se basa en documentación actual, no en una ejecución de Claude Code realizada por BIG CHANGE ni en una tarea medida. No envíes código o secretos que tu organización no haya autorizado para el proveedor configurado. Este flujo utiliza la selección nativa de Opus y Haiku de Claude Code; otro proveedor exigiría una pasarela o un flujo de orquestación especificado por separado y sus propias comprobaciones.

Fuentes y lecturas adicionales

• Anthropic, crear subagentes personalizados — archivos de agente del proyecto, prioridad de modelos, /tasks, permisos y comportamiento de worktrees. Manual actual revisado el 20 de octubre de 2026; documenta la función, no el resultado del ejemplo sin ejecutar de esta guía.
• Anthropic, configuración de modelos — alias actuales, diferencias entre proveedores, versiones necesarias y controles de modelos administrados. Confirma la versión instalada y el proveedor al utilizarlo.
• Anthropic, gestionar costes eficazmente — /usage : campos, estimaciones y facturación de suscripción frente a API. No demuestra un ahorro en esta tarea.
• Anthropic, configurar permisos — reglas efectivas de permisos de herramientas que deben examinarse antes de ejecutar un agente que modifica código.