Consejos para ahorrar tokens en Claude Code y qué pasa al alcanzar el límite

Una de las primeras cosas que notas al empezar a usar Claude Code es lo rápido que consume tokens. ¿Alguna vez has pensado: "Solo edité un archivo... ¿cómo es que ya llegué al límite?"

Este artículo explica por qué Claude Code usa tantos tokens, presenta 10 técnicas prácticas de ahorro y desglosa qué sucede al alcanzar el límite y cómo funcionan los costes adicionales.

1. ¿Por qué Claude Code consume tantos tokens?

A diferencia del chat convencional, Claude Code es un sistema agéntico. Una sola instrucción del usuario desencadena múltiples llamadas internas a la API para completar la tarea.

Razones específicas del alto consumo de tokens

• El prompt del sistema y el historial se envían en cada turno: Cada mensaje reenvía todo el historial de la conversación, por lo que cuanto más larga sea, más rápido se acelera el consumo
• El contenido de los archivos se carga en el contexto: Al editar código, el contenido del archivo se incorpora al contexto. Los archivos más grandes consumen más tokens
• Las llamadas a herramientas se encadenan: Una sola instrucción puede activar internamente pasos de búsqueda, lectura, edición y verificación. Según la documentación de Anthropic, Claude Code envía la conversación completa en cada petición, y cada vez que Claude usa herramientas envía otra petición con esos resultados (Manage costs effectively)
• Los tokens de razonamiento cuentan como salida: El proceso interno de "pensamiento" de Claude Code también consume tokens

El procesamiento de este modelo se realiza en los servidores de Anthropic, así que cambiar tu PC por uno más potente no modifica el consumo de tokens ni el tiempo que la IA dedica a pensar. Lo que sí cambia con el PC es el tiempo de los comandos que se ejecutan en local y si la memoria es suficiente (consulta «Especificaciones de PC necesarias para Claude Code y Codex»).

Para más información sobre las diferencias entre los modos de Claude, consulta nuestro artículo sobre las diferencias entre Claude Chat, Cowork y Code.

2. Límites de uso y precios por plan

Claude Code se usa iniciando sesión con un plan de pago de Claude (Pro, Max, Team o Enterprise) o con una clave de API de la Claude Console. Según la página de precios de Claude, el límite de todos los planes se cuenta en una ventana de sesión que se renueva cada cinco horas, y los planes de pago añaden encima un límite semanal. No hay un número fijo de mensajes: lo que puedes hacer depende de la longitud de tus conversaciones, del modelo que elijas y de las funciones que uses (página de precios de Claude, consultada el 26 de septiembre de 2026).

Fuentes: página de precios de Claude, Centro de ayuda de Anthropic «What is the Pro plan?» y «What is the Max plan?», documentación de Claude Code «Manage costs effectively» (todas consultadas el 26 de septiembre de 2026). Ultra es el plan que pasó a llamarse así el 31 de octubre de 2026 (antes, Max 20x). Según «What is the Ultra plan?» (Centro de ayuda de Anthropic), su límite semanal es 10 veces el de Pro y las cuentas verificadas no tienen límite de 5 horas (consultado el 31 de octubre). La verificación se hace automáticamente a partir del historial de la cuenta y de pagos; si en la página de uso de la configuración no aparece la barra «Current session», tu cuenta está verificada.

Fable, el modelo de gama más alta, funciona aparte. En la tabla comparativa de la página de precios, Pro solo puede usarlo mediante créditos de uso, mientras que Max y Ultra pueden dedicarle hasta el 50 % del límite semanal. En Claude Code, según tu plan, el uso de Fable puede cobrarse a los créditos de uso en lugar de a la cuota del plan; en ese caso, la fila de Fable en /model muestra «Requires usage credits» y Claude Code te pide confirmación antes de cobrar (Model configuration).

Para una comparación detallada de precios, consulta nuestro artículo sobre la comparación de precios entre Claude y ChatGPT.

3. 10 técnicas para ahorrar tokens

Aplicando las siguientes técnicas, puedes reducir significativamente tu consumo de tokens.

Aun así, antes de empezar a recortar conviene medir qué está ocupando el contexto. Mira el desglose con /context, comprueba el consumo real con /usage y obtén el coste por Skill con /skill-doctor. Lo tratamos en detalle en qué se está comiendo el contexto de Claude Code.

