Como dominar o Codex em 2026 (Curso para Desenvolvedores)

Usei o Claude Code por 12 meses. Depois mudei para o Codex por 30 dias.

Aqui está o que descobri

O que o Codex realmente é em 2026

A maioria das pessoas ainda acha que o Codex é um autocomplete mais inteligente. Não é.

O Codex é uma plataforma completa de desenvolvimento de software com agente. Ele lê sua base de código, escreve e testa código, revisa pull requests, controla seu Mac desktop, navega na web, gera imagens, agenda tarefas recorrentes e lembra suas preferências entre sessões.
A mudança mental que isso exige é significativa. Você deixa de ser a pessoa que escreve código. Você se torna a pessoa que revisa o código escrito por uma equipe de engenheiros júnior que nunca dorme.

A maioria dos desenvolvedores instala o Codex, envia prompts de uma linha por duas semanas, obtém resultados medianos e desiste. Eles nunca configuram o AGENTS.md.

Eles nunca escrevem uma Skill. Eles nunca usam subagentes. Eles usam 5% da superfície e julgam a ferramenta por esses 5%.

Este curso cobre os outros 95%.

As cinco superfícies

Antes de instalar qualquer coisa, entenda onde o Codex vive. A superfície que você escolhe determina o quão de perto você acompanha seu trabalho e onde o código é executado.

CLI é para fluxos de trabalho com scripts, tarefas únicas e automação headless. Seu código nunca sai da sua máquina a menos que você o envie. Código aberto, construído em Rust, roda em macOS, Windows e Linux.

Extensão IDE é para edição interativa com contexto preciso de arquivo. Instala no VS Code, Cursor, Windsurf ou JetBrains. Usa sua autenticação CLI sem login separado.

Aplicativo desktop é o lar de fluxos de trabalho com múltiplas threads, o navegador integrado, Computer Use, Modo Goal, Appshots e Automações. Lançado no macOS em fevereiro de 2026 e no Windows em 4 de março de 2026.

Cloud é para tarefas assíncronas em segundo plano, PRs paralelos e trabalho enquanto você dorme. As tarefas são executadas em contêineres com sandbox pré-carregados com seu repositório GitHub. Nada bloqueia sua máquina local.

Navegador integrado e Computer Use é para verificação de UI, iteração de frontend e testes ponta a ponta. O Codex abre seu servidor de desenvolvimento local, interage com ele, tira screenshots do resultado e verifica se as alterações no código produziram a saída visual correta.

Um fluxo de trabalho real usa múltiplas superfícies:

CLI para coisas com script
IDE para trabalho interativo de funcionalidades
Cloud para tarefas paralelas que você não precisa monitorar
App para tarefas orientadas por objetivos (Goal) e de longa duração

O principal fator para escolher uma superfície é o quão de perto você quer acompanhar o trabalho do agente. Se você quiser monitorar as alterações enquanto são feitas, o CLI ou a IDE mantêm o trabalho na sua máquina e diante de você. Se você preferir delegar uma sessão mais longa e revisar no final, Cloud é a escolha certa.

O modelo mental: agente, não autocomplete

Com as superfícies claras, a próxima mudança é entender a unidade de trabalho.

A unidade de trabalho é uma tarefa, não uma interação. A saída é um PR, não uma resposta de chat.

Pense menos "escreva uma função que faz X" e mais "implemente a funcionalidade Y, aqui estão as restrições, execute os testes quando terminar".

Cada tarefa do Codex segue o mesmo loop interno. O Codex lê sua tarefa e contexto, produz um plano interno, executa passo a passo e verifica o próprio trabalho.

Pare de pensar no Codex como um assistente de codificação. Comece a pensar nele como uma equipe de engenheiros júnior que você instrui de manhã e revisa à tarde.

Um exemplo real disso na prática: desenvolvedores na WorkOS agora enfileiram de quatro a cinco tarefas no Codex antes de pegar o café da manhã. Quando voltam a sentar, de dois a três PRs concluídos estão esperando revisão, lidando com o trabalho de manutenção que costumava consumir 30 a 40 por cento do dia deles.

Os modelos atuais a partir de maio de 2026:

GPT-5.5 (padrão) — lida com a maioria das tarefas, mesma latência de antes, mas significativamente menos tokens para o mesmo trabalho
GPT-5.3-Codex — construído especificamente para execuções autônomas longas, grandes refatorações e fan-out paralelo na nuvem; 25% mais rápido que o especialista Codex anterior
GPT-5.5 Pro — raciocínio mais alto; apenas planos Pro, Business e Enterprise
Codex Mini — permanentemente gratuito no ChatGPT Free; adequado para aprendizado

Deixe o Codex no GPT-5.5 por padrão. Mude para GPT-5.3-Codex para tarefas grandes de agente onde o Codex é executado autonomamente por muito tempo.

