Codex: Dicas Avançadas do Codex
Última atualização: 2026-08-31
Com as operações básicas dominadas, esta lição aborda dicas avançadas para maximizar a eficiência do Codex.
📋 Pré-requisitos: Proficiência com operações básicas do Codex (veja Lições 3-8)
1. O Que Você Vai Aprender
- Estratégias de paralelismo multi-tarefa
- Técnicas de otimização de contexto
- Métodos de recuperação de erros
- Segredos para aumentar a eficiência
2. Paralelismo Multi-Tarefa
(1) Quando Paralelizar
| Cenário | Estratégia |
|---|---|
| Modificando arquivos diferentes | Pode paralelizar |
| Modificando o mesmo arquivo | Deve ser sequencial |
| Tarefas com dependências | Deve ser sequencial |
| Módulos de funcionalidade independentes | Pode paralelizar |
(2) Métodos de Operação Paralela
Modo App: Crie múltiplas tarefas no painel esquerdo, cada uma roda independentemente.
Modo Web: Submeta múltiplas tarefas simultaneamente para sandboxes na nuvem.
Modo CLI: Abra múltiplas janelas de terminal, cada uma executando uma instância do Codex.
▶ Exemplo 1: Estratégia Paralela de Alice
# Alice lida com três módulos independentes simultaneamente
Tarefa 1: Refatorar módulo src/auth/
Tarefa 2: Adicionar docs Swagger ao src/api/
Tarefa 3: Otimizar desempenho de src/utils/
# Três tarefas modificam diretórios diferentes — podem rodar em paralelo
# Economia de tempo estimada: 60%
3. Otimização de Contexto
(1) Gerenciamento da Janela de Contexto
A janela de contexto do Codex é limitada — gerenciamento adequado melhora os resultados:
| Dica | Descrição |
|---|---|
| Adição Precisa | Apenas adicionar arquivos relevantes ao contexto |
| Remoção Oportuna | Remover arquivos completados do contexto |
| Compactação Regular | Usar /compact para comprimir histórico |
| Novas Sessões Quando Necessário | Dividir tarefas grandes em múltiplas sessões |
(2) Estratégia de Adição de Contexto
# Boa prática
/add src/auth/login.ts # Apenas adicionar arquivos relevantes
/add src/types/auth.ts # Adicionar definições de tipo
# Má prática
/add src/**/*.ts # Muitos arquivos, desperdiça contexto
(3) AGENTS.md como Contexto Persistente
O AGENTS.md é automaticamente incluído como contexto sem consumir a janela:
# AGENTS.md
## Estrutura do Projeto
- src/auth/ - Módulo de autenticação
- src/api/ - Rotas de API
- src/utils/ - Funções utilitárias
## Convenções
- Usar TypeScript strict mode
- Todas as APIs precisam de tratamento de erros
▶ Exemplo 2: Otimização de Contexto de Bob
# Bob trabalhando em um projeto grande
/status # Ver: contexto 75% usado
# Otimizar
/remove src/legacy/ # Remover arquivos irrelevantes
/compact # Comprimir histórico
# Ainda não é suficiente
/new # Iniciar nova sessão
/add src/payments/ # Apenas adicionar arquivos relacionados à tarefa atual
4. Recuperação de Erros
(1) Quando o Codex Erra
# Cenário: O Codex executa testes e eles falham
> Codex: Tests failed, 3 cases did not pass
> Você: View details of failed cases, fix them one by one
# Cenário: O Codex modificou o arquivo errado
> Codex: Modified config.ts (should have modified constants.ts)
> Você: Revert config.ts changes, modify constants.ts
(2) Rollback com Git
# Ver mudanças
git diff
# Reverter arquivo específico
git checkout -- src/wrong-file.ts
# Reverter todas as mudanças
git checkout -- .
# Voltar ao commit anterior
git reset --hard HEAD~1
(3) Correção Iterativa
# Primeira tentativa
> "Migrate Express to Fastify"
Resultado: Algumas rotas não foram convertidas corretamente
# Acrescentar correção
> "Check the /api/users route, the conversion syntax is wrong, refer to Fastify official docs"
Resultado: Correção de rota completada
# Continuar corrigindo
> "Middleware conversion also has issues, error handling needs Fastify's setNotFoundHandler"
Resultado: Correção de middleware completada
5. Segredos para Aumentar a Eficiência
(1) Otimização de Prompt
| Dica | Descrição | Exemplo |
|---|---|---|
| Fornecer Exemplos | Dar formato de saída esperado | "Output in the following format: ..." |
| Referenciar Arquivos | Especificar arquivos de referência | "Follow the style of auth.py" |
| Passo a passo | Dividir tarefas grandes em etapas | "Step 1: ... Step 2: ..." |
| Incluir Verificação | Especificar como verificar | "Ensure npm test passes" |
| Definir Restrições | Limitar escopo | "Only modify the src/auth/ directory" |
(2) Prompts Baseados em Templates
# Template para Corrigir Bug
"Fix <Bug-description> in <file>.
Error message: <error-log>
Expected behavior: <correct-behavior>
Ensure <verify-command> passes."
# Template para Adicionar Funcionalidade
"Add <feature> to <module>.
Follow the code style of <existing-file>.
Include input validation and error handling.
Write unit tests."
# Template para Refatoração
"Refactor <old-impl> to <new-impl>.
Maintain the external interface.
Ensure all existing tests pass.
Add new tests covering the new implementation."
(3) Pipelines Automatizados
# Um comando: correção de código → teste → commit
codex --full-auto "Fix all lint errors, run tests, if passing then git commit -m 'fix: lint errors'"
6. Armadilhas Comuns e Como Evitá-las
| Armadilha | Evitação |
|---|---|
| Overflow de contexto | Regularmente /compact, usar /new quando necessário |
| Aceitar mudanças cegamente | Revisar cada diff |
| Tarefa grande demais | Dividir em pequenos passos, executar um por um |
| Esquecer proteção Git | Sempre commitar antes de operações |
| Modificações paralelas no mesmo arquivo | Separar estritamente escopos de tarefas |
❓ Perguntas Frequentes
P: Como sei se o contexto é suficiente? R: Use
/statuspara ver o uso. Quando exceder 80%, considere compactar ou iniciar uma nova sessão.
P: E se o Codex continuar entendendo mal minha intenção? R: Tente uma descrição diferente, forneça exemplos específicos, ou referencie código existente. Descrições em inglês geralmente funcionam melhor.
P: Tarefas paralelas vão interferir umas nas outras? R: No modo sandbox na nuvem não — cada tarefa roda independentemente. No modo multi-instância local pode causar conflitos de arquivos; garanta que está modificando arquivos diferentes.
P: Como faço o Codex seguir o estilo de código do projeto? R: Defina regras de estilo no AGENTS.md — o Codex as seguirá automaticamente. Você também pode referenciar configs de ESLint/Prettier.
P: Quão grande um projeto o Codex pode lidar? R: Depende da janela de contexto. 128K tokens pode lidar com aproximadamente alguns milhares de linhas de código. Projetos grandes requerem adição precisa de arquivos de contexto, não carregamento total.
📖 Resumo
- Paralelismo multi-tarefa: arquivos diferentes em paralelo, mesmo arquivo em sequencial
- Otimização de contexto: adição precisa, remoção oportuna, compactação regular
- Recuperação de erros: acrescentar correções / rollback Git / desenvolvimento iterativo
- Aumento de eficiência: Prompts baseados em templates + incluir verificação + pipelines automatizados
- Evitar armadilhas: overflow de contexto, aceitação cega, tarefas superdimensionadas
📝 Exercícios
- Básico (⭐): Use desenvolvimento iterativo para completar uma funcionalidade — escreva um esqueleto primeiro, depois melhore gradualmente, registrando cada instrução acrescentada.
- Intermediário (⭐⭐): Execute duas tarefas independentes em paralelo, registre a proporção de economia de tempo.
- Avançado (⭐⭐⭐): Crie sua própria biblioteca de Templates de Prompt do Codex cobrindo cinco cenários: Corrigir Bug / Adicionar Funcionalidade / Refatorar / Testar / Revisar.