Consejo 1: Reinicia el contexto con frecuencia usando /clear

Cuando cambies de tarea, ejecuta /clear para reiniciar la conversación. El historial acumulado hace que se reenvíen tokens innecesarios con cada mensaje.

# Después de terminar el trabajo de autenticación
/clear

# Iniciar la siguiente tarea
"Añadir una función de pago"

Consejo 2: Comprime las conversaciones con /compact

Puedes comprimir una conversación larga en plena sesión. Añade instrucciones personalizadas para conservar solo lo importante.

# Compresión básica
/compact

# Compresión con instrucciones personalizadas
/compact Conservar solo los cambios de código y las especificaciones de la API

Dicho esto, no ganas más cuantas más veces lo pulses. El coste de una compactación depende de si la caché de prompts está caliente, y pulsarlo justo después de una pausa es el caso más caro de todos. Dónde pulsarlo lo tratamos en detalle en cuándo pulsar /compact.

Consejo 3: Indica exactamente qué debe leer

Cuando la petición es vaga, Claude Code busca a lo ancho los archivos que podrían ser relevantes y los lee, y el contexto crece en consecuencia. La documentación de Anthropic lo dice igual: una petición vaga como «mejora esta base de código» provoca un rastreo amplio, mientras que una concreta como «añade validación de entrada a la función login de auth.ts» permite trabajar con un mínimo de lecturas (Manage costs effectively). Si ya sabes qué archivo importa, menciónalo con @ y Claude lo incorpora a la conversación sin tener que buscarlo (Common workflows). Un archivo mencionado con @ entra con todo su contenido, y un directorio muestra la lista de archivos en lugar del contenido, así que menciona solo los archivos que necesitas.

❌ «Mejora esta base de código»
→ Claude busca a lo ancho y lee todo lo que parece relevante (más tokens de entrada)

✅ «Añade validación de entrada a la función login de @src/auth.ts»
→ El trabajo se queda en el archivo que importa

Consejo 4: Cambia de modelo según la tarea

No necesitas un modelo de gama alta para cada tarea. A 26 de septiembre de 2026, el modelo predeterminado de Claude Code es Opus 5.5 en Pro, Max, Team, Enterprise y la API por igual (Model configuration). Por token, en cambio, Sonnet, de gama media, cuesta aproximadamente la mitad que Opus, y el ligero Haiku es aún más barato: a 12 de octubre de 2026, Haiku 5.5 cuesta 40 veces menos que Opus con prompts de hasta 100.000 tokens (ver la tabla de la sección 5). La documentación de Anthropic indica igualmente que Sonnet resuelve bien la mayoría de las tareas de programación y cuesta menos que Opus, recomienda reservar Opus para decisiones de arquitectura complejas y razonamientos de varios pasos, y sugiere especificar Haiku para tareas sencillas de subagentes (Manage costs effectively). También en los planes de suscripción, lo que puedes hacer depende del modelo que elijas. Aunque las proporciones cambien con una nueva versión, el criterio sigue siendo el mismo: elige el nivel según la dificultad de la tarea.

# Usar Sonnet para la programación diaria
/model sonnet

# Usar Opus para decisiones de diseño o refactorización compleja
/model opus

Consejo 5: Pide respuestas más cortas

Las respuestas más largas de la IA implican más tokens de salida. Instrucciones como "solo código" o "responde en una línea" reducen la salida innecesaria.

❌ "Arregla esta función"
→ La IA genera una explicación larga + código + notas (muchos tokens de salida)

✅ "Arregla esta función. Sin explicaciones, solo el código"
→ Solo código (significativamente menos tokens de salida)

Consejo 6: Limita los tokens de razonamiento

En Claude Code el pensamiento extendido (extended thinking) está activado por defecto, y los tokens de pensamiento se cobran como tokens de salida. Según el modelo, el presupuesto predeterminado puede llegar a decenas de miles de tokens por solicitud. Para trabajos que no requieren un razonamiento profundo, bajar el nivel de esfuerzo con /effort (o en /model) reduce el coste. Opus 5.5 y los modelos Fable siempre piensan, así que en ellos se ajusta el esfuerzo (Manage costs effectively). El esfuerzo predeterminado de Opus 5.5 es medium; el de la mayoría de los demás modelos, high (Model configuration).

# Menor esfuerzo para tareas simples
/effort low