Primeiros passos: sua primeira sessão real

O caminho mais rápido para uma sessão Codex funcional segue cinco etapas. Esqueça o tutorial fizzbuzz. Comece em uma base de código real.

Etapa 1: Instale o CLI.

Etapa 2: Abra um projeto real.

Navegue até um repositório de baixo risco com o qual você já esteja familiarizado. Isso é importante.

O Codex tem melhor desempenho quando você consegue reconhecer a saída e detectar erros. Trabalhar em uma base de código desconhecida na primeira sessão produz resultados imprevisíveis.

Faça login com sua conta ChatGPT quando solicitado. Seu navegador abre automaticamente. Clique em Continuar e volte ao terminal.

Etapa 3: Execute /init antes de fazer qualquer outra coisa.

Este único comando é o que a maioria dos tutoriais pula. O Codex verifica seu diretório e histórico do Git, identifica linguagens, frameworks, comandos de build e comandos de teste, e cria um arquivo AGENTS.md pré-preenchido com o que encontra.

Revise o arquivo gerado, ajuste qualquer coisa que esteja errada e faça o commit. Toda sessão futura do Codex neste projeto o lerá automaticamente.

Etapa 4: Dê ao Codex uma tarefa de orientação.

Peça para ele explicar a base de código antes de dar algo para modificar. Isso constrói sua confiança no contexto que ele carregou:

Leia a saída. Se ela descrever sua base de código real com precisão, ele tem o contexto necessário. Se for vaga ou errada, seu AGENTS.md precisa de mais detalhes.

Etapa 5: Dê a ele uma tarefa pequena e real. Escolha algo concreto e delimitado.

Este é o formato correto de um prompt do Codex: contexto específico de arquivo, resultado esperado, restrições e uma etapa de verificação definida. Revise o diff que ele retorna. Você agora está usando o Codex corretamente.

Etapa 6: Instale o aplicativo desktop. Baixe do site da OpenAI. Faça login com a mesma conta ChatGPT.

Etapa 7: Instale a extensão IDE. Pesquise "OpenAI Codex" no painel de extensões do seu editor. Ela lê sua autenticação CLI automaticamente.

Etapa 8: Conecte o GitHub. Vá em Configurações (Settings) dentro do aplicativo Codex e conecte sua conta GitHub. Vincule pelo menos um repositório antes de usar tarefas na nuvem.

Onde as coisas ficam:

~/.codex/config.toml : configuração principal: modo de aprovação, modo sandbox, servidores MCP, modelos padrão
~/.codex/AGENTS.md : AGENTS.md pessoal, aplica-se a todos os projetos
<projeto>/AGENTS.md : instruções no nível do projeto
<projeto>/.agents/skills/ : Skills no nível do projeto
<projeto>/.codex/config.toml : configuração com escopo do projeto (apenas projetos confiáveis)

AGENTS.md: o arquivo mais importante do seu repositório

Agora que você tem uma sessão funcional, o próximo passo é fazer com que toda sessão futura comece com a mesma qualidade. É isso que o AGENTS.md faz.

AGENTS.md é o único arquivo que separa uma saída medíocre do Codex de uma saída consistente e de alta qualidade.
É um arquivo Markdown simples na raiz do seu repositório. Toda vez que uma sessão do Codex é iniciada no seu projeto, o agente o lê automaticamente antes de fazer qualquer outra coisa.
É um padrão aberto. Codex, Cursor, Gemini CLI, Windsurf e GitHub Copilot o leem. Escreva uma vez e todos os agentes na sua cadeia de ferramentas leem a mesma fonte de verdade.

Ordem de resolução: o Codex lê ~/.codex/AGENTS.md (nível do usuário, todos os projetos) mais <projeto>/AGENTS.md (nível do projeto). Arquivos AGENTS.override.md têm prioridade em cada nível. Limite combinado de 32 KiB.

O que incluir:

Stack, frameworks, versões de linguagem, gerenciador de pacotes
Comandos exatos de build, teste e dev; copiáveis, não "execute os testes de sempre"
Convenções de estrutura de arquivos e regras de nomenclatura
Regras de estilo e padrões
Zonas proibidas: o que não tocar
Requisitos de entrega: CI, convenções de PR, mecanismo de deploy

O que não incluir:

Segredos ou credenciais (o arquivo está no controle de versão)
Orientação vaga ("escreva código limpo" não significa nada para um agente)
Documentação que duplica seu README

Mantenha abaixo de 500 palavras. Excesso de conteúdo empurra contexto útil para fora da memória de trabalho do modelo.

Um template funcional:

Verifique se o Codex está lendo: peça um resumo das instruções atuais que ele carregou
Para monorepos grandes, coloque arquivos AGENTS.md adicionais dentro de subdiretórios.
Um arquivo em packages/api/AGENTS.md tem precedência sobre o arquivo raiz para tarefas dentro daquele pacote.
Execute codex trust . para habilitar um .codex/config.toml no nível do projeto. Isso impede que um repositório clonado malicioso configure o Codex pelas suas costas.

