> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ¿Qué es AGENTS.md en Codex CLI?

> Descubre para qué sirve AGENTS.md en Codex CLI, cómo funciona la jerarquía de instrucciones, qué debes incluir y cuáles son los errores habituales.

## 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

```md theme={null}
# Project instructions

## Build and test
- Run `npm test` before finishing behavior changes.
- Run `npm run lint` after editing TypeScript files.

## Style
- Keep diffs small and focused.
- Match existing component patterns.

## Safety
- Do not edit files outside this repository.
- Do not commit secrets.
```

## Errores habituales

* Convertir `AGENTS.md` en un prompt universal demasiado largo.
* Escribir secretos en el archivo.
* Olvidar actualizarlo cuando cambian los comandos del proyecto.
* Mezclar `AGENTS.md` con el archivo de usuario `config.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](/es/faq/codex/what-is-codex-cli)
* [Cómo configurar config.toml en Codex CLI](/es/faq/codex/config-toml)
* [Qué son el sandbox y los modos de aprobación de Codex CLI](/es/faq/codex/sandbox-approval)
* [Qué es CLAUDE.md en Claude Code](/es/faq/claude-code/claude-md)

## Referencias

* [Guía de AGENTS.md para Codex](https://developers.openai.com/codex/guides/agents-md)
* [Prácticas recomendadas de Codex](https://developers.openai.com/codex/learn/best-practices)
* [Debates sobre OpenAI Codex](https://github.com/openai/codex/discussions)