Plugin Codex para Claude Code: comandos e limite de revisão

Atualização (9 de novembro de 2026): Claude Fable 5.2 e Mythos 5.2 foram lançados - preços, acesso e benchmarks no meu guia do Claude Fable 5.2.

👁 111 leituras

Desde meados de outubro, tenho um ritual fixo no trabalho. O Claude Code organiza a tarefa, eu copio o prompt pronto, colo no Codex em outra janela, espero e trago o resultado de volta. Funcionava, mas eu era o mensageiro entre os dois. A OpenAI lançou um plugin oficial que elimina essa etapa: o Claude Code delega a tarefa ao Codex, espera pelo resultado e recebe a resposta de volta na conversa.

Instalei o plugin em 3 de novembro. A seguir, explico o que ele inclui, quanto consome de tokens e do limite, o que não ativar e o que deu errado na minha primeira tentativa.

Como instalar em quatro comandos

No Claude Code, digite os comandos a seguir, um de cada vez:

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

O último comando verifica se o Codex está instalado e se você fez login. Se não estiver instalado, ele sugere a instalação com npm install -g @openai/codex. Instalei o plugin pelo terminal, usando os comandos claude plugin marketplace add e claude plugin install, porque trabalho no aplicativo para desktop. O resultado é o mesmo. Se você ainda não conhece o Codex, veja primeiro o guia de instalação do Codex CLI no Windows.

A versão instalada foi a 1.0.6. O comando claude plugin details codex@openai-codex mostra o conteúdo: 11 skills, um subagente chamado codex-rescue e três hooks, ou seja, scripts executados no início da sessão, no fim dela e após cada resposta. O custo fixo do plugin é de cerca de 451 tokens adicionados a cada sessão do Claude Code. São descrições dos comandos, para que o Claude saiba quando usá-los. O restante só é carregado quando necessário.

Oito comandos, três para o trabalho

/codex:rescue é o principal recurso do plugin. Ele delega uma tarefa ao Codex: investigar um erro, corrigi-lo ou concluir um trabalho. Você pode especificar o modelo (--model) e o nível de raciocínio (--effort), executar a tarefa em segundo plano (--background) ou retomar uma conversa anterior do Codex (--resume). O resultado aparece na conversa do Claude sem alterações, para você ver exatamente o que o Codex escreveu.

/codex:review revisa alterações em um repositório Git, sejam as atuais ou as de toda uma branch em comparação com outra (--base main). O comando é somente de leitura e não corrige nada. A versão mais rigorosa, /codex:adversarial-review, não procura erros de digitação: questiona a própria ideia, avalia se a solução escolhida faz sentido, em quais premissas ela se baseia e onde pode falhar. Para mim, é o comando mais interessante, porque um segundo modelo de outra empresa não tem os mesmos hábitos do primeiro.

Os outros comandos são auxiliares. /codex:status mostra as tarefas em andamento; /codex:result exibe o resultado de uma tarefa concluída; /codex:cancel interrompe uma tarefa em segundo plano. /codex:transfer transfere a sessão atual do Claude para uma nova conversa no Codex e fornece o comando codex resume, que você pode usar para abri-la no Codex.

A revisão automática pode consumir seu limite

O plugin tem uma opção que parece razoável, mas pode ser arriscada na prática. A revisão automática (/codex:setup --enable-review-gate) faz com que o Codex revise cada resposta do Claude e, em seguida, o Claude corrija os pontos indicados. O hook pode levar até 15 minutos. Os próprios autores alertam na documentação que a revisão automática pode entrar em um ciclo longo entre Claude e Codex e consumir os limites rapidamente.

Por padrão, a revisão automática fica desativada. Conferi isso no código do plugin, em que a opção começa com o valor false, e no relatório de /codex:setup, que mostra reviewGateEnabled: false. Mantive a opção desativada. Peço uma revisão manualmente quando termino uma parte maior do trabalho, em vez de fazê-lo depois de cada frase.

Cada tarefa iniciada pelo plugin executa o Codex local usando sua conta e consome o mesmo limite semanal que o uso do aplicativo Codex. No artigo Codex sem desperdiçar o limite, explico como economizar esse limite.

Primeira tarefa: 25 segundos

Na primeira tentativa, dei ao Codex uma tarefa útil pelo plugin: revisar o script de sincronização de skills que publico no artigo Como transferir o Claude Code para o Codex e listar no máximo cinco erros reais. O relatório de /codex:setup estava correto: Node.js, npm, Codex CLI 0.162.1 e login ativo pela conta ChatGPT.

Após 25 segundos, recebi uma resposta dizendo que o Codex não conseguia ler o arquivo. Duas tentativas terminaram com o erro setup refresh had errors. O problema não era o plugin, mas o sandbox do Codex no Windows, que isola os comandos do restante do sistema. O comando codex doctor mostrou: sandbox provisioning failed. Eu já tinha visto o mesmo erro ao executar o Codex pelo terminal em modo somente leitura. Portanto, no Windows, vale a pena executar codex doctor antes de usar o plugin pela primeira vez e corrigir o sandbox. O relatório de /codex:setup não verifica isso.

Apesar desse começo frustrante, vou continuar usando o plugin. O Claude planeja bem e mantém o contexto de projetos longos, enquanto meu plano Pro do Codex tem um limite próprio que já pago mensalmente. O plugin conecta as duas ferramentas sem que eu precise intervir, e deixo de ser o mensageiro entre duas janelas.

Fontes

• OpenAI, codex-plugin-cc (README e código do plugin 1.0.6): https://github.com/openai/codex-plugin-cc
• Teste próprio de instalação e primeira tarefa, Claude Code 2.1.296 e Codex CLI 0.162.1, 3 de novembro de 2026

// continue lendoClaude: documentos, escrita e revisão com IAGuiasCodex na nuvem: CLI, revisão de código e planosGuiasIA para estudar para provas: plano, flashcards e revisõesGeral