Codex

Guia de Skills do Codex

Executar uma Tarefa

1. Padrão para modelo gpt-5.2. Pergunte ao usuário (via AskUserQuestion) qual esforço de raciocínio usar (xhigh, high, medium ou low). O usuário pode sobrescrever o modelo se necessário (veja Opções de Modelo abaixo).
2. Selecione o modo sandbox necessário para a tarefa; padrão para --sandbox read-only a menos que edições ou acesso à rede sejam necessários.
3. Monte o comando com as opções apropriadas:
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<high|medium|low>"
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
4. Sempre use --skip-git-repo-check.
5. Ao continuar uma sessão anterior, use codex exec --skip-git-repo-check resume --last via stdin. Ao retomar, não use sinalizadores de configuração a menos que explicitamente solicitado pelo usuário, por exemplo, se ele especificar o modelo ou o esforço de raciocínio ao solicitar retomar uma sessão. Sintaxe de retomada: echo "seu prompt aqui" | codex exec --skip-git-repo-check resume --last 2>/dev/null. Todos os sinalizadores devem ser inseridos entre exec e resume.
6. IMPORTANTE: Por padrão, acrescente 2>/dev/null a todos os comandos codex exec para suprimir tokens de pensamento (stderr). Mostre stderr apenas se o usuário explicitamente solicitar ver tokens de pensamento ou se a depuração for necessária.
7. Execute o comando, capture stdout/stderr (filtrado conforme apropriado) e resuma o resultado para o usuário.
8. Após o Codex terminar, informe ao usuário: "Você pode retomar esta sessão do Codex a qualquer momento dizendo 'codex resume' ou pedindo para eu continuar com análise ou alterações adicionais."

Referência Rápida

Opções de Modelo

Vantagens do GPT-5.2: 76,3% SWE-bench (vs 72,8% GPT-5), 30% mais rápido em tarefas médias, melhor manipulação de ferramentas, alucinações reduzidas, qualidade de código aprimorada. Data de conhecimento: 30 de setembro de 2024.

Níveis de Esforço de Raciocínio:

• xhigh - Tarefas ultra-complexas (análise profunda de problemas, raciocínio complexo, compreensão profunda do problema)
• high - Tarefas complexas (refatoração, arquitetura, análise de segurança, otimização de desempenho)
• medium - Tarefas padrão (refatoração, organização de código, adições de recursos, correção de bugs)
• low - Tarefas simples (correções rápidas, mudanças simples, formatação de código, documentação)

Desconto de Entrada em Cache: 90% de desconto ($0,125/M tokens) para contexto repetido, cache dura até 24 horas.

Acompanhamento

• Após cada comando codex, use imediatamente AskUserQuestion para confirmar próximas etapas, coletar esclarecimentos ou decidir se deve retomar com codex exec resume --last.
• Ao retomar, passe o novo prompt via stdin: echo "novo prompt" | codex exec resume --last 2>/dev/null. A sessão retomada usa automaticamente o mesmo modelo, esforço de raciocínio e modo sandbox da sessão original.
• Reafirme o modelo escolhido, esforço de raciocínio e modo sandbox ao propor ações de acompanhamento.

Tratamento de Erros

• Interrompa e reporte falhas sempre que codex --version ou um comando codex exec sair com código diferente de zero; solicite orientação antes de tentar novamente.
• Antes de usar sinalizadores de alto impacto (--full-auto, --sandbox danger-full-access, --skip-git-repo-check), peça permissão ao usuário usando AskUserQuestion a menos que já tenha sido concedida.
• Quando a saída inclui avisos ou resultados parciais, resuma-os e pergunte como ajustar usando AskUserQuestion.

Versão da CLI

Requer Codex CLI v0.57.0 ou posterior para suporte ao modelo GPT-5.2. A CLI usa como padrão gpt-5.2 em macOS/Linux e gpt-5.2 em Windows. Verifique a versão: codex --version

Use o comando slash /model em uma sessão do Codex para trocar modelos ou configure o padrão em ~/.codex/config.toml.