Aula 17Projetos: deixe o Claude coordenar o trabalho

🖥️ Versão Desktop. Nesta versão do curso, você usa o Claude Code no app Claude Desktop, na aba Code. Quase tudo é feito por janelas e botões. Quando uma aula pedir para digitar um comando, ela mostra exatamente o que digitar. Nesta aula, você não digita nenhum comando: os Projetos ficam na aba Code do app, com botões, e as conversas deles rodam na nuvem. A parte opcional do fim mostra como rodar uma conversa do Projeto no seu computador.

Objetivos

Ao final desta aula você vai saber:

• O que é um Projeto do Claude Code, e por que ele não é o "Projeto" do chat do claude.ai
• Criar o Projeto "Confeitaria" e mandar para ele o cardápio da sua página
• Mandar três pedidos numa mensagem só e ver cada um virar uma conversa, trabalhando ao mesmo tempo, na nuvem
• Achar no painel Overview o que espera a sua resposta, e responder dentro da própria conversa
• Gastar menos do seu plano, com um modelo menor e o Pause
• Que os arquivos mandados são cópias e, depois da Aula 19, como pôr o repositório da página no Projeto

ℹ️ O que esta aula pede: um plano Pro ou Max com os Projetos liberados. Eles estão em beta e chegam aos poucos, primeiro para quem já usou as conversas na nuvem do claude.ai/code; ainda não existem nos planos Team e Enterprise. Não aparece Projects na barra lateral da aba Code do app, nem no claude.ai/code, no navegador? A sua conta ainda não recebeu: entre na lista de espera e leia a aula assim mesmo, para usar quando chegar. A sua página não precisa estar no GitHub: um Projeto funciona sem repositório, então dá para fazer esta aula antes da Aula 19. Mas, se o app pedir uma conta do GitHub ligada antes de qualquer conversa na nuvem, volte a esta aula depois da Aula 19, que cria essa conta.

Na Aula 16, o Claude trabalhou num horário marcado, um pedido de cada vez. Nesta aula, várias conversas trabalham ao mesmo tempo para você, na nuvem, e uma delas coordena as outras: são os Projetos do Claude Code.

O que é um Projeto

Um Projeto (os Projetos do Claude Code) é um lugar no claude.ai onde várias conversas trabalham ao mesmo tempo para você, na nuvem, e uma delas coordena as outras:

• A conversa principal do Projeto (a que coordena) é onde você escreve. Ela recebe o que você manda, decide o que fazer e acompanha cada frente de trabalho. Uma pergunta rápida, ela mesma responde.
• Cada conversa do Projeto (thread) é uma frente de trabalho. Ela faz a sua parte num computador separado, na nuvem, e avisa a principal quando termina.

Até aqui, cada conversa fazia uma coisa de cada vez, e quem decidia a próxima era você. Num Projeto, você manda vários pedidos de uma vez, sai, e volta para o trabalho pronto.

⚠️ Atenção ao nome. Os Projetos do Claude Code não são os "Projetos" do chat do claude.ai, que têm o mesmo nome e guardam conversas e arquivos de consulta, sem uma conversa que coordena as outras. Os dois continuam existindo, cada um no seu lugar. Nesta aula, "Projeto" é sempre o do Claude Code.

💡 Este curso foi escrito assim: dentro de um Projeto, com uma conversa principal que abriu outras para escrever o conteúdo.

Onde ficam

Os Projetos não ficam no seu computador. Eles moram no claude.ai, com a mesma conta do Claude que você usa no app, e aparecem em três lugares:

• no app, na aba Code, em Projects, na barra lateral;
• no navegador, em claude.ai/code, também em Projects;
• no app do Claude no celular, para acompanhar de qualquer lugar.

Esta aula usa a aba Code do app. A pasta da sua página fica onde está: as conversas do Projeto trabalham longe dela, na nuvem. E as conversas que você abre na pasta da sua página, como as das aulas anteriores, continuam no seu computador: elas não entram num Projeto.

Crie o Projeto "Confeitaria"

