Orkas Orkas
Início Blog Guia
Guia

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

Claude Code e Codex se destacam em coisas diferentes. Veja como usá-los juntos — do jeito manual, com terminais e git worktrees, e do jeito mais simples: um Commander do Orkas que conduz os dois a partir de um único chat.

Orkas desktop app showing Claude Code planning, Codex implementing and Claude Code reviewing the diff in one conversation
Ilustração: planejar, implementar e revisar em cruzado — Claude Code e Codex em uma única conversa do Orkas.

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 três maneiras. A manual — dois terminais, um arquivo de contexto compartilhado e git worktrees — já funciona hoje. Se você já trabalha dentro do Claude Code, o plugin oficial do Codex da OpenAI permite chamar o Codex dali mesmo. E o jeito mais simples de rodar os dois de igual para igual é colocar um orquestrador na frente deles. Este post cobre as três.

Em resumo Um chat, os dois CLIs O Orkas comanda Claude Code e Codex a partir da mesma conversa, na sua máquina, com suas chaves. Veja também Orkas vs Claude Code.
Baixar o Orkas — grátis

Três formas de usar o Claude Code e o Codex juntos

Veja como as três se comparam antes dos detalhes. Cada uma tem a sua própria seção abaixo.

FormaComo funcionaIdeal paraAtenção a
Dois terminaisVocê roda as duas CLIs lado a lado e compartilha contexto por meio de um arquivo e de git worktrees.Uma revisão cruzada ocasional em um único repositórioVocê carrega o contexto e junta os resultados na mão.
OrkasUm app de desktop roda as duas CLIs como agentes em um mesmo chat, e um Commander distribui o trabalho entre elas em paralelo.Os dois agentes trabalhando ao mesmo tempo em partes separadas, além do trabalho que não é códigoOs agentes não ganham um git worktree próprio automaticamente, e o app precisa ficar aberto.
O plugin do Codex da OpenAI para o Claude CodeO Claude Code continua sendo a sua sessão, e os comandos slash chamam o Codex para uma revisão ou uma tarefa que você passa.Quem já trabalha dentro do Claude CodeO Codex é um ajudante dentro do Claude Code, não um igual, e o review gate opcional pode consumir seus limites rapidamente.

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.

Quando o Claude Code ou o Codex atinge o limite de uso

As duas CLIs funcionam com limites de uso atrelados ao seu plano, e uma tarefa longa pode bater em um deles no meio do caminho. Você pode esperar o limite ser renovado. Se você paga pelos dois, também pode passar a tarefa para o outro agente: os limites do Claude Code e os do Codex vêm de dois planos separados, então, quando um acaba, o outro geralmente ainda tem folga.

A passagem de bastão funciona porque o trabalho fica na pasta do projeto, não dentro da sessão de nenhum dos agentes. Em 20 de outubro de 2026, testamos isso com as duas CLIs em uma pequena ferramenta em Python. O Claude Code construiu a primeira metade, com testes, e parou, deixando uma nota curta de progresso: o que estava feito, o que faltava e quais decisões manter. O Codex, iniciado do zero na mesma pasta, leu a nota, manteve essas decisões, construiu o resto e rodou a suíte inteira: 14 testes, todos passando. Foi a nota que fez isso funcionar, então peça ao agente que começar primeiro para manter uma enquanto trabalha.

No Orkas, a mesma passagem de bastão acontece em uma única conversa. Os dois agentes trabalham na mesma pasta do projeto, os dois recebem as Metas e regras e a Memória do projeto a cada execução, e os dois podem ler a lista A fazer do projeto. Quando o Claude Code parar com “Limite de uso atual atingido”, @-mencione o seu agente Codex e peça para ele continuar a partir da nota. Ele também vê as mensagens recentes da conversa, então você não precisa colar nada de um para o outro.

Duas coisas que o Orkas não faz: não adiciona uso a nenhum dos planos e não troca de agente por você; é você quem decide quando passar a tarefa. Com versões recentes das duas CLIs, a página de cada agente no Orkas mostra quanto resta de cada janela de uso e quando ela é renovada.

O atalho oficial: o plugin do Codex da OpenAI para Claude Code

Se o Claude Code já é onde você trabalha, a OpenAI encurtou parte desse ciclo. O plugin do Codex para Claude Code (codex-plugin-cc, Apache-2.0) é instalado de dentro de uma sessão do Claude Code:

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

Ele adiciona /codex:review para uma revisão somente leitura das suas alterações atuais, /codex:adversarial-review para uma revisão que você direciona a uma decisão de design específica e /codex:rescue para passar uma tarefa ao Codex, além de /codex:status, /codex:result e /codex:cancel para o trabalho que roda em segundo plano. Ele funciona pelo Codex CLI e pelo app server na sua própria máquina — a mesma instalação, o mesmo login e o mesmo checkout que você usaria diretamente — e precisa de um plano do ChatGPT (incluindo o plano Free) ou de uma chave de API da OpenAI.

Com isso, a revisão cruzada lá de cima vira um comando em vez de copiar e colar. O formato da configuração não muda: o Claude Code continua sendo a sessão em que você trabalha, e o Codex é chamado para dentro dela para uma revisão ou para uma tarefa que você passa. O README da OpenAI também avisa que o review gate opcional do plugin pode deixar os dois em loop e consumir seus limites de uso rapidamente. Se você prefere que os dois agentes trabalhem de igual para igual — cada um na sua tarefa, ao mesmo tempo, reportando para um só lugar —, essa é a configuração do Orkas descrita acima.