Consejo 7: Mantén CLAUDE.md conciso

CLAUDE.md (el archivo de instrucciones del proyecto) se carga en el contexto al iniciar la sesión y luego viaja en cada solicitud posterior. Si incluye instrucciones paso a paso para flujos concretos, como revisiones de PR o migraciones de base de datos, pagas esos tokens incluso mientras haces otra cosa. La recomendación oficial es trasladar esas instrucciones a skills, que solo se cargan cuando se invocan (Manage costs effectively).

Consejo 8: Aprovecha los subagentes

Delega en un subagente el trabajo que genera mucha salida, como ejecutar pruebas, consultar documentación o procesar archivos de registro. La salida extensa se queda en el contexto del subagente y a tu conversación principal solo vuelve un resumen. Aun así, las solicitudes del propio subagente cuentan para tu uso; para gastar menos en ellas, asigna al subagente un modelo más pequeño, como Haiku (Manage costs effectively).

Consejo 9: Proporciona las especificaciones desde el inicio para evitar retrabajo

Un ida y vuelta del tipo "constrúyelo, luego arréglalo, luego cámbialo" desperdicia tokens. Proporcionar especificaciones claras desde el principio evita el retrabajo y mantiene el consumo de tokens lineal.

❌ Patrón conversacional (crecimiento exponencial de tokens):
"Crea un login" → "Añade validación"
→ "Mejor cambia a autenticación por email" → "Cambia también la interfaz"

✅ Patrón con especificaciones (crecimiento lineal de tokens):
"Crea un login con estas especificaciones:
- Autenticación por email + contraseña
- Validación de email (formato + duplicados)
- Requisitos de contraseña: 8+ caracteres, alfanuméricos
- Interfaz del formulario: centrada, estilo tarjeta"

Para más información sobre cómo escribir prompts efectivos, consulta nuestro artículo sobre consejos de prompts para el desarrollo de apps con IA.

Consejo 10: Cuida los formatos de archivo

En la API de Claude, cada página de un PDF cuesta los tokens de su texto extraído (normalmente entre 1.500 y 3.000 tokens por página) más los de la página convertida en imagen (documentación de la API de Claude, «PDF support»). Claude Code lee completos los PDF cortos y, los de más de 10 páginas, por tramos de hasta 20 páginas (Tools reference). Indica solo las páginas que necesitas o convierte el archivo a texto antes de pasárselo.

4. ¿Qué pasa al alcanzar el límite? La ventana de 5 horas, el límite semanal y los créditos de uso

Lo primero: los planes de suscripción sí pueden generar cargos adicionales, pero nunca por sí solos. Para seguir trabajando más allá del límite tienes que activar tú mismo los créditos de uso (usage credits) y cargar un saldo por adelantado. Si no lo haces, Claude Code simplemente se detiene en el límite, esperas a que se renueve la ventana y tu factura no cambia (Centro de ayuda de Anthropic, «Manage usage credits for paid Claude plans»).

Dos niveles de límite: la ventana de 5 horas y el límite semanal

• Ventana de 5 horas (límite de sesión): una cuota que se renueva cada cinco horas. La tienen Pro, Max y Team
• Límite semanal: un tope semanal común a todos los modelos. Se renueva el día y la hora fijos asignados a tu cuenta, que no dependen de cuándo empieces a usar Claude ni de cuándo te suscribiste. Puedes ver la próxima renovación en Settings > Usage de claude.ai (Centro de ayuda, «What is the Pro plan?» y «What is the Max plan?»)
• Límites por modelo: algunos límites se aplican solo a Opus o solo a Sonnet

El uso se descuenta a la vez de la ventana de 5 horas y del límite semanal. Una ráfaga de actividad intensa, como lanzar muchos subagentes a la vez, puede agotar el límite semanal antes de que se renueve la ventana de 5 horas. Al acercarte a un límite aparece un aviso como You've used 85% of your session limit · resets 3:45pm, y al alcanzarlo Claude Code se detiene con mensajes como estos (documentación de Claude Code, «Error reference»):

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

Tus opciones al alcanzar el límite en Pro o Max

Fuentes: documentación de Claude Code «Error reference» y «Wait for a usage limit to reset», Centro de ayuda de Anthropic «Use Claude Code with your Pro or Max plan» y las preguntas frecuentes de la página de precios de Claude (consultadas el 26 de septiembre de 2026). Qué hacer ante cada mensaje se explica en You've hit your session limit en Claude Code: qué significa y qué hacer.

