AI-translated from English; not yet reviewed by a fluent editor.

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

> Un flujo documentado de Claude Code para pasar un cambio limitado de un proceso principal Opus a un subagente Haiku del proyecto, comprobar el modelo y el diff reales e interpretar el uso sin dar por hecho un ahorro.

By BIG CHANGE Editorial

Published: 2026-10-20T10:17:38.691Z
Updated: 2026-10-20T10:17:38.691Z
Canonical: https://bigchange.ai/blog/claude-code-opus-haiku-subagent-coding-guide

![Conceptual charcoal illustration of a reviewer using a laptop trackpad beside a generic two-column code diff with one orange changed section.](https://bigchange.ai/api/media/file/opus-haiku-diff-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

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](https://code.claude.com/docs/en/model-config) 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:

```markdown
---
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](https://code.claude.com/docs/en/sub-agents) 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](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide). 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](https://code.claude.com/docs/en/costs) 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](https://code.claude.com/docs/en/sub-agents) — 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](https://code.claude.com/docs/en/model-config) — 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](https://code.claude.com/docs/en/costs) — `/usage` : campos, estimaciones y facturación de suscripción frente a API. No demuestra un ahorro en esta tarea.
- [Anthropic, configurar permisos](https://code.claude.com/docs/en/permissions) — reglas efectivas de permisos de herramientas que deben examinarse antes de ejecutar un agente que modifica código.

## Sources

- [Crear subagentes personalizados — documentación de Claude Code](https://code.claude.com/docs/en/sub-agents) — Manual principal del producto para archivos de agente, metadatos, prioridad y sustituciones de modelos, lectura de /tasks, herencia de permisos y worktrees. No verifica la tarea sin ejecutar de esta guía ni un ahorro.
- [Configuración de modelos — documentación de Claude Code](https://code.claude.com/docs/en/model-config) — Fuente principal sobre alias e identificadores actuales de Opus y Haiku en la API de Anthropic, correspondencias de otros proveedores, versiones mínimas y restricciones availableModels administradas. El lector debe comprobar la resolución local real.
- [Gestionar costes eficazmente — documentación de Claude Code](https://code.claude.com/docs/en/costs) — Explica los campos de tokens y estimaciones de sesión de /usage, la atribución local del plan, las pantallas desactualizadas, la facturación suscripción/API y Console como autoridad de facturación. No proporciona una factura exacta de un ejecutor concreto ni un ahorro medido de la tarea.
- [Configurar permisos — documentación de Claude Code](https://code.claude.com/docs/en/permissions) — Explica los permisos efectivos de shell y archivos para un ejecutor que cambia código. Una lista de herramientas del subagente no es por sí sola un límite de rutas del sistema de archivos.