Gestión del contexto
El contexto es la memoria de trabajo de Claude Code. Todo lo que ocurre en una sesión ocupa espacio: cada archivo que lee, cada comando que ejecuta, cada mensaje que envías. Entender cómo gestionarlo marca la diferencia entre sesiones fluidas y sesiones que se degradan.
🌐 Este vídeo es el original de Anthropic, en inglés. Para seguirlo en español, dale al play al audio 🎬 «Sigue el vídeo en español» de aquí abajo — es la traducción exacta de lo que se dice.
Sigue el vídeo en español
Escucha la lección
¿Qué es la ventana de contexto?
Piénsala como el espacio disponible en la memoria de Claude Code. Cada elemento que forma parte de la sesión consume parte de ese espacio:
- ›Tus mensajes e instrucciones
- ›El contenido de los archivos que Claude lee
- ›Los resultados de los comandos que ejecuta
- ›Las llamadas a herramientas y sus respuestas
- ›Los subagentes y habilidades cargados
¿Qué ocurre cuando se llena?
Cuando la ventana se acerca al límite, Claude Code la compacta automáticamente: resume los detalles importantes y elimina los resultados de herramientas que ya no son necesarios para liberar espacio.
La compactación automática puede provocar pérdida de detalles. Por eso es mejor gestionar el contexto de forma proactiva, antes de que se llene.
Así se ve el resumen que genera la compactación: conserva lo esencial — de qué iba la sesión, las decisiones clave, los archivos tocados — y descarta lo accesorio.
Los tres comandos de gestión
/compact
Compacta todo el historial hasta ese momento, manteniendo un resumen. Úsalo cuando alcanzas el límite pero quieres seguir trabajando en la misma función.
/clear
Elimina todo el contexto sin dejar rastro. Úsalo cuando empiezas una función nueva y no quieres que la sesión anterior influya.
/context
Muestra el estado actual: tokens usados, categorías que más consumen y espacio libre. Úsalo para saber cómo estás de contexto antes de decidir qué hacer.
Cómo usar el contexto de forma eficiente
Sé específico en tus instrucciones
Una instrucción vaga obliga a Claude a explorar más código y a razonar más — lo que consume mucho más contexto que una instrucción detallada. Paradójicamente, ser más preciso ahorra espacio.
Gestiona tus servidores MCP
Los servidores MCP cargan todas sus herramientas automáticamente, incluso las que no estás usando. Si tienes servidores configurados para tareas ajenas al proyecto actual, desactívalos. Las Habilidades son una alternativa más eficiente: solo cargan lo que necesitan.
Usa subagentes para tareas de consulta
Los subagentes tienen su propia ventana de contexto independiente. Para preguntas del tipo "¿dónde están los endpoints de autenticación?", un subagente hace el trabajo y devuelve solo un resumen a tu contexto principal — manteniéndolo limpio.
Lo que quieres recordar entre sesiones: CLAUDE.md
El /clear lo elimina todo, pero hay cosas que no deberían perderse entre sesiones: la arquitectura del proyecto, los comandos clave, las decisiones importantes. Para eso existe el archivo CLAUDE.md.
Todo lo que incluyas en CLAUDE.md estará disponible en cada nueva sesión sin ocupar contexto conversacional. Es tu memoria permanente — y hablaremos de él en detalle en la próxima lección.
Regla práctica: usa /compact cuando estés a mitad de una función y el contexto se llene; usa /clear cuando empieces algo nuevo; y guarda en CLAUDE.md lo que no quieres tener que redescubrir.
Glosario
Ventana de contexto
La memoria de trabajo de Claude Code: el espacio limitado donde caben mensajes, archivos y resultados de la sesión.
Lo que Claude puede tener "en la cabeza" a la vez. Cuando se llena, hay que gestionarla.
Token
Unidad mínima en que el modelo divide el texto; la ventana de contexto se mide en tokens.
Los "trocitos" en que se mide cuánto cabe en la memoria de Claude.
/compact · /clear · /context
Comandos de gestión: /compact resume el historial, /clear lo borra del todo, /context muestra cuánto contexto llevas usado.
Tres atajos: resumir la conversación, empezar de cero, o ver cuánta memoria llevas gastada.
Endpoint
Punto de acceso concreto de una API o servicio (una URL o función), por ejemplo los de autenticación.
Una "puerta" concreta del programa por la que se entra o se pide algo.
CLAUDE.md
Archivo en la raíz del proyecto que Claude lee al iniciar cada sesión; le da memoria persistente del proyecto.
La "ficha" del proyecto que Claude lee siempre al empezar, para no preguntar lo mismo cada vez.
Fuentes oficiales de Anthropic