Plugin do Codex para o Claude Code da OpenAI

• Agora é possível chamar o OpenAI Codex diretamente dentro do Claude Code para fazer revisão de código e delegar tarefas
• Chamado com base em comandos de barra como /codex:review, /codex:adversarial-review
• O recurso de gerenciamento de tarefas em segundo plano (/codex:rescue, /codex:status, /codex:result, /codex:cancel) permite processar de forma assíncrona tarefas de longa duração
• Sem runtime separado, reutiliza o Codex CLI local e o servidor do app como estão, mantendo o mesmo ambiente de autenticação, configuração e repositório
• Pode ser usado com assinatura do ChatGPT (incluindo o plano gratuito) ou apenas com uma chave da API da OpenAI (o uso conta para a cota de uso do Codex)
• Plugin open source público lançado sob licença Apache-2.0

Detalhes dos recursos oferecidos (comandos de barra)

• /codex:review: executa uma revisão Codex geral em modo somente leitura para o trabalho atual
  • Permite revisar mudanças ainda não commitadas ou fazer revisão comparando branches com --base <ref>
  • Suporta as opções --background e --wait; para alterações em vários arquivos, recomenda-se executar em segundo plano
  • Não permite inserir texto de foco personalizado e não faz modificações no código
• /codex:adversarial-review: executa uma revisão direcionável (steerable) que questiona decisões de implementação e design
  • Coloca sob pressão testes de premissas, trade-offs, modos de falha e abordagens alternativas
  • Pode focar em áreas específicas de risco, como autenticação, perda de dados, rollback, race conditions e estabilidade
  • Suporta entrada de texto de foco adicional após o comando e não faz modificações no código
• /codex:rescue: delega uma tarefa ao Codex por meio do subagente codex:codex-rescue
  • Pode investigar bugs, tentar correções, retomar uma tarefa anterior do Codex ou executar um caminho rápido com um modelo menor
  • Suporta as opções --background, --wait, --resume e --fresh
  • Se --model e --effort não forem especificados, o Codex escolhe seus próprios padrões
  • Ao informar spark, o valor é mapeado automaticamente para gpt-5.3-codex-spark
  • Também é possível delegar em linguagem natural (ex.: "Ask Codex to redesign...")
• /codex:status: consulta o status de execução e os trabalhos recentes do Codex no repositório atual
• /codex:result: consulta a saída final de uma tarefa concluída; se o ID da sessão do Codex for incluído, é possível retomar diretamente com codex resume <session-id>
• /codex:cancel: cancela um trabalho Codex ativo em segundo plano
• /codex:setup: verifica o estado de instalação e autenticação do Codex; se não estiver instalado, sugere a instalação via npm

Recurso de Review Gate

• Ativado com /codex:setup --enable-review-gate
• Quando ativado, usa o hook Stop para executar automaticamente uma revisão Codex direcionada com base na resposta do Claude
• Se a revisão encontrar problemas, bloqueia o stop para que o Claude resolva primeiro
• Atenção: como pode gerar loops longos entre Claude e Codex e consumir rapidamente o limite de uso, recomenda-se ativar apenas quando a sessão estiver sendo monitorada ativamente

Fluxo geral de uso

• Revisão antes do lançamento: execute apenas /codex:review
• Delegar um problema ao Codex: /codex:rescue investigate why the build is failing in CI
• Iniciar um trabalho longo e verificar depois: executar com --background → /codex:status → /codex:result

Estrutura da integração com o Codex

• O plugin encapsula o servidor do app Codex e usa o binário global codex instalado no ambiente
• Sem runtime separado, compartilha a mesma instalação do Codex, autenticação, repositório e ambiente local
• O modelo padrão e o esforço de raciocínio (reasoning effort) podem ser configurados em ~/.codex/config.toml (nível de usuário) ou .codex/config.toml (nível de projeto)
  • Exemplo: model = "gpt-5.4-mini", model_reasoning_effort = "xhigh"
  • A configuração em nível de projeto só é aplicada quando o projeto está em estado confiável (trusted)
• As tarefas delegadas concluídas podem ser retomadas diretamente no Codex com codex resume <session-id>

Autenticação e conta

• Se o Codex já estiver autenticado nessa máquina, pode ser usado imediatamente sem configuração adicional
• Quem ainda não usa o Codex precisa executar !codex login com uma conta ChatGPT ou chave de API
• As configurações existentes de chave de API e base URL são mantidas; ao usar outro endpoint, é possível definir openai_base_url na configuração do Codex

[xguru]

Foi lançado publicamente por um funcionário da OpenAI. "We love an open ecosystem!"
https://x.com/dkundel/status/2038670330257109461
O mais engraçado é que, quando pediram para o Claude Code revisar esse plugin, ele elogiou dizendo que era um "really well-engineered plugin"...

[godrm]

Que abordagem interessante. Fico na dúvida se isso é para usar mais o Claude ou para não usar, haha.

[kunggom]

Mesmo usando o Claude Opus, acontece bastante de o GPT encontrar coisas que passaram batido na revisão do próprio modelo, então venho alternando entre Claude Code e Codex — e agora saiu logo algo assim.
No momento, os tokens do lado do Codex estão esgotados, então é difícil usar de imediato, mas pretendo testar em breve.

[dusin]

“Pode usar a sua plataforma, o trabalho deixa com a gente” é a estratégia.

[click]

Seria bom se melhorassem as ferramentas tanto quanto o Claude Code. Dá a impressão de que eles estão admitindo algo como: no trabalho individual são bons, mas faltam na orquestração.

[sea715]

O código é um ponto, mas acho que isso acontece porque há uma diferença grande demais nos próprios parâmetros fundamentais do modelo entre o GPT e o Claude.

[bbulbum]

Não sai token do Claude também ao chamar o codex...? kkk

[netray]

Então ele usa o binário do codex que já existe....