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 baseada em agentes. Ele lê seu código, escreve e testa código, revisa pull requests, controla seu desktop Mac, 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 juniores que nunca dorme.

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

Nunca escrevem uma Skill. Nunca usam sub-agentes. Usam 5% da superfície e julgam a ferramenta com base nesses 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 quão de perto você acompanha seu trabalho e onde o código é executado.

CLI é para fluxos de trabalho com script, tarefas únicas e automação headless. Seu código nunca sai da sua máquina a menos que você o envie. Open source, 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.

Desktop app é o lar de fluxos de trabalho multithread, o navegador embutido, Computer Use, Goal mode, Appshots e Automations. 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 containers isolados pré-carregados com seu repositório GitHub. Nada bloqueia sua máquina local.

Navegador embutido e Computer Use são 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, captura a tela do resultado e verifica se as alterações de 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 a objetivos (Goal) e de longa duração

O principal fator na escolha de uma superfície é o quão de perto você quer acompanhar o trabalho do agente. Se você quiser monitorar as alterações conforme são feitas, a CLI ou IDE mantém o trabalho na sua máquina e na sua frente. Se 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 em "escreva uma função que faça X" e mais em "implemente a funcionalidade Y, aqui estão as restrições, execute os testes quando terminar."

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

Pare de pensar no Codex como um assistente de codificação. Comece a pensar nele como uma equipe de engenheiros juniores que você briefs pela manhã e revisa à tarde.

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

Os modelos atuais em 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 em nuvem; 25% mais rápido que o especialista Codex anterior
• GPT-5.5 Pro — maior poder de raciocínio; 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 o GPT-5.3-Codex para tarefas grandes e agentivas onde o Codex executa autonomamente por um longo período.

Primeiros Passos: Sua Primeira Sessão Real

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

Etapa 1: Instale a CLI.

Etapa 2: Abra um projeto real.

Navegue até um repositório de baixo risco que você já conhece. Isso importa.

O Codex tem melhor desempenho quando você consegue reconhecer a saída e identificar erros. Trabalhar em um código desconhecido na primeira sessão produz resultados imprevisíveis.

Faça login com sua conta do 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. Codex escaneia seu diretório e histórico Git, identifica linguagens, frameworks, comandos de build e de teste, e cria um arquivo AGENTS.md preenchido com o que encontra.

Revise o arquivo gerado, ajuste qualquer coisa errada e faça 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 o código antes de pedir para alterar algo. Isso constrói sua confiança em qual contexto ele carregou:

<code-segment id="0" lang="text">

Read the top-level directory structure and summarize the project's architecture. Identify the main entry points and data flow.

</code-segment>

Leia a saída. Se ela descrever seu 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.

<code-segment id="1" lang="text">

In src/utils/validation.ts, add a validateEmail function that takes a string and returns a boolean. Use the existing regex pattern from the AGENTS.md conventions. After implementation, run the test suite for that file.

</code-segment>

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. Agora você está usando o Codex corretamente.

Etapa 6: Instale o desktop app. Baixe do site da OpenAI. Faça login com a mesma conta do 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 dentro do app Codex e conecte sua conta do GitHub. Vincule pelo menos um repositório antes de usar tarefas em nuvem.

Onde as coisas ficam:

• ~/.codex/config.toml : config principal: modo de aprovação, modo sandbox, servidores MCP, padrões de modelo
• ~/.codex/AGENTS.md : AGENTS.md pessoal, aplica-se a todos os projetos
• <project>/AGENTS.md : instruções no nível do projeto
• <project>/.agents/skills/ : Skills no nível do projeto
• <project>/.codex/config.toml : config com escopo de 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 toda sessão futura começar com a mesma qualidade. É isso que o AGENTS.md faz.

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

Ordem de resolução: Codex lê ~/.codex/AGENTS.md (nível pessoal, todos os projetos) mais <project>/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ão
• 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ções vagas ("escreva código limpo" não significa nada para um agente)
• Documentação que duplica seu README

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

Um template funcional:

<code-segment id="2" lang="text">

Project: analytics-dashboard

Stack

• Next.js 15 (App Router), TypeScript 5.7, Tailwind 4
• PostgreSQL via Prisma ORM
• Vitest for unit tests, Playwright for e2e

Commands

• Build: npm run build
• Dev: npm run dev
• Test (unit): npm run test
• Test (e2e): npm run test:e2e
• Lint: npm run lint

Structure

