Límites de Claude Code en 2026: 8 reglas para evitar agotar los tokens

Documentación de referencia de Ailoot: ailoot.ai/docs/.

¿Cómo funcionan los límites de Claude Code en 2026 y por qué los alcanzas?#

A fecha del 20 de mayo de 2026, los planes de pago de Claude Code funcionan así:

Cifras de la página oficial de Anthropic. Además de la ventana de 5 horas, también hay un límite semanal, que empieza a afectar a los usuarios intensivos hacia el viernes.

¿Qué fue la duplicación del 6 de mayo?

En la conferencia Code with Claude SF, el 6 de mayo de 2026, Anthropic anunció un acuerdo con SpaceX Colossus 1: 220,000 tarjetas gráficas NVIDIA, 300 MW de capacidad, en línea en un mes. De inmediato:

• Se duplicaron los límites de 5 horas para todos los planes de pago.
• Se eliminó la restricción de las horas punta diarias, que antes reducía las cuotas durante las horas de mayor demanda.
• Para la API: el máximo de tokens de entrada por minuto para Opus subió de 30K a 500K (+1500 %), y el máximo de salida pasó de 8K a 80K.

Hay otra promoción temporal vigente del 13 de mayo al 13 de julio: +50 % en los límites semanales para Pro / Max / Team. Después del 13 de julio, las cuotas semanales volverán a sus niveles anteriores.

¿Cuánto usa realmente quien programa con IA?

Anthropic ofrece cifras de referencia en su documentación oficial:

• Los desarrolladores gastan 13 $ al día en promedio, 150-250 $ al mes.
• El 90 % de los usuarios se mantiene por debajo de 30 $ al día.
• Los equipos de agentes en Plan Mode consumen unos 7 veces más tokens que una sesión estándar.

El tamaño de la ventana de contexto depende del modelo. Según la documentación de Anthropic, a fecha de septiembre de 2026, Opus 4.7 y versiones posteriores, Sonnet 5 y los modelos Fable tienen una ventana de 1M tokens en cualquier plan, incluido Pro, y la compactación automática (auto-compact) se activa de forma predeterminada en torno a 967K. Opus 4.6 y Sonnet 4.6 sin contexto extendido tienen una ventana de 200K, y la compactación se activa al llegar al límite de 200K. Puedes establecer tu propio umbral con el comando /autocompact, por ejemplo, /autocompact 500k. Cuando metes medio día de trabajo en un solo chat, el contexto se infla, Claude pierde el hilo, empieza a volver a leer los mismos archivos y los tokens se consumen entre 1,5 y 2 veces más rápido.

Según la experiencia descrita por el autor, la suscripción de 200 $ basta gracias a las 8 reglas que se explican a continuación. Sin ellas, incluso Max 20x se agota a la hora del almuerzo.

Regla 1. ¿Por qué «una tarea, una conversación» ahorra más tokens?#

La regla no consiste en «abrir 5 chats en paralelo», sino específicamente en «no rebuscar en el chat anterior para usarlo en la siguiente tarea».

En el enfoque descrito, funciona así. Con cada mensaje, Claude ve no solo la solicitud nueva, sino también toda la conversación anterior. Si por la mañana hablaste de una página de destino, luego pasaste a una campaña de correo electrónico y después le pediste que corrigiera una instrucción del taller, todo el historial queda incluido en el contexto al hacer la tercera solicitud. Se gastan tokens en «recordar la página de destino», aunque tú ya te hayas olvidado de ella.

¿Por qué funciona «despejar la cabeza»?

Cierra el chat en cuanto termines la tarea. Ni siquiera se trata de los tokens: es una forma de liberar la atención.

Si la tarea está realmente terminada, no conserves el chat «por si vuelvo a necesitarlo». Abre uno nuevo. Puedes encontrar el anterior con claude --resume o /resume usando cualquier indicador (nombre de la rama, ID de PR, etiqueta).

¿Qué debes hacer si una tarea dura dos días?

Si de verdad hay que continuar la tarea, no dejes el chat «en el aire». Antes de cerrarlo, pídele a Claude que redacte un prompt para un chat paralelo (consulta la Regla 7). Así, 50K tokens de historial se comprimen en un prompt de 500 tokens, y mañana el chat nuevo retoma el contexto sin tener que reescribirlo todo.