1. Na aba Code do app, clique em Projects, na barra lateral, e em New project (Projeto novo).
2. Em Name (nome), escreva Confeitaria.
3. Em Goal (objetivo), que é opcional, escreva uma linha: "Ajudar a divulgar e organizar a confeitaria". A conversa principal trabalha para esse objetivo.
4. Em Context (contexto), clique em Add (adicionar) e escolha, na pasta da sua página, o index.html, que tem o cardápio com os preços. Clique em Add de novo para o decisoes.md. Uma foto ou o PDF do cardápio também servem. O .env fica de fora: senha não vai para o Projeto.
5. Clique em Create project (criar o Projeto).

Abre a conversa principal do Projeto, com a caixa de mensagem embaixo e, ao lado, o painel Overview (visão geral).

ℹ️ No seu primeiro Projeto, o Claude pode começar sozinho logo depois de criar, se você ainda não tiver mandado mensagem. Ele pode mostrar Setup recommendations (sugestões de configuração), tiradas das suas conversas recentes na nuvem, e esse turno usa o seu plano. As sugestões não são obrigatórias: pode ignorar e seguir com os pedidos abaixo.

Três pedidos numa mensagem só

Na caixa de mensagem do Projeto, mande os três de uma vez:

Três tarefas, cada uma num arquivo. 1. Três posts para o Instagram desta semana, cada um sobre um doce do cardápio, com frases curtas, tom carinhoso, o preço e cinco hashtags. 2. Uma tabela de preços dos seis doces, para imprimir numa folha. 3. Ideias de promoção para o Dia das Mães. Na terceira, antes de começar, me pergunte quanto de desconto eu posso dar. Não use nenhum conector e não mande nada para ninguém: só escreva os arquivos.

Pedidos sem relação, numa mensagem só, viram conversas separadas. Embaixo da sua mensagem aparece um cartão para cada uma, com o título e o estado; clique num cartão para abrir a conversa. As três trabalham ao mesmo tempo, cada uma no seu computador na nuvem. Se, em vez de cartões, aparecer uma lista Suggested threads (conversas sugeridas), clique no botão embaixo dela para começar todas.

⚠️ Por que "não use nenhum conector": as conversas do Projeto recebem os conectores da sua conta do claude.ai, como o Google Agenda da Aula 14, e trabalham sem pedir licença a cada passo (veja abaixo, no modo auto). Estes pedidos não precisam de nenhum.

Em pouco tempo, a conversa da promoção para e pergunta quanto de desconto você pode dar. Ela vai para a lista Waiting on you (esperando você), no painel Overview, e o botão Overview ganha um ponto. Abra essa conversa, pelo cartão ou pela lista, e responda na caixa de mensagem dela, por exemplo: "até 15% de desconto, só no fim de semana do Dia das Mães". Se a pergunta aparecer na conversa principal, responda ali mesmo.

⚠️ Responda dentro da própria conversa. O que você escreve na caixa de mensagem de uma conversa do Projeto vai direto para ela. Escrever "pode seguir" na conversa principal não chega até ela. Vale também para um pedido de licença: ele fica dentro da conversa que pediu.

O resultado completo de cada conversa fica dentro dela: clique no cartão para ler. E os arquivos que elas entregam vão para a aba Library (biblioteca) do painel Overview, junto do index.html e do decisoes.md que você mandou.

Pronto quando: os três arquivos novos aparecem na aba Library, e a lista Waiting on you fica vazia depois da sua resposta.

💡 A skill post-instagram, da Aula 13, não vai para a nuvem. Ela mora na pasta do seu computador, e as conversas do Projeto não a carregam. Por isso o pedido diz como você quer os posts.

O que o painel Overview mostra

A aba Threads (as conversas) separa as conversas do Projeto pelo estado:

As outras abas são a Library, com os arquivos que você mandou e os que as conversas entregaram; a Pull requests, que só aparece depois que uma conversa abrir um pedido para juntar (veja abaixo, depois da Aula 19); e a Scheduled tasks (tarefas agendadas), com as tarefas agendadas do Projeto.