• src/app/ — route groups and pages
• src/components/ — shared UI components
• src/lib/ — business logic, utils, API clients
• prisma/ — schema and migrations

Conventions

• Components: named exports, PascalCase files
• Functions: arrow functions for hooks, named functions for utilities
• No default exports in components (breaks lazy loading)
• No barrel files (index.ts that re-export)
• Imports: absolute within src/ (e.g. @/components/Header)

Don't touch

• prisma/migrations/ — managed by Prisma CLI only
• Any file under src/app/api/ — API routes are stable
• Environment variables — never read or set them

CI

• PR must pass npm run build and npm run test
• PR title must follow conventional commits (feat:, fix:, chore:) </code-segment>

• Verifique se o Codex está lendo: peça para ele resumir as instruções atuais que 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 sem seu conhecimento.

A CLI em Profundidade

Com o AGENTS.md configurado, a próxima coisa a dominar é a própria CLI. A maioria dos usuários só digita codex e perde os comandos que a tornam genuinamente poderosa.

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 seu código.

codex exec "<task>" executa o Codex de forma não interativa. Ele transmite para stdout e sai quando termina. Esta é a ferramenta poderosa para qualquer coisa com script:

<code-segment id="3" lang="text">

codex exec "Add input validation to all API routes in src/app/api/"

</code-segment>

Conecte exec em git hooks, pipelines 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:

<code-segment id="4" lang="text">

codex resume --last --reasoning high

</code-segment>

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

Flags úteis:

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

Sandbox e Aprovações

A CLI lhe dá poder. O sandbox controla quanto desse poder o Codex pode exercer sem pedir permissão. 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:

1. workspace-write (padrão) : ler e escrever dentro do workspace, comandos de rotina, sem rede a menos que permitido. Use isso quase sempre.
2. read-only : apenas leitura, sem gravação, sem shell. Use para revisão de código e exploração.
3. 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 sandbox de rotina, pergunta antes de qualquer coisa que quebre o limite do sandbox.

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

Ative-o com approvals_reviewer = "auto_review" na config. Funciona bem para tarefas assíncronas longas e Goal mode onde você não quer ficar de olho em cada etapa.

<code-segment id="5" lang="text">

[sandbox]

commands_require_approval = ["rm *", "dropdb", "git push --force"]

</code-segment>

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

Como Dar Prompts Eficazes ao 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 a ele o resultado que você quer, não o método
• Mostre a ele exemplos de entrada e saída esperada
• Descreva as APIs, bibliotecas e padrões a serem usados
• Lembre a ele das convenções do AGENTS.md

Nem todos os quatro são necessários toda vez. Um pequeno conserto de bug pode precisar apenas de Diga e Lembre. Uma nova funcionalidade geralmente quer todos os quatro.

1. A regra de uma única alteração: Codex tem desempenho dramaticamente melhor em uma coisa do que em cinco. "Corrija o bug de autenticação, adicione testes, refatore o repositório de usuário e atualize o README" é um cara ou coroa. O mesmo trabalho dividido em quatro prompts é confiável.
2. 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 do que trinta minutos debugando uma implementação errada.
3. Especifique o comportamento de falha explicitamente. Deixado por conta própria, Codex fará os testes passarem por qualquer meio necessário:

<code-segment id="6" lang="text">

Fix the flaky test in tests/checkout.test.ts. The test must verify that the redirect URL contains the order ID. Do not modify the test's structure or assertions. If the implementation is wrong, fix the implementation, not the test.

</code-segment>

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 funcionalidade e correções de bugs
• Alto : decisões de arquitetura, debug difícil, grandes refatorações multi-arquivo

Goal Mode

Quando prompts de tarefa única parecem naturais, o próximo nível é dar ao Codex um objetivo de vários dias e deixá-lo sequenciar o trabalho sozinho.

Goal mode é para trabalho grande demais para ser descrito 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:

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

<code-segment id="7" lang="text">

codex goal start "Implement the onboarding flow" --max-prs 5 --max-loc 300 --stop-on-arch

</code-segment>

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 limite com: max PRs, max linhas de código por PR, portões de CI entre PRs e condições de parada claras. Pause em qualquer decisão arquitetural não coberta no AGENTS.md. Pause em qualquer mudança de API que quebre compatibilidade.

Skills: Fluxos de Trabalho Reutilizáveis

Goal mode lida com grandes iniciativas. Skills lidam com os micro-fluxos de trabalho recorrentes que aparecem em todo projeto. Se você se vê repetindo as mesmas instruções entre sessões, esse é seu 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.

