Como rodar vários agentes de IA no mesmo repositório (sem conflitos de Git)
Rodar vários agentes em um projeto exige três coisas: uma máquina que os hospede, um diretório que compartilhem, e uma regra que decida quem escreve onde. Sem a terceira, o segundo agente apaga o trabalho do primeiro sem que nada avise.
Passo a passo
- Crie o projeto. Um canvas inicia sua própria máquina e um repositório privado. É ali que o diretório compartilhado vive, e ele é o mesmo para todos os agentes que você abrir depois.
- Conecte suas contas. Conecte a assinatura ou a chave de API que você já paga na Anthropic, na OpenAI ou em outro provedor. Nenhum token é revendido, o consumo fica na sua conta.
- Abra uma janela por agente. Claude Code, Codex, Kimi e OpenCode abrem cada um em sua própria janela, com um terminal de verdade. Duas janelas no plano Solo, cinco no Pro.
- Divida por arquivo, não por tarefa. Dê a cada agente um canto do projeto em vez de uma tarefa que atravessa tudo. Dois agentes em duas áreas avançam em paralelo, dois agentes no mesmo arquivo esperam um pelo outro.
- Deixe o painel arbitrar. Um agente reserva os caminhos que vai tocar antes de escrever, e o servidor os nega aos outros até que ele os libere. Você vê quem detém o quê, e quem está esperando.
O que é preciso ter em mãos
Um repositório, mesmo vazio, e uma conta em um provedor de modelo. O resto é fornecido pelo projeto: a máquina, o diretório e o painel que distribui os arquivos.
Um arquivo de instruções na raiz do repositório muda o resultado mais do que qualquer configuração. Os agentes o leem ao iniciar, e ele evita os cinco primeiros erros de cada um.
A divisão que funciona
A unidade certa não é a funcionalidade, é o arquivo. Um agente na API, um na interface, um nos testes: eles se cruzam pouco e quase nunca esperam. Três agentes na "página de pagamento" vão disputar os mesmos três arquivos a hora toda.
O que você observa enquanto isso
Os terminais rolam em suas janelas, e o painel mostra quem detém qual caminho. Um agente bloqueado fica visível antes de causar estrago, que é a real diferença em relação a uma fila de espera invisível. O mecanismo em detalhe.
Respostas diretas
Quantos agentes ao mesmo tempo são úteis?
Tantos quantas frentes independentes o projeto tiver naquele momento, o que dá dois ou três na maioria das vezes e cinco em uma refatoração grande. Além disso, os agentes passam o tempo esperando arquivos em vez de escrever.
É preciso um git worktree por agente?
É o método que a maioria dos guias recomenda, e funciona: cada agente recebe sua cópia de trabalho com seu próprio índice, então não há colisão. O custo é uma fusão por cópia, e um conflito que só se descobre no final. Em um diretório compartilhado com reserva, não há nada para fundir porque nunca existiram duas versões vivas ao mesmo tempo.
É preciso uma branch por agente?
Não, e esse é o ponto. Uma branch por agente empurra o conflito para a fusão, no momento em que ninguém mais se lembra do raciocínio. Um diretório compartilhado com reserva resolve o conflito no segundo em que ele acontece.
O que acontece se dois agentes quiserem o mesmo arquivo?
O segundo espera. Ele vê isso na tela, você também, e pode dar a ele outra coisa para fazer imediatamente em vez de descobrir o problema uma hora depois.