Respuesta breve
AGENTS.md es un archivo de instrucciones del proyecto para Codex. Informa a Codex sobre la estructura del repositorio, los comandos, las pruebas, el estilo de código, las reglas de commit y las preferencias de colaboración.
Está destinado a reglas estables del proyecto, no a tareas puntuales. Incluye los requisitos de una sola tarea en la conversación actual.
Qué debes incluir
- Cómo instalar dependencias, iniciar el proyecto y ejecutar pruebas
- Comandos de validación habituales
- Estilo de código y convenciones de nombres
- Directorios que no deben modificarse sin cuidado
- Comprobaciones obligatorias antes de terminar
- Preferencias del equipo para la comunicación y la salida
Qué no debes incluir
- API Keys, tokens, contraseñas o credenciales privadas
- Instrucciones temporales de una tarea
- Historias extensas sobre el producto
- Prompts genéricos sin relación con el repositorio
- Comandos y rutas obsoletos
Estructura recomendada
Errores habituales
- Convertir
AGENTS.mden un prompt universal demasiado largo. - Escribir secretos en el archivo.
- Olvidar actualizarlo cuando cambian los comandos del proyecto.
- Mezclar
AGENTS.mdcon el archivo de usuarioconfig.toml. - Suponer que las reglas eliminan la necesidad de revisar los diff y las pruebas.
Cómo interviene BetterToken
Aunque un equipo utilice BetterToken para unificar el enrutamiento de modelos,AGENTS.md sigue siendo importante. La capa de API gestiona las solicitudes del modelo y los registros de uso. AGENTS.md gestiona el contexto del proyecto y las normas de ejecución.
Utiliza ambos para reducir la confusión de configuración y el coste de colaboración.
Documentación relacionada
- Qué es Codex CLI
- Cómo configurar config.toml en Codex CLI
- Qué son el sandbox y los modos de aprobación de Codex CLI
- Qué es CLAUDE.md en Claude Code