Codex descobre Skills pelo 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ífico do projeto, controlado por versão, compartilhado com colaboradores

O formato SKILL.md:

<code-segment id="8" lang="text">

name: "open-pr"

description: "Open a pull request with a structured body"

trigger: "When the user says 'open a PR' or 'create PR'"

1. Check the current branch name (not main/master)
2. Push the branch to origin
3. Create the PR with:
4. Title derived from branch name
5. Body: summary of changes, testing notes, and screenshots
6. Labels: auto-detected from branch prefix (feat:, fix:, chore:)
7. Request review from the team listed in AGENTS.md </code-segment>

As três Skills que todo power user deve escrever primeiro:

1. open-pr é o fluxo de trabalho padrão de PR: verificar o branch, enviar, criar o PR com um corpo estruturado, aplicar labels e solicitar revisão. A Skill mais usada no trabalho diário.
2. 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 via a Skill open-pr. Se algo no PRD for ambíguo, pergunta antes de gerar código.
3. 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. 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 muitas vezes estará errada. Forçar investigate-first é a maior melhoria na qualidade da saída de debugging.

Verifique se suas Skills estão carregadas: codex skills list

Sub-agentes e Paralelismo

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

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

Três padrões onde sub-agentes são a ferramenta certa:

1. Exploração : crie um sub-agente para ler 30 arquivos e resumir; a leitura acontece no contexto dele, não no seu
2. Implementação paralela : cinco funcionalidades independentes como cinco sub-agentes concorrentes, cada um com seu próprio contexto e plano
3. Verificação : um sub-agente revisor novo não é enviesado por ter acabado de escrever o código

Sub-agentes personalizados são definidos em .codex/agents/<name>.md:

<code-segment id="9" lang="text">

Reviewer agent

You are a strict code reviewer. You only comment on correctness, security, and AGENTS.md compliance. You do not suggest style changes or refactors unless they affect correctness.

</code-segment>

• Endereçamento de sub-agente foi lançado em março de 2026. Fale com um sub-agente 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 sub-agentes em paralelo em tarefas independentes e combine os resultados de volta.
• Cinco tarefas são concluídas no tempo da mais lenta. Regra geral: se uma tarefa leva menos de 30 segundos no contexto principal, apenas faça ali.

O Desktop App: Codex para Tudo

Sub-agentes e Skills funcionam igualmente bem na CLI, extensão IDE e desktop app. Mas o desktop app é onde vivem os recursos que não têm equivalente na CLI.

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

Computer Use

Codex opera seu Mac: clicando, digitando, rolando, abrindo aplicativos, navegando em menus e executando 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.
• Computer Use fecha essa lacuna ao permitir que o Codex abra o servidor de desenvolvimento, clique no fluxo relevante e capture a tela do resultado.
• Para ativá-lo, vá em Codex Settings, Computer Use, Install. Conceda permissões de Gravação de Tela e Acessibilidade quando o macOS solicitar. Invoque-o a partir de qualquer prompt:

<code-segment id="10" lang="text">

Open the dev server at localhost:3000 and verify the checkout flow completes. Use Computer Use.

</code-segment>

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

Appshots

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

Codex captura a captura de tela, o texto visível e o texto de acessibilidade; muitas vezes incluindo conteúdo rolado para fora da tela.

• Sem Appshots: veja um erro, mude para o Codex, digite uma pergunta, tire uma captura de tela, arraste-a, 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 um thread do Codex nos últimos 60 segundos, o Appshot vai para aquela conversa.

Caso contrário, abre um novo thread. Vários Appshots em uma sessão se acumulam em um thread. Requer permissões de Gravação de Tela e Acessibilidade.

O Navegador Embutido

O navegador embutido é um navegador agêntico 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 capturas de tela e verifica se o patch recém-escrito corrigiu o bug visual.

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

Memória

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

