Límites de uso de Claude Code: cómo gastar menos tokens

Los límites de uso de Claude Code se miden en los tokens que consumen tus sesiones: todo el texto que Claude lee de tus archivos y de la conversación, y todo el que escribe de vuelta. En los planes Pro, Max y Team ese uso sale de una asignación que se reinicia en una ventana móvil de cinco horas, con un tope semanal encima, y la compartes con tus chats de Claude. En una cuenta de API pagas cada token, y Anthropic no publica un número fijo de mensajes para ningún plan.

El resto de esta guía explica qué cuenta, cómo mide cada plan, cómo ver en qué punto estás y ocho hábitos que hacen rendir mucho más el mismo plan.

Tokens de Claude Code: qué cuenta como uso

Cada vez que envías un mensaje, Claude Code vuelve a enviar toda la conversación: las instrucciones, tu CLAUDE.md, cada mensaje anterior y cada archivo leído. Por eso, como explica la guía de costos de Anthropic, una pregunta de una línea al final de una sesión larga consume uso por la conversación entera.

Además de tus mensajes, esto también suma:

• Archivos y salidas que Claude lee. Logs grandes, hojas de cálculo, PDF e imágenes entran en el contexto y se quedan ahí.
• Razonamiento. El pensamiento extendido se cobra como tokens de salida, y un nivel de esfuerzo más alto implica más.
• Ayudantes. Cada subagente o workflow que Claude inicia envía sus propias solicitudes además de las tuyas.
• Trabajo programado. Un /loop o una tarea programada se ejecuta en su intervalo incluso mientras no estás, reenviando el contexto cada vez.
• Pequeñas solicitudes de fondo. Funciones como los resúmenes de conversación para retomar sesiones cuestan un poco incluso en reposo, que la documentación sitúa normalmente por debajo de 0,04 USD por sesión.

Cómo funcionan los límites de Claude Code en cada plan

La página de precios de Anthropic dice que todos los planes tienen límites que se reinician en una ventana móvil de cinco horas, que los planes de pago añaden límites semanales y que tu actividad en la web, el escritorio, el móvil y Claude Code sale de la misma bolsa.

Cómo ver tu uso

En los planes de pago, el desglose de /usage atribuye el uso reciente a skills, subagentes, plugins y servidores MCP concretos, y señala comportamientos como contexto largo o fallos de caché cuando causan una décima parte de tu uso reciente. Antes de que se agote una ventana, Claude Code también puede avisarte con una línea como You've used 85% of your session limit · resets 3:45pm.

Por qué llegas al límite antes de lo esperado

• Una sola sesión larga para todo. Cada mensaje lleva todo el historial, así que tareas sin relación en la misma sesión se siguen pagando entre sí.
• Volver después de una pausa. Con suscripción, la caché de prompts dura una hora, y baja a cinco minutos cuando usas créditos de uso, así que el primer mensaje tras una pausa larga vuelve a procesar todo el contexto sin el descuento de caché.
• El modelo más grande con esfuerzo alto para trabajos pequeños. Renombrar archivos no necesita al modelo más capaz pensando a fondo.
• Muchos ayudantes a la vez. Los subagentes y workflows multiplican las solicitudes, y la documentación de Anthropic dice que los equipos de agentes usan unas 7 veces más tokens que una sesión normal cuando los compañeros trabajan en plan mode.
• Loops y tareas programadas encendidos. Siguen ejecutándose mientras la sesión está inactiva.
• Mucho chat el mismo día. Tus chats de Claude salen de la misma bolsa.
• Ráfagas grandes. El uso cuenta a la vez contra la asignación de sesión y la semanal, así que una ráfaga intensa puede agotar el límite semanal antes de que se reinicie la ventana de cinco horas.

Qué pasa cuando llegas a un límite

Los mensajes de límite están en la referencia de errores de Anthropic, y cada uno indica su hora de reinicio. En una sesión interactiva con suscripción, Claude Code puede esperar y continuar la tarea por su cuenta tras el reinicio, siempre que dejes la sesión abierta.

También tienes estas opciones:

• /rate-limit-options muestra formas de seguir, incluida la de esperar y continuar automáticamente.
• /usage-credits activa los créditos de uso, que te permiten seguir más allá del límite de tu plan a tarifas estándar de API; en Pro y Max puedes fijar un límite de gasto mensual en Settings > Usage.
• /upgrade abre la página para pasar a un plan superior con límites base más altos.
• Una cuenta de Claude Console con créditos de API, para un sprint intensivo facturado por token.

8 formas de gastar menos tokens

La elección de modelo es la palanca más fácil de ver en números: en la API, el precio de salida varía en un factor de 100 entre el modelo actual más pequeño y el más grande.

1. Limpia entre tareas. /clear empieza una conversación nueva y no cuesta nada, así el contexto viejo deja de viajar en cada mensaje. Ejecuta /rename antes si quieres volver a ella con /resume.
2. Compacta en pausas naturales, con un foco. /compact keep the decisions and the list of files we changed reduce el historial conservando lo importante. Hazlo entre tareas y no a mitad de una, y usa "Summarize from here" del menú de rebobinado para comprimir solo una parte de la sesión.
3. Ajusta el modelo al trabajo. Opus 5.5 es el modelo por defecto en los planes de pago; cambia con /model a Sonnet para el trabajo diario y a Haiku para tareas simples y mecánicas.
4. Baja el esfuerzo en trabajo sencillo. /effort low va bien para renombrar, dar formato y ediciones rápidas, y Opus 5.5 ya usa medium por defecto. Para una sola pregunta difícil, escribe ultrathink en ese prompt en lugar de subir el esfuerzo de toda la sesión.
5. Sé específico y señala archivos. "Arregla la tabla de precios en @index.html" lee un archivo; "mejora el sitio" hace que Claude revise todo.
6. Mantén CLAUDE.md ligero. Se carga en cada sesión, así que déjalo por debajo de 200 líneas y pasa los procedimientos paso a paso a skills, que solo se cargan cuando se usan. La guía de CLAUDE.md muestra qué va en cada sitio, y cómo crear una skill de Claude cubre el resto.
7. Apaga lo que no usas. Desactiva en /mcp los servidores MCP inactivos, pide resúmenes en lugar de volcados completos de logs y pasa el trabajo pesado de logs a un subagente para que solo vuelva su resumen.
8. Planifica los cambios grandes y frena a tiempo. Plan mode evita retrabajo caro, Esc detiene enseguida un giro equivocado y, tras dos correcciones fallidas, un /clear con un prompt mejor gana a un tercer intento.

Cuando una tarea larga tiene que seguir mañana, una nota de traspaso te deja empezar de cero sin perder el hilo:

Escribe una nota de traspaso breve en handoff.md: en qué estábamos trabajando, qué está terminado, qué falta, los archivos implicados y las decisiones que tomé. Que no pase de 20 líneas.

Luego ejecuta /clear y empieza la siguiente sesión con "Lee @handoff.md y continúa desde ahí". La chuleta de Claude Code reúne en una página todos los comandos mencionados aquí.

Qué hacer ahora

Abre /usage en tu próxima sesión y mira el desglose antes de cambiar nada, para saber si tu mayor gasto es el contexto largo, los ayudantes o un modelo pesado. Luego elige dos hábitos de la lista, como limpiar entre tareas y bajar el esfuerzo en el trabajo rutinario, y úsalos durante una semana. El tutorial para principiantes integra estos hábitos en un primer proyecto, y el curso de Claude Code tiene lecciones sobre cómo escribir prompts sin perder tiempo y cómo darle a Claude el contexto correcto.