Por qué Claude Code empieza a consumir muchos tokens: tutorial, diagnóstico y FAQ

Claude Code puede funcionar de forma eficiente durante días y, de repente, consumir muchos más tokens para tareas parecidas. No siempre significa que el precio haya cambiado o que el modelo falle. A menudo el contexto, los logs, los archivos leídos, Hooks, MCP o los reintentos han crecido sin que lo notes.

La pregunta correcta es: qué cambió recientemente y qué parte del flujo está inflando el contexto.

Dónde se gastan los tokens

El consumo incluye tu prompt, archivos leídos, salida de terminal, logs de pruebas, trazas de error, historial de conversación, resultados de herramientas, CLAUDE.md, Memory, salida de Hooks y la respuesta del modelo. Un mensaje corto puede ser caro si todo lo que lo rodea es grande.

Primeros pasos para frenar el gasto

1. Abre una sesión nueva.
2. Indica qué archivos puede leer.
3. Evita análisis de todo el repositorio.
4. Pega solo la parte útil de los logs.
5. Desactiva MCP innecesario temporalmente.
6. Revisa si Hooks imprime demasiado.
7. Separa diagnóstico y edición.

1
2
3

Please only inspect src/auth/session.ts and tests/auth/session.test.ts.
Goal: find why login state is lost.
Do not scan the whole repository. Do not modify files. First give the diagnosis.

Causa 1: sesiones largas

Una sesión larga acumula logs, archivos, planes y decisiones antiguas. Las tareas pequeñas posteriores cargan con ese historial. Usa sesiones nuevas para tareas independientes y pasa solo las conclusiones necesarias.

Causa 2: demasiados archivos

Un prompt amplio como:

1

Help me optimize this project’s login logic.

invita a explorar rutas, componentes, estado, pruebas y configuración. Mejor:

1
2

Please analyze the login refresh flow. Start with src/auth and tests/auth.
If you need other directories, explain why first.

Causa 3: logs de pruebas o build demasiado largos

Instalaciones, pruebas verbosas, Playwright traces, errores masivos de TypeScript y Docker build llenan el contexto. Usa comandos más pequeños.

1

pnpm test -- auth

en vez de:

1

pnpm test

Causa 4: CLAUDE.md demasiado grande

CLAUDE.md debe contener reglas de alta frecuencia: stack, comandos, archivos protegidos, validación y convenciones del proyecto. No lo conviertas en una enciclopedia. Los documentos largos pueden vivir en docs/.

Causa 5: Memory contaminada

Memory sirve para preferencias transversales, no para rutas o comandos de un repositorio concreto. Si guardas detalles temporales allí, Claude Code los arrastra a otros proyectos.

Causa 6: Hooks con salida enorme

Hooks puede imprimir diffs completos, logs enteros o variables de entorno. Prefiere resúmenes:

1
2

lint failed: 3 errors in src/auth/session.ts
full log saved to .tmp/lint.log

Causa 7: MCP devuelve demasiados datos

Herramientas de búsqueda, base de datos, web o índice de código pueden devolver documentos completos. Limita resultados:

1

Return only the 5 most relevant results. Do not expand full text. Explain why each result is relevant.

Causa 8: cambio de modelo

Quizá el número de tokens no cambió tanto, pero sí el modelo o el modo de razonamiento. Revisa el modelo actual, la configuración del equipo y cualquier cambio reciente.

Causa 9: reintentos fallidos

Cada fallo añade logs, explicaciones, parches y llamadas a herramientas. Tras dos fallos, detén la edición:

1

Stop editing. Summarize the common cause of the last two failures and propose one minimal verification command.

Causa 10: tareas demasiado abstractas

1

Improve this module.

consume más que:

1
2
3

Only optimize the expiration cleanup logic in src/cache/store.ts.
Do not change the public API.
After editing, run tests/cache/store.test.ts.

Lista de diagnóstico

Flujo eficiente

1. Define objetivo y límites.
2. Permite solo archivos necesarios.
3. Primero análisis, luego edición.
4. Modifica pocos archivos.
5. Ejecuta la prueba mínima.
6. Recorta logs.
7. Nueva sesión para la siguiente tarea.

1
2
3
4

Goal: fix login refresh failure.
Scope: start with src/auth/session.ts and tests/auth/session.test.ts.
Limit: first round only, no edits, no full-repo scan.
Output: the 3 most likely causes and verification methods.

FAQ

¿Es un bug de Claude Code?

Normalmente no. Revisa contexto, archivos, logs, Hooks, MCP y modelo.

¿Desactivar MCP ahorra tokens?

Puede ahorrar si devuelve muchos datos. Mejor limitar y resumir resultados.

¿CLAUDE.md debe ser muy detallado?

No. Debe contener reglas estables que cambian el comportamiento.

¿Por qué un cambio pequeño consume mucho?

Porque cuenta todo el contexto, no solo las líneas modificadas.

¿Una sesión nueva pierde contexto útil?

Pierde detalles antiguos, pero eso suele ayudar. Reintroduce solo conclusiones necesarias.

Resumen

Los picos de tokens en Claude Code suelen venir de contexto acumulado, tareas amplias, logs largos, CLAUDE.md excesivo, Memory contaminada, Hooks, MCP, cambios de modelo o reintentos. La solución práctica es sesión nueva, alcance estrecho, logs recortados y herramientas con salida limitada.