Por qué tu Claude termina como el burro de Shrek
Abres Claude Code, el Claude que trabaja con los archivos de tu computador. La primera hora va como Einstein. A las tres horas se salta lo que le pides y repite errores que ya le corregiste.
El modelo es el mismo. Pesa todo lo que se acumuló en la sesión, la conversación que dura hasta que la cierras. Según Anthropic, el rendimiento baja a medida que se llena.
Se queda en la sesión
Cada mensaje, cada archivo que Claude lee y cada resultado.
Correcciones como tope
Si corriges lo mismo más de dos veces, Anthropic recomienda empezar limpio.
Lo que cuesta limpiar
Vaciar la sesión con /clear no gasta. Resumirla sí.
Uno · contexto podrido, la pila de hojas
Todo lo que Claude tiene en cuenta en una conversación se llama contexto. Cada mensaje cae ahí como una hoja más, y la pila no se vacía sola.
Mueve las horas de sesión y mira qué pasa con la primera instrucción que le diste:
Una sesión larga en la web de una panadería
Tú, ahoraCambia los precios del pan.
ClaudeListo: cambié los precios del pan y de paso ajusté el logo.
Se saltó tu primera instrucción.
- Tú: ahora cambia los precios del pan
- Intento 4 del carrusel
- Tú: otra vez, sin decimales
Con 3 horas: 19 hojas en la pila y tu primera instrucción debajo de 18.
Dos · compactar, la prensa del cubito
Con /compact, Claude resume la conversación para liberar espacio. Sigues en la misma sesión, más liviana.
El problema: el resumen se queda ocupando lugar, y lo que no entra en él se pierde. Le puedes decir qué conservar, pero el cubito sigue en la espalda. Y resumir también gasta: para hacerlo, Claude lee toda la conversación.
Baja la prensa con y sin instrucciones:
La misma sesión, antes y después de compactar
/compact
Quedó en el resumen
- Objetivo: la web de la Panadería Doña Rosa
- Archivos: menu.html y estilos.css
- El carrusel falló tres veces
- Pendiente: el botón de pagos
Se quedó por fuera
- DecisiónLos precios van sin decimales hacía falta
- CorrecciónNo toques el logo hacía falta
- CharlaTres versiones del título no hacía falta
El resumen quedó en la sesión y dos hojas importantes se quedaron por fuera: la decisión de los precios y la corrección del logo.
Tres · limpiar el contexto, el borrador
/clear abre una conversación nueva, vacía. No gasta nada y Claude queda liviano. Lo que vive en archivos se queda; la conversación se va, y con ella qué estabas haciendo y por qué.
Borra la pizarra y pregúntale a la sesión nueva:
La pizarra de la sesión
Contexto vacío. Los archivos del proyecto siguen en la carpeta.
Pregúntale:
Tú¿Qué estábamos haciendo?
Sesión nuevaEn esta conversación no hay nada sobre eso. ¿Me cuentas en qué vamos?
Sesión nueva y vacía, sin handoff: lo que hacías se fue con la conversación.
Cuatro · handoff, pasar el relevo
Antes de cerrar, le pides a Claude un handoff.md: un archivo de texto con cinco puntos. Handoff es pasar el relevo, como el testigo en una carrera. Abres una sesión nueva y le dices que lo lea y siga.
Abre cada punto. El ejemplo es la web de una panadería:
La plantilla con tus cinco puntos
- EjemploLa web de la Panadería Doña Rosa,para recibir pedidos y pagos en línea.
Si falta: La sesión nueva empieza preguntando lo básico otra vez.
- EjemploMenú con 12 productos y precios.Fotos en la portada.Revisado en el celular.
Si falta: Repite trabajo que ya estaba listo.
- Ejemplo1. Botón de pagos.2. Horario en el pie de página.3. Revisar en el computador.
Si falta: Sigue por donde no era.
- EjemploPrecios sin decimales: así los muestra la panadería.El logo no se toca: es el de la marca.
Si falta: Vuelve a abrir discusiones que ya cerraste.
- Ejemplomenu.html: productos y precios.estilos.css: colores de la marca.fotos/portada.webp: foto nueva.
Si falta: Revisa todo el proyecto para encontrar los cambios, y eso gasta.
Los cinco puntos abiertos: así queda el handoff.md completo.
Hazlo tú · los dos prompts
Al cerrar, pide el handoff
Cuando la sesión empiece a fallar, o antes de irte, copia el primer prompt y mándalo en esa misma sesión.
Abre una sesión limpia
Escribe /clear o abre Claude Code otra vez en la misma carpeta. El archivo sigue ahí.
Pídele que lo lea y siga
Copia el segundo prompt. Antes de tocar nada, te resume en tres líneas en qué va el trabajo.
Antes de cerrar esta sesión, escribe un archivo handoff.md en la carpeta del proyecto con cinco partes:
- Objetivo: qué estamos haciendo y para qué.
- Qué quedó hecho: lo terminado y probado.
- Qué falta: los pendientes, en orden.
- Decisiones tomadas: qué decidimos y por qué, para no volver a discutirlo.
- Archivos tocados: cada archivo que cambiaste y qué le cambiaste.
Escríbelo para alguien que no vio esta conversación. Si algo no quedó probado, dilo.
Antes de cerrar esta sesión, escribe un archivo handoff.md…
Listo: handoff.md quedó en la carpeta del proyecto.
## Objetivo
## Qué quedó hecho
## Qué falta
## Decisiones tomadas
## Archivos tocados
Dale «Probar» para verlo en la terminal.
Cuál uso: compactar, limpiar o pasar el relevo
Cada una sirve para un momento distinto. Escoge en estos cuatro casos:
¿Qué harías?
- Caso 1
- Caso 2
- Caso 3
- Caso 4
Caso 1 de 4
Terminaste la web de la panadería. Ahora vas a escribir un correo que no tiene nada que ver.
Escoge una de las tres.
Lo que tienes que recordar
El relevo, de una sesión a la otra
Sesión larga
Llena y torpe. Antes de cerrarla, pides el handoff.
handoff.md
- 1. Objetivo
- 2. Qué quedó hecho
- 3. Qué falta
- 4. Decisiones tomadas
- 5. Archivos tocados
Sesión nueva
/clear y le dices: «Lee handoff.md y sigue».
- La sesión larga se pone torpe por todo lo que acumula, no por el modelo.
/compactresume, pero el resumen sigue en la sesión y algo se puede quedar por fuera./clearvacía todo, también lo que estabas haciendo.- Antes de cerrar: handoff.md con objetivo, qué quedó hecho, qué falta, decisiones tomadas y archivos tocados.
- En la sesión nueva: «Lee handoff.md y sigue».
Fuentes oficiales
Consultadas el 22 de octubre de 2026.
- Buenas prácticas de Claude Code: manejar el contexto
- Comandos de Claude Code: /clear y /compact
- Costos de Claude Code: por qué una sesión larga gasta más
Qué viene después
Si te quedó alguna duda concreta: comenta HANDOFF en el Reel o escríbeme por DM en @santaia.lab.