Qué son los archivos .md que crean Claude Code y Codex

Actualizado: 2026-11-03

Si le encargas trabajo a un agente de programación por inteligencia artificial como Claude Code o Codex, empezarán a aparecer archivos que terminan en .md en tu proyecto. Al abrirlos con el Bloc de notas pueden parecer confusos, llenos de # y **. No pasa nada: son documentos en markdown, el mismo formato que usan los asistentes de IA para sus respuestas. Los agentes lo utilizan porque es texto plano que tanto las personas como la inteligencia artificial pueden leer.

Los archivos que probablemente verás

Archivo	Qué es
`README.md`	Explica qué es el proyecto y cómo ejecutarlo
`CLAUDE.md`	Instrucciones permanentes que Claude Code lee para el proyecto
`AGENTS.md`	Instrucciones permanentes para agentes, usadas por Codex y otros
`PLAN.md`, `TODO.md`, `NOTES.md`	Planes, listas de tareas y notas, cuando tú o el agente decidís conservarlos
`CHANGELOG.md`	Un registro de los cambios en cada versión

Aparte de los tres primeros, los nombres varían según el proyecto, así que lee uno si no estás seguro de para qué sirve.

Ten cuidado con CLAUDE.md y AGENTS.md. Si los modificas, cambiará el comportamiento del agente en ese proyecto. Leerlos siempre es seguro.

Por qué querrías leerlos

Estos archivos es donde el agente se explica: lo que planeó, lo que hizo y lo que falta. Si te los saltas, acabas dependiendo de un resumen en el chat. Además, suelen ser largos y se leen mejor lejos del escritorio que en una terminal.

Leerlos en tu móvil

Estas herramientas suelen ejecutarse en un ordenador, por lo que el archivo debe llegar primero a tu teléfono:

Envíate el archivo. Google Drive, un archivo adjunto de correo electrónico y un cable USB sirven.
En tu móvil, ábrelo con MD Reader: toca el archivo y elige MD Reader, o usa Abrir archivo en la aplicación.

Disponible en Google Play

Los encabezados, las tablas, los bloques de código con resaltado de sintaxis, las fórmulas matemáticas y los diagramas de Mermaid se muestran formateados. Los metadatos iniciales aparecen como una tarjeta y las etiquetas como <example>, que son habituales en los archivos de instrucciones, se muestran tal cual en lugar de desaparecer.

MD Reader no se sincroniza con tu ordenador ni se conecta a Claude Code o Codex. Lo que abres es la copia que enviaste. Vuelve a enviarla cuando el agente la actualice. Las instrucciones paso a paso están en cómo abrir archivos .md desde Google Drive.

Revisar una carpeta entera

Los agentes rara vez se quedan con un solo archivo. Con el espacio de trabajo de carpetas (próximamente en Pro), podrás copiar una carpeta a tu teléfono, abrirla, buscar en todos sus documentos y seguir enlaces entre ellos.

Cambiar un plan desde el móvil

Marca una casilla en una lista de tareas mientras lees y se guardará en el archivo de inmediato. Para cambiar texto, toca Editar y escribe directamente en la página con formato, sin símbolos que recordar (más información sobre la edición). Si el archivo procede de una aplicación que solo permite lectura, MD Reader te pedirá que guardes una copia. Para usar tus cambios en el proyecto, vuelve a enviar el archivo a tu ordenador.