Gestionar la ventana de contexto en sesiones largas de Claude Code

Hora tres de la sesión, Claude empieza a olvidar cosas que le explicaste en la hora uno. Las respuestas se vuelven más vagas. El último cambio de código ignora una convención que fijaste explícitamente al principio. Drift de contexto clásico.

No puedes "quitarlo a base de prompts". Tienes que gestionar el contexto de forma activa. Las herramientas para ello están todas ahí, pero la mayoría de la gente no las usa o las usa mal. Aquí están los diez pasos que recorro en cada sesión de coding más larga, en el orden en el que entran en juego.

1. Reconoce cuándo el contexto se viene abajo

Tres señales que llegan de forma fiable antes de que se tuerza de verdad. Primero: Claude se repite, sugiere cosas que ya descartasteis hace dos horas. Segundo: los cambios de código se vuelven más frenéticos, más archivos a la vez, menos enfocados. Tercero: tienes que volver a nombrar explícitamente convenciones que fijasteis al principio, porque si no salen patrones equivocados.

Cuando llega una de estas tres señales, es hora del paso 2. No más tarde. Cuanto más avanzado el drift, más caro el reset.

2. /usage primero, luego decidir

Antes de resetear nada: teclea /usage. Ves el nivel actual de tokens de la sesión. /cost es un alias y hace lo mismo.

Por debajo del 50 por ciento de uso: el drift tiene otra causa, quizá tu último prompt es poco claro, quizá la tarea es simplemente demasiado grande. Un reset no te aporta nada.

Entre 50 y 75 por ciento: todavía hay margen, pero /compact tiene sentido ahora si vas a seguir un rato más.

Por encima del 75 por ciento: aquí tienes que actuar, si no la sesión se viene abajo en los próximos 20 minutos.

3. Usa /compact correctamente

/compact escribe un resumen de la sesión y reemplaza con él el historial largo. En tokens ahorras a menudo del 60 al 80 por ciento. Lo que queda: el resumen más tu CLAUDE.md más los últimos turnos.

Peligro: lo que no aterriza en el resumen, desaparece. Si estás justo en medio de un refactor delicado y Claude "sabía" una convención que no estaba guardada en ningún sitio de forma explícita, esa puede desaparecer tras /compact. Escribe las cosas importantes en CLAUDE.md antes o haz que Claude apunte la convención explícitamente.

Consejo práctico: dale al /compact una pista sobre qué tiene que entrar sí o sí. "Compact aber behalte alle Entscheidungen zur Auth-Architektur" funciona.

4. /clear cuando el trabajo está hecho

Cuando una tarea está de verdad terminada, es decir commiteada, testeada, desplegada: /clear. Arranca una conversación nueva con contexto vacío. La antigua sigue disponible en /resume por si tienes que volver.

Error clásico: la gente deja la sesión abierta todo el día, salta entre tareas, y se pregunta por qué después de 6 horas todo se descontrola. Cada tarea nueva merece un /clear. Eso es gratis y hace las horas 4 a 8 más productivas que las horas 1 a 3.

5. /resume en vez de reiniciar en pánico

Has hecho clear, y entonces te das cuenta de que en el contexto antiguo todavía había algo importante. /resume te muestra las últimas sesiones, saltas de vuelta dentro. Sin pérdida de datos.

Importante: /resume no es para "necesito todo el contexto otra vez". Es para "necesito una cosa del contexto antiguo". Coge la info, escríbela como nota en CLAUDE.md o en tu memoria, luego de vuelta a la sesión fresca.

6. CLAUDE.md como ancla

Este es el único sitio que sobrevive a los resets. CLAUDE.md está en la raíz del proyecto y se carga automáticamente en cada sesión. Todo lo que es constante del proyecto va ahí dentro, no en el contexto de la conversación.

En concreto dentro: convenciones de coding, versiones del stack, mapa de rutas, "usamos X no Y", glosario para términos de dominio, "PostgreSQL corre en el puerto 5433 no 5432". Lo que si no tienes que volver a explicar tras cada /compact va en el archivo.

