tutorial · Codex no Claude Code

Coloque o Codex para revisar o código do Claude

Com o plugin oficial da OpenAI, o Codex trabalha dentro do Claude Code. O Claude escreve, o Codex revisa e investiga bug, e você não troca de janela.

Passo 2 e Passo 3
/plugin marketplace add openai/codex-plugin-cc/plugin install codex@openai-codex/reload-plugins/codex:setup
Como funciona

Como funciona

O plugin é da própria OpenAI e foi feito para quem já usa o Claude Code. Ele não traz um Codex separado. Ele usa o Codex instalado no seu computador, com o mesmo login, as mesmas configurações e a mesma pasta do projeto. Você chama o Codex por comandos que começam com /codex:, dentro do Claude Code.

01

Revisar o que mudou no código

/codex:review

02

Uma revisão que questiona as decisões do código

/codex:adversarial-review

03

Passar um bug ou uma tarefa para o Codex

/codex:rescue

04

O Codex conferir cada resposta do Claude que mexeu no código

/codex:setup --enable-review-gate

05

Levar a conversa do Claude Code para o Codex

/codex:transfer

06

Acompanhar, ver o resultado ou cancelar uma tarefa

/codex:status · /codex:result · /codex:cancel

Antes de começar

Pré-requisitos

01

O Claude Code instalado e funcionando.

O plano Free do Claude não inclui o Claude Code; Pro, Max, Team e Enterprise incluem. O Pro custa US$ 20 por mês no mensal, ou US$ 200 por ano. Se você ainda não usa o Claude Code, comece pelo manual Claude Code na Prática, no gratis.denderson.ai.

02

Uma conta do ChatGPT, e pode ser a gratuita, ou uma chave da API da OpenAI.

O uso do plugin conta no limite de uso do Codex da sua conta. Com chave da API, o uso é cobrado pelo preço da API.

03

O Node.js na versão 18.18 ou mais nova.

04

Para a revisão, um projeto versionado com git e com alguma mudança feita.

Passo a passo

Passo a passo

Os comandos estão exatamente como no README. Os nomes de botão ficam em inglês porque é assim que o plugin mostra.

0 de 8 passos concluídos

O plugin roda com o Node.js, e a versão mínima é a 18.18. Dentro do Claude Code, o ! no começo da linha roda o comando direto no terminal e coloca a resposta na conversa. Se aparecer um número menor que 18.18, ou um erro dizendo que o comando não existe, baixe o instalador da versão LTS em nodejs.org/en/download, instale, feche e abra o Claude Code de novo e confira outra vez.

Comando
!node --version
Como saber que deu certo

Aparece v18.18.0 ou um número maior.

O primeiro comando adiciona ao seu Claude Code o marketplace da OpenAI, que vem do repositório oficial openai/codex-plugin-cc. O segundo instala o plugin codex desse marketplace. O terceiro recarrega os plugins, como a OpenAI manda fazer depois da instalação. Digite um, aperte Enter, espere terminar e só então digite o próximo.

Comando 1, adicionar o marketplace
/plugin marketplace add openai/codex-plugin-cc
Comando 2, instalar o plugin
/plugin install codex@openai-codex
Comando 3, recarregar os plugins
/reload-plugins
Como saber que deu certo

Ao digitar /codex: aparecem os comandos do plugin. Em /agents aparece o agente codex:codex-rescue.

O plugin conversa com o Codex CLI, o Codex de terminal instalado no seu computador. O /codex:setup confere o Node.js, o npm, o Codex e o login. Se o Codex não estiver instalado e o npm estiver disponível, ele pergunta se pode instalar, com as opções Install Codex (Recommended) e Skip for now. Escolha Install Codex (Recommended). Se preferir instalar você mesmo, rode o segundo comando no terminal do seu computador.

Comando
/codex:setup
Para instalar o Codex você mesmo, no terminal
npm install -g @openai/codex
Como saber que deu certo

O setup mostra o Codex instalado. Se ainda faltar o login, ele manda rodar !codex login, que é o próximo passo.

