Respuestas · 10 de noviembre de 2026
Qué son AGENTS.md y CLAUDE.md
Son archivos de texto con las instrucciones que un agente de IA lee solo cada vez que empieza a trabajar en una carpeta. AGENTS.md es un formato abierto que usan más de 60.000 proyectos y leen Codex y otras veinte herramientas; CLAUDE.md es el que lee Claude. Sirven para lo mismo: que le expliques una sola vez cómo se trabaja ahí.
¿Qué se escribe adentro?
Lo que le dirías a alguien que entra a trabajar con vos: qué leer primero, dónde se guarda cada cosa, cómo te gusta que te muestre el trabajo y qué puede hacer sin preguntar. Va en lenguaje corriente, sin formato especial.
Conviene que sea corto y que mande a leer el resto. El agente lo carga entero en cada sesión, así que lo que va ahí es lo que vale siempre; lo de una tarea puntual va mejor en su skill.
¿Cuál lee cada app?
Codex lee AGENTS.md: el de la carpeta del proyecto y los que encuentra hasta la carpeta donde está trabajando, según su documentación. Claude, en la pestaña Code de su app de escritorio y en la terminal, lee CLAUDE.md. Si en la carpeta no hay ningún CLAUDE.md, las versiones recientes leen el AGENTS.md en su lugar.
Un matiz para quien no programa: en Cowork, la otra vista de Claude que trabaja sobre carpetas, la documentación describe instrucciones por carpeta que se editan desde la app y, al 10 de noviembre de 2026, no menciona estos archivos. Ahí conviene pegar en esas instrucciones una línea que mande a leerlos.
¿Y si trabajo con las dos?
Tenés los dos y escribís en uno solo. Las instrucciones van en AGENTS.md, y el CLAUDE.md lleva una línea que lo trae: una arroba seguida del nombre del archivo. Claude sigue esa línea al arrancar y carga el contenido como propio. Así lo que cambies queda en un solo lugar.
¿Sirven fuera de la programación?
Sí. Nacieron para agentes que programan y funcionan igual en una carpeta de propuestas, informes o campañas. Lo que el agente necesita saber es lo mismo en cualquier oficio: de quién es el trabajo, cómo se hace y dónde queda.
¿Por dónde empiezo?
Por una carpeta que ya los trae escritos. Trama es gratis y viene con los dos archivos, pensados para un trabajo que no es de código: tu IA los lee, te pregunta de qué trabajás y arma el resto con vos. Cómo dar el primer paso está en cómo empezar a trabajar con un agente de IA sin saber programar.