Codex
Perfis
- (nenhum perfil) — análise somente leitura (sem compilação, sem testes)
--profile edit— edições locais, build ou teste (workspace-write, totalmente automático)--profile full— acesso à rede ou sistema de arquivos amplo (danger-full-access, totalmente automático)
Use --profile edit sempre que a tarefa envolver go test, go build ou qualquer comando que escreva artefatos de build. O sandbox padrão de somente leitura bloqueia todas as escritas, incluindo diretórios temporários do compilador.
Para tarefas complexas, adicione --config model_reasoning_effort="xhigh".
Seleção de Modelo
Use por padrão o modelo do projeto em .codex/config.toml (gpt-5.4).
Use --model gpt-5.3-codex-spark para trabalho interativo com prioridade em velocidade:
- iteração rápida de ida e volta
- correções rápidas de bugs e edições direcionadas
- refatorações pequenas a médias ou ajustes de UI
- prototipagem rápida onde redirecionamento/interrupção frequente é esperado
Mantenha o padrão gpt-5.4 para trabalho com profundidade:
- execuções longas autônomas
- mudanças amplas em múltiplos arquivos com raciocínio pesado
- tarefas com muitos testes ou verificação
- superfícies de maior correção/risco onde raciocínio mais profundo vale a latência extra
Se o usuário solicitar explicitamente um modelo, siga a solicitação.
Comandos
Padrões do projeto em .codex/config.toml. Sempre inclua --skip-git-repo-check e 2>/dev/null. Substitua o modelo apenas quando o usuário solicitar explicitamente, ou quando a tarefa claramente se encaixar nos critérios de velocidade Spark acima.
| Caso de uso | Comando |
|---|---|
| Análise somente leitura | codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null |
| Loop interativo rápido (Spark) | adicione --model gpt-5.3-codex-spark |
| Aplicar edições locais | adicione --profile edit |
| Acesso à rede / amplo | adicione --profile full |
| Retomar sessão | `echo "prompt" |
Crie um arquivo temporário para saída antes de executar: CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX). Leia o resultado de $CODEX_OUT após a conclusão.
Execute com Bash run_in_background: true. Monitore via TaskOutput com block: true, timeout: 600000 — NÃO use comandos sleep para polling. Leia o arquivo -o para a resposta final.
Retomando
Não passe flags de modelo/esforço/sandbox ao retomar — as configurações da sessão original são mantidas. -o é seguro incluir.
Convenções
Este é um projeto Go. Use go test, go build, go vet nos prompts. Os workers do Codex não recebem CLAUDE.md ou hooks, portanto as convenções do projeto devem ser explícitas.
Verificação Pós-Execução
Sempre verifique a saída do Codex via git diff --stat — nunca confie na lista de arquivos autoinformada pelo worker. Workers do Codex podem fazer alterações fora do escopo (excluir arquivos, reverter código não relacionado, remover funções de teste). A promessa de conclusão pode listar apenas os arquivos pretendidos enquanto omite efeitos colaterais destrutivos.
Quando houver outro trabalho no mesmo codebase, inclua listas explícitas de arquivos "NÃO modificar ou excluir" no prompt. A instrução positiva ("apenas toque nestes arquivos") é insuficiente — Codex interpreta "limpeza" de forma ampla.
Conforme [[principles/prove-it-works]]: confie em artefatos, não em auto-relatos.
Uso de Worktree
Com -C <worktree-dir>, o worktree tem seu próprio índice git. .claude/ pode ser um link simbólico para .agents/ — use caminhos .agents/ para operações git.