O que muda com o Claude Code Projects

Desde 17 de setembro de 2026, o Claude Code tem o Projects em beta: um coordenador distribui um objetivo entre threads paralelas, e cada thread é uma sessão do Claude Code na nuvem, em sua própria branch. Isso resolve rodar vários agentes do Claude Code ao mesmo tempo. Mas não traz o Codex. Todas as threads são Claude Code, e elas rodam na nuvem da Anthropic, não no seu computador. Se você quer o Claude Code e o Codex no mesmo trabalho, ainda precisa de uma das três formas deste post.

Mais sobre como o Projects funciona e onde ele para: Claude Code Projects explicado →

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.
  • Você decide quanta autonomia eles têm. Cada agente CLI roda no nível de permissão que você define em Equipe de IA > agente > Configurações de execução > Nível de permissão: Usar padrão da CLI, Pedir permissão ou Acesso total. Usar padrão da CLI preserva as permissões configuradas na própria CLI. Pedir permissão ativa os pedidos de aprovação; Acesso total dispensa as confirmações da CLI. As permissões dos conectores são separadas: ações sensíveis pedem aprovação, exceto quando você já autorizou aquela conexão para a tarefa ou ativou o modo Confiável no Orkas.

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.

Claude Code e Codex juntos: perguntas frequentes

Dá para usar Codex e Claude Code juntos?

Sim. São CLIs separadas com estado de sessão separado, então nada impede rodar as duas no mesmo repositório. O trabalho é evitar que editem os mesmos arquivos ao mesmo tempo — com git worktrees, ou deixando um comandante entregar cada tarefa a um agente.

Claude Code e Codex conversam entre si?

Não por conta própria. O Claude Code lê CLAUDE.md e o Codex lê AGENTS.md, e nenhum observa a sessão do outro. A exceção é o plugin do Codex da OpenAI para Claude Code, que permite que uma sessão do Claude Code chame o Codex para uma revisão ou para uma tarefa delegada. Fora isso, o que eles compartilham precisa passar por um arquivo que ambos escrevem, ou por um orquestrador que leva o resultado de um para o prompt do outro.

Existe um plugin do Codex para Claude Code?

Sim. A OpenAI publica um, o codex-plugin-cc. Dentro do Claude Code, rode /plugin marketplace add openai/codex-plugin-cc e /plugin install codex@openai-codex, depois /codex:setup. Ele adiciona comandos para revisões feitas pelo Codex e para passar uma tarefa ao Codex, funciona pelo Codex CLI na sua máquina e precisa de um plano do ChatGPT (incluindo o Free) ou de uma chave de API da OpenAI.

Qual a melhor forma de usar Codex e Claude Code juntos?

Divida por força, não por arquivo: deixe o Claude Code planejar e revisar, deixe o Codex executar uma mudança delimitada, e então peça ao outro para ler o diff. A passagem de revisão pega mais do que rodar o mesmo agente duas vezes.

Como fazer Codex e Claude Code trabalharem juntos?

No manual são dois terminais, um arquivo de spec compartilhado e um git worktree por agente para as edições não colidirem. No Orkas os dois rodam como sessões locais sob um Commander, que despacha a tarefa e reúne os dois diffs no mesmo chat.

Dá para rodar Claude Code e Codex ao mesmo tempo no mesmo projeto?

Dá para rodar em paralelo, mas não aponte os dois para a mesma pasta ao mesmo tempo — eles vão editar os mesmos arquivos simultaneamente. Dê a cada agente seu próprio git worktree ou seu próprio diretório de projeto. O Orkas não isola os agentes em worktrees separados para você, então esse passo é seu de qualquer forma.

Dá para rodar Claude Code e Codex em um só terminal?

Não como duas sessões interativas — cada CLI quer seu próprio TTY. Na prática, você divide o terminal com tmux ou deixa um orquestrador rodar os dois como sessões locais e juntar a saída em um só lugar. O Orkas segue o segundo caminho: os dois CLIs rodam sob um Commander e reportam no mesmo chat.

Dá para orquestrar além de Claude Code e Codex?

Sim. O Orkas dirige cinco agentes CLI locais — Claude Code, Codex, OpenCode, OpenClaw e Hermes. Os que você tiver instalados aparecem, e um único Commander pode misturá-los no mesmo projeto.

O Claude Code Projects funciona com o Codex?

Não. O Claude Code Projects coordena apenas sessões do Claude Code na nuvem. Para rodar o Claude Code e o Codex na mesma tarefa, você precisa do plugin do Codex, de uma configuração manual com git worktrees ou de um orquestrador como o Orkas, que roda os dois no seu computador.

Preciso de planos pagos para Claude Code e Codex?

Cada CLI usa o próprio login e o próprio plano. O Orkas apenas inicia os binários que você já tem — ele não gerencia chaves de API, login nem cobrança de nenhum dos dois.

O que fazer quando o Claude Code ou o Codex atinge o limite de uso?

Espere o limite ser renovado ou passe a tarefa para o outro agente, já que os dois limites vêm de planos separados. Mantenha uma nota curta de progresso na pasta do projeto (o que está feito, o que falta, quais decisões manter) para que o outro agente possa continuar a partir dela. No Orkas, os dois agentes compartilham a pasta do projeto e a conversa, então basta @-mencionar o outro para ele continuar.