Ten en cuenta el límite: Anthropic advierte explícitamente contra archivos CLAUDE.md demasiado grandes. Si el tuyo pasa de 500 líneas, eso es un code smell. Divide en un CLAUDE.md para el núcleo más archivos de docs separados que se cargan bajo demanda vía una instrucción Read.

7. Divide tareas largas con /fork

Algunas tareas son tan grandes que llenan una sesión entera por sí solas. Refactor a través de 40 archivos, migración a una nueva versión de API, implementación de una feature con cinco dependencias. Un solo sub-agente o una rama /fork tiene sentido ahí.

/fork arranca una rama de la sesión actual. Sigues trabajando ahí por separado, el contexto original se mantiene limpio. Vuelves con /resume. Así evitas que la parte de research de una tarea te llene de basura la sesión de implementación.

CLAUDE_CODE_FORK_SUBAGENT como variable de entorno lo cambia de forma que /fork lanza un sub-agente en vez de una rama de sesión. Esa es la variante para "quiero trabajo en paralelo, no secuencial".

8. Memory MCP para cross-session

CLAUDE.md tiene scope de proyecto, pero algunas cosas son cross-proyecto. "Matthias hasst em-dashes", "Wir deployen über Docker, nie direkt", "Postgres läuft Port 5433 weil 5432 schon besetzt war". Eso a un servidor MCP de memoria.

StudioMeyer Memory MCP o un servidor comparable (Mem0, Letta, uno propio) guarda los facts de forma persistente y los devuelve bajo demanda. Las lecciones del Level 4 (memory-einrichten, memory-hygiene) muestran el setup. Efecto: tus facts sobreviven no solo a /clear, sino también a máquinas completamente nuevas.

9. El plan mode reduce la carga de contexto

Antes de meterte en una tarea grande, haz que Claude la planifique en plan mode. El plan mode genera solo el plan, nada de código. El plan aterriza como texto compacto en el contexto, no como 40 lecturas de archivo y 200 líneas de diff.

Con el plan en el contexto puedes luego implementar pieza a pieza de forma dirigida, si acaso /compact después de cada pieza. Eso es 5x más eficiente que "implementa la feature por completo". Más sobre esto en el playbook plan-mode-richtig-nutzen.

10. Rutina de reset diaria

Fin de la jornada de trabajo: cierra la sesión de forma limpia, no la dejes abierta hasta mañana. En concreto:

Primero, commitea todas las tareas abiertas o márcalas explícitamente como draft. Segundo, las decisiones importantes tomadas hoy a CLAUDE.md o a la memoria. Tercero, /clear más una línea "Tomorrow: pick up X". Cuarto, empieza la mañana siguiente con un /clear fresco y si acaso /resume de ayer si hace falta.

Esto suena a overhead, pero 5 minutos al día invertidos te devuelven de 30 a 60 minutos de dolor de drift por semana. Además reconoces patrones: qué tareas necesitan de verdad sesiones largas, cuáles son piezas de 2 horas. Eso te ayuda a planificar mejor las tareas a la larga.

Qué viene después

Si el tema en general te quema, dos pasos siguientes. La lección 04-kontext-und-tokens en el Level 1 explica cómo funcionan las ventanas de contexto a nivel técnico, por si necesitas el modelo mental. El playbook claude-code-cost-controls-für-daily-driver muestra cómo limitas el coste de tus sesiones, lo que está directamente relacionado con la gestión de contexto. Y si trabajas mucho con sub-agentes en tareas de varias horas, merece la pena el playbook erster-sub-agent-in-30-min más las lecciones L5 sobre patrones multi-agente.

Source

Este playbook se apoya en la documentación oficial de Claude Code:

• Slash Commands Reference: https://code.claude.com/docs/en/commands (comprobado por última vez 2026-05-04)
• Memory & CLAUDE.md: https://code.claude.com/docs/en/memory
• Skills & Built-in Commands: https://code.claude.com/docs/en/slash-commands

Verificado: /clear, /compact, /resume, /fork, /usage, /cost (alias de /usage), CLAUDE.md, CLAUDE_CODE_FORK_SUBAGENT.