Pode fechar o app e até desligar o computador: na nuvem, as conversas continuam. Quando voltar, o Overview mostra o que terminou e o que espera você. O app avisa com uma notificação quando a conversa principal escreve para você ou quando uma conversa do Projeto dá erro ou precisa da sua resposta. Para receber um aviso também a cada vez que uma conversa termina uma resposta, ou para desligar os avisos de um Projeto, escolha Notifications (notificações) no menu do Projeto, na barra lateral. No navegador não chega notificação: o aviso é o ponto no botão Overview.

No modo auto, na nuvem

As conversas do Projeto trabalham no modo auto (Aula 04), num computador na nuvem, longe da sua pasta: a maior parte do que elas fazem não pede licença, e você não escolhe o modo delas. Por isso, o que precisa da sua palavra vai escrito no pedido, como "antes de começar, me pergunte" e "não mande nada para ninguém".

O uso do plano

Um Projeto gasta o limite do seu plano mais depressa que uma conversa comum, ainda mais no Pro: várias conversas trabalham ao mesmo tempo, e a principal também gasta para ler o que elas contam. E um Projeto novo começa com as conversas no modelo maior, o Opus, com esforço alto. Antes do primeiro pedido grande:

1. Abra Project settings (configurações do Projeto), na engrenagem do cabeçalho do Projeto.
2. Em General (geral), troque Thread model (o modelo das conversas do Projeto) por um menor, como o Sonnet, que dá conta de posts, tabelas e ideias (Aula 08).
3. Em Thread effort (o esforço das conversas), que começa no alto, escolha um mais baixo.

Para um pedido só, também dá para escrever na conversa principal: "faça esta tarefa com um modelo menor".

Um Projeto parado, sem nenhuma conversa rodando, não gasta nada. Se o limite do plano acabar no meio, a conversa mostra Service is busy e continua sozinha quando o limite renovar, já gastando a próxima janela de uso; para ela não continuar, clique em Stop dentro dela. E, para parar tudo de uma vez, use Pause (pausar), no fim de Project settings → General. O Resume (retomar) fica no mesmo lugar.

Os arquivos são cópias

O que você mandou para o Projeto é uma cópia. Mudou o preço do brigadeiro no index.html do seu computador? As conversas do Projeto continuam vendo o preço antigo até você mandar o arquivo de novo: na aba Library, clique em Add, escolha o arquivo e, quando o Projeto perguntar pelo nome repetido, escolha Replace (substituir).

Tarefas agendadas no Projeto

Um pedido que se repete também pode morar no Projeto, por exemplo: "toda sexta de manhã, escreva três posts para a semana seguinte". A conversa principal cria uma tarefa agendada na nuvem (Aula 16), que roda como conversas do Projeto e aparece na aba Scheduled tasks. Cada execução usa o seu plano, e o Pause do Projeto também para as tarefas dele.

Depois da Aula 19: o repositório da página

Com a página no GitHub, as conversas do Projeto podem mexer nela:

1. Peça na conversa principal: "adicione o repositório confeitaria a este Projeto". Ou abra Project settings → Environment (ambiente) e escolha o repositório.
2. O Projeto precisa do app do Claude instalado no seu repositório, no GitHub (o Claude GitHub App). Se faltar, a página do Projeto diz o passo que falta e leva até ele; depois, clique em Check again (conferir de novo).
3. Cada conversa trabalha numa linha paralela e entrega a mudança num pedido para juntar, que aparece na aba Pull requests. Review PR abre o pedido no GitHub, para você ler o que mudou. Merge it pede à conversa que junte a mudança à linha principal, e aí a página no ar muda.

As conversas leem o CLAUDE.md do repositório, com as regras da casa (Aula 11). As skills dele, como a post-instagram, não carregam.

Para ir além (opcional): Projetos para quem programa

🔧 Para ir além (para quem já programa; pode pular): esta parte mostra quando um Projeto vale a pena num trabalho de programação, como ele se organiza por dentro, o que as conversas na nuvem carregam de cada repositório, o GitHub, o primeiro lote e as frases para ajustar a coordenação, os pull requests, as instruções e a memória do Projeto, a escolha de repositórios, o uso em detalhe, como rodar uma conversa do Projeto no seu computador e os limites do beta. Aqui, as conversas do Projeto aparecem pelo nome da tela: threads. Se você nunca programou, pule direto para o Na prática: tudo o que ele pede já foi explicado acima.