Cómo funcionan los créditos de uso (Pro y Max)

• Dónde se activan: en la sección «Usage credits» de Settings > Usage en claude.ai. En Claude Code, /usage-credits abre esa página en el navegador (solo si has iniciado sesión con una suscripción de claude.ai; no está disponible con una clave de API)
• Pago: por adelantado. Compras saldo con «Add funds» y puedes activar la recarga automática (auto-reload) para reponerlo cuando baje
• Freno: puedes fijar un límite de gasto mensual (o elegir «Set to unlimited»). Si lo alcanzas y aún te quedan créditos, Claude Code te pregunta si quieres subir o quitar el límite
• Tarifa: las tarifas estándar de la API (la tabla de la sección 5), que aparecen como un cargo aparte de tu suscripción. La ventana de 5 horas se sigue renovando como siempre
• Confirmación: recibes avisos al acercarte al límite y al alcanzarlo, y se te pide confirmar antes de seguir con créditos
• Desactivarlos: puedes hacerlo en cualquier momento en Settings > Usage; a partir de ahí solo usas la cuota de tu plan

Hay dos detalles fáciles de pasar por alto. El primero es la duración de la caché. Dentro de la cuota del plan, la caché de la conversación principal de Claude Code dura una hora, pero baja a cinco minutos mientras consumes créditos de uso. Si paras más de cinco minutos, el siguiente mensaje vuelve a leer toda la conversación y los créditos se gastan más rápido (Manage costs effectively). El segundo es la caducidad. En la mayoría de los lugares los créditos comprados no caducan, pero en algunas jurisdicciones, como Japón, caducan seis meses después de la compra a partir del 10 de septiembre de 2026, con un aviso por correo siete días antes.

Si no quieres pagar nunca nada extra

• No actives los créditos de uso (si ya están activados, desactívalos en Settings > Usage)
• No dejes definida la variable de entorno ANTHROPIC_API_KEY. Si lo está, Claude Code se autentica con esa clave de API en lugar de con tu suscripción, y tu uso se cobra como uso de la API (Centro de ayuda, «Use Claude Code with your Pro or Max plan»). /status muestra con qué cuenta estás trabajando
• Inicia sesión solo con tu cuenta Pro o Max, sin añadir credenciales de la Claude Console (API) (mismo artículo)

Team y Enterprise

• Team y Enterprise por puestos: el uso de cada miembro se descuenta de una cuota por puesto que se renueva en una ventana de cinco horas y otra semanal. La cuota se comparte con el chat y con Cowork, y su tamaño depende del tipo de puesto (estándar o premium). Solo se puede seguir más allá si un administrador activa los créditos de uso, con límites de gasto por organización, grupo o miembro (Manage costs effectively). En Team los créditos se pagan por adelantado; en Enterprise por puestos se factura a final de mes el uso real (Centro de ayuda, «Manage usage credits for Team and seat-based Enterprise plans»)
• Si un miembro sin permisos de facturación ejecuta /usage-credits, Claude Code pide confirmación y envía una solicitud a los administradores
• Enterprise por consumo (planes nuevos y de autoservicio): no hay cuota por puesto; todo el uso se cobra a tarifas de la API desde el primer token. El uso se detiene al alcanzar el límite de gasto de la organización o del miembro (Centro de ayuda, «How am I billed for my Enterprise plan?»)

Clave de API (pago por uso)

• No hay ventana de 5 horas ni límite semanal; se te cobra todo lo que uses
• Si superas un límite de tasa por minuto (solicitudes, tokens de entrada o tokens de salida por minuto), recibes un error 429 con una cabecera retry-after que indica cuánto esperar
• Cada nivel de uso, que depende de tu historial, tiene un tope de gasto mensual (Start $500, Build $1.000, Scale $200.000). Al alcanzarlo, el uso se pausa hasta las 00:00 UTC del día 1 del mes siguiente. También puedes fijar tu propio límite, más bajo (documentación de la API de Claude, «Rate limits»)
• En una organización, también puedes poner límites de gasto a los espacios de trabajo de la Claude Console (Manage costs effectively)
• Los planes Max y Team incluyen cada mes créditos para usar en la API ($100 en Max y $200 en Ultra). Se reciben vinculando una organización de la Claude Console, y sirven también para claude -p ejecutado con una clave de API, pero no para Claude Code en modo interactivo («Los créditos de API mensuales de los planes Max y Team de Claude»)

