Context window
Entiende el límite más importante de Claude — y cómo gestionarlo
⏱ Estim. ~5 min
01 · Leer
La context window de Claude es como un escritorio. Todo lo que Claude está pensando tiene que caber en ese escritorio — tu conversación, el contenido de los archivos que lee, la salida de los comandos, CLAUDE.md, los skills cargados, las descripciones de las herramientas MCP, las instrucciones del sistema.
Cuando el escritorio se llena, Claude tiene que empujar lo viejo para hacerle espacio a lo nuevo. Cuando eso pasa, Claude puede olvidar instrucciones que le diste antes, o perder de vista qué archivos ya leyó.
Es el concepto más importante para usar Claude Code de forma efectiva.
💡 Imagínalo asíImagina que trabajas con un colega muy capaz cuyo escritorio solo aguanta 50 páginas. Cada vez que le das un documento nuevo, uno viejo se cae. Si le sigues pasando archivos nuevos, al final tus instrucciones originales se le resbalan del escritorio. Entender ese límite es la clave de una sesión productiva.
Puntos clave
- La context window contiene todo lo que Claude está "pensando"
- Incluye conversación, archivos, salida de comandos, CLAUDE.md, skills y herramientas MCP
- Cuando se llena, el contenido viejo se elimina automáticamente
- Por eso CLAUDE.md importa — se vuelve a cargar siempre, incluso después de la compresión
02 · Leer
No todo consume la misma cantidad de context. Leer un archivo grande vuelca todo su contenido a la ventana. La salida larga de un comando se come tokens. Cada descripción de herramienta MCP ocupa espacio (por eso existe Tool Search).
Guía rápida — CLAUDE.md usa entre 2 y 5k tokens según su tamaño. Cada lectura de archivo usa tokens proporcionales al tamaño del archivo. La salida de comandos (como resultados de tests o errores de build) puede ser inesperadamente grande. Los skills se cargan bajo demanda y solo consumen tokens cuando se activan. Las herramientas MCP consumen tokens por sus descripciones.
La idea clave — mantén el context inicial ligero y deja que Claude cargue lo que necesite.
Puntos clave
- CLAUDE.md: 2-5k tokens (mantenlo bajo 200 líneas)
- Lectura de archivos: proporcional al tamaño del archivo
- Salida de comandos: puede ser muy grande (suites de tests, logs de build)
- Skills: bajo demanda — costo cero al arrancar
- Herramientas MCP: las descripciones consumen tokens (Tool Search ayuda)
03 · Ejemplo de código
Claude Code te da herramientas para monitorear el uso de context y liberar espacio cuando lo necesites.
Ver el uso del context
/context
Compactar con instrucciones de foco
/compact Focus on the API changes and test failures
Limpiar entre tareas sin relación
/clear
Usa /context para ver qué tan llena está la ventana. Cuando esté apretado, /compact resume la conversación y conserva lo importante — agrega instrucciones de foco para decirle a Claude qué conservar. Entre tareas totalmente sin relación, usa /clear para resetear todo (pero CLAUDE.md se recarga automáticamente).
04 · Leer
Cuando el context se llena demasiado, Claude Code lo compacta automáticamente. Resume la conversación, conserva el trabajo reciente y las decisiones clave, y condensa los intercambios viejos.
Después de compactar — sea automático o manual — Claude vuelve a leer CLAUDE.md desde el disco. Eso significa que lo que está en CLAUDE.md sobrevive a la compresión. Lo que solo está en el historial de conversación, puede que no.
Es la razón fundamental para poner las reglas importantes en CLAUDE.md y no solo decirlas en la conversación.
Puntos clave
- Claude compacta automáticamente al acercarse al límite
- La compresión resume la conversación vieja y conserva el trabajo reciente
- CLAUDE.md siempre se vuelve a leer después de compactar
- Las reglas de CLAUDE.md sobreviven; las instrucciones habladas tal vez no
- Usa /compact de forma proactiva antes de que se dispare la compresión automática
05 · Quiz
Al inicio de una sesión larga le dijiste a Claude "siempre usa Bun, nunca npm". Después de una compactación automática, Claude empieza a usar npm. ¿Por qué?
- Claude ignora tus instrucciones a propósito
- Bun no es compatible con Claude Code
- Hay que reiniciar Claude Code para que las instrucciones surtan efecto
- Las instrucciones habladas se pierden al compactar — ponlas en CLAUDE.md
06 · Clasificar arrastrando
Piensa cómo afecta cada tipo de contenido a la context window. Ordénalos del más eficiente al menos eficiente en context.
(Esta sección es interactiva — activa JavaScript para usarla.)
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.