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

> Para rodar várias sessões do Claude Code ao mesmo tempo, dê a cada sessão o seu git worktree: uma pasta e uma branch separadas do mesmo repositório. No manual, você roda `git worktree add` por tarefa e inicia o `claude` em cada pasta, numa aba própria. O Tallos automatiza isso: cada workspace novo é um worktree com sua sessão do Claude Code, lado a lado, com revisão de diff.

- Canonical: https://runtallos.com/pt/aprenda/rodar-varias-sessoes-do-claude-code
- English: https://runtallos.com/learn/run-multiple-claude-code-sessions.md
- Atualizado em: 2026-09-29
- Section: Aprenda

## Em resumo

- Uma sessão por worktree: sem arquivos nem branch compartilhados
- Manual: `git worktree add` + uma aba de terminal por sessão
- Tallos: um clique por workspace, painéis divididos, diff por workspace
- Todas as sessões dividem os limites de uso do seu plano do Claude

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

Dá. O [Claude Code](https://runtallos.com/pt/integracoes/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`.

```bash
# 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](https://runtallos.com/pt/aprenda/git-worktrees-para-agentes-de-ia) 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. → https://runtallos.com/signup

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

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](https://runtallos.com/pt/aprenda/conectar-seus-agentes).
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. **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. **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. **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. **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. **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](https://runtallos.com/pt/recursos/workspaces-paralelos).

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

| Tarefa | Manual (git + abas de terminal) | Tallos |
| --- | --- | --- |
| Criar uma sessão isolada | `git worktree add ../dir -b branch`, `cd`, `claude` | Novo workspace → Claude Code |
| Copiar `.env` e config local | Na mão, em cada worktree | `.worktreeinclude`, aplicado a todo workspace novo |
| Ver qual sessão precisa de você | Olhar aba por aba | Status na barra lateral |
| Acompanhar várias sessões | Divisões do terminal ou tmux | Arrastar abas para painéis divididos |
| Revisar uma sessão | `git diff main...branch` | Diff com notas por linha que voltam para o agente |
| Limpar | `git worktree remove` + `git branch -d` | Excluir o workspace (com confirmação) |

_Sessões paralelas do Claude Code, de dois jeitos_

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](https://runtallos.com/pt/squads/melhor-de-tres): 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](https://runtallos.com/pt/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. → https://runtallos.com/signup

## Perguntas frequentes

### Duas sessões do Claude Code podem trabalhar na mesma pasta?

Podem, mas vão editar os mesmos arquivos na mesma branch e sobrescrever uma à outra. Dê a cada sessão seu próprio git worktree.

### Sessões paralelas do Claude Code dividem os limites de uso?

Sim. Toda sessão na mesma conta consome os limites daquela conta. O Tallos mostra seu uso do Claude na barra de status para você ver o quanto falta.

### O Tallos usa git worktrees nas sessões do Claude Code?

Sim. Todo workspace do Tallos é um git worktree de verdade com branch própria, e o Claude Code roda com esse worktree como diretório de trabalho.

### Posso rodar Claude Code e Codex na mesma tarefa em paralelo?

Pode. Crie dois workspaces a partir da mesma branch, um com cada agente, passe o mesmo prompt e compare os diffs.

### Como paro de copiar o .env para cada worktree?

Liste os arquivos ignorados pelo git num `.worktreeinclude` na raiz do repositório. O Tallos copia esses arquivos em cada workspace novo.

### O que acontece com a branch quando excluo um workspace?

O Tallos remove a pasta do worktree e a branch depois da confirmação. Se o git mantiver a branch por ela ter commits sem merge, o Tallos deixa você revisar antes de apagar.

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)