La mayoría de las personas que usan Claude Code están ignorando el único archivo que la IA siempre lee antes de comenzar cualquier tarea.
Ese archivo se llama "CLAUDE.md".
La documentación oficial de Anthropic lo indica claramente: si existe un archivo CLAUDE.md en la carpeta, Claude Code siempre lo cargará antes de comenzar a trabajar, incluso si no se lo pides.
En otras palabras, lo que escribas aquí cambia el comportamiento inicial de la IA en un 100%. Mientras que tienes que volver a escribir los prompts cada vez, CLAUDE.md funciona en todas las conversaciones una vez que está escrito.
El apalancamiento está en otro nivel.
Por el contrario, a menos que organices este archivo, no importa cuánto perfecciones tus prompts, los beneficios serán casi nulos. La IA se desviará cada vez. Tendrás que re-explicar las premisas cada vez. Incluso para la misma tarea, la calidad variará de un día a otro. La causa no es el modelo ni tu habilidad para escribir prompts, es este archivo.
Hoy, voy a revelar exactamente "qué y cómo escribir" en CLAUDE.md, incluyendo ejemplos que puedes copiar y pegar.
Para quienes tienen un rendimiento bajo, CLAUDE.md es solo una "nota"
Para ser honesto, yo también tuve dificultades al principio.
Durante un tiempo en X, había muchos artículos que decían "el contenido de las carpetas es importante" o "CLAUDE.md es importante". Los vi y abrí mis carpetas.
El contenido era un desastre.
No sabía qué estaba dónde. Datos similares estaban dispersos por todas partes. La IA no podía encontrar el conocimiento que necesitaba, y cada vez que generaba una respuesta, no era la respuesta que quería.
CLAUDE.md era igual. Las reglas sobre dónde guardar qué no estaban definidas. Ni siquiera entendía qué era CLAUDE.md en primer lugar. Así que me limitaba a añadir instrucciones desde arriba a medida que se me ocurrían.
Como resultado, creció hasta 300 o 400 líneas. Superaba fácilmente las 200 líneas.
Se recomienda mantener CLAUDE.md con un máximo de 200 líneas.
Un CLAUDE.md demasiado largo se convierte en un "texto extenso donde la IA no sabe qué es importante".
En este estado, la IA relee el archivo completo cada vez e intenta adivinar: "Entonces, ¿qué parte aplica para esta tarea?". Cuando hay adivinanzas, la inconsistencia aparece. Naturalmente.
CLAUDE.md no es un "bloc de notas". Es un "mapa para la toma de decisiones" al que la IA recurre cada vez. Cambiar tu percepción de esto es la mitad de la batalla.
Escribe solo estas 5 cosas en CLAUDE.md
No necesitas complicarlo demasiado. Un centro de comando sólido invariablemente contiene estos cinco elementos:
- ① Reglas prioritarias: La declaración principal que debe seguirse antes de cualquier resultado
- ② Tabla de enrutamiento Palabra clave → Ubicación: Qué trabajos van a dónde
- ③ Árbol de decisión para ubicaciones: Cómo evaluar elementos que no están en la tabla
- ④ Manejo de tareas: Cómo y dónde registrar lo que necesita hacerse
- ⑤ Manejo de información confidencial: Establecer el límite sobre lo que no debe compartirse
Cuando estos cinco están en su lugar, la IA deja de "adivinar" y comienza a "consultar". La raíz de la inconsistencia desaparece.
Ahora, veamos cómo escribir cada uno con ejemplos reales.
Configuración ① Declara las "Reglas prioritarias" al inicio
Lo primero que debes escribir es una declaración para fijar el movimiento inicial de la IA. Es una advertencia: "Antes de pensar, sigue primero las reglas a continuación".
▼ Ejemplo de escritura
Prioridad: Antes de generar o guardar algo, verifica siempre las reglas a continuación antes de actuar. Las ubicaciones deben decidirse usando la "Tabla de palabras clave" y el "Árbol de decisión" que se muestran abajo. Si no puedes decidir, no continúes por tu cuenta; haz una pregunta.
Con solo colocar esto al inicio, la IA deja de "simplemente mover las manos". Comienza a verificar las reglas cada vez antes de actuar. Esto fija el punto de partida.
Configuración ② Incluye una tabla de mapeo "Palabra clave → Ubicación"
Lo siguiente más efectivo es una tabla de distribución de trabajo. Vincula "si llega esta solicitud, ponlo aquí/búscalo aquí" usando palabras clave.
▼ Ejemplo de escritura
Palabra clave → Ubicación ・Blogs/Artículos → Publicación/Blog/ ・Gastos/Recibos → Contabilidad/Comprobantes/ ・Actas/Notas de reuniones → Registros/Actas/
El truco es escribirlo exactamente con las palabras que usas normalmente. La IA mira las palabras en la tabla y puede elegir la ubicación sin dudar.
El consejo para el eje de distribución es cortar por "función (tarea)" en lugar de por "negocio". De esta manera, incluso si aumentan los negocios o productos, la tabla no se romperá.
Configuración ③ Incluye un "Árbol de decisión" para cuando se pierde ← Esto es lo más efectivo
De los cinco, este tiene el mayor impacto. Cómo manejar cosas que no están en la tabla o que son ambiguas.
Tanto los humanos como la IA se detienen cuando están perdidos. Se desvían porque están perdidos. Así que simplemente elimina el margen para la duda. Haz que sigan un camino de SÍ/NO desde el principio.
▼ Ejemplo de escritura
Antes de guardar, sigue estos pasos en orden: P1. ¿Es información confidencial (claves API/contraseñas)? → SÍ: Ve a .env. Fin. P2. ¿Son datos sin procesar recién descargados de afuera? → SÍ: Ve a Activos/. P3. ¿De qué trabajo se trata? → Ve a uno de: Publicación / Ventas / Contabilidad / Registros. → Si no se puede determinar una única ubicación al final, no continúes; haz exactamente 2 preguntas.
Entonces, ¿cómo cambia el comportamiento antes y después de añadir un árbol de decisión? Específicamente, de dos maneras.
Cambio 1: Realiza la misma acción para la misma solicitud cada vez.
Claude Code opera con probabilidades. No recuerda la conversación anterior cuando el chat cambia. Así que sin un árbol de decisión, incluso para la misma solicitud de "guardar las actas", fluctúa.
Sin un árbol de decisión:
- 1ª vez → Guardado en Reunión/
- 2ª vez → Memo/Actas/
- 3ª vez → Por alguna razón, la carpeta Activos
Con un árbol de decisión:
- Cada vez sigue el mismo camino: P1→P2→P3 → Siempre el mismo lugar
El comportamiento cambia de "fluctuación probabilística" a un "procedimiento fijo". La reproducibilidad significa que puedes construir sobre ella.
Cambio 2: Deja de cometer errores con exceso de confianza cuando está perdido.
El comportamiento más aterrador de la IA es "estar equivocada con confianza". Como tirar una grabación de video y las actas hechas a partir de ella en el mismo lugar.
- Forzándolo a pasar adivinando → ❌
- Deteniéndose y verificando con 2 preguntas → ✓
La última línea es sutilmente efectiva. Con solo escribir "Si no puedes decidir, no te apresures, pregunta", reduces estructuralmente la producción en masa de entregables fuera de objetivo.
Cuanto más inteligente es la IA, mejor se desempeña cuando se le da una "plantilla" en lugar de libertad total.
Configuración ④ y ⑤ Manejo de tareas y Confidencialidad
Los dos restantes pueden ser cortos. Pero debes escribirlos.
④ Fija "dónde y cómo dejar" las tareas. Sin esto, las cosas por hacer se dispersan con cada conversación.
▼ Ejemplo de escritura
Manejo de tareas ・Consolida todas las tareas pendientes en un solo archivo "tareas.md". ・Cuando termines, no elimines; muévelo a "Completado" y deja un resultado de 1 línea.
⑤ Escribe los límites para la información confidencial con claridad. Esta es la línea de vida para la prevención de accidentes.
▼ Ejemplo de escritura
Información confidencial ・Escribe las claves API/contraseñas solo en .env. ・Nunca las pegues en chats, código o registros.
Con estos dos, las tareas no se dispersan, y las cosas que no deberían salir se quedan dentro. Funcionan como tus dos escudos defensivos.
Mantén CLAUDE.md "con menos de 200 líneas". Si se desborda, muévelo a otro archivo.
Algunos de ustedes se habrán dado cuenta de que si escriben todo en CLAUDE.md, se hará cada vez más largo.
Eso es correcto. Esto es importante. Si haces CLAUDE.md demasiado largo, en realidad se vuelve menos efectivo. Dado que la IA lo lee de principio a fin cada vez, si es demasiado largo, la sensación de "qué es importante" se diluye.
La pauta es menos de 200 líneas.
Si no cabe, mueve las reglas detalladas a un archivo separado (por ejemplo, "reglas_detalle.md"). Luego, al inicio de CLAUDE.md, da instrucciones sobre "cuándo leerlo".
▼ Ejemplo de escritura (Solo añade una línea a la declaración inicial)
Prioridad: Antes de generar/guardar, sigue siempre las reglas a continuación. Lee "reglas_detalle.md" solo cuando estés escribiendo una publicación de blog.
El truco aquí es añadir una condición como "solo cuando..." en lugar de "leer siempre". De esta manera, la IA no abrirá ese archivo para tareas no relacionadas, pero para tareas necesarias, irá "CLAUDE.md → reglas_detalle.md".
Esto mantiene el cuerpo principal delgado mientras te permite añadir tantas reglas detalladas como quieras. El punto es hacerlo un sistema de llamada bajo demanda.
CLAUDE.md es la "Entrada y el Comandante", y los detalles son "Llamar a archivos separados". Si recuerdas esta división de roles, tus reglas no colapsarán sin importar cuánto aumenten.
Para ser honesto, no se convertirá en una bestia diferente de inmediato
Voy a ser honesto aquí.
Reorganicé un desastre de 300-400 líneas en 5 bloques. Después de eso, lo primero que sentí no fue un "cambio dramático".
Primero, simplemente dejó de perderse. Eso es todo.
El mundo no cambia de inmediato. Surge gradualmente. Devuelve el mismo movimiento para la misma solicitud, los resultados fuera de objetivo disminuyen y el conocimiento se acumula. Antes de que te des cuenta, se mueve como una bestia diferente. Así es como funciona.
Si esperas magia llamativa, te decepcionarás. Pero la reproducibilidad definitivamente se acumulará.
Resumen: Para quienes piensan que hacer todo es una molestia
No le des demasiadas vueltas. Lo que necesitas hacer hoy es abrir tu CLAUDE.md (o crearlo si no lo tienes). Eso es todo.
Para aquellos que encuentran que hacer todo es una molestia, aquí está la lista de prioridades con estimaciones de tiempo:
- Primeros 5 min: Escribe 3 preguntas para el ③ Árbol de decisión (Mayor impacto)
- +7 min: Añade las ① Reglas prioritarias y la ② Tabla de enrutamiento
- +3 min: Añade los límites de ④ Tarea y ⑤ Confidencialidad
Total 15 minutos. Esto los alineará en el orden ①→②→③→④→⑤. Si parece que superará las 200 líneas, mueve los detalles a un archivo separado y haz que se lea desde el inicio. Eso es todo.
No necesitas sobrecargarlo. Solo organízalo. Con solo esto, el mismo Claude Code que estabas usando ayer comenzará a moverse como algo completamente diferente.
Las personas que quieren mejorar el rendimiento de Claude Code siempre buscan técnicas de prompts. Pero el verdadero apalancamiento está más arriba. Es el único archivo que la IA lee primero cada vez.
La diferencia entre el 5% superior y el 95% restante no es el talento ni la habilidad para hacer prompts. Es simplemente si organizaron un archivo CLAUDE.md o lo dejaron intacto.
Comienza copiando y pegando las 3 preguntas del árbol de decisión de este artículo.
Finalmente
Finalmente, déjame confesar una cosa.
Las diapositivas que suelo publicar están todas hechas por IA. Ya no tengo ni una sola diapositiva hecha a mano.
Y hoy, estoy regalando la IA que puede hacerlas con esa misma calidad.
Si has leído hasta aquí, probablemente ya te has dado cuenta. Todo lo que he estado hablando en este artículo se reduce a una cosa:
"No dejes que la IA se pierda."
La IA no falla porque su capacidad sea baja. Falla porque está perdida.
Dale contexto. Diseña las instrucciones. No dejes espacio para que la IA dude. En otras palabras, edúcala como una secretaria. En este artículo, hicimos eso con Claude Code.
Lo que voy a distribuir es un ChatGPT GPTs. Solo para aclarar: el texto principal trataba sobre Claude Code, y esto es un ChatGPT GPTs. Las herramientas son diferentes.
Pero la raíz es la misma. Lo que se necesita no es tecnología. Es solo un diseño que no deje que la IA se pierda.
Este GPTs es un producto terminado que lleva esa filosofía al límite en el área única de "creación de diapositivas". Ya he terminado todo el trabajo de diseñar el contexto.
Te lo garantizo. Todo lo que haces es escribir el tema. Después de eso, el GPTs cuidadosamente diseñado generará diapositivas sin dudar.
El artículo que presentó este GPTs por primera vez registró 400,000 impresiones. Así de muchas personas reaccionaron, diciendo "esto es diferente".
https://x.com/masaki_aihack/status/2068646555524223366
Y por tiempo limitado, estoy regalando un paquete de "20 bonificaciones" que incluye este GPTs.
La forma de recibirlo es simple. Comienza uniéndote al Open Chat de LINE a continuación.
Seré honesto: este GPTs no se terminó de inmediato. Fallé más de 50 veces. Tomó una semana finalmente lograr un punto en el que "cualquiera pueda usarlo". Estoy regalando ese manual tal cual.
Déjame decirlo una vez más. Lo que se necesita no es tecnología. Es solo el ingenio para no dejar que la IA se pierda.
¿Por qué no terminar hoy con el agotamiento de hacer diapositivas?
