Cinco formas de usar o Claude Code e o Codex juntos
A maioria das configurações combina duas ou três delas. Se você ainda está escolhendo entre os agentes, comece por Claude Code vs Codex.
| Forma | Como funciona | Use quando |
|---|---|---|
| 1. Instruções compartilhadas | Um único AGENTS.md que os dois agentes leem; o CLAUDE.md o importa | Sempre. É o passo mais barato e evita que os dois agentes sigam regras diferentes |
| 2. Worktrees separados | Cada agente trabalha em um git worktree e um branch próprios do mesmo repositório | Os dois agentes editam código ao mesmo tempo |
| 3. Um escreve, o outro revisa | O Claude Code escreve e codex review confere o branch, ou o contrário | Você quer um segundo modelo para pegar o que o primeiro deixou passar |
| 4. Codex dentro do Claude Code | O codex-plugin-cc, da OpenAI, adiciona /codex:review, /codex:rescue e mais ao Claude Code | Você vive no Claude Code e quer o Codex a um comando de distância |
| 5. Um orquestrador | Um quadro ou app (Claude Squad, Conductor, Orca, Vibe Kanban, Crewmark) inicia e acompanha os dois | Você roda vários agentes todo dia e perde o controle dos terminais |
2. Rode os dois em worktrees separados
Dois agentes editando um único checkout vão sobrescrever um ao outro; a própria documentação do Claude Code avisa que dois agentes editando o mesmo arquivo levam a sobrescritas. Um git worktree é um segundo diretório de trabalho, com arquivos e branch próprios, que compartilha o histórico do repositório; assim, cada agente recebe a sua própria cópia para editar.
O Claude Code cria um para você com claude --worktree <name>, dentro de .claude/worktrees/. A CLI do Codex tem uma flag --worktree que inicia uma sessão ou uma execução de codex exec em um novo worktree gerenciado, e o app desktop do Codex gerencia worktrees para as suas tarefas. O git worktree add simples funciona para qualquer um dos agentes. Nosso guia de worktrees no Claude Code cobre a limpeza, o .worktreeinclude para arquivos .env e o branch base.
3. Um escreve e o outro revisa
É a esse padrão que a maioria das pessoas se refere ao falar em usar os dois juntos. Um segundo agente, de outro fornecedor, lê o diff sem as suposições do primeiro e por isso pode pegar o que o autor deixou passar.
- Codex revisando o Claude:
codex review --base mainrevisa o branch em relação ao main;--uncommittedrevisa mudanças staged, unstaged e untracked;--commit <SHA>revisa um único commit. - Claude revisando o Codex: envie o diff por pipe para
claude -p, o modo não interativo. A documentação do Claude Code mostra a mesma ideia como um script de build que rodagit diff main | claude -pcomo revisor. - Devolva os achados ao agente que escreveu o código e deixe que ele os corrija; não deixe o revisor editar o branch também.
4. Chame o Codex de dentro do Claude Code (plugin oficial)
A OpenAI publica o codex-plugin-cc, um plugin do Claude Code sob Apache-2.0 para "usar o Codex a partir do Claude Code para revisar código ou delegar tarefas". Ele usa a CLI codex que já está na sua máquina, com o mesmo login, a mesma configuração e o mesmo checkout. Você precisa de um plano do ChatGPT (o Free conta) ou de uma chave de API da OpenAI, e de Node.js 18.18 ou superior. O uso conta para os seus limites de uso do Codex.
Instale de dentro do Claude Code com /plugin marketplace add openai/codex-plugin-cc, /plugin install codex@openai-codex, /reload-plugins e /codex:setup.
/codex:review: uma revisão do Codex somente leitura das mudanças não commitadas, ou do branch com--base main. O README diz que equivale a rodar/reviewno próprio Codex./codex:adversarial-review: uma revisão somente leitura que você pode direcionar, voltada a escolhas de design, tradeoffs e áreas de risco./codex:rescue: entrega ao Codex uma tarefa, como investigar um bug ou tentar uma correção, por meio de um subagente; adicione--backgroundpara trabalhos longos e acompanhe com/codex:statuse/codex:result./codex:transfer: transforma a conversa atual do Claude Code em uma thread do Codex e imprime o comandocodex resumepara continuar nela.- O review gate opcional (
/codex:setup --enable-review-gate) executa uma revisão do Codex toda vez que o Claude tenta parar e bloqueia a parada se encontrar problemas. O README avisa que ele pode entrar em loop por muito tempo e esgotar os limites de uso rapidamente, então só ative enquanto estiver acompanhando.
Passo a passo: worktrees, instruções compartilhadas e um ciclo de revisão
Esta é a configuração mais comum: o Claude Code e o Codex constroem cada um em seu próprio worktree a partir do mesmo AGENTS.md e depois revisam o branch um do outro antes do merge. Todos os comandos vêm da documentação do Claude Code, da referência da CLI do Codex ou do README do plugin; o prompt de revisão é um exemplo.
Escreva um único AGENTS.md e importe-o no CLAUDE.md
Coloque as regras compartilhadas no AGENTS.md, na raiz do repositório. O Codex o lê diretamente. Se você também tem um CLAUDE.md, comece-o com o import para que o Claude Code leia o mesmo arquivo.
# CLAUDE.md: o Claude Code lê o AGENTS.md primeiro, depois o resto @AGENTS.md ## Claude Code Use plan mode for changes under src/billing/.Inicie o Claude Code no próprio worktree
O Claude Code cria o worktree e um branch para ele. Instale as dependências dentro do worktree, já que é um checkout novo.
# Claude Code no próprio worktree: .claude/worktrees/feature-auth, branch worktree-feature-auth claude --worktree feature-auth # mantenha os worktrees fora do git status echo ".claude/worktrees/" >> .gitignoreInicie o Codex em um segundo worktree
Crie um worktree com o git e aponte o Codex para ele com --cd, ou deixe o Codex criar um worktree gerenciado com --worktree.
# Codex em um segundo worktree, em um branch próprio git worktree add ../project-feature-a -b feature-a codex --cd ../project-feature-a # ou deixe o Codex criar um worktree gerenciado para uma tarefa pontual codex exec --worktree "implement the next step"Peça ao Codex que revise o branch do Claude
Quando o Claude Code terminar, rode uma revisão do Codex contra o main a partir do worktree do Claude, ou de dentro do Claude Code se você instalou o plugin. Cole os achados de volta no Claude Code para ele corrigir.
# O Codex revisa o branch do Claude (rode dentro do worktree do Claude) codex review --base main # ou, de dentro do Claude Code, com o plugin da OpenAI /codex:review --base mainPeça ao Claude Code que revise o branch do Codex
Envie o diff do Codex por pipe para o modo não interativo do Claude Code e devolva os achados ao Codex.
# O Claude Code revisa o branch do Codex (rode dentro do worktree do Codex) git diff main | claude -p "Review this diff for bugs and missing tests. List each issue with file:line."Faça o merge e depois remova os worktrees
Faça o merge de cada branch como de costume (ou abra um PR) e depois remova os worktrees de que não precisa mais. O Claude Code se oferece para limpar o próprio worktree quando você encerra a sessão.
git worktree list git worktree remove ../project-feature-a
O Claude Code e o Codex conseguem conversar entre si?
Não diretamente, no sentido de um chat. Nenhum dos agentes tem um canal embutido com o agente do outro fornecedor; por isso eles se comunicam por algo que ambos alcançam: os arquivos e o histórico do git no repositório, um comando que um roda na CLI do outro, ou um quadro que os dois leem.
- Pela CLI: o Claude Code pode rodar
codex execoucodex reviewcomo comando de shell, e o Codex pode rodarclaude -p. Cada um recebe a resposta do outro como saída do comando. - Pelo plugin: no Claude Code,
/codex:rescuee/codex:reviewenviam trabalho ao Codex e trazem o resultado de volta para a conversa. A OpenAI mantém o plugin. - Por MCP: esse caminho se fechou em boa parte. O Codex costumava rodar como servidor MCP com
codex mcp-server; a OpenAI o removeu no Codex rust-v0.154.0 e indica aos integradores o Codex app server experimental, que fala o próprio protocolo JSON-RPC. No outro sentido,claude mcp servetransforma o Claude Code em um servidor MCP, mas ele expõe as ferramentas do Claude Code (ler, editar, shell), não um segundo agente Claude. - Por um quadro compartilhado: um orquestrador ou um quadro de issues guarda a tarefa, os comentários e o status, e cada agente lê e escreve ali.
- O que não cruza fornecedores: os agent teams do Claude Code e a sua mensagem entre sessões conectam apenas sessões do Claude Code. Uma sessão do Codex não pode ser um colega de equipe.
Dá para rodar o Claude Code e o Codex ao mesmo tempo?
Sim. São programas separados, com logins separados, então os dois podem rodar na mesma máquina e no mesmo repositório ao mesmo tempo. O Claude Code usa o seu plano do Claude ou uma chave de API; o Codex usa o seu plano do ChatGPT ou uma chave de API da OpenAI. O que você precisa gerenciar são os arquivos e o uso.
- Arquivos: dê a cada agente o seu próprio worktree. Dois agentes em um único checkout vão editar os mesmos arquivos e sobrescrever um ao outro.
- Uso: cada agente consome os seus próprios limites. O trabalho que você envia ao Codex pelo plugin do Claude Code conta para os seus limites de uso do Codex.
- Loops: um ciclo de revisão automático (como o review gate do plugin) pode manter os dois agentes ocupados por muito tempo e esgotar os limites rapidamente. Rode-o enquanto estiver acompanhando.
- O paralelismo do lado do Claude custa mais: a Anthropic diz que os agent teams usam bem mais tokens do que uma única sessão, e o custo cresce a cada colega de equipe.
Ferramentas que orquestram o Claude Code e o Codex
Se você inicia vários agentes por dia, uma ferramenta que cria os worktrees, abre os terminais e mostra os diffs poupa muita troca de contexto. Todas rodam o Claude Code e o Codex; veja as alternativas ao Vibe Kanban para uma comparação mais ampla.
| Ferramenta | O que faz | Isolamento | Roda em | Licença / status |
|---|---|---|---|---|
| Claude Squad | App de terminal para gerenciar Claude Code, Codex, OpenCode, Amp e outros agentes; rode o Codex com cs -p "codex" | Sessão tmux e git worktree por agente | Terminal (instala com Homebrew) | Código aberto, AGPL-3.0 |
| Conductor | Roda Claude Code, Codex, Cursor e OpenCode em paralelo; revise o diff, abra um PR, faça o merge | Um workspace e um branch por tarefa | Mac | App desktop |
| Orca | Roda uma frota de agentes de terminal, incluindo Claude Code e Codex, com as suas próprias assinaturas | Git worktree por agente | macOS, Windows, Linux | Código aberto, MIT |
| Vibe Kanban | Quadro kanban que inicia um workspace por issue com Claude Code, Codex, Gemini CLI e outros | Git worktree por workspace | Navegador ou app desktop via npx vibe-kanban | Código aberto, Apache-2.0; mantido pela comunidade desde que a bloop encerrou as atividades em abril de 2026 |
| Crewmark | Claude Code e Codex como funcionários de IA de longa duração, com funções, em um quadro de issues compartilhado | Cada funcionário é uma sessão própria na sua máquina | A sua própria máquina | Veja abaixo |
Crewmark: Claude Code e Codex como uma equipe em um só quadro
As ferramentas acima giram em torno de uma tarefa por vez: iniciar um agente, revisar o diff, fazer o merge. Se você quer que o Claude Code e o Codex continuem trabalhando juntos por dias, cada um com a sua função, o Crewmark é outra opção.
No Crewmark, cada agente é um funcionário de IA: uma sessão de longa duração com uma função, rodando na sua própria máquina. Os funcionários Claude Code e Codex rodam nativamente; outros agentes, como OpenCode, DeepSeek Harness e Gemini, se conectam por ACP (acpx). O trabalho passa por um quadro de issues compartilhado, onde você e os funcionários atribuem issues, comentam, se mencionam com @ e mudam status. É assim que um funcionário Claude Code passa uma revisão a um funcionário Codex: ele o menciona com @ na issue. Os funcionários acordam em um horário agendado (heartbeats) e sempre que são mencionados, então a revisão começa sem que você precise repassá-la.
Ele não substitui os worktrees nem os comandos de revisão acima; seus funcionários continuam usando todos eles. Ele acrescenta as funções, o quadro e os despertares em torno disso. Para a ideia por trás dele, veja multi-agent harness.
Perguntas frequentes
O Claude Code e o Codex podem trabalhar juntos?
Sim. A configuração comum é um AGENTS.md compartilhado, um git worktree separado para cada agente e um ciclo de revisão em que um escreve e o outro faz a revisão. A OpenAI também publica um plugin oficial para o Claude Code, o codex-plugin-cc, que permite ao Claude Code chamar o Codex.
Qual é a melhor forma de usar o Claude Code e o Codex juntos?
Deixe um escrever e o outro revisar. Construa com o Claude Code no próprio worktree, depois rode codex review --base main (ou /codex:review de dentro do Claude Code) e devolva os achados. Troque os papéis quando o Codex escrever.
O Claude Code e o Codex conseguem conversar entre si?
De forma indireta. Cada um pode rodar a CLI do outro (codex exec, codex review, claude -p) e ler a saída, o plugin do Codex passa tarefas e resultados dentro do Claude Code, e um quadro compartilhado pode guardar a conversa. Os agent teams do Claude Code e a mensagem entre sessões conectam apenas sessões do Claude Code.
Posso rodar o Claude Code e o Codex ao mesmo tempo?
Sim, na mesma máquina e no mesmo repositório. Dê a cada um o seu próprio worktree para que não sobrescrevam os arquivos um do outro. Cada um usa o seu próprio plano ou chave de API, e o trabalho que você envia ao Codex pelo plugin conta para os seus limites do Codex.
Posso usar o Codex como servidor MCP no Claude Code?
Não mais. O codex mcp-server foi removido no Codex rust-v0.154.0; a OpenAI agora indica o Codex app server, que não é MCP. Para usar o Codex a partir do Claude Code, instale o codex-plugin-cc, da OpenAI.
O Claude Code e o Codex compartilham o AGENTS.md?
Podem compartilhar. O Codex lê o AGENTS.md por padrão. O Claude Code o lê quando o repositório não tem CLAUDE.md (v2.1.277 e posteriores); se você tem um CLAUDE.md, comece-o com @AGENTS.md para que os dois agentes sigam o mesmo arquivo.
O Codex pode ser um colega de equipe nos agent teams do Claude Code?
Não. Os agent teams são formados por instâncias do Claude Code: um líder e colegas de equipe que compartilham uma lista de tarefas e uma caixa de mensagens. Para trazer o Codex ao mesmo trabalho, use o plugin do Codex, um ciclo de revisão ou um quadro que rode os dois.
Quais ferramentas rodam o Claude Code e o Codex lado a lado?
Claude Squad, Conductor, Orca e Vibe Kanban iniciam os dois agentes em worktrees ou workspaces isolados. O Crewmark os roda como funcionários de IA de longa duração em um quadro de issues compartilhado.
Comandos e recursos conferidos na documentação do Claude Code, na documentação e na referência da CLI do Codex e no README do codex-plugin-cc em 20 de novembro de 2026.