O CLI em detalhes

Com o AGENTS.md configurado, a próxima coisa a dominar é o próprio CLI. A maioria dos usuários apenas digita codex e perde os comandos que o tornam verdadeiramente poderoso.

Existem quatro comandos que cobrem 95% do uso diário real.

codex abre o modo interativo para exploração, iteração e conversa de ida e volta com sua base de código.

codex exec "<tarefa>" executa o Codex de forma não interativa. Ele transmite para stdout e termina quando concluído. Esta é a ferramenta poderosa para qualquer coisa que possa ser scriptada:

Conecte exec em hooks do Git, pipelines de CI e cron jobs. É o bloco de construção para tudo automatizado.

codex resume --last retoma exatamente de onde você parou. Toda sessão é armazenada:

codex cloud gerencia tarefas assíncronas na nuvem, abordadas na seção Cloud abaixo.

Flags úteis:

--json : fluxo de eventos JSONL para redirecionar para outras ferramentas
--model <nome> : selecionar GPT-5.5 ou GPT-5.3-Codex
--reasoning <nivel> : baixo, médio ou alto
--search : permitir pesquisa na web durante a tarefa
-C <dir> : executar em um diretório de trabalho diferente
--sandbox <modo> : substituir o modo sandbox para esta sessão
--approval <politica> : substituir a política de aprovação para esta sessão

Sandbox e aprovações

O CLI te dá poder. O sandbox controla quanto desse poder o Codex pode exercer sem perguntar. Acertar isso mantém seu fluxo de trabalho rápido sem criar risco.

O sandbox é o limite que controla o que o Codex pode e não pode fazer. Configurá-lo corretamente evita surpresas.

Os três modos de sandbox:

workspace-write (padrão) : leitura e escrita dentro do workspace, comandos de rotina, sem rede a menos que permitido. Use quase sempre.
read-only : somente leitura, sem escrita, sem shell. Use para revisão de código e exploração.
danger-full-access : sem restrições. Use quase nunca. Reserve para automações testadas e verificadas.

As duas políticas de aprovação:

untrusted — pergunta antes de cada comando não confiável. Use ao aprender ou em um projeto desconhecido.
on-request (padrão) — aprova automaticamente comandos de sandbox de rotina, pergunta antes de qualquer coisa que quebre o limite do sandbox.

auto_review é um subagente revisor que aprova ou rejeita automaticamente com base no seu AGENTS.md.

Ative-o com approvals_reviewer = "auto_review" na configuração. Funciona bem para tarefas assíncronas longas e Modo Goal, onde você não quer supervisionar cada etapa.

Adicione comandos que constantemente pedem aprovação. Nunca adicione nada destrutivo.

Como fazer prompting eficaz no Codex

Sandbox configurado, sessões rodando. A próxima alavanca é a qualidade do prompt, que tem mais impacto na saída do que qualquer outra variável.

A maior alavanca na qualidade da saída do Codex é a estrutura do prompt. Prompts vagos produzem código vago.

O framework: Diga, Mostre, Descreva, Lembre.

Diga o resultado que você quer, não o método
Mostre exemplos de entrada e saídas esperadas
Descreva as APIs, bibliotecas e padrões a serem usados
Lembre as convenções do AGENTS.md

Nem todos os quatro são necessários todas as vezes. Uma pequena correção de bug pode precisar apenas de Diga e Lembre. Uma nova funcionalidade geralmente quer todos os quatro.

A regra da única alteração: o Codex tem um desempenho dramaticamente melhor em uma coisa do que em cinco. "Corrigir o bug de autenticação, adicionar testes, refatorar o repositório de usuário e atualizar o README" é um cara ou coroa. O mesmo trabalho dividido em quatro prompts é confiável.
Force um plano primeiro para qualquer coisa não trivial: "produza um plano primeiro, não escreva código até que eu aprove." Trinta segundos revisando um plano é melhor que trinta minutos depurando uma implementação errada.
Especifique explicitamente o comportamento em caso de falha. Deixado por conta própria, o Codex fará os testes passarem por qualquer meio necessário:

Limite o contexto explicitamente. Nomeie arquivos específicos para ler. "Não leia ou modifique mais nada. Se precisar de informações de outro lugar, me pergunte."

Níveis de esforço de raciocínio:

Baixo : edições triviais, formatação, refatorações simples
Médio (padrão) : a maioria dos trabalhos de funcionalidades e correções de bugs
Alto : decisões de arquitetura, depuração difícil, grandes refatorações em múltiplos arquivos

Modo Goal

