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 lo cargará siempre antes de empezar a trabajar, incluso si no se lo pides.
En otras palabras, lo que escribas aquí cambia el comportamiento inicial de la IA al 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, por mucho que perfecciones tus prompts, los beneficios serán casi nulos. La IA se desviará cada vez. Tendrás que reexplicar 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 hacer prompts, sino este archivo.
Hoy revelaré exactamente «qué y cómo escribir» en CLAUDE.md, incluyendo ejemplos que puedes copiar y pegar.
Para quienes tienen un rendimiento pobre, CLAUDE.md es solo una «nota»
Para ser sincero, yo también tuve problemas 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 salida, no era la respuesta que yo 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 según 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 en un máximo de 200 líneas.
Un CLAUDE.md demasiado largo se convierte en un «texto largo donde la IA no sabe qué es importante».
En este estado, la IA relee todo el archivo cada vez e intenta adivinar: «Entonces, ¿qué parte de esto aplica a esta tarea?». Cuando hay conjeturas, la inconsistencia es inevitable. Naturalmente.
CLAUDE.md no es un «bloc de notas». Es un «mapa para el juicio» al que la IA se refiere 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 mando sólido siempre contiene estos cinco elementos:
- ① Reglas prioritarias: La declaración principal que debe seguirse antes de cualquier salida
- ② Tabla de enrutamiento Palabra clave → Ubicación: Qué trabajos van a dónde
- ③ Árbol de decisión para ubicaciones: Cómo juzgar elementos que no están en la tabla
- ④ Gestión de tareas: Cómo y dónde registrar lo que hay que hacer
- ⑤ Gestión de información confidencial: Establecer el límite de lo que no debe compartirse
Cuando estos cinco están en su sitio, la IA deja de «adivinar» y empieza 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 principio
Lo primero que hay que escribir es una declaración para fijar el movimiento inicial de la IA. Es una advertencia: «Antes de pensar, sigue primero las reglas de abajo».
▼ Ejemplo de escritura
Prioridad: Antes de generar o guardar algo, revisa 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 aparecen más abajo. Si no puedes decidir, no actúes por tu cuenta; haz una pregunta.
Con solo colocar esto al principio, la IA deja de «mover las manos sin más». Empieza a comprobar 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í / mira aquí» usando palabras clave.
▼ Ejemplo de escritura
Palabra clave → Ubicación ・Blog/Artículos → Publicación/Blog/ ・Gastos/Recibos → Contabilidad/Comprobantes/ ・Actas/Notas de reuniones → Registros/Actas/
El truco está en escribirlo exactamente con las palabras que usas normalmente. La IA mira las palabras de la tabla y puede elegir la ubicación sin dudar.
El consejo para el eje de distribución es dividir por «función (tarea)» en lugar de por «negocio». Así, aunque aumenten los negocios o productos, la tabla no se romperá.
Configuración ③ Incluye un «Árbol de decisión» para cuando se pierda ← Esto es lo más efectivo
De los cinco, este tiene el mayor impacto. Cómo manejar lo que no está en la tabla o lo que es ambiguo.
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 arriba.
▼ 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 brutos recién descargados del exterior? → SÍ: Ve a Assets/. P3. ¿De qué trabajo se trata? → Ve a uno de: Publicación / Ventas / Contabilidad / Registros. → Si al final no se puede determinar una única ubicación, no actú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 en base a probabilidades. No recuerda la conversación anterior cuando cambia el chat. Así que, sin un árbol de decisión, incluso para la misma solicitud de «guardar el acta», fluctúa.
Sin un árbol de decisión:
- 1ª vez → Guardado en Meeting/
- 2ª vez → Memo/Actas/
- 3ª vez → Por alguna razón, la carpeta Assets
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 ello.
Cambio 2: Deja de cometer errores por exceso de confianza cuando está perdido.
El comportamiento más aterrador de la IA es «estar equivocada con confianza». Como meter una grabación de video y las actas hechas a partir de ella en el mismo sitio.
- Forzar el camino adivinando → ❌
- Detenerse y comprobar 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 masiva de resultados fuera de lugar.
Cuanto más inteligente es la IA, mejor funciona cuando se le da una «plantilla» en lugar de total libertad.
Configuración ④ y ⑤ Gestión de tareas y confidencialidad
Las dos restantes pueden ser breves. Pero debes escribirlas.
④ Fija «dónde y cómo dejar» las tareas. Sin esto, las cosas por hacer se dispersan con cada conversación.
▼ Ejemplo de escritura
Gestión de tareas ・Consolida todas las tareas pendientes en un único archivo «tasks.md». ・Al terminar, no las borres; muévelas a «Completado» y deja una línea con el resultado.
⑤ Escribe claramente los límites de la información confidencial. 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 estas dos, las tareas no se dispersan y las cosas que no deben salir se quedan dentro. Funcionan como tus dos escudos defensivos.
Mantén CLAUDE.md en «menos de 200 líneas». Si se desborda, muévelo a otro archivo.
Algunos os habréis dado cuenta de que si escribes todo en CLAUDE.md, cada vez será más largo.
Eso es correcto. Esto es importante. Si haces CLAUDE.md demasiado largo, en realidad se vuelve menos efectivo. Como 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 principio de CLAUDE.md, da instrucciones sobre «cuándo leerlo».
▼ Ejemplo de escritura (Solo añade una línea a la declaración superior)
Prioridad: Antes de generar/guardar, sigue siempre las reglas a continuación. Lee «reglas_detalle.md» solo cuando escribas una entrada de blog.
El truco aquí es añadir una condición como «solo cuando...» en lugar de «leer siempre». Así, la IA no abrirá ese archivo para tareas no relacionadas, pero para las tareas necesarias, irá «CLAUDE.md → reglas_detalle.md».
Esto mantiene el cuerpo principal ligero mientras te permite añadir tantas reglas detalladas como quieras. El punto es convertirlo en un sistema de llamada bajo demanda.
CLAUDE.md es la «Entrada y el Comandante», y los detalles son «Archivos separados a los que llamar». Si recuerdas esta división de roles, tus reglas no colapsarán por mucho que aumenten.
Para ser sincero, no se convertirá en una bestia diferente de golpe
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 golpe. Se activa gradualmente. Devuelve el mismo movimiento para la misma solicitud, los resultados fuera de lugar 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 sin duda se acumulará.
Resumen: Para los que 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 tiempos estimados:
- Primeros 5 min: Escribe 3 preguntas para el ③ Árbol de decisión (Mayor impacto)
- +7 min: Añade ① Reglas prioritarias y ② Tabla de enrutamiento
- +3 min: Añade ④ Tareas y ⑤ Límites de confidencialidad
Total 15 minutos. Esto los alineará en el orden ①→②→③→④→⑤. Si parece que va a superar las 200 líneas, mueve los detalles a un archivo separado y haz que se lea desde arriba. Eso es todo.
No necesitas sobrecargarlo. Solo organízalo. Con solo esto, el mismo Claude Code que usabas ayer comenzará a moverse como si fuera otra cosa.
La gente que quiere mejorar el rendimiento de Claude Code siempre busca técnicas de prompting. 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 solo.
Empieza copiando y pegando las 3 preguntas del árbol de decisión de este artículo.
Finalmente
Por último, déjame confesar una cosa.
Las Slides que suelo publicar están todas hechas por IA. Ya no tengo ni una sola Slide hecha a mano.
Y hoy, estoy regalando la IA que puede hacerlas con esa mismísima calidad.
Si has llegado hasta aquí, probablemente ya te habrás dado cuenta. Todo de 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 a un secretario. En este artículo, lo hicimos con Claude Code.
Lo que voy a distribuir es un ChatGPT GPTs. Solo para asegurarme: 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 la única área de «creación de Slides». Ya he terminado todo el trabajo de diseñar el contexto.
Lo garantizo. Todo lo que haces es escribir el tema. Después, el GPTs meticulosamente diseñado escupirá Slides sin dudar.
El artículo que presentó este GPTs por primera vez registró 400.000 impresiones. Así de reaccionó la gente, diciendo «esto es diferente».
https://x.com/masaki_aihack/status/2068646555524223366
Y por tiempo limitado, estoy regalando un paquete de «20 bonos» que incluye este GPTs.
La forma de recibirlo es sencilla. Empieza uniéndote al LINE Open Chat de abajo.
Seré honesto: este GPTs no se terminó de una sola vez. Fallé más de 50 veces. Me llevó una semana finalmente conseguir que estuviera en 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 poner fin hoy al agotamiento de hacer Slides?
