Los subagentes de Claude Code ahora consumen menos de tu límite de uso
Los subagentes de Claude Code ahora consumen menos de tu límite de uso. Anthropic cambió la línea de estado de los subagentes en segundo plano: en lugar de releer toda la conversación, ahora es Haiku 5.5 quien la genera a partir de notas breves. Cada actualización cuesta alrededor de un 99 % menos, y las sesiones con subagentes en segundo plano consumieron cerca del 5 % menos del límite. Actualiza a la v2.1.316 o posterior para obtenerlo.
Esa es toda la historia en cuatro frases. El resto de esta entrada cubre quién recibe el cambio, qué significan los dos porcentajes, qué sigue sin saberse y qué ajustes reducen aún más el consumo de los subagentes.
Qué cambió en los subagentes de Claude Code
Un subagente en segundo plano es un asistente que se ejecuta en paralelo a tu sesión principal mientras tú sigues trabajando. En la terminal muestra una breve línea de estado para que veas qué está haciendo, y esa línea se actualiza cada 30 segundos.
Anthropic anunció el cambio en X el 5 de noviembre de 2026:
- Antes: cada actualización de 30 segundos releía toda la conversación del subagente.
- Ahora: Haiku 5.5 redacta la actualización a partir de notas breves.
- Sin cambios: el subagente conserva su propio modelo. Si se ejecuta en Opus 5.5 o Sonnet 5.5, sigue haciéndolo. Solo la línea de estado pasó a Haiku 5.5.
No necesitas cambiar ningún ajuste ni sacrificar calidad en el trabajo en sí. El resultado del subagente proviene del mismo modelo que antes.
Por qué la línea de estado de un subagente era costosa
Una línea de estado era costosa porque un resumen de una sola línea pagaba la lectura completa de una conversación larga. La salida era minúscula, la entrada no, y la tarea se repetía cada 30 segundos durante todo el tiempo que el subagente estuviera en ejecución.
La aritmética muestra lo rápido que se acumula. A una actualización cada 30 segundos, un subagente que corre durante una hora produce 120 actualizaciones. Tres corriendo durante una hora producen 360.
La longitud de la conversación también importa. La documentación de costos de Claude Code dice que los costos en tokens escalan con el tamaño del contexto, y la conversación de un subagente crece a medida que lee archivos y ejecuta herramientas. Así que el diseño antiguo probablemente cobraba más cuando un subagente de larga duración tenía más contexto. Esa es nuestra lectura de la documentación, ya que Anthropic no ha publicado una curva de costos para ello.
No confundas esto con la línea de estado personalizada que configuras con /statusline. La documentación de la línea de estado dice que esta se ejecuta localmente y no consume tokens de la API. El cambio que aquí se trata cubre la línea de estado que Claude Code genera para cada subagente en ejecución.
Las cifras: 99 % por actualización, cerca del 5 % por sesión
Las dos cifras miden cosas distintas, y solo una de ellas describe tu límite.
| Cifra | Qué mide | Qué no es |
|---|---|---|
| Alrededor de un 99 % menos | El costo de una actualización de estado | Un ahorro en tu factura o en tu límite |
| Alrededor de un 5 % menos | Límite consumido por las sesiones con subagentes en segundo plano | Un ahorro en las sesiones sin ellos |
| Alrededor de un 6 % más | Prompts que obtienes con el mismo límite, según Anthropic | Un aumento del propio límite |
Si solo vas a recordar una cifra, que sea el 5 %. Un recorte del 99 % en algo que era una parte pequeña de la sesión te da un ahorro pequeño en la sesión. Los subagentes siguen haciendo su trabajo real con su propio modelo, y ese trabajo es donde se va la mayor parte del uso.
Anthropic no dijo cuánto del límite consumían antes las actualizaciones de estado. Las dos cifras juntas sugieren aproximadamente una vigésima parte de esas sesiones, pero es una inferencia a partir de números redondeados, no una cifra publicada.
Tu ahorro propio también variará. Cerca del 5 % es lo que Anthropic reporta para las sesiones con subagentes en segundo plano. No publicó un rango, y una sesión con un solo subagente breve tiene menos que ganar que una con varios largos.
Quién recibe el menor consumo de los subagentes
Anthropic dice que el cambio ya está disponible para la mayoría de los planes individuales y para todos los planes de organización, solo en la CLI.
| Dónde usas Claude Code | Estado |
|---|---|
| Pro, Max, Ultra | Disponible para la mayoría de los usuarios, no para todos |
| Team, Enterprise | Disponible para todos |
| CLI | Incluido, con v2.1.316 o posterior |
| App de escritorio | Nada que cambiar: no escribe esta línea de estado |
| Clave de API, Bedrock, Vertex, Foundry | No se ha especificado |
El detalle de la app de escritorio proviene de una respuesta en el mismo hilo de Lydia Hallie, de Anthropic, quien dijo que la app de escritorio no escribe esta línea de estado de los subagentes, así que allí no había nada que cambiar.
Dos lagunas que conviene conocer:
- "La mayoría" no tiene una prueba pública. Ni el hilo ni la documentación mencionan una flag ni un indicador que muestre si tu cuenta Pro, Max o Ultra lo tiene. Tener la versión correcta es necesario, pero no demuestra que el cambio esté activo para ti.
- Los usuarios de pago por token aún no tienen respuesta. Anthropic enmarcó esto en los límites de los planes y no abordó las configuraciones con clave de API o proveedores de nube. El changelog de la 2.1.318 sí cambia los resúmenes de progreso de los subagentes en Bedrock, Vertex, Foundry o con la telemetría desactivada: con una caché de prompts fría, puede haber que esperar hasta 5 minutos la respuesta pendiente del subagente. Eso demuestra que esas configuraciones reciben su propio tratamiento, no que obtengan este ahorro.
Las entradas del changelog de la 2.1.316 que leímos tampoco mencionan la línea de estado, así que el hilo es la única fuente para las cifras y la versión.
Cómo actualizar Claude Code y comprobar tu versión
Tres comandos lo cubren:
claude --version # needs to show 2.1.316 or later
claude update # installs a newer version if one exists
claude --version # confirm
claude update también funciona en instalaciones por gestor de paquetes, donde actualiza a través de ese gestor. La versión más nueva listada en el changelog el 5 de noviembre era la 2.1.318.
Para ver qué consumen los subagentes, ejecuta /usage dentro de una sesión. En los planes Pro, Max, Ultra, Team y Enterprise, este comando atribuye el uso reciente a skills, subagentes, plugins y servidores MCP en forma de porcentajes. Pulsa d o w para alternar entre 24 horas y 7 días. Las cifras son aproximadas y provienen del historial local de esa máquina, así que toma cualquier comparación entre antes y después como una guía orientativa. Si llevas un control cercano de los límites, nuestra guía sobre los límites de Claude Pro y Max explica cómo funcionan.
Otras formas de gastar menos en subagentes
La corrección de la línea de estado es automática, pero ronda el 5 %. Sobre el resto, la documentación es clara: cada subagente envía sus propias solicitudes, y estas cuentan para el mismo límite que tu conversación principal. Estos ajustes tienen más margen para ayudar.
Elige un modelo más pequeño. Un subagente hereda el modelo de tu sesión, salvo que se indique lo contrario, así que un cambio a Opus también aplica a esos subagentes. Define model: haiku en la definición de un subagente para tareas simples. Nuestra guía sobre Claude Haiku 5.5 en Claude Code cubre esa configuración.
Para establecer un valor predeterminado para todos ellos:
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
}
}
La primera variable por sí sola es solo un valor predeterminado. Una definición de subagente o un modelo que Claude pase explícitamente sigue ganando, y no cambia los subagentes integrados Explore y Plan. La segunda fuerza un único modelo en todos los subagentes.
Baja el nivel de esfuerzo. La versión 2.1.316 añadió CLAUDE_CODE_SUBAGENT_EFFORT, que establece el nivel de esfuerzo de los subagentes cuando nada más indica uno, en lugar de heredar el de la sesión. Aparece en el changelog, pero el 5 de noviembre no estaba en la referencia de variables de entorno, así que verifica los valores aceptados antes de depender de él. Para un solo subagente, define el campo effort documentado en su definición (low, medium, high, xhigh o max, según el modelo).
Ejecuta menos a la vez. El límite predeterminado es de 20 subagentes en ejecución por sesión. Define CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS con un número entero menor si quieres un tope estricto. Ejecuta /tasks para ver qué está en ejecución y qué modelo y nivel de esfuerzo usa cada subagente.
Mantén la tarea bien acotada. La documentación de costos señala que las solicitudes vagas desencadenan escaneos amplios. Un subagente al que se le pide comprobar un solo endpoint lee menos que uno al que se le pide revisar la API. Nuestra guía sobre cómo crear subagentes personalizados de Claude Code recorre el formato completo de definición.
Ejecuta pruebas de API en un subagente en segundo plano con Apidog CLI
Las ejecuciones de pruebas de API son ideales para un subagente en segundo plano: toman tiempo, producen salidas extensas y solo necesitas recuperar los fallos. Apidog CLI permite que el subagente ejecute un escenario de pruebas guardado mientras tu sesión principal sigue programando, y la salida sin procesar se mantiene fuera de tu contexto principal.
Configúralo una sola vez:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick Claude Code when prompted
Luego añade un pequeño subagente en .claude/agents/api-tester.md:
---
name: api-tester
description: Runs Apidog test scenarios and reports only the failures.
tools: Bash, Read
model: haiku
background: true
---
Run the Apidog test scenario you are given. Report which steps failed
and why. Don't paste the full output.
Ahora dale a Claude Code un solo [REDACTED PROMPT]
Use the api-tester subagent to run Apidog test scenario in
project against environment . Keep working on
the checkout refactor. When it finishes, tell me only what failed.
El subagente ejecuta comandos como estos:
bash
apidog test-scenario list --project
apidog test-scenario run --project -e -r cli,json --out-dir apidog-reports
Las solicitudes de permiso de un subagente en segundo plano aparecen en tu sesión principal e indican el nombre del subagente que las realiza. Para ejecuciones largas, la 2.1.318 también pasa un comando de shell a segundo plano después de 3 minutos, de modo que la caché de prompts no expire mientras se ejecuta.
El mismo comando `run` funciona en CI con `-r junit`, como muestra la [guía de CI/CD de Apidog CLI](https://apidog.com/es/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation). Para la configuración general, consulta [Apidog CLI en Claude Code](https://apidog.com/es/blog/apidog-cli-in-claude-code?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation). El plan Free de Apidog cubre hasta 4 usuarios.
## Preguntas frecuentes
**¿Los subagentes de Claude Code ahora cuestan un 99 % menos?** No. El 99 % aplica a cada actualización de estado. Anthropic dice que las sesiones con subagentes en segundo plano consumieron cerca del 5 % menos del límite.
**¿Mi subagente ahora se ejecuta en Haiku 5.5?** No. El subagente conserva su propio modelo. Solo la línea de estado pasó a Haiku 5.5.
**¿Qué versión necesito?** La v2.1.316 o posterior. Ejecuta `claude --version` para comprobarlo y `claude update` para actualizar.
**¿Esto aplica a la app de escritorio de Claude?** No, porque no había nada que cambiar. Lydia Hallie, de Anthropic, dijo que la app de escritorio no escribe esta línea de estado de los subagentes.
**¿Está activo en mi plan Pro?** Probablemente, aunque no con certeza. Anthropic dice que la mayoría de los usuarios Pro, Max y Ultra ya lo tienen, y todos los de Team y Enterprise. Ni el hilo ni la documentación mencionan una forma de comprobarlo en tu cuenta.
**¿Esto ayuda si uso una clave de API o Bedrock?** Anthropic no lo ha dicho. El anuncio habla de límites de uso y no cubre el uso con clave de API, Bedrock o Vertex.
Top comments (0)