Quando o prompting de tarefa única parecer natural, o próximo nível é dar ao Codex um objetivo de vários dias e deixá-lo sequenciar o trabalho por conta própria.

O Modo Goal é para trabalho grande demais para ser detalhado tarefa por tarefa, mas coerente o suficiente para um único objetivo. Tornou-se estável em maio de 2026.

Gerencie um Goal em execução com estes comandos:

codex goal status : veja Goals ativos e seu progresso
codex goal logs <id> : inspecione o que o Codex fez até agora
codex goal pause <id> : interrompa a execução e aguarde sua entrada
codex goal resume <id> : continue de onde parou
codex goal cancel <id> : pare e descarte o Goal

Comece com Goals delimitados. "No máximo 5 PRs" até você confiar em como o Codex interpreta seus objetivos. Um Goal descontrolado fazendo a coisa errada com confiança é o pior resultado possível.

Sempre delimite com: máximo de PRs, máximo de linhas de código por PR, gates de CI entre PRs e condições claras de parada. Pause em qualquer decisão arquitetural não coberta no AGENTS.md. Pause em qualquer alteração de API que quebre a compatibilidade.

Skills: fluxos de trabalho reutilizáveis

O Modo Goal lida com grandes iniciativas. As Skills lidam com os microfluxos de trabalho recorrentes que aparecem em todos os projetos. Se você se pegar repetindo as mesmas instruções entre sessões, esse é o sinal para escrever uma Skill.

Uma Skill é um fluxo de trabalho reutilizável empacotado como um diretório: instruções em um arquivo SKILL.md, mais recursos e scripts opcionais.

O Codex descobre Skills por nome e descrição. Ele carrega as instruções completas apenas quando uma tarefa aciona a Skill. Você pode ter 50 Skills com custo de contexto zero até que uma seja acionada.

Onde as Skills ficam:

Pessoal : $HOME/.agents/skills/ : entre projetos, reflete como você trabalha independentemente do repositório
Equipe : .agents/skills/ dentro do repositório : específica do projeto, com controle de versão, compartilhada com colaboradores

O formato SKILL.md:

As três Skills que todo usuário avançado deve escrever primeiro:

open-pr é o fluxo de trabalho padrão de PR: verificar o branch, enviar, criar o PR com um corpo estruturado, aplicar rótulos e solicitar revisão. A Skill mais usada no trabalho diário.
new-feature lê o PRD e o AGENTS.md, identifica componentes existentes para reutilizar, gera um plano, aguarda aprovação, implementa, testa e abre um PR através da Skill open-pr. Se algo no PRD for ambíguo, pergunta antes de gerar código.
investigate é a Skill de diagnosticar sem corrigir. Confirma a reprodução, lê caminhos de código relevantes, forma uma hipótese ("Acredito que X acontece porque Y") e gera a hipótese e o plano de validação como Markdown. Ela não implementa uma correção. A saída é entendimento, não código.

A Skill investigate é importante porque o Codex pulará a análise de causa raiz toda vez que você permitir. Ele pulará diretamente para uma correção, e essa correção geralmente estará errada. Forçar investigate primeiro é a maior melhoria individual na qualidade da saída de depuração.

Verifique se suas Skills estão carregadas: liste as skills disponíveis

Subagentes e paralelismo

As Skills lidam com seus fluxos de trabalho repetíveis. Os subagentes lidam com os paralelos. A distinção é importante porque o paralelismo feito errado cria mais problemas do que resolve.

Um subagente é uma instância de agente separada e isolada. Ele roda em seu próprio contexto, retorna um resumo e seu contexto é descartado. É diferente de uma Skill, que roda no contexto do agente principal.

Três padrões onde subagentes são a ferramenta certa:

Exploração : criar um subagente para ler 30 arquivos e resumir; a leitura acontece no contexto dele, não no seu
Implementação paralela : cinco funcionalidades independentes como cinco subagentes concorrentes, cada um com seu próprio contexto e plano
Verificação : um subagente revisor novo não é tendencioso por ter acabado de escrever o código

Subagentes personalizados são definidos em .codex/agents/<nome>.md:

A capacidade de endereçar subagentes foi lançada em março de 2026. Fale com um subagente em execução pelo apelido com @<apelido>.
Útil quando vários estão rodando em paralelo e você quer redirecionar um sem perturbar os outros.
O padrão fan-out: crie N subagentes em paralelo em tarefas independentes e consolide os resultados de volta.
Cinco tarefas são concluídas no tempo que a mais lenta leva. Regra prática: se uma tarefa leva menos de 30 segundos no contexto principal, faça lá.

O aplicativo desktop: Codex para tudo

Subagentes e Skills rodam igualmente bem no CLI, extensão IDE e aplicativo desktop. Mas o aplicativo desktop é onde vivem os recursos que não têm equivalente no CLI.