Regla 2: Mantén CLAUDE.md en 200 líneas, no en 500#

CLAUDE.md es el primer archivo que lee Claude al iniciar una sesión nueva. Esta sección se centra específicamente en ahorrar tokens.

¿Cuántas líneas son normales?

¿Por qué un CLAUDE.md largo vuelve más tonto al agente?

La explicación es sencilla: /init describe el repositorio «de vuelta al modelo» y añade al contexto información que el modelo ya conoce o puede descubrir con un vistazo a la estructura. Esta duplicación consume tokens y dispersa la atención.

La regla de densidad: cada palabra cambia el comportamiento

Si puedo quitar una línea de CLAUDE.md y el comportamiento de Claude no cambia, esa línea es innecesaria. Úsalo como prueba:

1. Abre CLAUDE.md y revisa cada párrafo.
2. Pregúntate: «Si quito esto, ¿Claude empezará a cometer errores?»
3. Si no, bórralo o muévelo a un Skill.

Todas las reglas que solo se aplican en situaciones específicas van en Skills (.claude/skills/<name>/SKILL.md). CLAUDE.md es solo para lo que se necesita siempre.

Regla 3. ¿Por qué guardar el plan de Claude Code en un archivo aparte?#

Plan Mode es un modo de Claude Code que se activa con Shift+Tab. En él, Claude explora el código, lee archivos y pregunta antes de implementar. En el flujo siguiente, separa las ediciones: revisa el plan propuesto y guárdalo manualmente en plans/, o sal expresamente de Plan Mode y autoriza esa escritura antes de abrir otro chat.

¿Por qué un plan guardado en un archivo es mejor que uno en la cabeza de Claude?

Tengo una carpeta plans/ en cada proyecto. Cuando empiezo una tarea:

1. Le pido a Claude en Plan Mode que investigue y proponga un enfoque.
2. Reviso el plan y guardo yo su texto en plans/YYYY-MM-DD-task-name.md; también puedo salir de Plan Mode y autorizar a Claude a escribirlo. Verifico su contenido antes de cerrar el chat.
3. Cierro el chat.
4. En un chat nuevo digo: «lee plans/YYYY-MM-DD-...md e implementa la fase 1».

Lo que gano:

• El plan queda fijado: Claude no «olvida» lo que decidimos hace una hora.
• Puedo editar el plan a mano: veo 5 pasos, entiendo que el paso 3 no hace falta, lo borro y sigo.
• El plan sobrevive a un reinicio: vuelvo mañana, abro el archivo y continúo.
• Puedo asignárselo a agentes en secuencia: un chat redacta el plan, otro lo implementa y un tercero lo revisa.

Plan Mode no rompe la caché

Un detalle importante: Plan Mode invalida solo la caché de la conversación (los mensajes), mientras que el prompt del sistema y el contexto del proyecto (CLAUDE.md) permanecen calientes. Eso significa que cambiar a Plan Mode y volver cuesta casi nada en tokens, a diferencia de cambiar de modelo con /model, lo que rompe la caché del 90 % del precio de entrada y obliga a recalcular todo el prefijo.

La ingeniería del contexto también consiste en guardar el plan en un lugar duradero, no en un chat que desaparecerá en 5 horas.

Regla 4: Las Skills se cargan cuando se activan, no al inicio de la sesión#

Las Skills utilizan una carga en tres niveles:

1. Los metadatos siempre: al inicio de la sesión, Claude solo ve el name y la description de cada Skill. Presupuesto: ~100 tokens por Skill.
2. Instrucciones al activarse: cuando el usuario dice algo pertinente, Claude carga el contenido de SKILL.md. Presupuesto: hasta 5000 tokens.
3. Recursos a petición: los archivos incluidos (ejemplos, plantillas) se incorporan solo cuando el propio modelo los necesita.

¿Cómo cambia esto la economía de tokens?

