Inicio / Contexto y coste

Un subagente cuesta antes de haber trabajado

Un subagente cuesta antes de haber trabajado, porque su conversación ya contiene elementos que tú no escribiste y que cada lanzamiento vuelve a cargar. Sin campo tools hereda todas las herramientas, y sin modelo nombrado funciona con el mismo modelo que tú. Lista sus herramientas y nombra su modelo según el papel.

Un subagente es una conversación separada que Claude Code abre para una tarea. Antes de su primera instrucción, esa conversación ya contiene elementos que tú no escribiste, y cada lanzamiento los vuelve a cargar. El coste de un subagente se compone por tanto de ese arranque y del trabajo pedido.

Qué contiene un subagente al empezar

La documentación de los subagentes enumera, entre otras cosas, lo que recibe: su propio prompt de sistema con datos del entorno, todos los niveles de archivos CLAUDE.md que carga la conversación principal, el contenido íntegro de las skills nombradas en su campo skills, los servidores MCP de su campo mcpServers, y el comienzo de su archivo de memoria si la memoria está activada. Con las herramientas, la regla es la inversa de lo que se supone: si se omite el campo tools, el subagente hereda todas las herramientas disponibles. Cuantos más elementos al empezar, más pesa la primera llamada.

Un agente personalizado con herramientas listadas

Un archivo colocado en .claude/agents/ define un agente que Claude puede lanzar por su nombre. Este conserva solo lo que exige su tarea:

---
name: lector
description: Lee archivos e informa de lo que contienen, sin modificar nada.
tools: Read, Grep, Glob
model: haiku
---
Lees los archivos pedidos e informas de los hechos encontrados, con el nombre del archivo.
No juzgas y no modificas nada.

Las tres herramientas listadas son las únicas que este agente puede usar, y model: haiku le da un modelo pequeño. La documentación precisa que Claude Code vigila estas carpetas y toma en cuenta un archivo añadido o modificado en pocos segundos; tras crear el primerísimo archivo de una carpeta agents, hace falta reiniciar la sesión.

Nombrar el modelo según el papel

Sin modelo nombrado, la documentación da este orden: el parámetro de la llamada, luego el campo model de la definición, luego la variable CLAUDE_CODE_SUBAGENT_MODEL, luego el modelo de la conversación principal. Un subagente que no ha recibido nada más funciona por tanto con el mismo modelo que tú, sin que nada lo señale al lanzarlo; el comando /tasks muestra el modelo en la fila del subagente. Una recogida mecánica (leer, listar, extraer) puede confiarse a un modelo pequeño; la redacción y el análisis a un modelo mediano; el juez, que debe refutar, al más capaz. El nivel de esfuerzo se ajusta del mismo modo: la herramienta Agent acepta un parámetro effort para un lanzamiento concreto, y la definición de un agente puede fijar el suyo.

Medir antes de concluir

El peso real de cada elemento se lee en tu propio equipo, no en un promedio. La lección sobre la factura muestra dónde leer el consumo por partida; aplícala a un subagente por defecto y luego al mismo trabajo confiado al agente restringido.