A atualização de 16 de abril de 2026 "Codex para (quase) tudo" transformou o aplicativo desktop de uma ferramenta de codificação em uma estação de trabalho completa para desenvolvedores.

Computer Use

O Codex opera seu Mac: clicando, digitando, rolando, abrindo aplicativos, navegando em menus e rodando ao seu lado sem roubar o foco do cursor.

O uso matador é a verificação comportamental. Testes unitários passam, mas a UI ainda está quebrada.
O Computer Use fecha essa lacuna permitindo que o Codex abra o servidor de desenvolvimento, clique no fluxo relevante e tire um screenshot do resultado.
Para ativá-lo, vá em Configurações do Codex, Computer Use, Instalar. Conceda as permissões de Gravação de Tela e Acessibilidade quando o macOS solicitar. Invoque-o a partir de qualquer prompt:

O Computer Use com tela bloqueada permite que o Codex continue operando aplicativos desktop após a tela ser bloqueada. Ative em Configurações, em Computer Use. Inicie uma tarefa antes de dormir, bloqueie a máquina e revise os resultados pela manhã.

Appshots

Pressione Command-Command e a janela frontal do macOS vai diretamente para sua thread do Codex.

O Codex captura o screenshot, o texto visível e o texto de acessibilidade; geralmente incluindo conteúdo que estava rolado para fora da tela.

Sem Appshots: veja um erro, mude para o Codex, digite uma pergunta, tire um screenshot, arraste-o, digite mais contexto. Meio minuto de atrito.
Com Appshots: veja o erro, pressione Command-Command, faça sua pergunta. Cinco segundos.

Se você interagiu com uma thread do Codex nos últimos 60 segundos, o Appshot vai para aquela conversa.

Caso contrário, abre uma nova thread. Múltiplos Appshots em uma sessão se acumulam em uma única thread. Requer permissões de Gravação de Tela e Acessibilidade.

O navegador integrado

O navegador integrado é um navegador agente nativo, não uma prévia de página. Ele abre seu servidor de desenvolvimento local, clica, preenche formulários, inspeciona o estado do DOM, captura screenshots e verifica se o patch que acabou de ser escrito corrigiu o bug visual.

Abra um servidor de desenvolvimento local dentro dele e, em seguida, adicione comentários em linguagem natural diretamente nos elementos renderizados.
Escreva "torne este botão 20 pixels mais alto" no elemento, e o Codex executa a alteração em sua base de código e recarrega a página.
O navegador integrado fornece acesso direto ao DOM sem sobrecarga de gerenciamento de janelas e é isolado em sandbox do seu navegador real.

Memória

A Memória permite que o Codex retenha contexto entre sessões.

Após cada sessão terminar, o Codex resume a interação e escreve em ~/.codex/memories/.
Na próxima sessão, ele lê esses arquivos antes de carregar seu prompt.
O Codex aprende seu formato de mensagem de commit preferido, frameworks de teste, padrões de arquitetura e os erros que cometeu da última vez; sem que você repita qualquer contexto.
Ative em Configurações ou adicione memories = true em [features] no config.toml.

O ecossistema de mais de 90 plugins

Plugins são pacotes curados de Skills, MCPs e integrações. Instale com codex plugins install <nome>.

Principais categorias de plugins:

Gerenciamento de projetos : Linear, JIRA, GitHub
CI/CD : CircleCI, Vercel, GitHub Actions
Bancos de dados : Neon, Postgres, PlanetScale
Qualidade de código : Sentry, CodeRabbit
Produtividade : Notion, Remotion

Instale apenas ferramentas que você usa diariamente. Escolha por projeto sempre que possível. Audite trimestralmente. Cada plugin custa tokens de contexto, quer você o use ou não.

Codex Cloud: trabalho assíncrono em escala

O aplicativo desktop alimenta seu trabalho local e interativo. Cloud é o que você usa quando o trabalho é grande demais para uma única sessão interativa ou quando você quer várias tarefas rodando em paralelo enquanto foca em outra coisa.

Codex Cloud é o recurso que transforma o Codex de um assistente de codificação rápido em uma equipe de engenharia júnior que escala horizontalmente.

Envie uma tarefa, o Codex cria uma sandbox pré-carregada com seu repositório, trabalha, executa testes e abre um PR. Nada bloqueia sua máquina local.

Enviando uma tarefa única:

Tarefas paralelas; o padrão principal:

Vinte minutos depois, quatro PRs estão abertos. Revise, trie, mescle.

Fan-out CSV permite que você envie um arquivo de tarefas e o Codex as distribui como agentes de nuvem paralelos com rastreamento de progresso:

codex cloud navega por tarefas ativas e concluídas. codex cloud apply <id-da-tarefa> puxa as alterações localmente antes de mesclar.

Integração com GitHub

As tarefas Cloud chegam no seu repositório como PRs. A integração com GitHub determina como esses PRs são revisados e como o Codex se alimenta do seu pipeline de CI/CD existente.