Se você já usa o Codex neste computador, o plugin aproveita esse login e você pode pular este passo. Se nunca usou, rode o comando abaixo dentro do Claude Code. Ele abre o navegador para você entrar com a conta do ChatGPT, e a conta gratuita serve. Se o navegador não abrir ou o login for bloqueado, o próprio plugin indica o login por código de dispositivo, o segundo comando. Quem prefere usar chave da API da OpenAI faz o login com a opção --with-api-key, que lê a chave pela entrada do terminal.

Comando
!codex login
Se o login pelo navegador não funcionar
!codex login --device-auth
Como saber que deu certo

Rode /codex:setup de novo. Ele diz que o Codex está pronto.

Abra o Claude Code na pasta de um projeto com git e com alguma mudança feita, por você ou pelo Claude. O /codex:review revisa as mudanças que ainda não foram para um commit. Ele só lê e não altera nada. É a mesma revisão que o comando /review faz dentro do próprio Codex. Revisão com muitos arquivos pode demorar, e a OpenAI recomenda rodar em segundo plano, com o --background, enquanto você segue usando o Claude. O /codex:status mostra se a revisão ainda está rodando, e o /codex:result mostra o resultado quando ela termina. Para revisar a sua branch inteira comparada com a main, use o comando com --base main.

Comandos, um de cada vez
/codex:review --background
/codex:status
/codex:result
Para revisar a branch inteira contra a main
/codex:review --base main
Como saber que deu certo

O /codex:result mostra a revisão completa do Codex sobre as suas mudanças.

O /codex:rescue entrega a tarefa para o Codex por um agente do plugin, o codex:codex-rescue. Serve para investigar um bug, tentar um conserto, continuar uma tarefa anterior do Codex ou fazer uma passada mais rápida e mais barata com um modelo menor. Diferente da revisão, aqui o Codex pode mexer nos arquivos do projeto. Por padrão o agente roda o Codex com permissão de escrita, a não ser que você peça só leitura, diagnóstico ou pesquisa. O texto depois do comando é o pedido.

Tarefa longa pode demorar, então use --background e acompanhe pelo /codex:status. Para continuar a última tarefa, use --resume. Para começar do zero, use --fresh. Sem nenhum dos dois, o plugin pode perguntar se você quer continuar a última conversa do Codex neste projeto. Para escolher o modelo e o esforço, use --model e --effort. Sem eles, o Codex usa os padrões dele, e a palavra spark vira o modelo gpt-5.3-codex-spark.

Exemplos do README
/codex:rescue investigate why the tests started failing
/codex:rescue fix the failing test with the smallest safe patch
/codex:rescue --resume apply the top fix from the last run
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test
/codex:rescue --model spark fix the issue quickly
/codex:rescue --background investigate the regression

Você também pode só pedir na conversa para o Claude delegar a tarefa ao Codex, como no exemplo do README:

Comando
Ask Codex to redesign the database connection to be more resilient.
Como saber que deu certo

A resposta do Codex aparece na conversa do jeito que ele escreveu. Em segundo plano, ela aparece no /codex:result.

Com a review gate ligada, toda vez que o Claude vai encerrar uma resposta, o plugin roda uma revisão do Codex focada no que o Claude acabou de fazer. Se o Codex achar problema, a resposta não termina e o Claude corrige primeiro. A revisão só barra quando o Claude mexeu no código naquela resposta. Resposta que só traz status, resumo ou resultado de comando passa direto. A OpenAI avisa que isso pode virar um vaivém longo entre o Claude e o Codex e gastar o limite de uso rápido, então ligue só quando for acompanhar a sessão. O segundo comando desliga.

Comandos
/codex:setup --enable-review-gate
/codex:setup --disable-review-gate
Como saber que deu certo

O /codex:status mostra a situação da review gate junto com as tarefas do Codex.

/codex:adversarial-review. Uma revisão que questiona a solução e o design escolhidos, as premissas, os trade-offs, os pontos de falha e se outro caminho seria mais seguro ou mais simples. Diferente do /codex:review, ela aceita um texto de foco depois das opções. Também só lê e não conserta nada. O resultado traz um veredito, aprovado ou precisa de atenção, o resumo, cada problema com a gravidade, o arquivo, as linhas e a recomendação, e os próximos passos.

