Como usar Claude Code e Codex juntos — um chat para orquestrar os dois

Se você programa com IA em 2026, há uma boa chance de manter os dois — Claude Code e OpenAI Codex — à mão. Ambos são agentes de código no terminal, e é tentador colocar como Claude Code vs Codex — qual é melhor? Na prática, a pergunta mais útil é: como executar Claude Code e Codex juntos, sem virar o barramento humano que copia contexto entre dois terminais?

Resposta curta: dá para fazer, e de duas maneiras. A manual — dois terminais, um arquivo de contexto compartilhado e git worktrees — já funciona hoje. A mais simples é colocar um orquestrador na frente dos dois. Este post cobre as duas.

Claude Code vs Codex: quem é melhor em quê

Nenhum domina o outro; eles têm formatos diferentes, e usá-los juntos significa aproveitar a força de cada um:

• O Claude Code costuma brilhar em entender uma base de código existente: ler código desconhecido, explicar arquitetura, fazer edições cuidadosas em vários arquivos e revisar um diff para ver o que ele realmente vai quebrar.
• O Codex costuma brilhar em execução rápida e bem delimitada: montar uma nova feature, gerar boilerplate e avançar rápido em um ticket claramente definido.

Então "qual é melhor" é a pergunta errada. O fluxo interessante é planejar e revisar com um, executar com o outro — e, idealmente, cada um pegando os erros do outro.

O jeito manual: dois terminais, um contexto compartilhado

Ambas as ferramentas se instalam como CLIs e rodam em qualquer diretório de projeto:

npm install -g @anthropic-ai/claude-code   # depois: claude
npm install -g @openai/codex               # depois: codex

O truque para rodá-las no mesmo projeto é dar a elas uma fonte de verdade compartilhada e mantê-las fora do caminho uma da outra:

• Mantenha um PROJECT_CONTEXT.md vivo no repositório que os dois agentes leem e atualizam, para que um plano escrito por um seja visível para o outro.
• Use git worktrees para que cada agente trabalhe em seu próprio branch, em seu próprio diretório — eles nunca disputam os mesmos arquivos.

git worktree add ../feature-claude feature/claude
git worktree add ../feature-codex  feature/codex
# rode `claude` em um, `codex` no outro; revise e faça o merge dos diffs

Isso funciona. O detalhe é que você é a camada de integração: cola o plano do Claude Code no Codex, cola o diff do Codex de volta no Claude Code e reconcilia os resultados na mão.

Um fluxo que funciona de verdade: planejar → executar → revisão cruzada

O padrão mais confiável é uma pequena linha de montagem entre os dois agentes:

1. Claude Code  — leia o código, escreva um plano (arquivos, passos, riscos)
2. Codex        — implemente o plano rápido, produza um diff
3. Claude Code  — revise o diff do Codex: correção, casos de borda, estilo
4. itere no que a revisão apontar

Dois modelos independentes revisando o trabalho um do outro pegam uma classe de erros que um único agente, corrigindo a própria lição, ignora alegremente. O custo é a coordenação — que é justamente a parte que vale a pena automatizar.

O atrito: o orquestrador é você

Tudo acima funciona e, para uma tarefa pontual, está ótimo. Feito todo dia, o jeito manual transforma silenciosamente você no orquestrador: roteando cada tarefa para o agente certo, carregando contexto entre eles, reconciliando dois diffs. É trabalho de verdade — e é o mesmo problema de coordenação, seja com dois agentes de código ou vinte.

Como o Orkas roda Claude Code e Codex juntos

O Orkas é um app de desktop open source e local-first que transforma essa dança manual em um recurso nativo. Ele pode rodar agentes de código CLI locais para você — Claude Code, Codex, OpenClaw, OpenCode e Hermes — e coordená-los a partir de um único chat. A configuração é curta:

1. Instale e faça login nas CLIs `claude` e `codex` na sua máquina
2. No Orkas: novo chat → adicionar um agente → aba "External" → escolha uma CLI
   (o Orkas só lista as CLIs que detecta no seu PATH)
3. Faça isso duas vezes — um agente Claude Code, um agente Codex
4. Opcional: defina um diretório de projeto por agente e um modelo
   (deixe o modelo em branco para usar o padrão de cada CLI)

O Orkas não reimplementa nem embrulha os modelos. Ele roda os seus binários reais, já instalados, claude e codex como subprocessos, usando as credenciais com que você já fez login neles. Ele gerencia a coordenação, não as chaves.

Um Commander, os dois agentes, em paralelo

Agora você tem dois agentes especialistas em uma conversa. Peça algo ao Commander líder e ele roteia as partes — pode entregar a fatia de "entender e planejar" ao Claude Code e a de "implementar rápido" ao Codex. Quando o Commander dispara várias delegações em um único turno, o Orkas as executa simultaneamente (algumas por vez), então Claude Code e Codex trabalham ao mesmo tempo em vez de você alternar entre terminais. Você também pode simplesmente @-mencionar qualquer um dos agentes. Explicamos como essa orquestração funciona em Orquestração multiagente na prática.

Há um bônus que dois terminais nus não dão: quando o Orkas roda Claude Code ou Codex, ele também expõe a si mesmo de volta a eles por uma ponte local. O agente de código pode alcançar as ferramentas e o conhecimento conectados ao Orkas — seus conectores de GitHub, Notion ou Google Workspace e sua base de conhecimento — de dentro da própria execução, não apenas os arquivos do repositório.

Alguns pontos para acertar

• Você traz as CLIs e seus logins. O Orkas inicia claude e codex; ele não gerencia chaves de API nem login. Instale-as e faça login antes, em uma versão recente (aproximadamente Claude Code 2.0+ e Codex 0.100+).
• Aponte-as para diretórios diferentes para paralelizar com segurança. O Orkas não isola cada agente em seu próprio git worktree — se ambos apontarem para a mesma pasta e rodarem ao mesmo tempo, editam os mesmos arquivos simultaneamente. Dê a cada um seu próprio diretório de projeto ou repositório para trabalho paralelo de verdade.
• Eles rodam de forma autônoma. Dentro do Orkas, Claude Code e Codex rodam sem pedir aprovação a cada passo, então editam arquivos e executam comandos por conta própria. A única coisa que o Orkas ainda confirma com você é quando um agente de código usa um conector.

Então — Claude Code ou Codex?

Os dois. Use Claude Code para entender, arquitetar e revisar; use Codex para execução rápida e bem delimitada; e deixe um Commander rotear entre eles para você conduzir o trabalho em vez de transportá-lo. É esse o sentido de usá-los juntos em vez de escolher um vencedor.

Local-first significa que seu repositório e suas chaves ficam na sua máquina — veja O que é IA local-first? Para pular a dança dos dois terminais, baixe o Orkas e aponte um Commander para Claude Code e Codex.