O Codex e o GitHub se integram em três níveis: ambientes de repositório, revisões de pull request e codex-action para CI/CD.

Ambientes de repositório são a base. Vincule um repositório GitHub nas Configurações do Codex e as tarefas Cloud clonarão o repositório, executarão tarefas em um contêiner com sandbox e enviarão o resultado como um branch ou PR. O AGENTS.md é lido automaticamente para cada tarefa Cloud.

As revisões de pull request funcionam de duas maneiras:

Mencione @codex review em qualquer comentário de PR. O Codex reage com um emoji de olhos para confirmar o recebimento e, em seguida, publica uma revisão estruturada focada em problemas sérios verificados em relação ao seu AGENTS.md.
Ative as Revisões Automáticas para que o Codex publique em cada novo PR sem um gatilho manual.

Depois que o Codex publica uma revisão, peça para ele corrigir os problemas identificados diretamente na thread de comentários do PR. Ele faz o commit da correção no mesmo branch e atualiza o PR.

codex-action é uma GitHub Action oficial que executa o Codex CLI dentro do seu pipeline de CI/CD em qualquer gatilho: push, agendamento, criação de issue ou abertura de PR. Esta é a maneira recomendada de integrar o Codex em pipelines totalmente automatizados, onde nenhum humano está presente.

Automações: trabalho não supervisionado

A integração com GitHub lida com o que acontece quando um humano abre um PR. As Automações lidam com o que acontece quando nenhum humano precisa estar envolvido.

Automações são tarefas agendadas do Codex executadas em worktrees dedicados. Configure-as a partir do painel de Automações: nome, projeto, prompt, cronograma e ambiente de execução.

A reutilização de threads foi lançada em abril de 2026. As Automações podem reutilizar uma thread entre execuções, acumulando contexto e ficando mais inteligentes com o tempo.

Três automações iniciais que todo projeto deveria ter:

Revisão semanal de dependências (segunda-feira 6h): Execute pnpm outdated e pnpm audit. Relate achados críticos, maiores e menores. Faça auto-PR de atualizações seguras de versões menores e patches. Não toque em atualizações críticas ou maiores; essas precisam de decisões humanas.
Triagem diária do Sentry (dias úteis 8h): Busque os erros das últimas 24 horas agrupados por impressão digital. Para cada grupo com 3 ou mais ocorrências, identifique o arquivo e a linha, leia o código relevante e identifique a causa raiz. Publique um relatório de triagem. Apenas diagnóstico, sem correções.
Limpeza semanal de PRs obsoletos (sexta-feira 17h): Liste PRs abertos há mais de 7 dias. Para cada um, determine se está esperando por você, esperando revisão ou ficou obsoleto, e publique um comentário de lembrete. Não feche ou mescle nada.

Mate qualquer automação cuja saída pare de ser lida. Uma boa automação economiza uma tarefa recorrente que você certamente faria de qualquer forma, produz uma única saída escaneável e não toma ações destrutivas sem supervisão.

Integração MCP

As Automações funcionam com o que está no seu repositório. Os servidores MCP estendem o Codex para trabalhar com tudo fora dele.

MCP (Model Context Protocol) é o padrão aberto por trás dos plugins. Use um plugin quando existir um. Use MCP puro para integrações personalizadas com ferramentas internas.

STDIO : O Codex inicia um processo local e se comunica via stdin/stdout. Cobre 95% do uso solo.
HTTP Streamable : O Codex se conecta a um endpoint de rede. Usado para MCPs de equipe hospedados.

Adicionando um servidor MCP puro:

Ou diretamente em ~/.codex/config.toml:

Configure aprovações por ferramenta: aprovação automática para leituras, perguntar antes de escrever. Cada servidor MCP adiciona definições de ferramenta ao contexto do Codex, consumindo tokens e diluindo a atenção. Ative apenas o que você realmente usa.

O Docker MCP Toolkit conecta o Codex a mais de 220 servidores pré-construídos com um comando: docker mcp-client configure codex

Aplicativo Móvel

Os servidores MCP ampliam o alcance do Codex. O aplicativo móvel amplia onde você pode alcançar o Codex.

Em 14 de maio de 2026, o Codex chegou ao aplicativo móvel do ChatGPT no iOS e Android.

O Codex Móvel é uma superfície de controle remoto e monitoramento, não um editor de código. O caso de uso típico é verificar uma tarefa de longa duração na nuvem ou uma execução do Modo Meta pelo celular enquanto está longe da sua mesa.

Pelo seu celular, você pode:

Assistir execuções ao vivo em laptops, devboxes ou ambientes remotos conectados
Navegar por threads e saltar entre tarefas paralelas
Revisar diffs antes de mesclá-los em um branch
Aprovar ou rejeitar comandos que o Codex queira executar no seu hardware
Trocar o modelo no meio da tarefa se um mais potente for necessário
Iniciar novas tarefas a partir de um prompt novo ou diretamente de uma issue do GitHub
Comentar em um pull request que o Codex abriu

Para configurar, atualize o ChatGPT para a versão de 13 de maio de 2026 ou superior, faça login com a mesma conta do desktop e garanta que pelo menos um ambiente de nuvem esteja configurado em Configurações, em Codex, Ambientes. O Móvel herda automaticamente todas as threads existentes e hosts conectados.

O ciclo prático que isso permite: inicie uma execução do Modo Meta pela manhã antes de sair de casa, verifique o progresso no trajeto, aprove uma decisão pausada pelo celular e chegue ao escritório com os dois primeiros PRs já abertos.

Extensão do Chrome

O aplicativo móvel amplia seu alcance. A extensão do Chrome amplia o alcance do Codex em qualquer site no qual você já esteja logado.

Isso significa que ela pode acessar serviços autenticados: LinkedIn, Salesforce, Gmail, Workday e qualquer ferramenta interna que exija login.
Instale-a indo em Plugins dentro do aplicativo desktop do Codex, adicionando o plugin do Chrome e seguindo a configuração guiada.
A extensão mostra o status Conectado quando ativa. Invoque-a a partir de qualquer thread do Codex:

O Codex pode controlar várias abas do Chrome por meio de subagentes em diferentes threads, cada aba isolada.

Uma grande vantagem sobre a automação headless de navegador: a extensão do Chrome pode acessar as ferramentas de desenvolvedor web. O Codex pode inspecionar o DOM, ler erros do console e diagnosticar problemas de runtime em uma sessão de navegador ao vivo. Funciona tanto no macOS quanto no Windows.

O SDK do Codex

A extensão do Chrome cuida da automação de navegador. O SDK cuida da automação programática, incorporando o Codex como infraestrutura dentro de suas próprias aplicações e pipelines.

O SDK do Codex dá aos desenvolvedores controle programático sobre o Codex a partir de suas próprias aplicações e pipelines de CI.

Instale o SDK JavaScript:

Uso básico:

Chame run() novamente na mesma thread para continuar a conversa. Retome uma thread salva com codex.resumeThread(threadId).
O SDK Python usa from codex_app_server import Codex. Passe um nome de modelo ao iniciar: thread = codex.thread_start(model="gpt-5.5").
O SDK é atualmente experimental e requer uma instalação local da CLI do Codex.
Ele se comunica com o app-server local via JSON-RPC; ele controla o mesmo agente com o qual você interage no aplicativo desktop.

Verificação: Como Realmente Confiar na Saída do Codex

Todas as superfícies acima produzem saída. A verificação é o que determina quanto dessa saída você pode realmente enviar para produção.

A geração está resolvida. A verificação é o gargalo.

Cinco PRs paralelos na nuvem são cinco chances de enviar um bug. Sem uma camada de verificação, sua produtividade é limitada pela velocidade com que você consegue ler PRs.

O problema central é a bajulação. O modelo que escreveu o código tem um viés para achar que ele está correto. Peça para ele revisar o próprio trabalho e você receberá um "joinha" na maioria das vezes.

Duas correções estruturais:

auto_review (dentro do Codex) é o subagente revisor nativo do Codex. Contexto novo, sem investimento na saída anterior, muito mais propenso a sinalizar problemas reais.
Verificação entre provedores (padrão ouro) significa Codex escreve e Claude Code revisa. A verificação entre provedores captura pontos cegos específicos de uma família de modelos. Este é o hábito mínimo viável de verificação para código de produção.

Uso do Computador para verificação comportamental fecha a lacuna entre "testes passam" e "a coisa realmente funciona." Peça ao Codex para abrir o servidor de desenvolvimento, navegar pelo fluxo relevante, capturar a tela do resultado e compará-lo com seu PRD.

O hábito mínimo viável em cada PR: execute uma revisão automatizada com um modelo diferente antes de abrir o diff você mesmo. Leia o resumo da revisão primeiro. Só abra o diff quando a revisão estiver limpa; então leia para avaliar o estilo, não a correção. Para mudanças de UI, olhe a captura de tela.

Receitas: Padrões Testados em Batalha

Com os hábitos de verificação em prática, aqui estão os templates completos para as tarefas que os desenvolvedores executam com mais frequência através do Codex.

