Coordenação de Múltiplas Sessões de Código Claude em um Repositório Compartilhado

Executar várias sessões do Claude Code contra a mesma base de código sem uma camada de coordenação produz três modos de falha silenciosa: gravações de arquivos conflitantes que corrompem o estado compartilhado, trabalhos de CI duplicados acionados por pushes paralelos de branches e o estado da sessão do Browser MCP perdido devido a timeouts de 5 minutos durante a execução. Este tutorial percorre uma arquitetura de coordenação em camadas — claude-presence MCP para conscientização em tempo real da sessão, sandboxes Daytona por sessão para isolamento de CI e configuração persistente do Browser MCP — para que você possa paralelizar o trabalho do agente sem que nenhum desses problemas ocorra.

Resumo: Quando duas ou mais sessões do Claude Code são executadas contra o mesmo repositório simultaneamente, elas não têm consciência umas das outras. A solução é em três camadas: (1) instale o servidor claude-presence MCP para dar visibilidade às sessões sobre o que outras estão tocando, (2) execute cada sessão em uma sandbox Daytona isolada para evitar thrashing de CI e (3) configure o Browser MCP com persistência fixada na sessão para evitar a perda de estado de 5 minutos que causa falhas de integração de ferramentas e alucinações. Todas as três camadas podem ser configuradas em menos de 30 minutos.

O que quebra quando sessões paralelas do Claude Code compartilham um repositório

Antes de construir uma solução, vale a pena ser preciso sobre o que realmente falha. Um tópico recente no r/mcp anunciando a ferramenta claude-presence documentou três modos de falha distintos que são fáceis de perder até que já tenham custado trabalho.

Gravações conflitantes e estado compartilhado corrompido. Duas sessões editando o mesmo arquivo produzem um resultado de último escritor vence — a sessão que grava no disco por último sobrescreve silenciosamente as alterações da outra. Com agentes operando em alta velocidade em dezenas de arquivos simultaneamente, quando você percebe o conflito, o trabalho de uma sessão pode estar completamente perdido. Sem marcador de conflito de mesclagem, sem aviso — apenas sobrescrito.

Trabalhos de CI duplicados e thrashing de PR. Ambas as sessões alcançam um ponto de commit natural, ambas fazem push para a mesma branch (ou branches relacionadas), e seu pipeline de CI é acionado duas vezes para o que é logicamente uma mudança. Pior, se ambas as sessões abrem PRs, você acaba com solicitações de revisão duplicadas, verificações de status duplicadas e revisores confusos sobre qual PR agir. Este é o modo de falha que mais frequentemente faz com que as equipes abandonem fluxos de trabalho de múltiplos agentes completamente.

Perda de estado da sessão do Browser MCP. Um tópico ativo separado no r/mcp documentou como as extensões do Browser MCP perdem seu estado de sessão após aproximadamente 5 minutos de inatividade durante a execução. Quando o Claude Code retoma após uma desconexão ou uma pausa, ele está operando com um contexto de navegador desatualizado ou ausente — levando a falhas de integração de ferramentas e, em casos mais severos, o agente agindo com um estado de navegador que assume estar presente, mas não está.

Pré-requisitos

• Claude Code instalado e autenticado (claude --version ≥ 1.0)
• Node.js 18+ em cada máquina ou sandbox onde as sessões são executadas
• Uma conta Daytona (o nível gratuito é suficiente para testes)
• Repositório Git com CI (GitHub Actions, GitLab CI ou equivalente)
• Opcional: Grass CLI para monitoramento móvel (npm install -g @grass-ai/ide)

Passo 1: Adicione o claude-presence MCP para detecção de conflitos entre sessões

O servidor claude-presence MCP é uma ferramenta comunitária construída especificamente para esse problema. Ele dá a cada sessão do Claude Code em execução uma visão ao vivo do que outras sessões estão fazendo — quais arquivos elas reivindicaram, em quais branches estão e quais tarefas estão executando ativamente.

Clone, construa e vincule o pacote do GitHub (garniergeorges/claude-presence), e então adicione-o à sua configuração do MCP do Claude Code em ~/.claude/settings.json:

git clone https://github.com/garniergeorges/claude-presence
cd claude-presence && npm install && npm run build && npm link

O passo npm link torna o binário claude-presence-mcp disponível globalmente. (O pacote ainda não está no registro npm — clonar e vincular é o único caminho de instalação funcional por enquanto.)

{
  "mcpServers": {
    "claude-presence": {
      "command": "claude-presence-mcp",
      "args": ["--workspace", "/caminho/absoluto/para/seu/repo"],
      "env": {
        "PRESENCE_BROADCAST_INTERVAL": "5000"
      }
    }
  }
}

Cada sessão transmite seus arquivos de trabalho atuais e descrição da tarefa por meio de um canal local pub/sub. Cada outra sessão no mesmo espaço de trabalho se inscreve e pode ver conflitos antes que eles aconteçam.

Na prática, instrua o Claude Code a verificar a presença antes de iniciar edições de arquivos. Adicione isso ao CLAUDE.md do seu repositório:

## Coordenação de múltiplas sessões

Antes de editar qualquer arquivo, verifique a claude-presence para confirmar que nenhuma outra sessão ativa está trabalhando no mesmo diretório ou arquivo. Se um conflito for detectado, relate-o e pause — não sobrescreva o trabalho da sessão conflitante.

Você também pode inspecionar o estado da presença diretamente de um terminal:

# Liste todas as sessões ativas no espaço de trabalho
claude-presence-mcp status --workspace /caminho/absoluto/para/seu/repo

Saída esperada quando duas sessões estão em execução:

Sessões ativas (2):
  session-a7f3 │ branch: feat/payments  │ working: src/api/payments.ts
  session-b2c1 │ branch: feat/auth      │ working: src/middleware/auth.ts

Nenhum conflito detectado.

Essa visibilidade é a camada de coordenação mínima viável. É um protocolo cooperativo — depende das sessões respeitarem os dados de presença, o que elas farão quando instruídas via CLAUDE.md. Para a visão complementar pós-execução,

Empresas brasileiras que utilizam agentes de IA em desenvolvimento de software podem se beneficiar ao evitar conflitos e perdas de dados. A implementação de uma coordenação eficaz entre sessões melhora a eficiência e reduz retrabalho. Isso é crucial para equipes que buscam integrar múltiplos agentes em seus fluxos de trabalho.