En el ejemplo descrito, las reglas para redactar instrucciones educativas, las normas de correo y las reglas de revisión de código estaban antes en CLAUDE.md. El archivo creció hasta 500 líneas, y al inicio de cada sesión pagaba por las 500 líneas, incluso si la conversación era sobre una página de destino.

En este ejemplo, CLAUDE.md contiene 200 líneas de navegación y principios básicos. Los 4 conjuntos de reglas están en Skills:

.claude/skills/
├── write-tutorial/SKILL.md         # trigger: “write a guide”
├── deploy-checklist/SKILL.md       # trigger: “check before publishing”
├── send-broadcast/SKILL.md         # trigger: “send a mailing”
└── debug-payment-webhook/SKILL.md  # trigger: “check the payment”

Claude solo ve los encabezados al inicio: 400 tokens. Cuando digo «redacta una guía», carga el SKILL.md correspondiente y lo sigue. Cuando digo «envía un correo», carga otro distinto.

Una cita de las reglas para redactar Skills en la documentación oficial de Anthropic:

Si una Skill te parece sospechosa, no la instales

Las Skills son instrucciones ejecutables con acceso directo a tus archivos y claves de API. Antes de instalar la colección de otra persona, abro cada SKILL.md y lo leo yo mismo. Si hay bloques bash: con enlaces a URL externas, es una señal de alerta; no la instalo.

Regla 5. ¿Cuándo debes delegar una tarea a un subagente en lugar de dejarla en la sesión principal?#

Según la documentación oficial:

¿Qué tareas se pueden delegar a subagentes?

• Buscar en un código grande. Un subagente lee 30 archivos y devuelve: «la función pertinente está en src/lib/payment/cloudpayments.ts:142». No veo el contenido de 30 archivos en el contexto principal.
• Ejecutar pruebas y analizar registros. Un subagente ejecuta npm test, recoge 200 líneas de salida y devuelve: «han fallado 3 pruebas en X, Y, Z por este motivo».
• Refactorizar varios archivos. Un subagente por archivo, en paralelo.
• Comprobar los enlaces de una guía. Un subagente visita 30 URL mediante WebFetch y devuelve: «5 enlaces responden con 404».

En mayo de 2026, Anthropic anunció oficialmente Multi-Agent Orchestration como función de primera clase. Antes, los subagentes solo podían iniciarse en el código mediante el SDK; ahora se pueden iniciar directamente en Claude Code con comandos de barra.

Cuándo fallan los subagentes

Por eso nunca dejo a los subagentes sin supervisión durante medio día. La regla es: cuanto más delegas en paralelo, más a menudo debes revisar los resultados intermedios. En tareas grandes, activo Plan Mode por separado para cada subagente.

Regla 6. ¿Cómo elegir un modelo de Claude (Opus / Sonnet / Haiku) para cada tarea?#

Precios de la API (por millón de tokens):

Fuente: página oficial de Anthropic. Los precios no se muestran en una suscripción, pero la proporción es la misma. Opus 4.7 tiene una salvedad: en comparación con Opus 4.6, su nuevo tokenizador puede usar hasta +35 % más tokens para el mismo texto. El precio por token no ha subido, pero sí el coste efectivo por solicitud. Si pasas todo por Opus sin pensarlo, agotarás tu límite 5 veces más rápido que si usaras Sonnet o Haiku para la mitad de tus tareas.

Ejemplo de selección de modelo

Cambia de modelo con el comando /model. Pero cambiar de modelo invalida la caché. Si pasas de Sonnet a Opus a mitad de una sesión, la siguiente solicitud recalcula todo el prefijo desde cero al precio completo de entrada (no al precio en caché). Por eso conviene elegir el modelo al inicio, en lugar de cambiar repetidamente.

/effort: un ajuste menos agresivo

En abril de 2026, Anthropic implementó /effort: 5 niveles de profundidad de razonamiento: minimal / low / medium / high / xhigh. Claude Code con Opus 4.7 funciona con xhigh de forma predeterminada.

Lo que hago:

• Para clasificaciones, extracción de datos y resúmenes breves: /effort low. Esto ahorra un 30-70 % en tipos de tareas que no requieren razonamiento profundo.
• Para tareas sencillas de programación: /effort medium.
• Para arquitectura compleja: lo dejo en xhigh.