Implementar uma funcionalidade: use a Skill nova-funcionalidade. Leia o PRD e o AGENTS.md. Planeje primeiro, aguarde aprovação. Testes para o caminho feliz e um caso de erro. Se algo estiver ambíguo, pergunte antes de gerar código.
Corrigir um bug: use a Skill investigar primeiro. Diagnostique apenas. Produza etapas de reprodução, hipótese da causa raiz e um plano de validação. Não corrija até que seja confirmado.
Refatorar: liste todos os locais com grep. Produza o plano de migração. Aguarde aprovação. Todos os testes existentes devem passar inalterados. Se um teste precisar de atualização, o teste está errado; pare e reporte. Um PR.
Integração de terceiros: envolva em /lib/integrations/[nome].ts. Adicione variáveis de ambiente ao .env.example. Sem UI neste PR. Abra como rascunho para teste manual contra o serviço externo.
Preenchimento de testes: produza o plano de teste cobrindo casos felizes, de borda e de erro. Aguarde aprovação. Todos os testes devem passar contra o código de produção existente. Não modifique o código de produção.
Atualização de dependência: leia as notas de lançamento entre versões. Liste as mudanças críticas. Aguarde aprovação. Atualize e aplique as mudanças de código. Execute os testes até ficar limpo.
Iniciativa do Modo Meta: limite com máximo de PRs, máximo de linhas de código por PR, portão de CI entre PRs e condições de parada claras. Pause em decisões arquiteturais que não estão no AGENTS.md. Pause em qualquer mudança de API que quebre a compatibilidade.

Erros Comuns

Esses padrões cobrem os ganhos comuns. A seção abaixo cobre as perdas comuns; os dez erros que explicam a maioria das experiências ruins com o Codex.

Tarefas vagas. Nomeie resultados, arquivos e restrições específicos. Se você não puder ser específico, a tarefa não está pronta para ser passada.

Sem AGENTS.md. Escreva um. Mesmo um ruim é melhor que nada.

Pular o plano. "Produza um plano primeiro" em qualquer coisa não trivial.

Prompts multitarefa. Uma tarefa por prompt. Use subagentes ou tarefas na nuvem para trabalho paralelo.

Começar com acesso-perigoso-total. workspace-write e sob-solicitação é o padrão correto para tudo, exceto automações testadas.

Muitos MCPs e plugins. Mantenha a lista enxuta. Desative o que você não usa ativamente.

Auto-revisão. Use auto_review ou uma ferramenta completamente diferente. O modelo que escreveu o código tem um viés em relação a ele.

Confiar em compilação-bem-sucedida como correção. Inclua verificação comportamental. Use Uso do Computador para mudanças de UI.

Paralelizar em excesso. Paralelize apenas trabalho independente. Arquivos compartilhados devem ser serializados.

Metas sem limites. Máximo de PRs, máximo de linhas de código, tempo máximo, condições de parada claras. O Modo Meta é mais útil com a rédea que você daria a um desenvolvedor júnior.

Folha de Consulta Rápida

Comandos da CLI:

Localizações principais de arquivos:

Configuração global: ~/.codex/config.toml
AGENTS.md global: ~/.codex/AGENTS.md
AGENTS.md do projeto: <raiz-do-repositorio>/AGENTS.md
Arquivo de substituição: AGENTS.override.md
Memórias: ~/.codex/memories/
Skills (pessoais): $HOME/.agents/skills/
Skills (equipe): .agents/skills/ dentro do repositório
Subagentes: .codex/agents/<nome>.md

A estrutura do prompt em quatro partes:

Diga : o resultado, não o método
Mostre : exemplos de entrada e saídas esperadas
Descreva : as APIs, bibliotecas e padrões a serem usados
Lembre : convenções do AGENTS.md

Conclusão

Após 12 meses usando o Claude, o ponto de ruptura não foi um dia ruim. Foi o acúmulo de limites de taxa, atrito no fluxo de trabalho e uma experiência do aplicativo desktop que continuava atrapalhando.

Essa frustração foi o que impulsionou a mudança para o Codex.

Nos últimos 90 dias, mergulhar fundo no ecossistema da OpenAI deixou uma coisa clara: o Codex parece mais completo como um ambiente de trabalho para fluxos de trabalho sérios de desenvolvimento.
O modelo agêntico é mais forte, as superfícies ao redor são mais amplas e o sistema é mais fácil de confiar uma vez que AGENTS.md, Skills, Nuvem e loops de verificação estão em vigor.
Isso não significa que o Claude Code não tem valor. Significa que as concessões deixaram de fazer sentido.

Se o Claude Code ainda funciona para o seu fluxo de trabalho, continue usando-o. Mas se você está cansado de limites de taxa, sessões frágeis e ferramentas que parecem estar lutando contra o seu processo, o Codex agora é bom o suficiente para justificar uma mudança séria.

Este artigo foi escrito para facilitar essa mudança.

Espero que tenha gostado e comece a construir ❤️

Aviso Legal

Este artigo foi escrito pelo autor com base em suas anotações, pesquisas e experiências pessoais, e editado por um modelo de IA (Sonnet 4.6).

A imagem de miniatura foi retirada do Pinterest e modificada usando IA.