Instrucciones de proyecto: CLAUDE.md vs AGENTS.md

Las tres herramientas inyectan un archivo de instrucciones del proyecto en el contexto del modelo, pero cambian el nombre del archivo, cómo se descubre y cómo se fusiona. Claude Code usa CLAUDE.md; Codex y Kimi Code usan los dos AGENTS.md — con reglas de descubrimiento distintas entre ellos.

Páginas relacionadas de cada herramienta: Claude Code — Instrucciones de proyecto (CLAUDE.md) · Codex CLI — Instrucciones de proyecto (AGENTS.md) · Kimi Code — Instrucciones de proyecto (AGENTS.md)

Ubicaciones y precedencia

Claude Code (CLAUDE.md)

Tipo	Ubicación
Política de empresa	macOS `/Library/Application Support/ClaudeCode/CLAUDE.md`; Linux/WSL `/etc/claude-code/CLAUDE.md`; Windows `C:\ProgramData\ClaudeCode\CLAUDE.md`
Proyecto	`./CLAUDE.md` o `./.claude/CLAUDE.md` (súbelo a git)
Usuario	`~/.claude/CLAUDE.md`
Proyecto, local	`./CLAUDE.local.md` — obsoleto, en favor de las importaciones con `@`

Todos los archivos de memoria se cargan en el contexto al arrancar; los niveles de arriba de la tabla se cargan primero y tienen prioridad.
La búsqueda sube desde el directorio actual hasta / (sin incluirlo), leyendo por el camino los CLAUDE.md y CLAUDE.local.md; los CLAUDE.md anidados en subdirectorios se cargan bajo demanda cuando Claude lee archivos allí.
No hay ningún límite de tamaño documentado.

Codex (AGENTS.md)

El descubrimiento se hace una vez por ejecución (o por sesión de la TUI):

Ámbito global (~/.codex): lee AGENTS.override.md si existe, y si no AGENTS.md — sólo el primer archivo no vacío de este nivel.
Ámbito de proyecto: desde la raíz del proyecto (normalmente la raíz de Git; configurable con project_root_markers) bajando hasta el directorio actual. En cada directorio Codex mira AGENTS.override.md, luego AGENTS.md y luego los nombres de project_doc_fallback_filenames. Como mucho un archivo por directorio.
Fusión: los archivos se concatenan de la raíz hacia abajo, separados por líneas en blanco; los más cercanos al directorio actual quedan al final y por tanto sobrescriben lo anterior.

Los archivos vacíos se ignoran.
El tamaño combinado está limitado por project_doc_max_bytes (por defecto 32 KiB).

Kimi Code (AGENTS.md)

Nivel de proyecto: AGENTS.md en la raíz o .kimi-code/AGENTS.md. El contenido se inyecta en el system prompt como datos de referencia (la variable de plantilla ${agents_md}).
Global, propio de Kimi: $KIMI_CODE_HOME/AGENTS.md (por defecto ~/.kimi-code/AGENTS.md); se mueve con KIMI_CODE_HOME.
Genérico, compartido entre herramientas: ~/.agents/AGENTS.md, en el home real del sistema; no se mueve con KIMI_CODE_HOME.
Límite de tamaño: ? La documentación no especifica un tope exacto ni si los AGENTS.md de subdirectorios se fusionan; el changelog menciona un aviso visible cuando AGENTS.md se trunca (antes era silencioso), así que el límite existe pero no está documentado.

Mecanismos de importación y sobrescritura

Mecanismo	Claude Code	Codex	Kimi Code
Importar otros archivos	Importaciones `@ruta/al/archivo` (relativas o absolutas, admite `@~/...`, recursivas hasta 5 saltos, no se evalúan en bloques de código)	No hay equivalente directo verificado.	No hay equivalente directo verificado.
Sobrescribir por directorio	Los CLAUDE.md anidados se cargan bajo demanda en cada subdirectorio	`AGENTS.override.md` sustituye a `AGENTS.md` en el mismo directorio	No hay equivalente directo verificado.
Sustituir las instrucciones internas	Los flags `--system-prompt` / `--system-prompt-file`	La clave `model_instructions_file` (sustituye las instrucciones internas, no AGENTS.md)	`$KIMI_CODE_HOME/SYSTEM.md` sustituye el system prompt del agente principal por defecto
Añadir algo rápido desde el compositor	El prefijo `#` pregunta a qué archivo de memoria añadirlo	No hay equivalente directo verificado.	No hay equivalente directo verificado.

Comportamiento de `/init`

Claude Code: /init genera un CLAUDE.md para el proyecto.
Codex: /init genera un AGENTS.md inicial en el directorio actual.
Kimi Code: /init (sólo con el agente parado) analiza el código y genera AGENTS.md.

Llevarte tus instrucciones de una herramienta a otra

De Claude Code a Codex o Kimi Code: renombra CLAUDE.md a AGENTS.md. Antes, desenrolla las líneas @import — ni Codex ni Kimi documentan una sintaxis de importación, así que pega tú el contenido importado. En Codex, mantén el total por debajo de 32 KiB (project_doc_max_bytes) o sube el límite.
De Codex a Claude Code: renombra AGENTS.md a CLAUDE.md. Recuerda que Codex concatena varios AGENTS.md de la raíz hacia abajo mientras que Claude carga los CLAUDE.md anidados bajo demanda, así que una configuración de Codex repartida en varios archivos puede acabar siendo uno solo, o un conjunto de archivos anidados, en Claude.
De Kimi Code a Claude Code o Codex: revisa las tres ubicaciones de Kimi (AGENTS.md o .kimi-code/AGENTS.md en el proyecto, ~/.kimi-code/AGENTS.md y ~/.agents/AGENTS.md) y consolídalas.
Importadores automáticos: Kimi Code incluye el comando de skill /import-from-cc-codex, que importa instrucciones, skills y ajustes de MCP de Claude Code y Codex. Codex incluye /import, que migra la configuración, los proyectos y los chats de Claude Code (o Cursor). Ni Claude Code ni Codex documentan un importador desde Kimi Code.

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.