Comando
/codex:adversarial-review
/codex:adversarial-review --base main challenge whether this was the right caching and retry design
/codex:adversarial-review --background look for race conditions and question the chosen approach

/codex:transfer. Cria uma conversa no Codex a partir da sessão atual do Claude Code e mostra o comando codex resume com o ID da sessão, para você continuar no app do Codex ou no terminal. Versões antigas do Codex, sem importação de sessão, precisam ser atualizadas antes.

Comando
/codex:transfer

/codex:status. Mostra as tarefas do Codex rodando e as recentes neste repositório.

Comando
/codex:status
/codex:status task-abc123

/codex:result. Mostra o resultado final de uma tarefa terminada e, quando tem, o ID da sessão do Codex para reabrir com codex resume.

Comando
/codex:result
/codex:result task-abc123

/codex:cancel. Cancela uma tarefa do Codex que está rodando em segundo plano.

Comando
/codex:cancel
/codex:cancel task-abc123
Como saber que deu certo

Cada comando responde na conversa do Claude Code.

O que dá e o que não dá

Dá

  • Revisar as mudanças ainda sem commit ou a branch inteira comparada com a main.
  • Pedir uma revisão que questiona as decisões do código, com o foco que você escolher.
  • Passar bug e tarefa para o Codex investigar e tentar consertar, em primeiro ou em segundo plano.
  • Fazer o Codex conferir cada resposta do Claude que mexeu no código, com a review gate.
  • Levar a conversa do Claude Code para o Codex e continuar lá.
  • Usar o login e as configurações do Codex que você já tem.

Não dá

  • Fazer o /codex:review ou o /codex:adversarial-review mudarem código. Os dois só leem.
  • Dar um foco para o /codex:review. Para isso existe o /codex:adversarial-review.
  • Inverter os papéis por comando. O plugin não tem comando para o Codex escrever e o Claude revisar.
  • Usar no plano Free do Claude, que não inclui o Claude Code.
  • Rodar o plugin com Node.js anterior ao 18.18.

FAQ

Não. O plugin funciona com qualquer conta do ChatGPT, inclusive a gratuita, ou com chave da API da OpenAI. No Free, a OpenAI apresenta o Codex para tarefas rápidas de código, e o uso conta no limite do Codex da sua conta. Com chave da API, o uso é cobrado pelo preço da API.

Não. Se você já entrou no Codex neste computador, o plugin usa esse login. Se nunca usou, entre com a conta do ChatGPT ou com uma chave da API pelo codex login, como no Passo 4.

Sim. É o mesmo Codex, com o mesmo login, a mesma pasta do projeto e as mesmas configurações. Para mudar o modelo ou o esforço padrão, coloque no config.toml do Codex. O ~/.codex/config.toml vale para todos os projetos, e o .codex/config.toml na raiz do projeto vale só para ele, desde que o projeto esteja marcado como confiável no Codex. O exemplo do README usa o gpt-5.4-mini com esforço alto:

Configuração
model = "gpt-5.4-mini"
model_reasoning_effort = "high"

A /codex:review e a /codex:adversarial-review só leem. O /codex:rescue pode mudar arquivos, porque roda com permissão de escrita por padrão, a não ser que você peça só leitura. Na review gate, o Codex revisa e quem corrige é o Claude.

Não, porque o plano Free do Claude não inclui o Claude Code. O plano gratuito que funciona é o do ChatGPT, do lado do Codex.

Dá. Rode codex resume com o ID da sessão que o /codex:result ou o /codex:status mostram, ou escolha a sessão na lista. Assim você revisa ou continua o trabalho por lá.

IMERSÃO AGENTE DE IA NA PRÁTICA

Aprenda a criar agentes de IA que te ajudam a faturar +100k sem aumentar nenhuma pessoa no time.

Imersão AGENTE DE IA NA PRÁTICA. Participe.

Quero participar