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.
- 8 passos
- Fatos conferidos em 20/10/2026
- ver fontes
/plugin marketplace add openai/codex-plugin-cc/plugin install codex@openai-codex/reload-plugins/codex:setupComo 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.
Revisar o que mudou no código
/codex:review
Uma revisão que questiona as decisões do código
/codex:adversarial-review
Passar um bug ou uma tarefa para o Codex
/codex:rescue
O Codex conferir cada resposta do Claude que mexeu no código
/codex:setup --enable-review-gate
Levar a conversa do Claude Code para o Codex
/codex:transfer
Acompanhar, ver o resultado ou cancelar uma tarefa
/codex:status · /codex:result · /codex:cancel
Pré-requisitos
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.
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.
O Node.js na versão 18.18 ou mais nova.
Para a revisão, um projeto versionado com git e com alguma mudança feita.
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.
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.
!node --versionAparece 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.
/plugin marketplace add openai/codex-plugin-cc/plugin install codex@openai-codex/reload-pluginsAo 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.
/codex:setupnpm install -g @openai/codexO 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.
!codex login!codex login --device-authRode /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.
/codex:review --background
/codex:status
/codex:result/codex:review --base mainO /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.
/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 regressionVocê também pode só pedir na conversa para o Claude delegar a tarefa ao Codex, como no exemplo do README:
Ask Codex to redesign the database connection to be more resilient.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.
/codex:setup --enable-review-gate
/codex:setup --disable-review-gateO /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.
/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.
/codex:transfer/codex:status. Mostra as tarefas do Codex rodando e as recentes neste repositório.
/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.
/codex:result
/codex:result task-abc123/codex:cancel. Cancela uma tarefa do Codex que está rodando em segundo plano.
/codex:cancel
/codex:cancel task-abc123Cada 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:reviewou o/codex:adversarial-reviewmudarem 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:
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á.
- Nome "Codex plugin for Claude Code"; feito para quem usa o Claude Code e quer começar a usar o Codex no fluxo que já tem; comandos /codex:review, /codex:adversarial-review, /codex:rescue, /codex:transfer, /codex:status, /codex:result e /codex:cancelhttps://github.com/openai/codex-plugin-cc
- Requisitos: conta do ChatGPT, inclusive a Free, ou chave da API da OpenAI; uso conta no limite de uso do Codex; Node.js 18.18 ou mais novohttps://github.com/openai/codex-plugin-cc (seção Requirements)
- Node.js mínimo 18.18.0 no campo engines do pacote @openai/codex-plugin-cc, licença Apache-2.0https://github.com/openai/codex-plugin-cc/blob/main/package.json
- Repositório na organização openai do GitHub, criado em 30/03/2026; autor do plugin declarado como OpenAI; versão atual 1.0.6, publicada em 08/07/2026 (UTC)https://api.github.com/repos/openai/codex-plugin-cc, https://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/.claude-plugin/plugin.json e https://github.com/openai/codex-plugin-cc/releases
- Instalação com /plugin marketplace add openai/codex-plugin-cc, /plugin install codex@openai-codex, /reload-plugins e /codex:setup; depois da instalação aparecem os comandos e o agente codex:codex-rescue em /agentshttps://github.com/openai/codex-plugin-cc (seção Install)
- /codex:setup confere se o Codex está instalado e autenticado e, com o npm disponível, oferece instalar; instalação manual com npm install -g @openai/codex; sem login, rodar !codex loginhttps://github.com/openai/codex-plugin-cc (seções Install e /codex:setup)
- O setup pergunta com as opções "Install Codex (Recommended)" e "Skip for now" e instala com npm install -g @openai/codexhttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/commands/setup.md
- O setup confere node, npm, Codex e login; com o login bloqueado no navegador, indica !codex login --device-auth ou !codex login --with-api-key; a revisão roda com sandbox só leitura e a tarefa com escrita usa workspace-writehttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/scripts/codex-companion.mjs
- O ! no começo da linha do Claude Code roda o comando direto no shell e coloca a saída na sessãohttps://code.claude.com/docs/en/interactive-mode#shell-mode-with-prefix
- node -v ou node --version mostra a versão do Node.jshttps://nodejs.org/api/cli.html#-version
- Instalador do Node.js, versão LTShttps://nodejs.org/en/download
- codex login abre o navegador para o login com a conta do ChatGPT; --device-auth usa o código de dispositivo no lugar do navegador; --with-api-key lê a chave da API pela entrada padrão; codex resume continua uma sessão pelo ID ou pela listahttps://learn.chatgpt.com/docs/developer-commands?surface=cli
- Codex incluído nos planos Free, Go, Plus, Pro, Business, Edu e Enterprise do ChatGPT; no Free, o Codex aparece para tarefas rápidas de código; com chave da API, cobrança pelo preço da API; o número de mensagens depende do modelo e do tamanho da tarefahttps://learn.chatgpt.com/docs/pricing (o link do README, developers.openai.com/codex/pricing, redireciona para esta página)
- Claude Code marcado como "No" no plano Free e incluído no Pro, Max, Team e Enterprise; Pro a US$ 20 por mês no mensal, ou US$ 17 por mês no anual com US$ 200 de uma vezhttps://claude.com/pricing
- /codex:review revisa as mudanças sem commit ou a branch contra uma base com --base; aceita --wait e --background; não aceita texto de foco; só lê; mesma qualidade do /review dentro do Codex; recomendação de rodar em segundo planohttps://github.com/openai/codex-plugin-cc (seção /codex:review)
- /codex:review roda sobre o estado local do githttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/commands/review.md
- /codex:adversarial-review questiona implementação e design, premissas, trade-offs e modos de falha; aceita texto de foco; só lê e não consertahttps://github.com/openai/codex-plugin-cc (seção /codex:adversarial-review)
- Resultado da adversarial-review com veredito approve ou needs-attention, resumo, problemas com gravidade, arquivo, linhas, recomendação e próximos passoshttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/schemas/review-output.schema.json
- /codex:rescue passa a tarefa pelo agente codex:codex-rescue para investigar bug, tentar conserto, continuar tarefa ou fazer passada mais rápida com modelo menor; aceita --background, --wait, --resume, --fresh, --model e --effort; spark vira gpt-5.3-codex-spark; sem --model e --effort, o Codex usa os padrões dele; pedido em texto também delegahttps://github.com/openai/codex-plugin-cc (seção /codex:rescue)
- O agente do rescue roda o Codex com escrita por padrão, a não ser que o pedido seja só leitura, diagnóstico ou pesquisahttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/agents/codex-rescue.md
- A resposta do rescue é a saída do Codex sem resumo nem reescritahttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/commands/rescue.md
- Review gate ligada e desligada pelo /codex:setup; usa o hook Stop para revisar a resposta do Claude e, se achar problema, bloqueia o fim para o Claude corrigir; aviso de vaivém longo e de gasto rápido do limite de usohttps://github.com/openai/codex-plugin-cc (seção Enabling review gate)
- A review gate só bloqueia quando o Claude fez mudança de código naquela resposta; status, resumo e saída de comando passam diretohttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/prompts/stop-review-gate.md
- /codex:status mostra as tarefas e a situação da review gatehttps://github.com/openai/codex-plugin-cc/blob/main/plugins/codex/commands/status.md
- /codex:transfer, /codex:status, /codex:result e /codex:cancel, com os exemplos; transfer exige Codex com importação de sessãohttps://github.com/openai/codex-plugin-cc (seções /codex:transfer a /codex:cancel)
- Plugin usa o Codex CLI e o app server locais, o mesmo login e a mesma configuração; config.toml do usuário e do projeto, que só carrega em projeto confiável; codex resume para continuar no Codexhttps://github.com/openai/codex-plugin-cc (seções Codex Integration e FAQ)
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.