O que é o Codex Plugin para Claude Code
Em abril de 2026, a OpenAI fez algo que ninguém esperava: lançou um plugin oficial do Codex que roda dentro do Claude Code, o terminal de IA da Anthropic.
O plugin permite que você use o GPT-5.4 Codex (o modelo especializado em código da OpenAI) diretamente no seu fluxo de trabalho dentro do Claude Code — sem sair do terminal, sem abrir outra ferramenta.
Na prática, isso significa que você tem dois cérebros de IA trabalhando juntos: o Claude (Opus/Sonnet) como assistente principal, e o Codex como revisor e corretor especializado.
O repositório oficial está disponível no GitHub da OpenAI, e a versão atual é a 1.0.2.
Como instalar o Codex Plugin passo a passo
A instalação leva menos de 2 minutos. Você precisa ter o Claude Code instalado e o Node.js (versão 18+).
Passo 1 — Instalar o Codex CLI
Primeiro, instale a CLI do Codex globalmente:
npm install -g @openai/codexPasso 2 — Autenticar na OpenAI
Faça login com sua conta OpenAI:
codex loginIsso abre o navegador para autenticação OAuth. Funciona com conta gratuita e paga.
Passo 3 — Adicionar o marketplace e instalar o plugin
No terminal do Claude Code:
claude plugins marketplace add openai/codex-plugin-cc
claude plugins install codex@openai-codex --scope userPasso 4 — Recarregar e verificar
/reload-plugins
/codex:setupSe tudo estiver correto, o setup retorna "ready": true com status de autenticação confirmado.
Quer implementar IA no seu negócio?
Criamos agentes de IA personalizados para empresas que querem automatizar processos e escalar resultados.
Falar no WhatsAppTodos os comandos disponíveis
O plugin adiciona 7 comandos ao Claude Code:
| Comando | O que faz |
|---|---|
/codex:setup | Verifica se o Codex está instalado, autenticado e pronto |
/codex:review | Roda code review automático no estado atual do Git |
/codex:adversarial-review | Revisão que questiona decisões de design e arquitetura |
/codex:rescue | Delega investigação ou correção de bugs ao Codex |
/codex:status | Mostra tarefas ativas e recentes do Codex |
/codex:result | Exibe o resultado de uma tarefa concluída |
/codex:cancel | Cancela uma tarefa em andamento |
Code Review automático com /codex:review
Este é o comando mais poderoso. O /codex:review analisa todas as mudanças no seu repositório Git e retorna bugs, vulnerabilidades e sugestões classificadas por prioridade.
Como funciona
- O plugin coleta o diff do Git (staged, unstaged e arquivos não rastreados)
- Envia para o Codex (GPT-5.4) em background
- O Codex analisa e retorna comentários com prioridade (P1 = crítico, P2 = importante, P3 = sugestão)
Exemplo de output real
[P2] Accept declined command/patch statuses — types.py:59-61
Pydantic will raise a validation error and the stream will abort.
Add the missing "declined" variant to both enums.
[P3] Ship py.typed in wheel — pyproject.toml:36-37
Include py.typed marker so downstream users get type hints.O review roda em background por padrão. Você continua trabalhando e checa o resultado com /codex:status.
Opções úteis
/codex:review --wait— espera o resultado (para reviews pequenos)/codex:review --background— roda em background (padrão para reviews grandes)/codex:review --base main— compara com a branch main
Corrigir código automaticamente com /codex:rescue
O /codex:rescue é como ter um programador sênior disponível 24 horas. Você descreve o problema e o Codex investiga, diagnostica e aplica o fix automaticamente.
Cenários de uso
- Bug encontrado no review: "Fix the issues found in the last review"
- Erro em produção: "The API returns 500 when user sends empty payload"
- Refatoração: "Remove unused imports and consolidate duplicate files"
Opções avançadas
--model spark— usa o modelo GPT-5.3 Codex Spark (mais rápido, menos profundo)--effort high— aumenta o raciocínio para problemas complexos--resume— continua uma thread anterior
O rescue roda como subagente: o Claude Code delega a tarefa para o Codex, que trabalha de forma independente e retorna o resultado quando termina.
Revisão adversarial: questionando suas decisões de design
O /codex:adversarial-review vai além do code review tradicional. Em vez de só procurar bugs, ele questiona suas escolhas de arquitetura:
- A abordagem escolhida é realmente a melhor?
- Quais pressupostos essa implementação depende?
- Onde o design pode falhar em condições reais?
- Existem alternativas mais simples ou robustas?
É como ter um advogado do diabo técnico analisando cada decisão antes de ir para produção.
Precisa de IA para seu negócio?
Agentes de IA que atendem, vendem e agendam no WhatsApp — 24 horas por dia, 7 dias por semana.
Falar com especialistaComo funciona por baixo dos panos
A arquitetura do plugin é elegante e bem pensada:
Componentes principais
- Companion Script (
codex-companion.mjs) — orquestra tudo. Recebe comandos, coleta contexto Git, envia para o Codex e retorna resultados. - Broker — multiplexador JSON-RPC que gerencia múltiplas requisições simultâneas ao Codex.
- State Manager — persiste o estado das tarefas em
state.json, com pruning automático (máximo 50 jobs). - Git Library — coleta diffs de forma inteligente, respeitando limite de 24KB por envio.
Fluxo de uma revisão
- Você roda
/codex:review - O plugin analisa o
git statuse coleta o diff relevante - Envia para a API da OpenAI via JSON-RPC
- O Codex (GPT-5.4) analisa o código com prompts especializados
- O resultado volta classificado por prioridade (P1/P2/P3)
- O Claude Code exibe o resultado verbatim (sem alterar)
Sessões e continuidade
O plugin mantém threads de conversação com o Codex. Isso significa que, se você roda um review e depois pede um rescue, o Codex tem contexto do que já analisou. Você pode continuar com --resume ou começar do zero com --fresh.
Por que a OpenAI criou um plugin para o concorrente
Esta é a pergunta de um bilhão de dólares. A OpenAI investiu milhões no Codex, e agora está distribuindo ele como plugin dentro do produto da Anthropic?
A estratégia faz sentido quando você entende o momento do mercado:
1. O Claude Code virou plataforma
Com o sistema de plugins e marketplace, o Claude Code não é mais "só" um assistente de código. É uma plataforma onde ferramentas de terceiros podem rodar. A OpenAI percebeu que estar FORA dessa plataforma é pior do que estar dentro.
2. Distribuição é tudo
O Claude Code tem milhões de desenvolvedores ativos. Se o Codex roda dentro dele, a OpenAI ganha distribuição gratuita para o GPT-5.4 sem precisar competir no terminal.
3. A guerra é por modelo, não por IDE
A verdadeira competição entre OpenAI e Anthropic é sobre qual modelo é melhor. Se o Codex consegue encontrar bugs que o Claude não encontra (e vice-versa), ambos se beneficiam. É um jogo de soma positiva.
4. Precedente no mercado
Não é a primeira vez. Modelos da OpenAI rodam dentro do Cursor, GitHub Copilot usa GPT, e agora o Codex roda no Claude Code. A tendência é clara: modelos de IA se tornam commodities distribuídas em múltiplas plataformas.
Perguntas frequentes
O plugin do Codex é gratuito? +
O plugin em si é gratuito e open source. Porém, o Codex usa créditos da sua conta OpenAI para rodar os reviews e tasks. Se você tem o plano ChatGPT Team ou Plus, os créditos já estão incluídos.
Precisa ter conta na OpenAI e na Anthropic? +
Sim. Você precisa do Claude Code (conta Anthropic) para o ambiente, e autenticação OpenAI (codex login) para o Codex funcionar. Ambos têm planos gratuitos.
O Codex substitui o Claude para código? +
Não. Eles se complementam. O Claude continua sendo seu assistente principal (editar arquivos, navegar código, executar comandos). O Codex atua como segundo par de olhos — revisor e corretor especializado.
Funciona com qualquer linguagem de programação? +
Sim. O Codex (GPT-5.4) suporta todas as linguagens que o GPT-4 suportava, incluindo Python, JavaScript, TypeScript, Go, Rust, Java, C++, Ruby, PHP e muitas outras.
O Codex tem acesso ao meu código? +
O plugin envia apenas os diffs do Git (as mudanças) para a API da OpenAI, não o repositório inteiro. O limite é 24KB por envio. A política de privacidade da OpenAI se aplica — revise-a se trabalha com código proprietário sensível.