Quando um Projeto vale a pena

Um Projeto vale a pena quando o trabalho tem um objetivo que dura mais do que uma sessão e continua gerando tarefas.

Como um Projeto se organiza

              Você
               │
               ▼
   ┌────────────────────────────┐
   │  Conversa principal        │  ← o Claude, coordenando
   │  (responde ou abre thread) │
   └─────┬────────┬────────┬────┘
         ▼        ▼        ▼
     Thread 1  Thread 2  Thread 3   ← cada uma com seu contexto,
     (branch)  (branch)  (branch)     sua branch e seu PR
         │        │        │
         └────────┴────────┴──▶ Painel Overview
                                (Ready for review · Waiting on you · Working)

• A conversa principal é uma sessão longa em que o Claude coordena. Ela vê o que as threads reportam, não cada passo delas, e trabalha a partir das mensagens recentes, das threads recentes e da memória do Projeto: você não gerencia contexto num Projeto (Aula 07).
• Cada thread é uma sessão separada, com a própria janela de contexto, como os subagentes da Aula 12, que compacta sozinha. Na nuvem, ela trabalha na própria branch e abre um PR quando o trabalho pede.
• Toda thread na nuvem começa com: os repositórios e os arquivos do Projeto, mais as instruções e a memória dele; o CLAUDE.md de cada repositório do Projeto; os conectores da sua conta do claude.ai (a conversa principal não tem conectores: o que precisa de um vira tarefa para uma thread); e um ambiente na nuvem, que define a rede, as variáveis, os segredos de rede e as ferramentas instaladas.

O que as threads carregam do repositório

Nada do Claude Code instalado na sua máquina vai para uma thread na nuvem. De cada repositório do Projeto, ela carrega só as instruções:

O GitHub

Para um Projeto que mexe em código: o código no github.com (não no GitHub Enterprise Server, no GitLab nem no Bitbucket), a sua conta do GitHub conectada com permissão de push e o Claude GitHub App instalado no repositório. O token do /web-setup serve para as suas outras sessões na nuvem, mas não para as threads de um Projeto, que precisam do app. Num repositório de organização, só um dono da organização conclui a instalação, e uma organização com SAML SSO pede que você autorize o app para ela. Se um repositório não aparecer na lista, confira em github.com/settings/installations, em Repository access, e clique em Check again.

Começar de uma sessão na nuvem

No menu de uma sessão na nuvem (no app, uma sessão aberta no ambiente Cloud), na barra lateral:

• Continue as project cria um Projeto novo com o nome da sessão, e o Claude propõe a configuração a partir do que ela fazia. A sessão original continua na lista e, se estava no meio de um turno, continua rodando. O banner Set up project, que pode aparecer acima da caixa de mensagem, faz o mesmo, mas para o turno em andamento.
• Move to project leva o trabalho da sessão para um Projeto que já existe.

Uma sessão Local não entra num Projeto: descreva o trabalho na conversa principal, ou faça push da branch, adicione o repositório ao Projeto e cite a branch na tarefa.

O primeiro lote e as frases que ajustam a coordenação

Antes de um lote grande:

1. Escreva as instruções do Projeto (veja abaixo).
2. Mande uma parte pequena do trabalho real e abra a thread quando ela terminar: veja como ela reporta e o que fez na branch.
3. Confira Thread model e Thread effort em Project settings → General.
4. Peça ao Claude para propor as threads antes de começar e rodar poucas por vez. Solte esses limites quando as primeiras voltarem como você quer.

Para ajustar o jeito de coordenar, diga na conversa principal:

Proponha as threads e espere meu ok antes de começar.

Rode no máximo duas threads por vez.

Só poste quando algo terminar ou empacar.

Me diga o que está errado nesses repositórios, mas ainda não corrija nada.

Responda aqui mesmo em vez de abrir uma thread.

