Ferramentas

Plugin oficial do Codex para Claude Code: instalação e comandos atuais

Como instalar o plugin oficial da OpenAI no Claude Code e usar review, revisão adversarial, rescue, transfer e tarefas em segundo plano com segurança.

3 min de leitura

A OpenAI mantém um plugin oficial que permite chamar o Codex dentro do Claude Code para revisão de código, investigação de problemas e delegação de tarefas. Ele usa o Codex CLI instalado e autenticado na mesma máquina; não cria um runtime isolado.

Requisitos

  • Claude Code com suporte a plugins;
  • Node.js 18.18 ou superior;
  • assinatura ChatGPT compatível ou chave da API da OpenAI;
  • Codex CLI autenticado, ou instalação guiada pelo setup.

Instalação oficial

No Claude Code, execute os comandos publicados no repositório oficial:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

Se o CLI não estiver presente, o setup pode oferecer a instalação. A alternativa manual indicada pela OpenAI é:

npm install -g @openai/codex
codex login

Comandos principais

  • /codex:review: revisão normal e somente leitura.
  • /codex:adversarial-review: questiona decisão, risco e alternativa com foco fornecido.
  • /codex:rescue: delega investigação ou implementação.
  • /codex:transfer: transfere o contexto para continuar no Codex.
  • /codex:status, /codex:result e /codex:cancel: acompanham tarefas em segundo plano.

Revisar sem alterar

/codex:review
/codex:review --base main
/codex:review --background

A revisão normal é somente leitura. Para mudança com muitos arquivos, rodar em segundo plano evita bloquear a conversa. O resultado continua sendo uma opinião técnica: confirme cada achado no código real antes de aplicar.

Revisão adversarial

/codex:adversarial-review --background \
  questione autenticação, rollback e risco de perda de dados

Esse modo é útil quando a implementação parece funcionar, mas a dúvida é se a direção escolhida é segura e simples. Ele também é somente leitura.

Delegar uma tarefa

/codex:rescue --background investigue por que o teste ficou instável
/codex:status
/codex:result

rescue pode alterar arquivos. Defina escopo, testes, arquivos de responsabilidade e proíba desfazer mudanças alheias. Revise o diff antes de aceitar.

Uso, limites e custo

As chamadas contam para os limites ou custos da autenticação do Codex usada na máquina. Tarefas em segundo plano e review gate podem consumir mais uso. O README oficial alerta que o gate automático pode criar ciclos longos; habilite somente quando alguém estiver acompanhando.

Checklist seguro

  • comece por revisão somente leitura;
  • não entregue segredos no prompt;
  • limite arquivos e responsabilidade no rescue;
  • confira diff, testes e saída de comando;
  • não faça deploy automático a partir do parecer;
  • cancele tarefa que perdeu o escopo.

Fonte primária

Comandos e requisitos foram verificados no repositório openai/codex-plugin-cc em 30/08/2026. O projeto muda; confirme o README e /codex:setup antes de instalar.