Domine o Codex CLI da OpenAI do zero ao avançado: instalação, comandos, skills, subagentes e projetos reais.
CLI, App e Web em perspectiva
Node.js, npm, login device auth
/ @ agents.md contexto
flags, config.toml, sandbox
SKILL.md, invoke, reutilizar
10 tipos, threads, workers
Paralelo, fórmula de prompt
Git paralelo, PRs automáticos
Agendamento, CI/CD, rotinas
App completo com multitasking
O Codex é o agente de codificação da OpenAI — rival do Claude Code. Diferencial: roda agentes na nuvem, delega tarefas remotamente (até pelo celular) e retorna pull requests prontos. Contexto de 274K tokens.
Contexto maior que Claude Code, suporte nativo a worktrees, integração direta com GitHub Actions. Para tarefas longas em nuvem é complemento natural ao Claude.
| Versão | Melhor para | Detalhe |
|---|---|---|
| CLI (terminal) | Velocidade + controle local | macOS, Windows, Linux. Integração direta com repositórios |
| App (Windows) | Interface visual completa | Skills, plugins, navegador interno, várias threads paralelas |
| Web (ChatGPT) | Delegar em nuvem | GitHub conectado, agentes sem PC ligado, acesso pelo celular |
Instalação via npm. Pré-requisito: Node.js v18+. Login usa device auth — você abre um link no browser, sem expor chave de API.
Node.js desatualizado causa falhas silenciosas. O device auth é mais seguro que API key — funciona em containers Docker sem variáveis de ambiente expostas.
winget install --id Git.Git -e --source winget # depois instale Node.js em nodejs.org
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs
npm install -g @openai/codex
codex login --device-auth # Abre link no browser → digita código → ✓ logado
Após instalar, codex abre modo interativo. / acessa comandos internos, @ referencia arquivos do projeto.
O agents.md é equivalente ao CLAUDE.md — define contexto permanente. Sem ele o Codex parte do zero em cada sessão.
codex # modo interativo codex "crie uma API" # prompt direto codex chat # modo conversa codex --full-auto "..." # sem confirmação
/plan mode— planejamento/model— trocar modelo/browser use— ativar browser/skill creator— criar skillApproval policies controlam quando o Codex pede confirmação. De sempre perguntar até nunca — ajuste conforme o ambiente (dev local vs produção).
Em container ou VM isolada, desativar confirmações elimina atrito e acelera muito. Em produção, sempre manter confirmações ativas.
| Flag | Comportamento | Risco |
|---|---|---|
| --full-auto | on-request + sandbox write | Médio |
| -a never | Nunca pede aprovação | Médio |
| --dangerously-bypass... | Zero confirmações, zero sandbox | Alto ⚠️ |
Skills são instruções reutilizáveis para tarefas recorrentes. Crie uma vez, use com $nome-da-skill ou deixe o Codex invocar automaticamente.
Eliminam repetição. Uma skill de "revisão de PR" pode rodar 3 subagentes em paralelo sem reescrever o prompt toda vez.
--- name: pr-review-agent description: Use quando pedir revisão de PR, diff ou código alterado. --- Ao revisar um PR: 1. Leia o diff completo 2. Identifique riscos de segurança 3. Verifique cobertura de testes 4. Classifique achados por severidade
O Codex tem vários "nomes" para agentes — thread, task agent, worker, subagente, background agent, automação, skill. Todos são variações de como você estrutura o trabalho.
Entender a hierarquia evita confusão. Comece com threads + skills + automações. Subagentes e workers vêm quando precisa paralelismo real.
| Tipo | Uso |
|---|---|
| Agente principal | Chat/thread normal |
| Subagente | "Use subagentes em paralelo" |
| Background agent | Thread em segundo plano |
| Automação | Aba Automations (agendado) |
| Skill | $nome ou linguagem natural |
Subagentes especializados disparados em paralelo. O Codex não os cria automaticamente — você pede explicitamente com "use subagentes em paralelo".
Auditorias, planejamento de features e refactoring divididos em paralelo reduzem o tempo total drasticamente.
Use subagentes em paralelo para [objetivo]. Divida: 1. Subagente A: [papel específico] 2. Subagente B: [papel específico] 3. Subagente C: [papel específico] Regras: trabalho independente, não edite ainda, consolide no final.
Worktrees permitem múltiplos agentes trabalharem em paralelo sem misturar alterações. Cada agente tem seu diretório + branch. A OpenAI destaca worktrees como parte central do fluxo multiagente.
Sem worktrees, dois agentes no mesmo arquivo criam conflitos. Com worktrees, cada um trabalha isolado e você faz merge depois.
Agentes paralelos, branch próprio, sem conflito
Branch + commit + push + PR com resumo
Codex como CI, patches automáticos
Delega via ChatGPT app, recebe PRs remotamente
Automações configuram rotinas que o Codex executa em horário definido sem você estar presente. Disponível na aba Automations do Codex App (Windows).
Transforma o Codex em membro da equipe que trabalha enquanto você dorme — revisando código, rodando testes, gerando relatórios.
Toda segunda-feira às 9h: 1. Atualizar dependências (se seguro) 2. Rodar testes 3. Rodar build 4. Gerar reports/weekly-review.md 5. Se houver mudanças, criar commit
Construção de um app de portfólio de ações completo — com UI, banco de dados, dados reais de mercado e material de marketing — usando Codex 5.5, sem experiência prévia em programação.
Mostra o Codex no limite: multitasking real com 3 agentes simultâneos (dev + vídeo + pesquisa), image generation e reverse prompting.
Design com image generation — Codex gera opções visuais, usuário escolhe
Frontend + banco — Next.js + Convex para persistir portfólio
Dados reais — Alpha Vantage API gratuita para preços ao vivo
Multitasking — 3 agentes: dev + vídeo (Remotion) + pesquisa (browser)
Reverse prompting — perguntar ao Codex "o que deve ser feito em seguida?"