Guia Orca: instale e monte sua equipe de agentes

Vários agentes de IA trabalhando ao mesmo tempo, numa tela só, com a assinatura que você já tem.

O que é

Em uns 20 minutos você termina com o Orca instalado e dois ou três agentes trabalhando no mesmo pedido, cada um na sua cópia do projeto.

O Orca é gratuito e de código aberto (licença MIT). Ele junta vários agentes de programação numa tela só. Não tem IA própria e não cobra nada: roda o Claude Code, o Codex e outros agentes que você já usa, com a sua assinatura.

Antes de começar

O Orca é só a central de comando. Os agentes precisam estar instalados e logados no seu computador antes.

Um agente de linha de comando funcionando. Por exemplo o Claude Code (assinatura Claude Pro ou Max) ou o Codex (assinatura ChatGPT). Teste: abra o terminal, digite claude ou codex e veja se ele responde.
Git instalado (git-scm.com). Cada agente trabalha numa cópia separada do projeto, que o Git chama de worktree.
Uma pasta de projeto com Git. Pode ser um projeto seu do GitHub ou uma pasta nova onde você rodou git init e fez um primeiro commit.

As assinaturas têm limite de uso. Com três agentes no mesmo pedido, o limite acaba três vezes mais rápido.

Instalar

Baixe pelo site oficial, onorca.dev/download, ou direto do GitHub:

Sistema	Arquivo
Mac com chip Apple (M1 em diante)	orca-macos-arm64.dmg
Mac com Intel	orca-macos-x64.dmg
Windows	orca-windows-setup.exe
Linux	orca-linux.AppImage (.deb e .rpm na página de versões)

No Mac também dá pelo Homebrew:

brew install --cask stablyai/orca/orca

Use o nome inteiro: orca sozinho instala outro programa, sem relação.

Na primeira vez que abrir

1O Mac pode pedir confirmação para abrir o app. É normal: o app é assinado pela Apple.
2Libere o acesso à sua pasta de usuário, para o Orca enxergar os projetos.
3Se ele oferecer importar as configurações do Claude Code e do Codex, aceite.
4Na tela inicial, clique em Add Repo e escolha a pasta do seu projeto.

Depois disso ele se atualiza sozinho.

Sua primeira equipe de agentes

A ideia é mandar o mesmo pedido para três agentes, comparar o que cada um fez e ficar com o melhor.

1Na barra lateral, clique no + ao lado do nome do projeto e dê um nome para a tarefa, por exemplo botao-de-login. Isso cria uma cópia separada do projeto (worktree).
2Em start-from, deixe a branch principal (normalmente origin/main).
3No terminal que abrir, escolha o agente no seletor: Claude Code, Codex, Cursor ou outro.
4Repita os passos 1 a 3 mais duas vezes (botao-de-login-2, botao-de-login-3). Dá para usar um agente diferente em cada um.
5Cole o mesmo pedido nos três e deixe trabalharem.
6Para ver todos ao mesmo tempo, arraste a aba de um deles até a borda direita ou de baixo. A tela se divide.
7Quando terminarem, abra a visão de mudanças (diff) de cada um. Com

Para o primeiro teste, use um pedido pequeno e fácil de conferir, como "adicione um botão de modo escuro nesta página". Assim você compara o resultado em poucos minutos.

Os outros recursos do vídeo

Modo de design

O Orca tem um navegador dentro de cada worktree. Com o site do projeto aberto nele:

1Clique em Design Mode na barra do navegador. O cursor vira um seletor.
2Clique na parte da página que quer mudar (um botão, um título, um card).
3O Orca anexa no terminal do agente o HTML, o CSS e um print recortado daquele pedaço.
4Escreva o que quer mudar, por exemplo "deixe esse botão maior e verde", e envie.

Dá para marcar vários pedaços e mandar todos de uma vez.

GitHub e Linear

GitHub: em Settings > Integrations, conecte sua conta. Issues e pull requests aparecem dentro do Orca, e de uma issue você cria o worktree já com o nome e o link da tarefa.
Linear: em Settings > Integrations > Linear, cole um token pessoal (no Linear, em Settings > API) e escolha os times. Abra a tarefa e crie o worktree a partir dela: o Orca usa o nome de branch que o Linear sugerir.

App no celular

O app está em beta. No iPhone ele se chama Orca IDE na App Store. No Android ele não está na Play Store: o APK é baixado pelo site oficial.

1Entre na mesma conta Orca no computador e no celular.
2No computador, abra o menu da conta ou de status e escolha o pareamento. Aparece um código de uso único, que vence em poucos minutos.
3No celular, toque em Pair e cole o código. Prefira o Orca Relay: assim funciona mesmo fora da sua rede de casa.

Pelo celular você vê o status de cada agente (trabalhando, terminou ou esperando você), recebe notificação quando um termina, responde, manda foto ou áudio e até faz commit.

O computador precisa estar ligado e com o Orca aberto.

Deu problema?

O que aconteceu	O que fazer
O agente não abre	Rode `claude` ou `codex` num terminal normal, fora do Orca. Se falhar lá também, falta instalar ou logar no agente. Se funcionar, confira Settings > Agents e clique em Restart na aba.
Não consigo criar o worktree	Rode `git fetch origin` na pasta do projeto. Se ainda falhar, já existe um worktree com esse nome: apague o antigo ou use outro nome.
As mudanças pararam de atualizar	Clique no ícone de atualizar na barra do diff.
O Orca ficou pesado	Feche os worktrees que não está usando. Abas de navegador divididas são o que mais gasta memória.
O código do celular não funciona	Ele vence em poucos minutos: gere outro. Confira se os dois aparelhos estão na mesma conta Orca.

Para o resto, tem a página de problemas da documentação e o Discord oficial.

Fontes

Conferido em 27/10/2026 na documentação oficial. O Orca muda rápido: se um botão tiver outro nome, vale o que estiver na tela.