/effort no cambia el modelo, solo la profundidad de su razonamiento. La caché permanece intacta.

Regla 7: Pasa un prompt a un chat nuevo en lugar de usar /compact#

/compact es un comando oficial de Claude Code que sustituye el historial por un resumen. Si lo ejecutas justo después del último mensaje, mientras la caché está caliente (el TTL de la suscripción es de 1 hora), el resumen queda en caché y se lee al 10 % del precio estándar. Si lo ejecutas después de una hora, la caché está fría y pagas el precio completo.

/compact se puede personalizar:

/compact Focus on code samples and API usage

O puedes especificar el enfoque predeterminado del resumen en CLAUDE.md:

# Compact instructions
When you are using compact, please focus on test output and code changes

Pero normalmente lo hago de otra forma.

Pasar un prompt a un chat paralelo: ejemplo

Pasos:

1. En el chat actual, cuando veo que el contexto ha superado el 50 %, digo: «Escríbeme un prompt para un chat paralelo que continúe el trabajo sin perder el sentido. Incluye: en qué estábamos trabajando, qué se ha hecho ya, qué falta, los archivos y constantes clave».
2. Claude me da un prompt de 300-800 tokens.
3. Cierro el chat actual con /clear o simplemente abro uno nuevo.
4. Pego el prompt y empiezo con un CLAUDE.md y contexto del proyecto calientes, pero con la memoria de conversación limpia.

Lo que gano frente a /compact:

• Control sobre lo que pasa al chat nuevo. /compact resume según su propio criterio; puedo editar el prompt a mano antes de empezar.
• Puedo guardar el prompt en un archivo de plans/ y retomarlo mañana.
• El chat nuevo empieza con una caché de conversación limpia; después trabajas con el precio de entrada en caché.

¿Cuándo es mejor /compact?

• Cuando estás en Plan Mode y no quieres perder el plan actual.
• Cuando la tarea es uniforme y el contexto es coherente (por ejemplo, traducir un documento largo).
• Cuando /compact se ejecuta inmediatamente después de la respuesta de Claude; así el resumen entra en la caché caliente y cuesta el 10 %.

/clear: último recurso

/clear lo borra todo, incluido el contexto del proyecto. Solo lo uso al cambiar a un tema completamente distinto y no querer conservar nada de lo anterior. Después de /clear, la siguiente solicitud paga el precio completo por volver a cargar CLAUDE.md.

Regla 8. ¿Qué invalida la caché de Claude Code y por qué pagas por ello?#

Con una suscripción, el TTL de la caché es de 1 hora (se prolonga cada vez que se accede a ella). En la API, el valor predeterminado es 5 minutos. Esto significa que, si vuelves al trabajo después de 40 minutos, la caché sigue viva y la siguiente solicitud cuesta unos céntimos en tokens de entrada. Después de 1 hora, la caché caduca y pagas el precio completo.

Qué rompe la caché (evita estas acciones a mitad de una tarea)

1. /model: cambiar el modelo durante la sesión. Cada modelo tiene su propia caché. Después de /model opus, la siguiente solicitud recalcula todo el prefijo para Opus desde cero.
2. Activar Plan Mode con el ajuste opusplan. En este modo, Plan Mode = Opus y el modo normal = Sonnet. Cada Shift+Tab equivale a un cambio de modelo y a una caché inválida.
3. Conectar o desconectar un servidor MCP. También incluye la reconexión automática tras un fallo temporal. Si tu servidor MCP es inestable, pagas dos veces.
4. Reglas de denegación con nombres simples (Bash, WebFetch): cambian las definiciones de herramientas en el prompt del sistema.
5. /compact: invalida la capa de conversación (por diseño).
6. Actualizar Claude Code a una versión nueva: una versión nueva implica un prompt del sistema nuevo y una caché nueva.

Qué NO rompe la caché