Cómo comprobar lo que te queda y lo que has gastado

• /usage: barras de uso del plan, gasto del mes en créditos de uso y un desglose de qué consumió tu cuota (skills, subagentes, servidores MCP, etc.). /cost y /stats son alias. El desglose se calcula con el historial de sesiones de este equipo, así que no incluye el uso en otros dispositivos ni en claude.ai
• Settings > Usage en claude.ai: el avance de la ventana de 5 horas y del límite semanal, y cuándo se renueva cada uno
• Línea de estado: añade los campos rate_limits para tener siempre a la vista lo que te queda
• /status: con qué cuenta estás trabajando
• Con una clave de API: la página Usage de la Claude Console (platform.claude.com/usage)

Fuentes: Manage costs effectively, Error reference, Commands (consultadas el 26 de septiembre de 2026).

5. Cómo funciona el precio de la API (pago por uso)

En la API, el precio por token depende del nivel del modelo (superior, alto, medio, ligero). Los precios concretos cambian con cada versión, pero las relaciones —cuanto más alto el nivel, más caro; la salida cuesta cinco veces la entrada; y lo leído desde la caché cuesta mucho menos que la entrada— se han mantenido hasta ahora entre generaciones. Precios a 12 de octubre de 2026:

* MTok = 1 millón de tokens. Fuente: Claude Platform Docs, «Pricing» (consultado el 12 de octubre de 2026). Los precios de Haiku 5.5 son para prompts de hasta 100.000 tokens; por encima, pasan a $0.50 de entrada, $2.50 de salida y $0.05 de lectura de caché. La lectura de caché de Sonnet 5.5 bajó del 10% al 5% de la entrada el 7 de octubre de 2026. El anterior Haiku 4.5 ($1 de entrada, $5 de salida) pasa a ser un modelo heredado (legacy) y sigue disponible. Para los precios actuales y la comparación de modelos, consulta la comparación de precios de Opus, Sonnet y Haiku; para los modelos actuales de cada empresa, la lista de modelos actuales y fechas de corte.

¿Qué es la caché de prompts?

Anthropic ofrece una función de caché de prompts: cuando se reutiliza el mismo contexto (prompt del sistema y conversación reciente), lo que se lee desde la caché cuesta el 10% del precio base de entrada (y aún menos en Opus 5.5 y Sonnet 5.5, con un 5%, y en Fable 5.1, con un 2,5%, como muestra la tabla). A cambio, escribir en la caché cuesta 1,25 veces la entrada con una vida de 5 minutos y 2 veces con una de una hora.

Cuánto dura la caché depende de cómo se te facture. Dentro de la cuota de un plan de suscripción, Claude Code da a la conversación principal una caché de una hora; con créditos de uso, una clave de API o un proveedor de nube, el valor predeterminado es de cinco minutos (documentación de Claude Code, «Prompt caching»). Con la duración de cinco minutos, si pausas más de cinco minutos la caché caduca y el siguiente mensaje vuelve a escribir todo el contexto en la caché. Configurar promptCacheTtl en 1h amplía la conversación principal a una hora (con un precio de escritura más alto).

Si quieres usar DeepSeek, GLM, Kimi u otros modelos desde Claude Code en lugar de Claude para reducir costes, y conocer sus precauciones (caché, cargos por búsqueda y destino del código), lo hemos resumido en Cómo usar DeepSeek, GLM y Kimi en Claude Code.

6. Resumen

Preguntas frecuentes

Fuentes

Fuentes primarias consultadas (obtenidas el 26 de septiembre de 2026): documentación de Claude Code Manage costs effectively / Error reference / Interactive mode / Prompt caching / Model configuration / Commands / Tools reference; documentación de la API de Claude Pricing / Rate limits / PDF support; la página de precios de Claude; Centro de ayuda de Anthropic créditos de uso (Pro y Max) / créditos de uso (Team y Enterprise) / Claude Code con Pro o Max / plan Pro / plan Max / facturación de Enterprise. Los precios, los límites y la disponibilidad pueden cambiar, así que comprueba las páginas oficiales antes de contratar.