Claude no VS Code · ponha 3 IAs trabalhando em paralelo e avance o triplo

Para quem é isso?

Para quem já constrói com um agente de código (como o Claude Code) e quer avançar mais rápido trabalhando como um profissional — sem programar a mais. É a continuação natural do [guia do GitHub](/recursos/guarda-todo-en-github-antes-de-que-la-ia-lo-rompa): lá você aprendeu a salvar e voltar atrás; aqui, a trabalhar em várias frentes ao mesmo tempo.

Quando surge a necessidade? (o momento exato)

O momento chega quando seu projeto cresce e uma única IA, fazendo uma coisa de cada vez, fica pequena demais. Você quer avançar mais rápido: que enquanto uma sessão constrói uma feature, outra conserte um bug e uma terceira teste uma ideia nova — tudo ao mesmo tempo. Também quando você fica em dúvida entre dois caminhos ("faço assim ou assado?") e quer ver os dois antes de decidir. Ou quando quer testar algo arriscado sem mexer no que já funciona. Em todos esses casos, ir de uma coisa por vez sobre a sua única versão é lento e frágil.

A dor que dá origem a isso · lento e com medo

Duas dores juntas. A de velocidade: com uma única sessão você avança em fila indiana — termina uma coisa para poder começar a outra, e o projeto grande fica lentíssimo. E a do medo: como tudo acontece sobre a sua única versão boa, você teme que a IA quebre algo ao "melhorar" outra coisa, então pede mudanças tímidas. Trabalhar em paralelo, em versões isoladas, mata as duas: você avança em várias frentes ao mesmo tempo E sem risco.

O que é um "worktree"? (em bom português)

No guia do GitHub você viu as branches: cópias paralelas do seu projeto. Um worktree leva isso um passo além: permite que você tenha várias dessas branches abertas e vivas ao mesmo tempo, cada uma na sua própria pasta, sem que uma toque na outra. Enquanto uma IA trabalha na "ideia A", outra pode estar na "ideia B", e sua versão principal segue intacta. Não é de uma em uma — é todas ao mesmo tempo.

Imagine assim · as fotocópias vivas

Seu projeto principal é o documento original. Um worktree é uma fotocópia que ganha vida própria: você pode rabiscar nela à vontade enquanto o original segue limpo em outra mesa. E você pode ter cinco fotocópias ao mesmo tempo, cada uma com uma ideia diferente. No fim, a que ficou boa você passa pro original; as outras, pro lixo. O original NUNCA correu perigo.

O superpoder · uma branch por ideia, com Claude no VS Code

O Claude Code tem uma extensão oficial para VS Code (também funciona no Cursor e compatíveis). A partir dela você abre várias sessões de IA em paralelo, cada uma no seu próprio worktree, e vê as mudanças que ela propõe com um diff visual (lado a lado) que você aprova ou rejeita. O melhor: criar um worktree isolado é um único comando.

Criar um worktree para uma ideia (um comando)bash

claude --worktree mi-idea-arriesgada

Isso cria uma cópia isolada do seu projeto (em .claude/worktrees/mi-idea-arriesgada/) sobre uma branch nova, sem mexer na sua versão principal. Você trabalha a ideia ali; se funcionar, você a une; se não, apaga e não aconteceu nada. Você pode abrir outra sessão com claude --worktree otra-idea e ter as duas competindo ao mesmo tempo.

Não decore comandos · peça pra sua IA

Como em toda a série: se você não quer mexer no terminal, é só falar com o seu agente. "Abra um worktree para testar [sua ideia] sem mexer na minha versão principal" — e ele faz. Você só decide qual ideia testar e com qual fica.

3 cenários onde isso te salva

1 · A mudança arriscada

Você quer redesenhar algo grande, mas tem medo de quebrar o que funciona. Faz isso num worktree: se der certo, você une; se der errado, joga fora. Sua versão boa nem ficou sabendo.

2 · Os dois caminhos (assim ou assado?)

Você não sabe se uma feature se faz de um jeito ou de outro. Abre DOIS worktrees, deixa a IA testar cada abordagem em paralelo, compara com resultados reais e fica com o vencedor. Você decide com evidência, não com achismo.

3 · A sessão travada

Uma conversa com a IA se enrolou ou saiu do caminho. Em vez de perdê-la, você abre outra sessão em paralelo (o próprio worktree dela) e segue fresco, sem jogar fora o trabalho da primeira.

É assim que a gente trabalha · várias sessões ao mesmo tempo (o grande acelerador)

Esse é o maior benefício, e é exatamente como a gente constrói: em vez de uma única IA avançando em fila indiana, temos várias sessões trabalhando em paralelo, cada uma no seu próprio worktree. A sessão 1 constrói uma parte do produto, a sessão 2 monta outra coisa diferente, uma sessão 3 poderia estar testando uma ideia nova — as três avançando AO MESMO TEMPO, sem se atrapalhar. É como ter três funcionários em vez de um, cada um na sua mesa, sem se estorvar.

O fluxo completo (paralelo + C-A-R + merge)