• Editar archivos del repositorio (se leen cuando se necesitan).
• Editar CLAUDE.md durante la sesión (pero los cambios no se aplican hasta reiniciar; consulta la Regla 2).
• Cambiar el estilo de salida.
• Cambiar el modo de permisos (si no interviene opusplan).
• Invocar Skills o comandos (se añaden a la capa de conversación).
• /recap (un comando nuevo, resumen sin invalidar la caché).
• /rewind (volver a un prefijo que ya está caliente).
• Iniciar un subagente (la caché del padre no se ve afectada).

Cómo aprovechar la caché

• No cambies de /model sin motivo. Elige el modelo al inicio de la tarea.
• No actives 10 servidores MCP «por si acaso». Cada uno se suma al prompt del sistema y rompe la caché al reconectarse.
• No edites CLAUDE.md entre tareas: haz todos los cambios de una vez y luego reinicia.
• Usa /recap en lugar de /compact cuando solo necesites consultar un resumen, no liberar contexto.

¿Qué ocurrió con la propuesta de créditos de automatización del 15 de junio?#

La división propuesta de la suscripción en fondos interactivo y programático se pausó. La actualización de soporte de Anthropic indica que Agent SDK, claude -p y aplicaciones de terceros pueden seguir usando los límites de suscripción. No sumes los créditos de la propuesta abandonada como una segunda factura obligatoria.

Los créditos API mensuales introducidos en octubre para planes Max y Team aptos son una cuota incluida en una organización Console vinculada. No sustituyen los límites interactivos. La guía actual de créditos API distingue el acceso por suscripción del uso con clave e identifica las superficies de inicio no cubiertas.

Antes de presupuestar una tarea programada, registra autenticación, superficie de inicio, modelo y uso real. Un comando claude -p por sí solo no demuestra qué saldo consume. El uso API de pago adicional depende de la configuración de facturación de la organización. Consulta la explicación y calculadora actuales en facturación de automatización de Claude Code.

Un día en la vida de alguien que programa con IA usando Claude Code#

Un día de ejemplo:

1. 9:00. Abro la tarea n.º 1: editar una plantilla de correo electrónico. Abro un chat nuevo, uso Plan Mode y le pido a Claude que investigue. El plan está listo en 3 minutos; cambio a auto-accept y la edición lleva 10 minutos. Cierro el chat.
2. 9:30. Tarea n.º 2: redactar una guía educativa. Abro un chat nuevo y se activa mi Skill para redactar guías. Carga 4000 tokens de metodología. Trabajo con ella y la guía está lista en 40 minutos. Listo.
3. 11:00. Tarea n.º 3: un problema arquitectónico complejo. /model opus, Plan Mode, conversación. Reviso el plan, lo guardo manualmente en plans/2026-05-20-...md —o autorizo la escritura tras salir de Plan Mode—, verifico el archivo y cierro el chat.
4. 12:00. Chat nuevo: «lee plans/2026-05-20-...md e implementa la fase 1». 6 subagentes trabajan en paralelo, uno por archivo. La fase 1 está lista en 45 minutos. Lo cierro.
5. 14:00. Tarea n.º 4: editar una página de destino. /model sonnet. Chat nuevo. El plan y la implementación llevan 30 minutos. Lo cierro.
6. 15:00. Tarea n.º 5: depurar producción. /model opus, Plan Mode; hace falta profundidad. Tras una hora de conversación, le pido que escriba un prompt para un chat paralelo con la causa identificada y la solución propuesta. Lo copio en un chat nuevo y lo implemento en 20 minutos.

Al final del día: 6 tareas, 8 chats cerrados, ni un solo /compact. Se ha usado entre el 40 y el 60 % del límite. Sobra.

El límite se agota con quienes:

• Meten una tarea entera en un chat que ya tiene ocupado el 50 % de su contexto.
• Mantienen CLAUDE.md en 600 líneas porque «quizá algún día sirva».
• Cambian a /model opus para cada edición sencilla.
• Activan 8 servidores MCP por si acaso.
• Nunca usan subagentes y arrastran todo a la conversación principal.

El límite no se agota para quienes crean un segundo cerebro en los archivos del proyecto y trabajan con Claude como con un ingeniero del equipo: le asignan tareas claras, no lo vuelcan todo en una sola conversación y usan distintas herramientas para distintas tareas.

Puedes seguir explorando Ailoot en ailoot.ai.