Codex: Modos de Fluxo de Trabalho do Codex

Última atualização: 2026-08-31

O Codex suporta múltiplos modos de fluxo de trabalho. Escolha o certo com base na complexidade da tarefa e nível de autonomia desejado.

📋 Pré-requisitos: Entendimento das operações básicas do Codex

1. O Que Você Vai Aprender

• Três modos de fluxo de trabalho
• Cenários apropriados para cada modo
• Métodos de troca de modo
• Princípios de design de fluxo de trabalho

2. Três Modos de Fluxo de Trabalho

3. Modo Pergunta

(1) Características

• O Codex apenas responde perguntas, não modifica código
• Atua como um motor de busca inteligente + consultor técnico
• Segurança mais alta

(2) Uso

> Explain React useEffect's cleanup mechanism
> What does this regex match? /\d{3}-\d{4}/
> What's the difference between type and interface in TypeScript?
> How to implement graceful shutdown in Node.js?

▶ Exemplo 1: Alice Usa o Modo Pergunta para Aprender

# Alice assume um projeto Rust, usa Modo Pergunta para entender rapidamente

> Explain the AST structure in src/parser/mod.rs
> What error handling pattern does this project use?
> Why is Arc<Mutex<T>> used here instead of RefCell<T>?
> Draw me a module dependency diagram

4. Modo Tarefa

(1) Características

• O Codex executa tarefas específicas com confirmação passo a passo
• Modo mais comumente usado
• Equilibra autonomia com segurança

(2) Uso

> Add JWT support to the auth module
> Fix the failing test_user_login test
> Convert this.state to React Hooks
> Add rate limiting to the API

(3) Princípios de Decomposição de Tarefas

▶ Exemplo 2: Decomposição de Tarefas de Bob

# Bob precisa adicionar registro de usuário, decomposto em:

Passo 1: "Create User model with email, password_hash, created_at fields"
Passo 2: "Implement registration API endpoint POST /api/register with email format validation"
Passo 3: "Add password hashing using bcrypt"
Passo 4: "Write integration tests for the registration flow"
Passo 5: "Add email verification flow"

5. Modo Agent

(1) Características

• O Codex planeja e executa autonomamente tarefas multi-passo
• Humano apenas precisa revisar resultados finais
• Mais eficiente mas também maior risco

(2) Uso

# Modo Full Auto
codex --full-auto "Migrate the entire project from JavaScript to TypeScript"

# Ou trocar durante a conversa
/mode full-auto

(3) Loop de Trabalho do Agent

graph TB
    A[Receber Tarefa] --> B[Analisar e Entender]
    B --> C[Planejar Passos]
    C --> D[Executar Passo 1]
    D --> E[Verificar Resultado]
    E --> F{Sucesso?}
    F -->|Não| G[Corrigir e Tentar Novamente]
    G --> D
    F -->|Sim| H[Executar Passo 2]
    H --> I[Continuar...]
    I --> J[Agregar Resultados]
    J --> K[Relatar Conclusão]

graph TB
    A[Receber Tarefa] --> B[Analisar e Entender]
    B --> C[Planejar Passos]
    C --> D[Executar Passo 1]
    D --> E[Verificar Resultado]
    E --> F{Sucesso?}
    F -->|Não| G[Corrigir e Tentar Novamente]
    G --> D
    F -->|Sim| H[Executar Passo 2]
    H --> I[Continuar...]
    I --> J[Agregar Resultados]
    J --> K[Relatar Conclusão]

▶ Exemplo 3: Modo Agent de Alice

# Alice usa Modo Agent para uma grande refatoração
> Migrate the Express project to Fastify:
> 1. Replace all route definitions
> 2. Update middleware syntax
> 3. Modify startup scripts
> 4. Ensure all tests pass
> 5. Update package.json

# Codex executa autonomamente:
→ Escaneando 45 arquivos...
→ Convertendo rotas (32 rotas)...
→ Atualizando middleware (8 arquivos)...
→ Execução de testes: 89/89 passaram ✓
→ Atualizando dependências...
→ Teste final: 89/89 passaram ✓
→ Migração completa!

6. Estratégia de Seleção de Modo

(1) Árvore de Decisão

Tipo de tarefa?
├── Apenas precisa de informação → Modo Pergunta
├── Precisa modificar código
│   ├── Tarefa única e clara → Modo Tarefa
│   └── Tarefa complexa multi-passo
│       ├── Risco controlável → Modo Agent
│       └── Alto risco → Modo Tarefa (passo a passo)

(2) Matriz de Seleção

7. Fluxos de Trabalho Híbridos

Na prática, os três modos são frequentemente combinados:

# Fluxo de trabalho híbrido de Alice

1. [Pergunta] "What's the auth architecture of this project?"
2. [Pergunta] "What are the best practices for JWT refresh tokens?"
3. [Tarefa] "Add a JWT refresh token endpoint"
4. [Tarefa] "Write unit tests for refresh tokens"
5. [Agent] "Review the entire auth module, fix all security issues"

❓ Perguntas Frequentes

P: Posso trocar de modo dentro de uma sessão? R: Sim. Use o comando /mode ou ajuste seu estilo de interação — perguntas é Modo Pergunta, tarefas é Modo Tarefa.

P: O Modo Agent é seguro? R: Depende do risco da tarefa e política de aprovação. Combine com rede de segurança Git — commite antes de operações, reverta em erros. Tarefas de alto risco devem usar Modo Tarefa.

P: Como julgo se uma tarefa é adequada para o Modo Agent? R: Faça-se três perguntas: 1) Os passos são previsíveis? 2) Erros são reversíveis? 3) Requer julgamento humano? Todas sim → Agent; caso contrário → Modo Tarefa.

P: O Modo Pergunta consome contexto? R: Sim. Cada pergunta e resposta usa espaço da janela de contexto. Após extensas perguntas, use /compact ou /new.

P: Qual modo economiza mais tokens? R: O Modo Pergunta é mais econômico — apenas gera texto, sem operações. O Modo Agent é mais caro — requer múltiplas rodadas de execução e verificação.

📖 Resumo

• Três modos: Pergunta (seguro) / Tarefa (equilibrado) / Agent (eficiente)
• Modo Pergunta: consultoria e análise, sem modificação de código
• Modo Tarefa: confirmação passo a passo, responsabilidade única
• Modo Agent: execução autônoma, combine com rede de segurança Git
• Uso híbrido produz os melhores resultados

📝 Exercícios

1. Básico (⭐): Complete diferentes tarefas no mesmo tópico usando todos os três modos, registre diferenças de experiência.
2. Intermediário (⭐⭐): Use o Modo Tarefa para completar uma funcionalidade de complexidade média, pratique decomposição de tarefas.
3. Avançado (⭐⭐⭐): Desenhe um fluxo de trabalho híbrido — Modo Pergunta para análise, Modo Tarefa para implementação, Modo Agent para revisão.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós