Blog · Agentes de programação

Como usar o Claude Code e o Codex juntos

Sim, o Claude Code e o Codex funcionam bem juntos: rode cada um em um git worktree próprio do mesmo repositório, dê aos dois o mesmo AGENTS.md e deixe um escrever o código enquanto o outro o revisa. Para uma ligação mais direta, a OpenAI publica um plugin oficial que permite ao Claude Code chamar o Codex para revisões e passar tarefas a ele. Este guia cobre as cinco formas como as pessoas combinam os dois, uma configuração passo a passo com comandos da documentação oficial, como os agentes podem conversar entre si, o que observar quando os dois rodam ao mesmo tempo e as ferramentas que os orquestram. Atualizado em 20 de novembro de 2026.

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.

FormaComo funcionaUse quando
1. Instruções compartilhadasUm único AGENTS.md que os dois agentes leem; o CLAUDE.md o importaSempre. É o passo mais barato e evita que os dois agentes sigam regras diferentes
2. Worktrees separadosCada agente trabalha em um git worktree e um branch próprios do mesmo repositórioOs dois agentes editam código ao mesmo tempo
3. Um escreve, o outro revisaO Claude Code escreve e codex review confere o branch, ou o contrárioVocê quer um segundo modelo para pegar o que o primeiro deixou passar
4. Codex dentro do Claude CodeO codex-plugin-cc, da OpenAI, adiciona /codex:review, /codex:rescue e mais ao Claude CodeVocê vive no Claude Code e quer o Codex a um comando de distância
5. Um orquestradorUm quadro ou app (Claude Squad, Conductor, Orca, Vibe Kanban, Crewmark) inicia e acompanha os doisVocê roda vários agentes todo dia e perde o controle dos terminais

1. Dê as mesmas instruções aos dois agentes

O Codex lê o AGENTS.md: um arquivo global em ~/.codex e depois todos os AGENTS.md da raiz do projeto até a pasta em que você está, com um AGENTS.override.md tendo precedência no próprio diretório. Ele para de adicionar arquivos em 32 KiB por padrão (project_doc_max_bytes). Mais detalhes no nosso guia do AGENTS.md no Codex.

O Claude Code também pode ler o AGENTS.md, a partir da v2.1.277, mas por padrão só quando não há CLAUDE.md, .claude/CLAUDE.md nem CLAUDE.local.md na pasta ou acima dela. Se o seu repositório tem um CLAUDE.md, coloque @AGENTS.md no topo dele para que o Claude leia o arquivo compartilhado primeiro, e adicione abaixo as regras só do Claude. Um symlink (ln -s AGENTS.md CLAUDE.md) também funciona, mas a documentação recomenda o import se alguém da equipe usa Windows. Veja o guia do CLAUDE.md para o resto.

  • Coloque no AGENTS.md os comandos de build, teste e lint, o estilo de código e as regras de "não mexer", para que os dois agentes rodem as mesmas verificações.
  • Deixe de fora as notas específicas de cada agente: as regras só do Claude ficam abaixo do import no CLAUDE.md, e as configurações só do Codex em ~/.codex/config.toml.
  • O Claude Code ignora AGENTS.override.md e AGENTS.local.md, então não coloque regras compartilhadas neles.

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 main revisa o branch em relação ao main; --uncommitted revisa 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 roda git diff main | claude -p como 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 /review no 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 --background para trabalhos longos e acompanhe com /codex:status e /codex:result.
  • /codex:transfer: transforma a conversa atual do Claude Code em uma thread do Codex e imprime o comando codex resume para 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.

  1. 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/.
  2. 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/" >> .gitignore
  3. Inicie 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"
  4. 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 main
  5. Peç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."
  6. 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 exec ou codex review como comando de shell, e o Codex pode rodar claude -p. Cada um recebe a resposta do outro como saída do comando.
  • Pelo plugin: no Claude Code, /codex:rescue e /codex:review enviam 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 serve transforma 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.

FerramentaO que fazIsolamentoRoda emLicença / status
Claude SquadApp 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 agenteTerminal (instala com Homebrew)Código aberto, AGPL-3.0
ConductorRoda Claude Code, Codex, Cursor e OpenCode em paralelo; revise o diff, abra um PR, faça o mergeUm workspace e um branch por tarefaMacApp desktop
OrcaRoda uma frota de agentes de terminal, incluindo Claude Code e Codex, com as suas próprias assinaturasGit worktree por agentemacOS, Windows, LinuxCódigo aberto, MIT
Vibe KanbanQuadro kanban que inicia um workspace por issue com Claude Code, Codex, Gemini CLI e outrosGit worktree por workspaceNavegador ou app desktop via npx vibe-kanbanCódigo aberto, Apache-2.0; mantido pela comunidade desde que a bloop encerrou as atividades em abril de 2026
CrewmarkClaude Code e Codex como funcionários de IA de longa duração, com funções, em um quadro de issues compartilhadoCada funcionário é uma sessão própria na sua máquinaA sua própria máquinaVeja 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.

Coloque o Claude Code e o Codex na mesma equipe.

O Crewmark dá a cada agente uma função, um quadro de issues compartilhado e despertares agendados, para que passem trabalho um ao outro sem você copiar nada entre terminais.

O Crewmark é de código aberto: deixe uma estrela no GitHub