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

# O que é AGENTS.md no Codex CLI?

> Saiba para que serve o AGENTS.md no Codex CLI, como funciona a hierarquia de instruções, o que incluir e quais erros evitar.

## Resposta curta

`AGENTS.md` é um arquivo de instruções do projeto para o Codex. Ele informa a estrutura do repositório, comandos, testes, estilo de programação, regras de commit e preferências de colaboração.

Use-o para regras estáveis do projeto, não para tarefas pontuais. Coloque requisitos temporários na conversa atual.

## O que incluir

* Como instalar dependências, iniciar o projeto e executar testes
* Comandos comuns de validação
* Estilo de programação e convenções de nomenclatura
* Diretórios que não devem ser alterados sem necessidade
* Verificações obrigatórias antes de concluir
* Preferências da equipe para comunicação e respostas

## O que não incluir

* API Keys, tokens, senhas ou credenciais privadas
* Instruções de tarefas temporárias
* Contextos longos sobre o produto
* Prompts genéricos sem relação com o repositório
* Comandos e caminhos desatualizados

## Estrutura sugerida

```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.
```

## Erros comuns

* Transformar o `AGENTS.md` em um prompt universal muito longo.
* Gravar segredos no arquivo.
* Esquecer de atualizá-lo quando os comandos do projeto mudam.
* Misturar o `AGENTS.md` com o `config.toml` do usuário.
* Achar que as regras eliminam a necessidade de revisar diffs e testes.

## Sobre a BetterToken

Mesmo quando uma equipe usa a BetterToken para unificar o roteamento de modelos, o `AGENTS.md` continua importante. A camada de API gerencia solicitações de modelo e registros de uso. O `AGENTS.md` gerencia o contexto do projeto e as normas de execução.

Use os dois para reduzir a confusão de configuração e o custo de colaboração.

## Documentos relacionados

* [O que é o Codex CLI?](/pt-br/faq/codex/what-is-codex-cli)
* [Como configurar o config.toml do Codex CLI](/pt-br/faq/codex/config-toml)
* [O que são os modos de sandbox e aprovação do Codex CLI?](/pt-br/faq/codex/sandbox-approval)
* [O que é CLAUDE.md no Claude Code?](/pt-br/faq/claude-code/claude-md)

## Referências

* [Guia do AGENTS.md no Codex](https://developers.openai.com/codex/guides/agents-md)
* [Práticas recomendadas do Codex](https://developers.openai.com/codex/learn/best-practices)
* [Discussões do OpenAI Codex](https://github.com/openai/codex/discussions)