OpenAI Codex CLI

OpenAI Codex CLI é o agente de coding da OpenAI para o terminal. Diferente de um chat, opera como um agente que lê o repositório, executa comandos e propõe edições: de forma interativa ou totalmente autônoma.

Instalação

npm install -g @openai/codex
codex

Modos de operação

Modo	Comportamento
suggest (padrão)	Propõe cada mudança para aprovação
auto-edit	Edita arquivos automaticamente, pede aprovação para comandos
full-auto	Executa tudo sem intervenção (sandbox recomendado)

codex --approval-mode full-auto "implementar autenticação JWT"

Arquivo de configuração: AGENTS.md

O AGENTS.md na raiz do projeto é o equivalente ao CLAUDE.md: define contexto, convenções e instruções para o agente.

# AGENTS.md
 
## Stack
- Python 3.12, FastAPI, PostgreSQL
 
## Convenções
- Testes com pytest, cobertura mínima de 80%
- Linting com ruff
 
## Comandos úteis
- `make test` — roda a suite de testes
- `make lint` — verifica estilo

SDD com Codex CLI

O Codex não tem um workflow de fases nativo como o Claude Code, mas o sdd pode ser aplicado manualmente:

1. Escreva a spec: crie um arquivo SPEC_feature.md com requisitos, arquitetura e casos de uso
2. Referencie no AGENTS.md: adicione uma seção apontando para a spec ou cole o conteúdo diretamente
3. Execute em full-auto: passe a spec como prompt inicial ou como contexto no AGENTS.md
4. Revise os diffs: mesmo em full-auto, valide cada mudança antes de commitar

# Exemplo: passar spec explicitamente
codex "Implementar conforme SPEC_auth.md — não desvie da arquitetura definida"

Vantagem do full-auto com spec

Com a spec detalhada no AGENTS.md, o modo full-auto consegue executar tarefas complexas end-to-end com mínima intervenção: o modelo sabe exatamente o que deve e não deve fazer.

Ver também: sdd | llm | llm-claude-code | llm-gemini