• Após cada sessão terminar, Codex resume a interação e escreve em ~/.codex/memories/.
• Na próxima sessão, ele lê esses arquivos antes de carregar seu prompt.
• 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 nenhum desse contexto.
• Ative em Configurações, ou adicione memories = true sob [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 <name>.

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 para ferramentas que você usa diariamente. Escopo por projeto quando 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 desktop app 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 inicia um sandbox pré-carregado com seu repositório, trabalha, executa testes e abre um PR. Nada bloqueia sua máquina local.

Enviando uma tarefa única:

<code-segment id="11" lang="text">

codex cloud submit "Add pagination to the users table"

</code-segment>

Tarefas paralelas; o padrão central:

<code-segment id="12" lang="text">

codex cloud submit "Add pagination to the users table" &

codex cloud submit "Add filtering to the orders table" &

codex cloud submit "Add sorting to the products table" &

codex cloud submit "Add search to the invoices table" &

</code-segment>

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

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

<code-segment id="13" lang="text">

codex cloud submit --from-file tasks.csv

</code-segment>

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

Integração com GitHub

Tarefas em nuvem chegam ao seu repositório como PRs. A integração com GitHub determina como esses PRs são revisados e como o Codex se alimenta de seu pipeline existente de CI/CD.

Codex e 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 em nuvem clonarão o repositório, executarão tarefas em um container isolado e enviarão o resultado como um branch ou PR. AGENTS.md é lido automaticamente para toda tarefa em nuvem.

Revisões de pull request funcionam de duas maneiras:

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

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

codex-action é uma GitHub Action oficial que executa a CLI do Codex dentro do seu pipeline 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.

Automations: Trabalho Não Supervisionado

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

Automations são tarefas do Codex agendadas executadas em worktrees dedicados. Configure-as no painel Automations: nome, projeto, prompt, agendamento e ambiente de execução.

Reutilização de thread foi lançada em abril de 2026. Automations podem reutilizar um thread entre execuções, acumulando contexto e ficando mais inteligentes ao longo do tempo.

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

1. Revisão semanal de dependências (segunda-feira 6h): Execute pnpm outdated e pnpm audit. Relate descobertas críticas, maiores e menores. Auto-PR para upgrades menores e de patch seguros. Não toque em atualizações críticas ou maiores; essas precisam de decisões humanas.
2. Triage diário 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 linha, leia o código relevante e identifique a causa raiz. Publique um relatório de triagem. Apenas diagnóstico, sem correções.
3. Limpeza semanal de PRs antigos (sexta-feira 17h): Liste PRs abertos com 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ê definitivamente faria de qualquer forma, produz uma única saída escaneável e não toma ações destrutivas sem supervisão.

Integração MCP

Automations trabalham com o que está no seu repositório. Servidores MCP estendem o Codex para trabalhar com tudo fora dele.

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

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

Adicionando um servidor MCP bruto:

<code-segment id="14" lang="text">

codex mcp add my-custom-tool --command "npx @my-org/mcp-server --port 8080" --transport stdio

</code-segment>

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

<code-segment id="15" lang="toml">

[mcp_servers.my-custom-tool]

command = "npx @my-org/mcp-server --port 8080"

transport = "stdio"

</code-segment>

``markdown
Configure aprovações por ferramenta: aprovação automática para leituras, perguntar antes de escrever. Cada servidor MCP adiciona definições de ferramentas 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 estendem o alcance do Codex. O aplicativo móvel estende 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 longa em execução na nuvem ou uma execução no modo Goal pelo celular enquanto você está longe da sua mesa.

Pelo seu celular, você pode:

- Acompanhar execuções ao vivo em laptops, devboxes ou ambientes remotos conectados
- Navegar por threads e saltar entre tarefas paralelas
- Revisar diffs antes de serem mesclados em um branch
- Aprovar ou rejeitar comandos que o Codex deseja executar no seu hardware
- Trocar o modelo no meio de uma 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 da versão desktop e garanta que pelo menos um ambiente de nuvem esteja configurado em Configurações, em Codex, Ambientes. O aplicativo móvel herda automaticamente todas as threads existentes e hosts conectados.

O ciclo prático que isso possibilita: iniciar uma execução no modo Goal pela manhã antes de sair de casa, verificar o progresso no trajeto, aprovar uma decisão pausada pelo celular e chegar no escritório com os dois primeiros PRs já abertos.

## Extensão para Chrome

O aplicativo móvel estende seu alcance. A extensão para Chrome estende o alcance do Codex para 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 acessando 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 para Chrome pode acessar as ferramentas de desenvolvedor web. O Codex pode inspecionar o DOM, ler erros do console e diagnosticar problemas de execução em uma sessão de navegador ao vivo. Funciona tanto no macOS quanto no Windows.

## O SDK do Codex

A extensão para 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:

``javascript

npm install codex-app-server
``

Uso básico:

``javascript

import { Codex } from "codex-app-server";

// Iniciar uma thread Codex

const codex = new Codex();

codex.auth.setToken("seu-token");

const thread = await codex.thread_start();

const reply = await thread.run("Explique a arquitetura do projeto");