A chave para isso não virar um caos: cada sessão fecha bem o seu trabalho antes de uni-lo. O ciclo: (1) cada sessão trabalha na SUA branch/worktree · (2) quando termina algo, você aplica o [protocolo C-A-R](/recursos/protocolo-car-construir-sin-bugs) — audita, depura, deixa impecável · (3) só então você faz o merge dessa branch para a principal · (4) repete com a próxima. Assim você avança o triplo, mas cada peça entra limpa na sua versão boa.

A regra que evita o desastre · push para a SUA branch, não para a principal

O erro clássico ao trabalhar em paralelo: dar push para a branch principal a partir de uma sessão pela metade e passar por cima do trabalho de outra. A regra de ouro: cada sessão salva e dá push para a SUA PRÓPRIA branch, nunca direto na principal. A principal só recebe coisas via merge, e só depois de auditar. Se ficar em dúvida, peça pra sua IA: "dê push na branch desta sessão, não na main".

Imagine assim · vários cozinheiros, uma cozinha organizada

Três cozinheiros na mesma cozinha se esbarrando é um caos. Mas se cada um tem sua mesa (o worktree dele) e só leva o prato à mesa principal quando está pronto e testado (o merge depois do C-A-R), a cozinha voa: saem três pratos no tempo de um, e nenhum sai pela metade. Isso é trabalhar em paralelo bem feito.

O review visual · você aprova ou rejeita, você manda

Dentro do VS Code, quando a IA quer mudar um arquivo, ela te mostra uma comparação lado a lado: o que havia vs. o que ela propõe. Você decide: aceitar, rejeitar ou dizer o que mudar. Nada é modificado pelas suas costas. É como ter o funcionário te mostrando cada mudança antes de aplicar, em vez de mexer em tudo e você descobrir depois.

Expectativa honesta

O review é arquivo por arquivo (diff lado a lado, aceitar/rejeitar), não um "aprovar tudo de uma vez" perfeito ainda. E unir branches (merge) às vezes tem conflitos que se resolvem com o fluxo normal do git — embora a IA te ajude em linguagem natural. Sem enrolação: é poderoso, mas é uma ferramenta de trabalho, não mágica de um clique.

A rotina de ouro · avançar em paralelo sem caos

O hábito

Uma sessão = uma branch/worktree: cada frente de trabalho na sua cópia isolada. Nunca várias sobre a versão principal.
Push para a SUA branch, nunca para a principal: cada sessão salva no que é seu; a principal só recebe via merge.
Audite com C-A-R antes de unir: nenhuma branch entra na principal sem passar pela auditoria/debug primeiro.
Revise o diff no VS Code antes de aceitar — você manda, não a IA.
Faça merge só do que ficou impecável: a peça terminada e auditada se une; as ideias que não vingaram são apagadas sem culpa.

Prompt pronto · monte seu fluxo de trabalho em paralelo

Copie e cole no seu agente de código para que ele te guie a trabalhar em várias frentes ao mesmo tempo, sem que você precise aprender comandos:

Cole no seu agente · trabalhar em várias sessões em paralelotexto

Quero avançar mais rápido no meu projeto trabalhando em VÁRIAS sessões em paralelo, cada uma na sua própria versão isolada (worktree), sem que se atrapalhem nem quebrem minha versão principal. Me guie em linguagem simples, assumindo que eu não sei nada de git.

1. Me explique em uma frase o que é um worktree (uma cópia viva e isolada do meu projeto).
2. Vou trabalhar nestas frentes ao mesmo tempo: [liste suas tarefas, ex: "1) redesenhar a página inicial, 2) consertar o login, 3) testar uma ideia nova"]. Crie um worktree dedicado para cada uma, ramificando a partir da minha versão estável.
3. Me diga como abrir o VS Code em cada worktree para ver o diff e aprovar/rejeitar as mudanças visualmente.
4. REGRA IMPORTANTE: cada sessão deve dar push para a SUA PRÓPRIA branch, NUNCA para a principal (main). A principal só recebe coisas via merge.
5. Quando eu terminar uma tarefa no seu worktree, antes de uni-la: aplique o protocolo C-A-R (audite, depure, deixe impecável). Só então faça o merge dessa branch para a principal, e resolva qualquer conflito em linguagem natural.
6. Se uma ideia não vingou, me ajude a descartar o worktree dela sem que meu projeto principal fique sabendo.

Regra de ouro: eu avanço em paralelo, mas na branch principal só entra o que foi auditado, via merge — nunca pela metade.

No NeuralOS, o isolamento já vem pronto

No NeuralOS, cada sessão de trabalho com um agente já nasce isolada — você testa coisas sem que se atrapalhem entre si, sem precisar pensar em worktrees nem branches. A ideia de "experimente em paralelo sem medo" faz parte de como o produto foi pensado. Se você quer esse superpoder sem a curva de aprendizado, esse é o atalho.

Salve tudo no GitHub · a base de tudo issoOs worktrees se apoiam nas branches do git. Se você pulou o guia do GitHub, comece por ali.O protocolo C-A-R · audite cada branch antes de fazer mergeAntes de unir uma ideia à sua versão principal, audite-a com C-A-R. Combina perfeitamente com o trabalho em paralelo.

#claude-code#vscode#worktrees#produtividade