Usá Claude Code como lo usan en Anthropic

Hay una sola causa detrás de casi todas las buenas prácticas oficiales, y Anthropic la dice sin vueltas: la ventana de contexto se llena rápido y el rendimiento se degrada a medida que se llena. Claude empieza a “olvidarse” de lo que le dijiste al principio y a equivocarse más. Todo lo que sigue existe para cuidar ese recurso.

📟 En criollo
Contexto = todo lo que Claude tiene “en la cabeza” en esta conversación: tus mensajes, cada archivo que leyó y la salida de cada comando que corrió. Es una pizarra de tamaño fijo: cuando se llena, hay que borrar. Y una pizarra sobrecargada se lee peor.

4pasos: explorar, planear, hacer, commitear
<200líneas ideales de CLAUDE.md
Oficialde Anthropic

01 Dale una forma de verificar su propio trabajo

Es la práctica que más cambia el resultado. Claude se detiene cuando el trabajo parece terminado; si no tiene una prueba que correr, “parece” es la única señal que existe — y el que verifica terminás siendo vos.

🧪 La analogía
Es la diferencia entre mandar a alguien a comprar y mandarlo con la lista. Sin lista vuelve con lo que le pareció; con lista, él mismo chequea antes de volver.

La “lista” puede ser cualquier cosa que dé un sí o un no: los tests, que el proyecto compile, o una captura de pantalla para comparar contra el diseño. En vez de “mejorá el dashboard”, la guía propone “implementá este diseño, tomá una captura del resultado, comparála con el original, listá las diferencias y corregilas”.

02 Primero explorar, después planear, recién ahí codear

✅ Cómo se hace
Explorar: apretá Shift+Tab hasta que abajo diga plan mode on. Ahí Claude lee y responde, pero no toca nada.
Planear: pedile un plan detallado de qué archivos cambia y por qué.
Implementar: aprobá el plan y dejalo trabajar contra ese plan.
Cerrar: pedile el commit con un mensaje descriptivo.

⚠️ Ojo con esto
La propia guía avisa que planear también cuesta. Si el cambio lo podés describir en una sola oración (“sacale la coma a ese título”), salteá el plan. El plan sirve cuando no estás seguro del enfoque, cuando toca varios archivos o cuando el código no lo conocés.

03 El archivo CLAUDE.md: corto o no sirve

CLAUDE.md es el archivo que Claude lee al empezar cada conversación. Se genera con /init y se afina a mano. La regla de oro de la guía para cada línea es: “¿si borro esto, Claude se equivocaría?”. Si la respuesta es no, se borra.

⚡ Tip del Tincho
Si Claude sigue haciendo algo que le prohibiste por escrito, el problema casi nunca es que “no entiende”: es que tu archivo es tan largo que la regla se perdió entre el ruido. Anthropic lo dice textual — un CLAUDE.md inflado hace que ignore tus instrucciones reales. Objetivo: menos de 200 líneas.

Va lo que Claude no puede adivinar: comandos de tu proyecto, convenciones que difieren de lo normal, cómo correr los tests, mañas de tu entorno. No va lo que puede deducir leyendo el código.

04 Manejá la sesión con la mano

Esc — frenálo apenas ves que agarró para el lado equivocado. El contexto se conserva.
Esc Esc o /rewind — volvé a un punto anterior de la conversación y del código.
/clear — pizarra limpia entre tareas que no tienen nada que ver entre sí.

⚡ Tip del Tincho
La regla de las dos correcciones: si ya lo corregiste dos veces por lo mismo y sigue sin salir, no insistas. El contexto quedó contaminado con los intentos fallidos. /clear y volvé a arrancar con un pedido mejor — una sesión limpia con buen prompt le gana casi siempre a una sesión larga llena de parches.

05 Las cinco trampas más comunes

La sesión cajón de sastre: mezclar tres tareas distintas en la misma charla. → /clear.
Corregir y corregir: ver arriba, la regla de las dos veces.
El CLAUDE.md inflado: tan largo que se ignora solo.
Confiar sin verificar: código que parece bien y no cubre los casos raros. Si no lo podés verificar, no lo publiques.
La exploración infinita: “investigá esto” sin acotar, y se come el contexto leyendo cien archivos. Acotá o mandalo con subagentes.