Formación › Programar con Claude Code en 12 horas › Hora 2
Programar con Claude Code en 12 horas · hora 2 de 12
La ventana de contexto y las sesiones
La documentación de Claude Code lo dice sin rodeos: casi todas las buenas prácticas nacen de una limitación, que la ventana de contexto se llena rápido y el rendimiento empeora a medida que se llena. Quien gestiona bien el contexto obtiene respuestas más fiables y gasta menos de su plan.
Al terminar sabrásExplicar qué ocupa el contexto de una sesión, medirlo con /context y usar /clear, /compact y /rewind en el momento adecuado, sabiendo qué sobrevive a la compactación.
60 minutos· 2 esquemas· 5 preguntas· 1 ejercicio· entregable
Repaso
Comprueba De la hora 1: ¿cuáles son las tres fases del bucle de Claude Code?
Correcto. Así lo describe la documentación oficial; las fases se mezclan entre sí.
No. Guardar en Git es opcional y llega al final, si lo pides.
No. Es un ciclo de desarrollo, no el bucle del agente.
Comprueba De la hora 1: en la sesión del mapa, ¿qué ocupó el contexto de Claude?
No. Leer también llena el contexto, aunque no se edite nada.
Correcto. Leyó los 9 ficheros del repositorio: todo eso entra en la ventana.
No. El modo plan impide editar, no leer: lo leído ocupa contexto igual.
Vocabulario
- Ventana de contexto
- Todo lo que Claude ve en un momento: instrucciones, CLAUDE.md, mensajes, ficheros leídos y salidas de comandos.
- Compactar
- Resumir la conversación para liberar espacio. Claude Code lo hace solo al acercarse al límite.
- Punto de control
- Una instantánea que Claude Code guarda antes de cada cambio, para poder volver atrás con /rewind.
El ejemplo: la regla que desaparece
Ejemplo resuelto Una sesión de dos horas en informes-mantenimiento
- Al empezar dices: «los importes, siempre con dos decimales y coma decimal».
- Claude trabaja una hora y media: lee ficheros, ejecuta pruebas y edita. El contexto se llena.
- Claude Code compacta solo: resume la conversación para seguir trabajando.
- Al rato genera un parte con punto decimal. La regla estaba solo en un mensaje y se ha perdido en el resumen.
- Arreglo inmediato:
/rewindhasta antes del parte erróneo y repetir la petición. - Arreglo definitivo: escribir la regla en CLAUDE.md. Según la documentación, el CLAUDE.md de la raíz del proyecto se vuelve a leer del disco tras compactar, así que la regla sobrevive a cualquier compactación y a cualquier sesión nueva.
Qué hay en la ventana de contexto
Según la documentación oficial, la ventana de contexto contiene:
- Lo que carga al empezar: las instrucciones del sistema, tu CLAUDE.md, la memoria automática y las descripciones de las skills.
- Lo que se acumula: cada mensaje tuyo y suyo, cada fichero que lee y cada salida de comando.
Lo segundo es lo que se dispara: una sesión de depuración o de exploración del código puede consumir decenas de miles de tokens. Cuanto más se llena, más fácil es que Claude «olvide» instrucciones del principio o cometa más errores.
Estimación: en español, una página de texto ocupa del orden de 500 tokens; cada herramienta cuenta a su manera. Los tamaños de ventana son ejemplos: el real depende del modelo y del plan.
Las cuatro órdenes que más vas a usar
| Orden | Qué hace | Cuándo |
|---|---|---|
/context | Muestra qué está ocupando el contexto | Antes de una tarea larga o cuando notes respuestas peores |
/clear | Vacía el contexto y empieza de cero | Entre tareas que no tienen nada que ver |
/compact | Resume para liberar espacio; admite instrucciones: /compact céntrate en los cambios de la API | En una tarea larga que quieres continuar |
/rewind (o Esc dos veces) | Vuelve a un punto anterior: conversación, código o ambos, o resume desde ahí | Cuando un camino no ha funcionado |
Dos reglas de la guía oficial de buenas prácticas:
- Si has corregido a Claude más de dos veces en lo mismo, haz
/cleary empieza con un prompt mejor que incluya lo que has aprendido. Una sesión limpia con un buen prompt casi siempre supera a una larga llena de intentos fallidos. - Acota las investigaciones. Una petición de «investigar» sin límites lee cientos de ficheros y llena el contexto. Acótala, o delega la exploración en un subagente, que trabaja en su propio contexto (hora 9).
¿Una duda rápida que no quieres que se quede en el contexto? Usa /btw: la respuesta no entra en el historial. Y recuerda que los puntos de control solo cubren los cambios hechos con las herramientas de edición de Claude: lo que hace un comando de Bash no se puede deshacer con /rewind. No sustituyen a Git.
Practica
Clasifica Tras una compactación, ¿qué pasa con cada cosa?
- Las reglas del CLAUDE.md de la raíz del proyectoClaude lo vuelve a leer del disco tras compactar.
- «No toques la carpeta datos», dicho en el tercer mensaje de la sesiónLo que solo se dijo en la conversación puede quedar fuera del resumen. Muévelo a CLAUDE.md o a un hook.
- La salida completa de unas pruebas que ejecutó hace una horaLas salidas antiguas de las herramientas son lo primero que se elimina.
- Una regla de
.claude/rules/limitada a ciertos ficherosLas reglas por ruta se vuelven a cargar al trabajar con un fichero que coincide.
Comprueba lo que has aprendido
Comprueba Terminas un fallo en el módulo de fechas y quieres empezar con la exportación a CSV, que no tiene nada que ver. ¿Qué haces?
Correcto. Es la recomendación oficial entre tareas sin relación: contexto limpio y relevante.
No. Resumes algo que ya no necesitas: mejor vaciar.
No. El proyecto lo recuerda por CLAUDE.md; arrastrar el fallo anterior solo añade ruido.
Comprueba Has corregido tres veces el mismo error y Claude sigue fallando. ¿Qué recomienda la guía oficial?
No. El problema principal es el contexto contaminado.
Correcto. Una sesión limpia con lo aprendido casi siempre gana.
No. El contexto ya está lleno de intentos fallidos que lo confunden.
Comprueba Claude borró unos ficheros con un comando de Bash por error. ¿Lo arregla /rewind?
No. En modo plan no habría podido borrar nada.
No. Los puntos de control solo cubren las ediciones hechas con sus herramientas de edición.
Correcto. Por eso conviene trabajar con Git y guardar versiones a menudo.
Entregable Tu regla de contexto
Trabaja una tarea real de unos 20 minutos en el repositorio de práctica o en uno tuyo. Ejecuta /context al principio y al final y anota qué ocupa más. Después escribe tu regla personal: cuándo harás /clear, cuándo /compact (y con qué instrucciones) y qué vas a mover a CLAUDE.md para que no se pierda.
Está bien si: anotas dos lecturas de /context y qué creció más; tu regla dice cuándo usar cada orden con un ejemplo tuyo; y mueves al menos una instrucción a CLAUDE.md. Tiempo: unos 30 minutos en total.
Lo esencial
- El contexto es el recurso clave: se llena con ficheros leídos y salidas de comandos.
/clearentre tareas distintas,/compactcon instrucciones en las largas y/rewindpara deshacer un camino.- Tras dos correcciones fallidas, sesión limpia y mejor prompt.
- Lo permanente va en CLAUDE.md, que sobrevive a la compactación. Los comandos de Bash no se deshacen con /rewind: usa Git.
Fuentes y para seguir
- Buenas prácticas de Claude Code (se abre en otra pestaña) (documentación oficial, consultada el 24/10/2026).
- Explorar la ventana de contexto (se abre en otra pestaña), una simulación oficial de lo que carga cada sesión.
- Cómo funciona Claude Code: la ventana de contexto y los puntos de control (se abre en otra pestaña).
Lección revisada el 24/10/2026 con la documentación oficial enlazada en sus fuentes. Revisamos los cursos cada trimestre.