Un archivo llamado CLAUDE.md alcanzó el #1 en GitHub Trending.
82,000 estrellas. 7,800 bifurcaciones.
Todo comenzó con Andrej Karpathy. Exdirector de IA en Tesla. Miembro fundador de OpenAI. Identificó 4 comportamientos que hacen que Claude Code falle y los escribió en un solo archivo.
Un desarrollador tomó esas 4 reglas, las amplió y publicó el archivo. Se volvió viral.
La razón: la precisión de codificación pasó del 65 % al 94 %.
La mayoría de los desarrolladores que usan Claude Code a diario nunca lo han configurado. Empiezan desde cero en cada sesión. Vuelven a explicar el mismo contexto. Limpian cambios de alcance no deseados. Revierte refactorizaciones que nadie pidió.
Este es el archivo completo.
La configuración que la mayoría de los desarrolladores pasaron por alto
Cada vez que abres Claude Code, comienza sin nada.
No conoce tu stack. Tus estándares. El contexto de tu proyecto. Lo que ya has intentado. Lo que explícitamente decidiste no hacer hace tres sesiones.
Así que adivina. Y cuando adivina, refactoriza código que no le pediste que tocara. Sugiere frameworks que rompen tu arquitectura existente. Elimina archivos sin preguntar. Contradice decisiones que ya tomaste.
CLAUDE.md es un archivo de texto plano que colocas en la raíz de tu proyecto. Claude Code lo lee automáticamente al inicio de cada sesión.
Una configuración. Cero explicaciones repetidas. Tres categorías de errores costosos solucionados.
1 / 3 | VALORES PREDETERMINADOS: los $375/semana que gastas en repetirte
El desarrollador promedio dedica 30 minutos al día a reexplicar el contexto a Claude.
Stack. Estándares de codificación. Antecedentes del proyecto. Lo que ya se ha probado. Nada de eso persiste entre sesiones a menos que lo escribas una vez y dejes que Claude lo lea cada vez.
30 minutos al día a una tarifa de desarrollador de $150/hora: $375/semana. Por desarrollador.
Para un equipo de 5: $1,875/semana perdidos.
Estas 7 reglas van al inicio de tu archivo CLAUDE.md.
→ Elimina el relleno:
→ Ajusta la extensión según la tarea:
→ Muestra opciones antes de actuar:
→ Admite incertidumbre antes de que me cueste:
→ Quién soy y qué sé:
→ Contexto actual del proyecto:
→ Fija tu tono:
Tiempo dedicado a reexplicar el contexto por día: 30 min. A una tarifa de desarrollador de $150/hora: $75/día. Por semana: $375/semana por desarrollador. Equipo de 5: $1,875/semana. Configuración de CLAUDE.md para esta sección: 45 minutos en total.
Error a evitar: no escribas tu CLAUDE.md desde cero. Usa primero este prompt y luego edita el resultado:
2 / 3 | COMPORTAMIENTO: los cambios de $150/hora que no autorizaste
Le pides a Claude que arregle una función.
Él refactoriza tres archivos, renombra tus variables, reorganiza las importaciones y reescribe comentarios que dedicaste tiempo a redactar.
Todo sin preguntar.
1 hora para revisar y revertir cambios no deseados: $150. Tres veces por semana: $450/semana. Por desarrollador.
Para un equipo de 5: $2,250/semana gastados en limpiar cambios que nadie autorizó.
Estas 7 reglas van en la sección de comportamiento de tu CLAUDE.md.
→ Mantente dentro del alcance:
→ Pregunta antes de hacer cambios grandes:
→ Confirma antes de cualquier acción destructiva:
→ Paradas duras para producción:
→ Siempre muestra lo que cambió:
→ Nunca actúes sin confirmación explícita:
→ Piensa antes de escribir código:
1 hora/semana revirtiendo cambios de alcance no deseados: $150/semana. 30 min/semana haciendo diferencias manuales después de cada tarea: $75/semana. Desperdicio total relacionado con el comportamiento por desarrollador: $225/semana. Equipo de 5: $1,125/semana. Configuración de la sección de comportamiento de CLAUDE.md: 30 minutos.
3 / 3 | MEMORIA + STACK: la configuración que hace que Claude Code sea realmente confiable
Claude olvida todo entre sesiones.
Cada decisión que tomaste. Cada enfoque que falló. La razón por la que elegiste Prisma sobre Drizzle hace seis meses. La restricción que existe debido a un requisito específico del cliente.
Lo olvida. Luego sugiere exactamente lo que ya descartaste.
Esta sección le da a Claude lo más parecido a una memoria real que existe actualmente. Y fija tu stack tecnológico para que deje de proponer herramientas que rompan tu arquitectura existente.
→ Registro de decisiones de MEMORY.md:
→ Resumen de fin de sesión:
→ Registro de fallos de ERRORS.md:
→ Lista de hechos permanentes:
→ Fija tu stack tecnológico:
→ Pensamiento extendido para decisiones difíciles:
→ Las 4 reglas que se volvieron virales:
Karpathy identificó 4 comportamientos que hacen que Claude Code falle. Un desarrollador los destiló en estas 4 líneas. La precisión de codificación pasó del 65 % al 94 %.
2 horas/semana recuperándose de decisiones olvidadas y sugerencias incorrectas: $300/semana por desarrollador. Recomendaciones de stack incorrectas y herramientas incompatibles: $75/semana. Desperdicio total relacionado con la memoria por desarrollador: $375/semana. Equipo de 5: $1,875/semana. Configuración de MEMORY.md + ERRORS.md + stack: 20 minutos.
CONCLUSIÓN
Aquí están los números completos.
$375/semana reexplicando contexto en cada sesión. $225/semana revirtiendo cambios no autorizados. $375/semana recuperándose de decisiones olvidadas. Desperdicio total por desarrollador: $975/semana.
Equipo de 5 desarrolladores: $4,875/semana. Por año: $253,500.
Configuración de CLAUDE.md: 2 horas en total. Solo las 4 reglas de Karpathy: del 65 % al 94 % de precisión de codificación.
Un archivo de texto plano. 21 reglas. Dos horas de trabajo.
Los desarrolladores que configuraron esto están trabajando con una versión de Claude que recuerda decisiones, se mantiene dentro del alcance, confirma antes de destruir algo, nunca sugiere un framework que rompa tu arquitectura.
Los que no lo han hecho están gastando $975/semana para repetirse.
P.D.: Empieza con las 4 reglas de Karpathy. Solo esas 4. Pégalas en un archivo nuevo llamado CLAUDE.md en la raíz de tu proyecto ahora mismo. Toma 2 minutos. Agrega el resto una semana a la vez, según notes lo que falta.
Guarda esto antes de que se entierre. Si te fue útil, compártelo con alguien que lo necesite.
