Al terminar este módulo, vas a entender cómo piensa Claude Code — y por qué a veces "olvida" — para dejar de pelearte con eso.
En el módulo 1 le diste tu primera chamba real y todo salió bien. Pero si sigues usándolo unos días vas a notar algo raro: a veces Claude Code se comporta como si hubiera olvidado algo que le dijiste hace rato. No es que esté fallando — está siendo exactamente como es. Hoy le abres la cabeza y ves cómo funciona por dentro: en qué mide lo que lee y escribe, dónde lo va acomodando mientras trabaja, y por qué cuando ese espacio se llena, algo se cae.
Cuando le pegas un párrafo a Claude, o le pides que lea un archivo, él no lo procesa letra por letra ni palabra por palabra: lo corta en pedacitos y trabaja con esos pedacitos. Se llaman tokens, y un token puede ser una palabra completa, un pedazo de palabra, o hasta un signo de puntuación. No necesitas aprender a cortarlos tú — eso lo hace Claude solo, en el instante — pero sí te conviene saber que existen, porque en tokens se mide TODO: cuánto le cabe en la cabeza en un momento dado, y cuánto te cuesta cada chamba (el detalle de precios, con tabla y fecha, lo ves en el módulo 3).
Los tokens son como fichas de dominó del lenguaje. Cada palabra que escribes se reparte en una o varias fichas — en español, calcula que cada palabra se parte, en promedio, en casi 2 fichas. Nadie hace este conteo a mano; lo importante es la idea: cuando hablamos de "espacio" o de "cuánto trae encima" la conversación, hablamos en fichas, no en palabras.
Para que el número deje de ser abstracto: hoy el modelo más generoso guarda hasta 1 millón de tokens en la cabeza al mismo tiempo. ¿Cuánto es eso? Le cabe El Quijote completo —casi 380 mil palabras— y todavía le sobra más de la mitad del espacio. El documento de práctica que vas a usar en el HAZLO TÚ de hoy tiene unas 4,800 palabras (unas 8 hojas tamaño carta): ocupa aproximadamente 8,600 tokens — ni el 1% de esa cabeza más grande.
No todos los modelos traen la misma capacidad: algunos manejan 200 mil tokens, otros hasta 1 millón. De qué depende eso y cómo elegir con criterio es tema del módulo 6 — por hoy, quédate con la idea de que el tamaño varía.
Ese espacio donde Claude va guardando tokens mientras trabaja contigo tiene nombre técnico: ventana de contexto (context window). Pero en este manual le vas a decir como se le dice en la casa, porque es el nombre que se entiende sin pensarlo dos veces:
Es LA MESA de trabajo. Todo lo que Claude lee (tu mensaje, los archivos que abre, lo que ya han platicado) y todo lo que escribe (sus respuestas, los archivos que crea) se pone ENCIMA de la mesa. La mesa tiene tamaño fijo. Mientras quepa, Claude ve con la misma claridad lo de hace cinco minutos y lo de hace una hora. El problema empieza cuando se llena: algo se tiene que caer para que quepa lo nuevo.
¿Cómo sabes qué tan llena está tu mesa AHORA MISMO? Hay un comando para eso.
Teclea (o pega) esto, DENTRO de una sesión de Claude Code:
/contextVas a ver algo así:
Context usage
▓▓▓▓▓░░░░░░░░░░░░░░░░░░░ 22% (43,910 / 200,000 tokens)
System prompt + tools ~3,200
Messages ~40,710
Free space ~156,090Qué significa: la barra ES tu mesa. El porcentaje dice qué tanto está cubierta ahora mismo; el número de la derecha es el tamaño total según el modelo que traes activo.
Si en vez de eso ves números o etiquetas en otro orden: no pasa nada, las versiones nuevas reacomodan la pantalla seguido — el dato que te importa siempre es el porcentaje.
¿Te acuerdas del tablero del coche que viste en el módulo 1 —la barrita de SmartProcess que siempre está visible—? Una de las tres cosas que muestra sin que nadie pregunte es justo esta: cuánta mesa le queda a Claude. Se puede pedir como comando (/context) o dejarlo siempre a la vista — tú decides.
En el módulo 0 conociste cómo trabaja tu empleado nuevo: hace algo con las manos, mira cómo quedó, decide qué sigue, y repite hasta terminar. Ya lo viviste en carne propia en el módulo 1, cuando le pediste el inventario de Descargas y lo viste avanzar en pasos, no de un jalón. Hoy ese ciclo recibe su nombre técnico: loop agéntico (agentic loop).
El ciclo del empleado: lee → piensa → usa una mano (una herramienta) → mira el resultado → repite. No es una animación bonita — es LITERAL cómo Claude Code resuelve tu encargo. Por eso lo ves trabajar "en pasos": cada vuelta del ciclo es una decisión chica, tomada con lo que tiene sobre la mesa en ese instante.
Esto explica algo que quizás ya notaste: entre más vueltas da el ciclo —más archivos lee, más herramientas usa, más te pregunta y le contestas— más tokens se acumulan sobre la mesa. El ciclo no es gratis en espacio: cada vuelta escribe algo nuevo encima.
Aquí está la pieza que estabas esperando. Cuando la mesa se llena, Claude Code no puede seguir amontonando: tiene que hacer espacio. Y aquí es donde mucha gente se asusta sin necesidad, así que vamos claro, con dos comandos:
/compact — le pides que RESUMA lo que hay sobre la mesa. Se queda con la idea general de todo lo platicado, pero suelta el detalle fino (la redacción exacta, los pasos intermedios). Es lo que tú haces cuando resumes en tus notas una junta de dos horas: te quedas con las decisiones, no con cada palabra que se dijo.
/clear — mesa NUEVA. Arrancas una conversación de cero, sin nada de lo anterior encima. Se usa cuando ya cerraste una chamba y vas a empezar otra que no tiene nada que ver con la anterior.
Síntoma: "Corrí /clear y sentí que perdí toda la conversación para siempre."
Causa: el nombre suena definitivo, pero no lo es.
Salida: /clear NO borra nada de tu disco. Tu conversación anterior queda guardada, y la recuperas con /resume (lo dominamos a fondo en el módulo 4) — ábrelo, elige la sesión de la lista, y ahí sigue completa. /clear es "mesa nueva", no "documento destruido".
Síntoma: "Hice /compact y ahora Claude ya no se acuerda de un dato que sí necesitaba."
Causa: el resumen prioriza la idea general — un dato suelto (un número, un nombre poco repetido) se puede quedar fuera.
Salida: no hay forma de "deshacer" un /compact para recuperar el detalle exacto. Por eso la regla de este módulo es aterrizar lo importante en archivo ANTES de resumir, no después. Si ya pasó, vuelve a pegarle el dato o el documento original.
Ahora, la pregunta de fondo: si /compact guarda solo lo general, ¿qué pasa con el detalle que sí te importaba? Ahí es donde entra la regla de este módulo:
Lo que de verdad importa no vive en la conversación — vive en un archivo. La mesa se puede resumir o vaciar; el disco no.
Tres cosas la llenan más rápido de lo que crees:
/clear es una mesa que solo crece.Nada de esto es un defecto: es simplemente cómo funciona el espacio. Ya sabes leer el número (/context) y ya sabes qué hacer cuando se acerca al límite.
Si esto te suena a chino, bríncatelo: no lo necesitas para seguir. Un detalle para quien ya trae ganas: cuando la mesa está a punto de llenarse SOLA, sin que tú corras nada, algunos modelos se auto-resumen para no trabarse a media tarea — es una red de seguridad del sistema, no un reemplazo de tu propio /compact a tiempo. Mejor decide tú CUÁNDO resumir, en vez de que la mesa decida por ti a la mitad de algo importante.
En la constitución de la casa —las reglas escritas que dirigen al socio-agente de SmartProcess AI— hay una línea que resume todo este módulo: "aterrizo decisiones y estado en archivos TEMPRANO — lo escrito en disco no se pierde." No espera a que la mesa esté a punto de reventar: apenas se decide algo que importa, se escribe. Esa misma disciplina es justo lo que vas a practicar en el HAZLO TÚ de hoy.
Qué vas a lograr: ver con tus propios ojos cómo se llena la mesa, comprobar qué sobrevive a un /compact, y aterrizar lo importante en un archivo antes de confiarlo solo a la conversación.
Qué necesitas: Claude Code instalado (módulo 1) y el documento de práctica de este módulo, contrato-dummy.md (un contrato ficticio, sin validez legal, hecho para este ejercicio).
Pasos:
contrato-dummy.md dentro de ~/Curso-Claude/ y párate ahí:Teclea (o pega) esto:
cd ~/Curso-Claude && claudeVas a ver: el prompt de Claude Code, esperando tu primer mensaje.
Qué significa: estás en la misma carpeta del módulo 1, lista para trabajar.
Si en vez de eso ves no such file or directory: te falta el paso 1 del HAZLO TÚ del módulo 1 (mkdir -p ~/Curso-Claude).
Lee contrato-dummy.md y dame un resumen de media página: quiénes son las partes, de qué trata, y las 3 cláusulas a las que le pondrías más atención si fueras el Cliente.
Teclea (o pega) esto:
/contextVas a ver algo así:
Context usage
▓▓▓░░░░░░░░░░░░░░░░░░░░░ 12% (24,300 / 200,000 tokens)Qué significa: ese porcentaje es tu punto de partida.
/context otra vez y compara contra el número del paso 3:Teclea (o pega) esto:
/contextVas a ver algo así:
Context usage
▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░ 44% (88,600 / 200,000 tokens)Qué significa: subió contra el número que apuntaste en el paso 3 — esas 3 preguntas y sus respuestas se quedaron sobre la mesa.
Teclea (o pega) esto:
/compactVas a ver algo así:
Compacting conversation...
✔ Context compacted: 61,200 → 8,400 tokensQué significa: Claude resumió toda la charla en un párrafo interno y liberó la mesa. La conversación sigue viva — solo más ligera.
¿Cómo se llaman exactamente el Prestador y el Cliente, con su razón social completa?
Compáralo contra el original (Cláusula 1: "Servicios Creativos del Bajío, S.A. de C.V." y "Distribuidora El Colibrí, S. de R.L."). Si acertó, sobrevivió al resumen. Si dudó o inventó, acabas de ver con tus ojos qué se pierde en un /compact — y por qué importa la regla de hoy.
Aterriza las 3 decisiones más importantes de esta conversación en un archivo nuevo, decisiones.md, en esta misma carpeta.
¿LO LOGRASTE?
/context subir entre el paso 3 y el paso 5./compact.decisiones.md en tu carpeta, y las 3 decisiones que anotó sí se hablaron en la charla./compact y /clear — y cuándo usarías cada uno?token — el pedacito en que Claude corta el texto; en tokens se mide espacio y costo.
ventana de contexto — la mesa de trabajo: todo lo que la conversación carga en este momento.
loop agéntico — el ciclo lee → piensa → usa una herramienta → mira el resultado → repite.
/compact — resume la conversación para liberar mesa sin perder el hilo general.
/clear — mesa nueva: conversación limpia (la anterior no se borra, queda accesible con /resume).
La demo de 5 minutos: en vivo, pega un documento largo (o usa el contrato de práctica), corre /context frente al grupo, sigue platicando 4-5 turnos, y vuelve a correr /context para que VEAN el número subir. Luego /compact y pregunta el detalle del principio delante de todos — que el grupo apueste si sobrevive antes de que Claude conteste.
El error que el alumno VA a cometer: correr /clear pensando que es "borrar todo de verdad" y preguntar angustiado si perdió la mañana completa. Provócalo a propósito y muéstrales /resume recuperando la sesión — el susto enseña mejor que la explicación.
La pregunta de arranque: "¿Alguna vez sentiste que Claude 'se le olvidó' algo que le dijiste hace rato? Hoy vas a ver EXACTAMENTE por qué pasa, y vas a dejar de pelearte con ello."
Verificado contra documentación oficial el 2026-07-12.