Orkas Orkas
Início Blog Guia
Guia

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

O Claude Code e o Codex destacam-se em coisas diferentes. Veja como usá-los em conjunto — de forma manual, com terminais e git worktrees, e da forma mais simples: um Commander do Orkas que conduz os dois a partir de uma única conversa.

Se programa com IA em 2026, é bastante provável que tenha os dois — Claude Code e OpenAI Codex — à mão. Ambos são agentes de código no terminal, e é tentador formular a questão como Claude Code ou Codex — qual é melhor? Na prática, a pergunta mais útil é: como executar o Claude Code e o Codex em conjunto, sem se tornar o barramento humano que copia contexto entre dois terminais?

Resposta curta: é possível, e de três maneiras. A manual — dois terminais, um ficheiro de contexto partilhado e git worktrees — já funciona hoje. Se já trabalha dentro do Claude Code, o plugin oficial do Codex da OpenAI permite chamar o Codex a partir daí. E a forma mais simples de pôr os dois a trabalhar em pé de igualdade é colocar um orquestrador à frente deles. Este artigo aborda as três.

Em resumo Uma conversa, as duas CLI O Orkas comanda o Claude Code e o Codex a partir da mesma conversa, na sua máquina, com as suas chaves. Veja também Orkas vs Claude Code.
Descarregar o Orkas — grátis

Claude Code e Codex: em que é melhor cada um

Nenhum domina o outro; têm formatos diferentes, e usá-los em conjunto significa aproveitar os pontos fortes de cada um:

  • O Claude Code costuma brilhar em compreender uma base de código existente: ler código desconhecido, explicar a arquitetura, fazer edições cuidadosas em vários ficheiros e rever um diff para ver o que vai realmente deixar de funcionar.
  • O Codex costuma brilhar em execução rápida e bem delimitada: criar uma nova funcionalidade, gerar código-base e avançar rapidamente numa tarefa claramente definida.

Por isso, "qual é melhor" é a pergunta errada. O fluxo interessante é planear e rever com um, executar com o outro — e, idealmente, cada um detetar os erros do outro.

A forma manual: dois terminais, um contexto partilhado

Ambas as ferramentas são instaladas como CLI e funcionam em qualquer diretório de projeto:

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

O truque para as executar no mesmo projeto é dar-lhes uma fonte de verdade partilhada e impedir que interfiram uma com a 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 no seu próprio ramo, no seu próprio diretório — nunca disputam os mesmos ficheiros.
git worktree add ../feature-claude feature/claude
git worktree add ../feature-codex  feature/codex
# run `claude` in one, `codex` in the other; review and merge the diffs

Isso funciona. O detalhe é que si é 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 à mão.

Um fluxo que funciona de facto: planear → executar → revisão cruzada

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

1. Claude Code  — read the code, write a plan (files, steps, risks)
2. Codex        — implement the plan fast, produce a diff
3. Claude Code  — review Codex's diff: correctness, edge cases, style
4. loop on anything the review flags

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

O atrito: o orquestrador é o utilizador

Tudo o que foi descrito acima funciona e, para uma tarefa pontual, está ótimo. Feita todos os dias, a abordagem manual transforma silenciosamente si no orquestrador: encaminhando cada tarefa para o agente certo, transportando contexto entre eles, reconciliando dois diffs. É trabalho a sério — e é o mesmo problema de coordenação, seja com dois agentes de código ou com vinte.

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

Se o Claude Code já é onde trabalha, a OpenAI encurtou parte deste ciclo. O seu plugin do Codex para o Claude Code (codex-plugin-cc, Apache-2.0) instala-se a partir de uma sessão do Claude Code:

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

Acrescenta /codex:review para uma revisão só de leitura das alterações em curso, /codex:adversarial-review para uma revisão que orienta para uma decisão de design concreta e /codex:rescue para passar uma tarefa ao Codex, além de /codex:status, /codex:result e /codex:cancel para o trabalho que corre em segundo plano. Funciona através da CLI do Codex e do app server na sua própria máquina — a mesma instalação, a mesma sessão iniciada e o mesmo checkout que usaria diretamente — e requer um plano do ChatGPT (incluindo o plano Free) ou uma chave de API da OpenAI.

Assim, a revisão cruzada descrita acima passa a ser um comando em vez de copiar e colar. A forma da configuração não muda: o Claude Code continua a ser a sessão em que trabalha, e o Codex é chamado para dentro dela para uma revisão ou para uma tarefa que lhe entrega. O README da OpenAI avisa também que o review gate opcional do plugin pode manter os dois em ciclo e esgotar depressa os seus limites de utilização. Se prefere que os dois agentes trabalhem em pé de igualdade — cada um na sua tarefa, ao mesmo tempo, a reportar para o mesmo sítio —, essa é a terceira maneira.

Como o Orkas executa o Claude Code e o Codex em conjunto

O Orkas é uma aplicação para computador de código aberto e com prioridade ao funcionamento local que transforma essa dança manual numa funcionalidade nativa. Pode executar agentes de código CLI locais por si — Claude Code, Codex, OpenClaw, OpenCode e Hermes — e coordená-los a partir de uma única conversa. A configuração é breve:

1. Install and sign in to the `claude` and `codex` CLIs on your machine
2. In Orkas: new chat → add an agent → "External" tab → pick a CLI
   (Orkas only lists the CLIs it detects on your PATH)
