Índice del artículo
- En 30 segundos
- Una instaladora necesita presupuestos revisables
- Qué debe contar tu archivo
- Dónde guardar CLAUDE.md
- Del archivo guardado a una entrega comprobada
- Cómo escribir reglas que puedas revisar
- Si alternas Claude Code y Codex
- Antes de pasar a documentos reales
- Dudas sobre archivos de instrucciones, respuestas cortas
En 30 segundos
CLAUDE.md guarda instrucciones que Claude Code carga al empezar; AGENTS.md sirve para herramientas compatibles, con reglas de lectura propias.
Empieza por una tarea concreta: qué debe preparar, dónde están los materiales y cómo revisarás la entrega. Aquí tienes una plantilla para copiar y comprobar con un presupuesto de muestra.
Escribir una regla orienta al agente, el programa que realiza pasos para resolver tu encargo. Los controles que bloquean accesos y acciones se configuran aparte.
Una instaladora necesita presupuestos revisables
Ejemplo ilustrativo: una instaladora de climatización de Sevilla quiere preparar borradores a partir de solicitudes y un catálogo aprobado. El comercial necesita saber de dónde sale cada partida y qué condiciones faltan. No quiere recibir un documento que parezca terminado si incluye un precio inventado. Este ejercicio usa documentos ficticios; no describe un cliente de Ciade ni resultados medidos.
El archivo conserva las reglas de ese trabajo para las siguientes sesiones. El encargo del día dice qué solicitud preparar; las instrucciones del proyecto dicen cómo tratar cualquier solicitud. Si necesitas situar el concepto antes de escribir, consulta qué es el archivo de instrucciones del proyecto. Crea uno que puedas revisar y probar. Antes de empezar necesitas Claude Code instalado y una cuenta compatible: el plan gratuito de Claude no lo incluye. Si aún no lo tienes, consulta cómo instalar Claude Code.
Qué debe contar tu archivo
Propósito
Define una entrega concreta: preparar un borrador de presupuesto para el comercial. Así puedes juzgar el resultado sin pedir a la herramienta que resuelva todo el negocio.
Materiales
Señala el origen autorizado: solicitudes ficticias y catálogo aprobado. Quien revise debe poder encontrar los documentos que sustentan cada partida del borrador.
Revisión
Describe una señal observable: cada precio identifica su archivo de origen. Si una partida no tiene respaldo, debe aparecer como pendiente, no como una propuesta cerrada.
Decisión humana
Nombra quién decide: el comercial valida importes, descuentos, condiciones y envío. El ejercicio termina con un borrador que esa persona puede aceptar o devolver.
Dónde guardar CLAUDE.md
Usa la carpeta del proyecto que vas a abrir con Claude Code. Para esta práctica, prepara una carpeta separada con solicitudes y un catálogo ficticios, además de un sitio para los borradores. Crea los materiales antes de pedir que los lea: escribir el nombre de una carpeta en las instrucciones no hace que exista. Organiza las solicitudes, el catálogo y los borradores como en la estructura siguiente.
Escribe texto normal, con títulos y frases breves. El formato Markdown permite organizarlo mediante encabezados que empiezan con una almohadilla. No necesitas inventar comandos de programación para un trabajo de documentos. El archivo debe describir los pasos y materiales que tu equipo utiliza de verdad. Si tu editor añade una extensión de texto, comprueba el nombre completo: CLAUDE.md.txt no es CLAUDE.md.
presupuestos-prueba/
├── CLAUDE.md
├── solicitudes/
├── catalogo-aprobado/
└── borradores/# Proyecto
Preparamos borradores de presupuestos para revisión del comercial.
## Dónde están los materiales
Lee solicitudes/ y catalogo-aprobado/ de esta carpeta de prueba.
Guarda los borradores en borradores/; conserva los originales.
## Cómo se comprueba
Identifica el archivo de origen de cada precio.
Si falta un precio o una condición, márcalo como pendiente.
Entrega un resumen de lo preparado y lo que queda por revisar.
## Decisiones humanas
El comercial valida importes, descuentos, condiciones y envío.
No envíes mensajes, compres material ni modifiques el catálogo.Del archivo guardado a una entrega comprobada
Prepara la práctica
Usa la carpeta de prueba. Añade una solicitud y un catálogo de muestra a las carpetas del ejemplo. Deja a propósito una partida fuera del catálogo: será la forma de comprobar qué hace cuando le falta información. Pide al responsable técnico que limite el acceso al entorno de prueba y que deje fuera correo y compras. No copies contraseñas, claves, facturas reales ni datos personales de clientes para hacer este ejercicio.
Guarda las instrucciones
Adapta la plantilla a tu caso. Sustituye el propósito y los materiales si tu caso es distinto, pero conserva una forma concreta de revisar la entrega. Guarda el archivo en la carpeta principal que abrirás con Claude Code. Vuelve a abrirlo para comprobar que contiene tus reglas y que el nombre es correcto. La herramienta puede preparar un borrador inicial, pero revisarlo sigue siendo tarea tuya: no aceptes comandos ni carpetas que tu proyecto no utiliza.
Comprueba la carga
Mira los archivos incorporados. Inicia Claude Code dentro de la carpeta de prueba y utiliza el comando de contexto que aparece debajo de estos pasos. Busca el apartado Memory files, donde aparecen los archivos de instrucciones, y comprueba que figura el del ejercicio. Esto verifica la carga, no la calidad del siguiente resultado. Si falta, revisa desde qué carpeta has abierto el proyecto y el nombre con el que lo has guardado antes de añadir más reglas.
Pide el borrador
Haz un encargo acotado. Pide que prepare el presupuesto de la solicitud ficticia usando el catálogo autorizado y las instrucciones del proyecto. No añadas en el mensaje el precio que has dejado fuera: quieres observar cómo trata ese hueco. El texto copiable de abajo es un punto de partida para el ejercicio, no una orden para enviar nada al cliente. Espera una entrega que puedas contrastar con los documentos de muestra.
Contrasta el resultado
Revisa el dato que falta. Abre el borrador y comprueba el origen de cada precio frente al catálogo. La partida ausente debe quedar pendiente, junto con cualquier condición que no aparezca en los materiales. Si ha completado el hueco por su cuenta, devuelve la entrega y señala el fallo concreto. Que el archivo aparezca cargado no basta para dar el presupuesto por bueno. El comercial revisa también los importes, las condiciones y el envío.
Ajusta y repite
Corrige la regla ambigua. Si el fallo se relaciona con una instrucción poco clara, reescríbela para que describa lo que esperas ver. Abre una sesión nueva, vuelve a comprobar la carga y repite el encargo ficticio. Conserva la salida para compararla con la anterior. Antes de usar documentos reales, resuelve lo que siga fallando; superar esta práctica no asegura que los siguientes presupuestos sean correctos.
/context all
/memory
/init
/clearPrepara un borrador de presupuesto con la solicitud ficticia
y el catálogo aprobado de esta carpeta.
Sigue las instrucciones del proyecto.
Identifica el archivo de origen de cada precio
y deja pendientes los datos que no encuentres.
Guarda el borrador y resume lo que debe revisar el comercial.Cómo escribir reglas que puedas revisar
Cambia deseos por resultados observables. «Haz buenos presupuestos» no le dice al comercial qué mirar. «Identifica el archivo de origen de cada precio» sí deja una comprobación concreta. Haz el mismo cambio en tu caso: en vez de pedir cuidado con los datos ausentes, explica cómo deben aparecer en la entrega. En la plantilla se marcan como pendientes, para que el responsable sepa qué necesita resolver antes de aprobar.
Conserva solo instrucciones vigentes. Anthropic recomienda archivos breves. Usa las veinte líneas como ejercicio de concisión, no como requisito técnico. No añadas una frase por cada respuesta que te disgusta. Comprueba si el problema está en el encargo, en el material o en una regla contradictoria. Cuando cambie el catálogo autorizado o el responsable de revisión, actualiza la instrucción correspondiente y retira la anterior.
Qué archivo busca cada herramienta
:
:
:
:
:
:
:
:
Cada herramienta lee los archivos de forma distinta. Si alternas herramientas, comprueba qué instrucciones incorpora cada una.
Si alternas Claude Code y Codex
Guarda las reglas comunes en AGENTS.md. Para que Claude Code incorpore su contenido, crea también un CLAUDE.md con la línea del ejemplo siguiente. Esa línea debe quedar como texto del archivo, fuera de un bloque de código. Codex busca sus instrucciones por separado; no des por hecho que entiende la misma sintaxis.
Comprueba qué carga cada herramienta. Por defecto, Claude Code recurre a AGENTS.md si no encuentra CLAUDE.md, .claude/CLAUDE.md ni CLAUDE.local.md en la carpeta de trabajo o en las carpetas que la contienen. La configuración puede cambiar esta elección. Codex da prioridad a AGENTS.override.md sobre AGENTS.md en cada carpeta. Evita mantener copias manuales de las mismas reglas. Tienes más detalle en CLAUDE.md y AGENTS.md.
@AGENTS.mdAntes de pasar a documentos reales
Separa las tres comprobaciones: que el archivo se cargue, que la entrega responda a tus criterios y que los accesos estén limitados. Son cuestiones distintas. Revisa los permisos de un agente con quien configure el entorno. Una instrucción puede indicar quién aprueba; el responsable técnico debe comprobar que las vías de acceso relevantes respetan esa decisión.
Lleva las reglas a tu proyecto. Elige una tarea pequeña, materiales autorizados y una entrega que sepas revisar. Comprueba de nuevo la carga y el resultado al cambiar de entorno. Si quieres trabajar también la organización del proyecto y sus comprobaciones, sigue con Claude Code a fondo.
Dudas sobre archivos de instrucciones, respuestas cortas
¿Me sirve si no sé programar?
Sí, puedes describir un trabajo con documentos, como el borrador de presupuesto del ejemplo. Indica dónde están los materiales, qué debe devolver y cómo lo revisarás. No copies órdenes técnicas que tu equipo no utiliza. Para configurar accesos y bloqueos, pide ayuda a quien mantenga la herramienta.
¿Tengo que ejecutar la inicialización en cada sesión?
No. Crear y cargar son tareas distintas. La inicialización puede preparar un borrador de instrucciones que debes revisar. Después, Claude Code carga los archivos según sus reglas de lectura. Para comprobar una sesión, mira el detalle del contexto; no necesitas regenerar el documento cada vez que empiezas a trabajar.
¿Basta con renombrar CLAUDE.md como AGENTS.md?
Depende de la herramienta y de los demás archivos del proyecto. Cada una decide qué lee y qué prioridad aplica. Claude Code admite una alternativa e importaciones; Codex utiliza su cadena de instrucciones. Si alternas ambos, comparte el texto como muestra la guía y comprueba la carga en cada entorno.
¿Qué longitud debe tener el archivo?
Incluye solo las reglas necesarias para entender el proyecto y revisar la entrega. Anthropic recomienda concisión; usa las veinte líneas como ejercicio para resumir lo esencial, no como condición técnica. Quita repeticiones y reglas caducadas. Si repartes instrucciones entre subcarpetas, comprueba cómo las carga tu herramienta.
¿Es seguro poner contraseñas o prohibiciones en estas instrucciones?
Deja las claves fuera. El archivo describe cómo trabajar; no debe reunir contraseñas ni secretos para tenerlos a mano. Una prohibición escrita tampoco instala un bloqueo. Configura y comprueba los permisos del entorno por separado, y usa documentos ficticios mientras revisas el comportamiento de la práctica.
Fuentes
Fuentes oficiales, consultadas el 4 de noviembre de 2026
- Anthropic: memoria, archivos de instrucciones e importaciones
- Anthropic: comandos para comprobar el contexto y editar instrucciones
- Anthropic: qué incluir en CLAUDE.md y cómo mantenerlo
- Anthropic: configuración de permisos efectivos
- Anthropic: países admitidos, incluida España
- Anthropic: instalación y requisitos de cuenta de Claude Code
- OpenAI: descubrimiento y prioridad de AGENTS.md
- OpenClaw: instrucciones en el espacio de trabajo
- Nous Research: archivos de contexto de Hermes Agent
- OpenAI: aislamiento y aprobaciones
Cómo lo comprobamos. Documentación consultada el 4 de noviembre de 2026. Ciade usa Claude Code a diario desde España. Para esta guía no se han realizado pruebas nuevas de carga, cumplimiento de instrucciones o permisos en Claude Code, Codex, OpenClaw ni Hermes Agent.
Qué ha cambiado.
- 4 de noviembre de 2026: Reescritura con plantilla documental, comprobación de carga y entrega, compatibilidad por herramienta y distinción entre instrucciones y permisos.
Términos relacionados
Aprende a usar la IA en tu trabajo, con criterio.
El nivel 0 es gratis: cuarenta minutos para entender qué pedirle a la IA y qué revisar. El programa completo enseña a implementarla en tu propio negocio, tarea a tarea.