O Claude guarda preferências assim na memória do Projeto e segue nas próximas threads. São instruções que ele segue, não configurações garantidas: um limite de threads pedido assim não é um teto. Para uma regra exata desde o começo, use as instruções do Projeto.

Os pull requests das threads

Quando uma thread na nuvem mexe em código, por padrão ela trabalha numa branch nova, criada a partir da branch padrão; abre um PR quando você pede, ou sozinha, para uma correção concreta; e, depois de abrir, acompanha o PR com o auto-fix ligado: corrige quando o CI falha, responde a comentários de revisão e avisa quando está pronto.

O cartão da thread pode mostrar o próximo passo: Resolve conflicts, Fix CI, Address comments e Merge it mandam essa instrução para a thread, como uma mensagem sua; Review PR abre o PR no GitHub; Create PR aparece quando uma thread parada enviou uma branch sem abrir PR, e cria o PR direto. No Overview, entram mais duas listas: Ready for review (o PR aberto, esperando revisão) e Landing (o PR aprovado ou na fila para o merge).

Instruções e memória do Projeto

A memória do Projeto é separada da memória automática do seu computador e do CLAUDE.md: regras de um repositório, como os comandos de build, vão no CLAUDE.md dele; as do Projeto, nas instruções ou na memória. Mudanças nas instruções, nos repositórios, nos plugins e no ambiente chegam às threads novas, não às que já estão rodando.

Um bom brief diz para que serve o Projeto, onde o trabalho acontece, como a thread confere o próprio trabalho, o que fazer quando falta algo e o que precisa do seu ok:

Este projeto mantém o p95 de latência da API de pagamentos abaixo de
200 ms: profiling, correções de queries e cache, e as atualizações de
dependências que vierem junto, no repositório payments-api.

- Crie a branch a partir da main e abra um PR em rascunho por thread.
- Antes de dar o trabalho como pronto, rode `make test` e `make lint` e
  cole as linhas de resumo na sua mensagem final.
- Se não conseguir acessar algo de que precisa (repositório, segredo,
  API ou conector), diga exatamente o que falta na primeira mensagem e
  pare. Não substitua, não simule, não chute.
- Não faça merge, force-push nem mude a configuração de CI sem me
  perguntar na thread.

Que repositórios pôr no Projeto

Ponha os um ou dois repositórios que quase toda tarefa usa, e cite os outros nas instruções. Uma thread pode acrescentar um repositório só para ela, quando a tarefa pede, mas o CLAUDE.md dele não estava lá quando ela começou, e a próxima thread começa sem ele. Depois que o Projeto tem repositórios, o Claude só acrescenta outros do mesmo dono no GitHub; de outro dono, acrescente você, em Project settings → Environment.

O uso em detalhe

• O que gasta: as threads rodando, cada uma uma sessão inteira; a conversa principal, que lê o que elas reportam; e as threads que acompanham um PR, que acordam quando o CI falha ou chega um comentário. Para uma parar de acompanhar, peça dentro dela. O teto é de 200 threads novas por dia.
• No limite do plano, a thread espera e continua sozinha quando ele renova. A exceção é a thread que uma tarefa agendada começou: ela para com um erro de limite, e você manda uma mensagem depois.
• Uma thread parada há mais de uma hora relê a conversa inteira antes de continuar. Para trabalho novo, uma thread nova pode gastar menos.
• Project settings → Usage mostra o gasto por thread e por modelo. Coordinator model e Coordinator effort, em General, valem para a conversa principal, que começa no Opus com esforço baixo.

Rodar uma thread no seu computador

Quando uma tarefa precisa de algo que só a sua máquina tem, como um banco local, um emulador ou uma API atrás da VPN, peça que aquela thread rode no seu computador, pelo Remote Control. As outras continuam na nuvem.

1. Conecte a pasta, com o Claude Code 2.1.280 ou mais novo nesse computador (numa sessão Local, o /status mostra a versão na linha Claude Code). Em Settings → Claude Code, ligue Use this computer from your phone and claude.ai e acrescente a pasta na lista embaixo da chave. Pelo terminal, o caminho é rodar claude remote-control dentro da pasta e deixar rodando.
2. Peça a tarefa escolhendo Work locally no menu + ao lado da caixa de mensagem, ou dizendo na mensagem que ela deve rodar no seu computador.
3. Autorize no cartão "Allow Claude to work in a folder on your device": escolha a pasta, ligue Worktree se duas threads forem usar o mesmo repositório e clique em Allow once.