3. Do it twice — one Claude Code agent, one Codex agent
4. Optionally set a project directory per agent, and a model
   (leave the model blank to use each CLI's own default)

O Orkas não reimplementa os modelos nem os encapsula. Executa os seus binários reais, já instalados, claude e codex como subprocessos, usando as credenciais com que já iniciou sessão neles. Gere a coordenação, não as chaves.

Um Commander, os dois agentes, em paralelo

Agora tem dois agentes especialistas numa conversa. Peça algo ao Commander líder e ele encaminha as partes — pode entregar a parte de "compreender e planear" ao Claude Code e a de "implementar rapidamente" ao Codex. Quando o Commander desencadeia várias delegações num único turno, o Orkas executa-as simultaneamente (algumas de cada vez), pelo que o Claude Code e o Codex trabalham ao mesmo tempo em vez de ter de alternar entre terminais. Também pode simplesmente mencionar qualquer um dos agentes com @. Explicamos como esta orquestração funciona em Orquestração multiagente na prática.

Há uma vantagem adicional que dois terminais por si só não oferecem: quando o Orkas executa o Claude Code ou o Codex, também se expõe a si mesmo a eles através de uma ponte local. O agente de código pode aceder às ferramentas e ao conhecimento ligados ao Orkas — os seus conectores do GitHub, Notion ou Google Workspace e a sua base de conhecimento — a partir da própria execução, não apenas aos ficheiros do repositório.

Alguns pontos para acertar

  • As CLI e as respetivas sessões são da sua responsabilidade. O Orkas inicia claude e codex; não gere chaves de API nem o início de sessão. Instale-as e inicie sessão previamente, numa 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 no seu próprio git worktree — se ambos apontarem para a mesma pasta e forem executados ao mesmo tempo, editam os mesmos ficheiros simultaneamente. Dê a cada um o seu próprio diretório de projeto ou repositório para trabalho verdadeiramente paralelo.
  • Decide quanta autonomia têm. Cada agente CLI é executado com o nível de permissão que definir em Equipa de IA > agente > Definições de execução > Nível de permissão: Usar a predefinição da CLI, Pedir permissão ou Acesso total. Usar a predefiniçã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: as ações sensíveis pedem aprovação, exceto quando já autorizou essa ligação para a tarefa ou ativou o modo Fiável no Orkas.

Então — Claude Code ou Codex?

Os dois. Use o Claude Code para compreender, definir a arquitetura e rever; use o Codex para uma execução rápida e bem delimitada; e deixe um Commander encaminhar as tarefas entre eles para poder conduzir o trabalho em vez de o transportar. É esse o sentido de os usar em conjunto em vez de escolher um vencedor.

A prioridade ao funcionamento local significa que o seu repositório e as suas chaves ficam na sua máquina — veja O que é a IA com prioridade ao funcionamento local? Para evitar a dança dos dois terminais, descarregue o Orkas e aponte um Commander para Claude Code e Codex.

Claude Code e Codex juntos: perguntas frequentes

É possível usar o Codex e o Claude Code em conjunto?

Sim. São CLI separadas com estados de sessão separados, pelo que nada impede a execução das duas no mesmo repositório. O trabalho é evitar que editem os mesmos ficheiros 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 si próprios. 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 o Claude Code, que permite a uma sessão do Claude Code chamar o Codex para uma revisão ou para uma tarefa delegada. De resto, o que partilham tem de passar por um ficheiro em que ambos escrevem, ou por um orquestrador que leva o resultado de um para o prompt do outro.

Existe um plugin do Codex para o Claude Code?

Sim. A OpenAI publica um, o codex-plugin-cc. No Claude Code, execute /plugin marketplace add openai/codex-plugin-cc e /plugin install codex@openai-codex, e depois /codex:setup. Acrescenta comandos para revisões feitas pelo Codex e para lhe passar tarefas, funciona através da CLI do Codex na sua máquina e requer um plano do ChatGPT (incluindo o Free) ou uma chave de API da OpenAI.

Qual é a melhor forma de usar o Codex e o Claude Code em conjunto?

Divida por pontos fortes, não por ficheiros: deixe o Claude Code planear e rever, deixe o Codex executar uma alteração delimitada e depois peça ao outro para ler o diff. A passagem de revisão deteta mais problemas do que executar o mesmo agente duas vezes.

Como fazer com que o Codex e o Claude Code trabalhem em conjunto?

Na abordagem manual, são dois terminais, um ficheiro de especificação partilhado e um git worktree por agente para que as edições não entrem em conflito. No Orkas, os dois são executados como sessões locais sob um Commander, que distribui a tarefa e reúne os dois diffs na mesma conversa.

É possível executar o Claude Code e o Codex ao mesmo tempo no mesmo projeto?

É possível executá-los em paralelo, mas não aponte os dois para a mesma pasta ao mesmo tempo — vão editar os mesmos ficheiros simultaneamente. Dê a cada agente o seu próprio git worktree ou o seu próprio diretório de projeto. O Orkas não isola os agentes em worktrees separados por si, pelo que esse passo é sempre da sua responsabilidade.

É possível executar o Claude Code e o Codex num único terminal?

Não como duas sessões interativas — cada CLI precisa do seu próprio TTY. Na prática, divide o terminal com tmux ou deixa um orquestrador executar os dois como sessões locais e reunir a saída num único local. O Orkas segue o segundo caminho: as duas CLI são executadas sob um Commander e apresentam os resultados na mesma conversa.

É possível orquestrar outros agentes além do Claude Code e do Codex?

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

Preciso de planos pagos para Claude Code e Codex?

Cada CLI usa o seu próprio início de sessão e plano. O Orkas apenas inicia os binários que já tem — não gere chaves de API, o início de sessão nem a faturação de nenhum dos dois.