Como rodar várias sessões do Claude Code ao mesmo tempo

Dá para rodar várias sessões do Claude Code ao mesmo tempo?

Dá. O Claude Code é uma CLI, então você pode iniciar quantos processos claude sua máquina e seu plano aguentarem. O problema é a pasta. Duas sessões no mesmo diretório de trabalho editam os mesmos arquivos na mesma branch e uma sobrescreve a outra. A solução é dar a cada sessão seu próprio diretório de trabalho, e o jeito limpo de fazer isso é um git worktree.

• Mesmos arquivos: a sessão A reescreve o auth.ts enquanto a sessão B está no meio da edição dele.
• Mesma branch e mesmo index: o git add ou git stash de uma sessão leva junto as mudanças da outra.
• Mesmo build: testes, servidores de desenvolvimento e lockfiles batem de frente.
• Histórico ilegível: na revisão, você não sabe qual mudança veio de qual prompt.

Como rodar várias sessões do Claude Code manualmente com git worktrees?

Crie um worktree por tarefa, abra uma aba de terminal para cada um e inicie o Claude Code em cada aba. Cada worktree é um checkout completo numa branch própria, compartilhando o mesmo histórico do .git.

# na raiz do seu repositório
git worktree add ../myapp-auth -b feat/auth-flow
git worktree add ../myapp-tests -b test/checkout

# aba de terminal 1
cd ../myapp-auth && npm install && claude

# aba de terminal 2
cd ../myapp-tests && npm install && claude

# veja o que você tem
git worktree list

1. Copie para cada worktree os arquivos ignorados pelo git que a sessão precisa (.env, configuração local) e instale as dependências lá.
2. Use uma porta diferente em cada sessão que sobe servidor de desenvolvimento.
3. Revise cada branch com git diff main...feat/auth-flow antes do merge.
4. No fim, limpe com git worktree remove ../myapp-auth e git branch -d feat/auth-flow.

Funciona, e é exatamente o que acontece por baixo do Tallos. O guia de git worktrees detalha cada comando e cada armadilha.

O que dá errado quando você gerencia sessões paralelas na mão?

O manual vai bem com duas sessões e vira sofrimento com cinco. O trabalho não são os agentes; é tudo em volta deles.

• Acompanhar o estado: qual aba terminou, qual está esperando permissão, qual travou.
• Preparar cada worktree: dependências, .env e portas, toda vez.
• Revisar: trocar de pasta e rodar git diff por branch, sem lugar para deixar comentários por linha para o agente.
• Limpar: worktrees velhos e branches esquecidas se acumulam, e uma pasta apagada na mão deixa metadados que pedem git worktree prune.

Pule a configuração. O Tallos dá a cada sessão do Claude Code seu worktree com um clique.

Baixar o Tallos →

Como rodar várias sessões do Claude Code no Tallos?

1. 1

   Conecte o Claude Code

   Abra Configurações → Conexões e confira se o cartão do Claude Code está Conectado. Se não estiver, clique em Instalar e depois em Entrar (roda claude auth login) ou Usar chave de API. Guia: conectar seus agentes.

2. 2

   Abra seu projeto

   Adicione o repositório uma vez. O Tallos usa a branch padrão como base de onde todo workspace parte.

3. 3

   Crie um workspace por tarefa

   Clique em Novo workspace, escolha o projeto, dê nome à tarefa e selecione Claude Code como agente. O Tallos cria um git worktree e uma branch de verdade em segundo plano. Repita para cada tarefa; dá para continuar trabalhando enquanto eles são criados.

4. 4

   Passe a tarefa para cada sessão

   O Claude Code abre num chat dentro de cada workspace. Descreva a tarefa ali, ou troque para Ver terminal para usar a CLI crua. Cada sessão roda com o workspace como diretório de trabalho.

5. 5

   Acompanhe lado a lado

   Arraste uma aba até a borda direita ou inferior de um painel para dividir a tela e acompanhar várias sessões ao mesmo tempo. A barra lateral mostra quais workspaces estão trabalhando e quais precisam de você, e a barra de status mostra seu uso do Claude em relação aos limites do plano.

6. 6

   Revise cada diff

   Abra o diff de cada workspace contra a branch de partida. Deixe notas nas linhas e devolva tudo num lote para aquela sessão com Enviar notas para.

7. 7

   Entregue o que ficou bom, exclua o resto

   Faça commit, push e Criar PR nos workspaces que você mantém. Exclua os outros; o Tallos remove a pasta do worktree e a branch depois da sua confirmação.

Para parar de copiar .env na mão, liste os arquivos num .worktreeinclude na raiz do repositório. O Tallos copia esses arquivos ignorados pelo git em cada workspace novo. Mais em workspaces paralelos.

Worktrees na mão vs Tallos: qual a diferença?

Os dois jeitos usam o mesmo recurso do git, então não há amarra: todo workspace do Tallos é um worktree normal que você abre em qualquer terminal, e worktrees que você mesmo criou podem aparecer na barra lateral do Tallos.

Quantas sessões do Claude Code devo rodar em paralelo?

Quantas você conseguir revisar. O Tallos não impõe um teto fixo, mas existem três limites. Seu plano: toda sessão consome os limites de uso da mesma conta do Claude, então sessões em paralelo chegam a eles mais rápido. Sua máquina: cada workspace mantém observadores de arquivos, dependências e processos vivos. Sua atenção: cada diff ainda precisa de revisão humana antes de ir para produção.

Comece com duas ou três tarefas independentes, como uma feature, uma suíte de testes e uma correção de bug. Se quiser várias tentativas da mesma tarefa, use a squad melhor de três: escolha Claude Code para o membro de tentativa e um líder inicia três cópias em worktrees separados, compara os resultados e recomenda uma. Para o panorama completo, leia rodar agentes de IA em paralelo.

Solução de problemas com sessões paralelas do Claude Code

• `fatal: 'branch' is already checked out`. O git só permite uma branch em um worktree por vez. Crie uma branch nova por sessão.
• Os testes só falham no worktree novo. Faltam arquivos ignorados pelo git. Instale as dependências e copie o .env, ou coloque-os no .worktreeinclude.
• Porta já em uso. Duas sessões subiram o mesmo servidor de desenvolvimento. Use uma porta por workspace.
• As sessões travam juntas. Provavelmente você bateu o limite de uso do plano. Confira o uso na barra de status.
• Uma sessão espera sem saída nenhuma. Ela está pedindo permissão. Abra o chat e responda.

Teste no seu próprio repositório.

Baixar o Tallos →