A thread local roda no modo auto e usa os arquivos, as ferramentas, os servidores MCP e as configurações do Claude Code da sua máquina, inclusive hooks e regras de permissão. Começa com as instruções do Projeto, mas sem a memória. Só roda enquanto o app estiver aberto e o computador acordado: pausa se ele dormir e para se o app fechar. Para o computador não dormir sozinho, ligue Keep this computer awake for Remote Control, também em Settings → Claude Code. Se o cartão disser Claude is out of date on your device (o Claude está desatualizado no seu computador), atualize o app: Claude → Check for Updates no macOS, Help → Check for Updates no Windows. E não funciona com Require trusted devices ligado na sua conta.

Os limites do beta

• Os Projetos existem no claude.ai/code, no app Claude Desktop e no app do celular, não no terminal, no VS Code nem no JetBrains, nem pela Amazon Bedrock, pela Agent Platform do Google Cloud ou pela Microsoft Foundry.
• Faça commit do trabalho em andamento. A máquina de uma thread na nuvem pausa entre um turno e outro e, se não puder ser retomada, a thread recomeça de um clone novo: o que não foi commitado pode se perder.
• Um Projeto é de uma pessoa só: não dá para compartilhar o Projeto nem as threads. Uma thread pertence ao Projeto que a criou, e dois Projetos não se juntam.

Na prática

Use a pasta da sua página (a confeitaria, ou a da sua ideia) só para pegar os arquivos: o resto acontece na aba Code do app.

1. No app, abra a aba Code e clique em Projects, na barra lateral. Não apareceu? Entre na lista de espera e leia a aula até o fim.
2. Clique em New project: o nome Confeitaria, o objetivo de uma linha e, em Context, o index.html e o decisoes.md da pasta da sua página. Clique em Create project.
3. Abra Project settings, na engrenagem, e, em General, troque o Thread model para o Sonnet e o Thread effort para um mais baixo. No Pro, não pule este passo.
4. Mande os três pedidos da aula numa mensagem só e veja aparecer um cartão para cada um.
5. Quando a conversa da promoção aparecer em Waiting on you, abra e responda lá dentro: "até 15% de desconto, só no fim de semana do Dia das Mães".
6. Abra a aba Library: os três arquivos novos estão lá. Abra cada um e leia.
7. Mande o decisoes.md de novo, em Library → Add, e escolha Replace: é assim que uma mudança do seu computador chega ao Projeto.
8. Depois da Aula 19: peça na conversa principal "adicione o repositório confeitaria a este Projeto".

Resumo

• Um Projeto do Claude Code é um lugar no claude.ai onde várias conversas trabalham ao mesmo tempo para você, na nuvem, e a conversa principal coordena. Não é o "Projeto" do chat do claude.ai.
• Fica em Projects, na aba Code do app, e também no claude.ai/code e no celular. Está em beta no Pro e no Max, liberado aos poucos.
• Não precisa da página no GitHub: mande o cardápio em Context (ou em Library, com Add).
• Pedidos sem relação numa mensagem viram conversas separadas, que trabalham no modo auto: diga no pedido o que precisa da sua palavra. Pronto quando: os três arquivos aparecem na Library.
• O que espera você fica em Waiting on you: abra a própria conversa e responda lá dentro.
• Um Projeto gasta o plano mais depressa: troque Thread model e Thread effort em Project settings → General. O Pause para tudo.
• Os arquivos mandados são cópias: mudou, mande de novo e escolha Replace. Depois da Aula 19, o repositório da página entra no Projeto, e as mudanças chegam por pedidos para juntar.

Quer ir mais fundo? Veja a página dos Projetos na documentação oficial (em inglês).

Na próxima aula, um recurso novo, com um cuidado novo: os mods, que mudam o Claude Code por dentro e rodam com as suas permissões.