Pular para o conteúdo principal
Projects estão em beta público nos planos Pro, Max e Ultra e estão sendo implementados gradualmente. A implementação começou com contas que usaram sessões na nuvem e não têm projetos existentes no chat claude.ai ou Cowork. Projects ainda não são oferecidos nos planos Team ou Enterprise.Se Projects não aparecer na barra lateral em claude.ai/code ou na aba Code do aplicativo desktop, verifique em More nesse mesmo local. Se também não estiver lá, a implementação ainda não chegou à sua conta. Você pode entrar na lista de espera e consultar Executar agentes em paralelo para ver o que você pode usar enquanto isso.
Um projeto é uma conversa contínua onde Claude coordena um fluxo de trabalho relacionado para você. Você diz o que precisa ser feito e ele inicia uma thread para cada tarefa. Cada thread é geralmente uma sessão em nuvem: Claude Code executando na nuvem em vez de na sua máquina. Quando uma tarefa precisa de algo que apenas seu computador tem, você pode pedir a Claude para executar essa thread no seu computador em vez disso através do Remote Control. As threads são executadas em paralelo e você pode verificá-las e direcioná-las do seu telefone. As threads em nuvem continuam funcionando depois que você fecha o laptop, enquanto uma thread no seu computador é executada apenas enquanto esse computador está acordado. Sem um projeto, executar várias sessões significa fazer a coordenação você mesmo: você decide no que cada uma trabalha, repete o mesmo contexto no início de cada uma e verifica qual terminou ou precisa de uma resposta. Com um projeto, você:
  • Envia trabalho para um único lugar: cole um relatório de bug, um rastreamento de pilha ou uma lista de tarefas na conversa sempre que surgir. Claude inicia uma thread para cada peça de trabalho ou a passa para a thread já trabalhando nessa área, e responde perguntas rápidas no local.
  • Define o contexto uma vez: cada nova thread começa com as instruções do projeto, então uma regra que você declara uma vez, como qual branch direcionar, alcança todas elas.
  • Saia e volte para o trabalho concluído: quando você voltar uma hora depois ou na manhã seguinte, o painel Overview mostra quais threads terminaram, quais pull requests estão prontos para revisão e qual thread está aguardando sua resposta.
Se você já sabe o trabalho que deseja que um projeto execute, vá direto para Criar um projeto.

Quando usar um projeto

Um projeto vale a pena criar quando o trabalho tem um objetivo que dura mais de uma sessão e continua produzindo tarefas. Esses tipos de trabalho funcionam bem em um projeto:
  • Um objetivo em muitos repositórios: “Trazer cada serviço para a nova configuração de lint.” Claude pode executar uma thread por repositório, cada uma com seu próprio pull request, e o painel Overview mostra quais estão prontos para revisão.
  • Uma área que você continua alimentando: os bugs, rastreamentos de pilha e solicitações de revisão para um serviço, colados na conversa conforme chegam até você. Uma armadilha que você diz a Claude para lembrar após uma correção está na memória do projeto para a próxima.
  • Uma compilação ou migração maior que uma sessão: “Construir o que docs/spec.md descreve” ou “Mover o aplicativo do ORM descontinuado.” O trabalho se divide em threads que cada uma pega uma parte, decisões que você pede a Claude para lembrar no início chegam às threads posteriores, e a especificação muda e bugs que você encontra durante a compilação vão para a mesma conversa.
  • Trabalho que não é código: uma pasta de contratos ou uma exportação de ticket de suporte que você continua voltando com novas perguntas, como “encontre os dez erros de integração mais comuns nesses tickets.” Carregue os documentos em vez de adicionar um repositório, e as threads entregam cada relatório como um arquivo na aba Library do projeto.
Em qualquer um deles você pode enviar um lote de tarefas, dizer a Claude para começar sem pedir que você confirme, e sair. Quando voltar, você pode encontrar as threads que precisam de você em Waiting on you. Você também pode pedir a Claude para colocar parte do trabalho em um cronograma como uma tarefa agendada na nuvem. Se uma dessas é sua situação, crie um projeto.

Quando algo mais se encaixa melhor

Um projeto ainda se encaixa quando apenas algumas tarefas precisam de sua máquina. As threads em nuvem funcionam em repositórios GitHub e nos arquivos, pastas e pastas do Google Drive que você carrega no projeto, e para a tarefa ocasional que precisa de um banco de dados local ou de uma ferramenta em seu computador, você pode pedir a Claude para executar a thread dessa tarefa em seu computador. Algo diferente de um projeto se encaixa melhor nestes casos:
  • Uma tarefa que cabe em uma sessão: “Corrigir o teste de login instável.” Inicie uma sessão em nuvem você mesmo.
  • Trabalho onde cada tarefa precisa de sua máquina: um banco de dados local, um emulador de dispositivo, ou uma API atrás de sua VPN. Use uma sessão local, ou agent view para executar várias de uma vez. Se o trabalho só precisa de arquivos locais, carregue-os no projeto.
  • Uma tarefa que se repete em um cronograma sem conversa ao redor: “Postar um relatório de dependência toda segunda-feira.” Crie uma tarefa agendada na nuvem por conta própria.
  • Várias pessoas dando trabalho a Claude e direcionando-o juntas em um canal Slack: veja Claude Tag.
Um projeto usa os mesmos limites de plano que suas outras sessões Claude Code e os usa mais rapidamente. Uso e custo cobre o que usa seu plano e como mantê-lo baixo.

Como um projeto é organizado

Um projeto é uma conversa coordenadora com Claude mais as threads que ele inicia para fazer o trabalho. Estas são suas partes:
  • A conversa do projeto: uma sessão de longa duração onde Claude atua como coordenador. Ele pega o que você envia, decide o que se torna uma thread e acompanha cada thread que iniciou. Ele vê o que as threads relatam, não cada passo que elas dão.
  • Threads: os trabalhadores. Cada uma é uma sessão separada com sua própria janela de contexto que faz uma peça de trabalho e relata de volta à conversa quando termina. Uma thread em nuvem trabalha em seu próprio branch e abre um pull request quando o trabalho exigir um.
  • O que cada thread em nuvem começa com:
  • O painel Overview: onde você vê todas as threads de uma vez e quais delas precisam de você. Suas outras abas são Library para os arquivos que você adicionou e os arquivos que as threads produziram, Pull requests para os que as threads abriram, e Scheduled tasks para trabalho agendado no projeto.
As threads em nuvem não pegam nada da configuração Claude Code na sua própria máquina. Obter skills, plugins, connectors e ferramentas em threads cobre como dar a elas o que de outra forma estariam faltando. Aqui está como essas partes se conectam, de você através da conversa para as threads fazendo o trabalho, com Overview rastreando seu estado:
Diagrama de um projeto. Você escreve na conversa do projeto, onde Claude responde ou inicia uma thread. Cada thread em nuvem trabalha em seu próprio branch e pull request. O painel Overview lista threads por estado, como pronto para revisão, aguardando você e trabalhando.Diagrama de um projeto. Você escreve na conversa do projeto, onde Claude responde ou inicia uma thread. Cada thread em nuvem trabalha em seu próprio branch e pull request. O painel Overview lista threads por estado, como pronto para revisão, aguardando você e trabalhando.

Criar um projeto

Você cria e usa projects em claude.ai/code, na aba Code do aplicativo desktop, ou no aplicativo móvel Claude para iOS e Android. No navegador e no aplicativo desktop existem duas maneiras de iniciar um projeto:
  • Do zero, quando você sabe o fluxo de trabalho que deseja que Claude execute: abra o diálogo New project e nomeie-o. Iniciar um novo projeto do zero percorre o diálogo.
  • De uma sessão na nuvem que já está fazendo o trabalho: no menu dessa sessão na barra lateral, escolha Continue in project e depois Continue as new project. Claude propõe a configuração do projeto a partir do que a sessão estava fazendo. Veja Iniciar a partir de uma sessão na nuvem existente.
De qualquer forma, verifique os pré-requisitos primeiro.

Verificar os pré-requisitos

Antes de criar um projeto, verifique seu plano, sua configuração do GitHub e o que o trabalho precisa alcançar:
  • Plano: você está no Pro, Max ou Ultra e Projects aparece na sua barra lateral, diretamente ou em More. Selecione Projects e verifique se oferece New project ou Get started.
  • GitHub, se o projeto funcionará em código: seu código está em github.com em vez de GitHub Enterprise Server, GitLab ou Bitbucket, sua conta GitHub conectada tem acesso push a ele, e o Claude GitHub App está instalado nele. Se você conectou GitHub com /web-setup, esse token permite que suas outras sessões em nuvem alcancem um repositório, mas não é suficiente para threads de projeto, que precisam do Claude GitHub App. Configurar acesso ao GitHub tem os passos.
  • Acesso à rede, segredos e ferramentas: para threads na nuvem, estes vêm do ambiente na nuvem do projeto. O ambiente padrão já alcança registros de pacotes comuns, então verifique isso apenas se o trabalho precisar de outros domínios, um segredo ou uma ferramenta que não está pré-instalada. Se o trabalho precisa de um servidor MCP, verifique se ele aparece como conectado em seus conectores do claude.ai.

Iniciar um novo projeto do zero

Iniciar um projeto do zero significa abrir o diálogo New project, nomear o fluxo de trabalho e opcionalmente dar a ele um objetivo e os repositórios e arquivos em que funciona. Apenas o nome é obrigatório, então você pode criar o projeto primeiro e preencher o resto conforme o trabalho toma forma.
1

Abrir Projects

Em claude.ai/code ou na aba Code do aplicativo desktop, selecione Projects na barra lateral esquerda, ou em More ali. Em um navegador você também pode ir direto para claude.ai/code/projects/browse. Depois selecione New project. Se o botão mostrar Get started em vez disso, selecione-o e primeiro faça upgrade ou arquive os projetos existentes do claude.ai que ele lista.
2

Preencher o diálogo New project

Restrinja o escopo do projeto a um fluxo de trabalho que você continuará adicionando, como tudo o que é necessário para manter uma API sob seu alvo de latência. Quando usar um projeto tem mais exemplos. Então preencha os campos do diálogo:
  • Name: como o projeto aparece na lista Projects.
  • Goal (opcional): uma linha do que você está tentando realizar, como “Manter latência p95 da API abaixo de 200 ms”. Claude na conversa trabalha em direção a isso. Sem um objetivo, Claude trabalha a partir das tarefas que você envia, e você pode adicionar um objetivo mais tarde em Project settings > General.
  • Context (opcional): os repositórios GitHub em que este projeto funciona, mais quaisquer arquivos, pastas ou pastas do Google Drive que as threads devem ler. Clique Add para cada um. Adicione os repositórios que a maioria das tarefas precisa em vez de cada um que o trabalho pode tocar; Decidir quais repositórios adicionar cobre a escolha, e você pode adicionar mais tarde em Project settings > Environment.
Regras permanentes para como as threads devem funcionar vão em instruções do projeto, que você define após o projeto existir.
3

Criar o projeto

Clique Create project. A conversa do projeto abre com uma caixa de mensagem na parte inferior, onde você descreve trabalho para Claude.No seu primeiro projeto, Claude toma uma volta por conta própria assim que o projeto é criado, a menos que você envie uma mensagem primeiro. Essa volta usa seu plano. Nela, Claude pode:
  • Iniciar uma thread que explora o repositório sem fazer alterações e propõe próximos passos, se o projeto tiver um repositório que ele possa ler.
  • Postar Setup recommendations extraídas de suas sessões na nuvem recentes: repositórios para adicionar, tarefas agendadas para criar e threads que ele poderia iniciar. Cada repositório e tarefa agendada recomendados começam ligados. Desligue os que você não quer, depois clique Update setup para adicionar o resto, ou ignore as recomendações e descreva o trabalho você mesmo.
O projeto agora está listado em Projects na barra lateral, e sua conversa está aberta. Seu primeiro lote cobre o que configurar antes de enviar trabalho a ele.

Iniciar a partir de uma sessão existente

Se uma sessão na nuvem que você mesmo iniciou está fazendo trabalho que pertence a um projeto, abra o menu dela na barra lateral e escolha Continue in project, depois escolha no submenu:
  • Escolha Continue as new project para criar um novo projeto a partir da sessão. O projeto abre, e Claude lê a sessão e posta Setup recommendations na conversa do projeto para você confirmar. A sessão original permanece na sua lista de sessões. Se estava no meio de um turno, ela continua em execução, então pare-a você mesmo se não quiser que ambas trabalhem ao mesmo tempo.
  • Escolha um dos seus projetos existentes para trazer o trabalho da sessão para esse projeto. Esse projeto abre, e uma mensagem enviada em seu nome pede a Claude para ler a sessão e continuar de onde parou. A sessão original permanece na sua lista de sessões, inalterada.
Um banner Set up project também pode aparecer acima da caixa de mensagem de uma sessão na nuvem. Se você usá-lo em vez de Continue as new project, o resultado é o mesmo, exceto que o turno em execução da sessão para assim que o projeto abre. Uma sessão na sua própria máquina recebe o mesmo menu da barra lateral em claude.ai/code assim que você a conecta por meio do Remote Control. A partir de um projeto, Claude não consegue ler a transcrição de uma sessão que se conectou enquanto Require trusted devices estava ativado para sua conta. Se essa configuração estiver desativada:
  1. Se a sessão ainda não estiver conectada, execute /remote-control nela. Se ela se conectou enquanto essa configuração estava ativada, desconecte-a e conecte-a novamente primeiro.
  2. Em um navegador, encontre a linha da sessão na barra lateral em claude.ai/code, abra o menu dela e escolha no mesmo submenu.
Se Require trusted devices estiver ativado, ou se você não usar o Remote Control, descreva o trabalho você mesmo na conversa do projeto. Ou faça push do branch da sessão, adicione o repositório dela ao projeto e informe a Claude o nome do branch.

Configurar acesso ao GitHub

A maioria da configuração do GitHub acontece uma vez, não por projeto. Você conecta sua conta GitHub a Claude uma vez, e o Claude GitHub App é instalado uma vez por repositório, ou uma vez para toda uma organização GitHub se você der a ela todos os repositórios. Você volta a essas etapas quando adiciona um repositório que o Claude GitHub App ainda não cobre ou um em uma organização GitHub que impõe SSO.
1

Conectar sua conta GitHub

Se você nunca usou claude.ai/code antes, sua primeira visita o orienta através da conexão do GitHub; veja Conectar GitHub. Caso contrário, use uma das opções de autenticação do GitHub.
2

Instalar o Claude GitHub App nos repositórios do projeto

Instale o Claude GitHub App e conceda a ele os repositórios que o projeto usará. Em um repositório pertencente a uma organização GitHub, apenas um proprietário da organização pode concluir a instalação; se você não for um, o GitHub envia ao proprietário uma solicitação de instalação e o projeto não pode usar o repositório até que ele aprove.
3

Autorizar SSO para organizações que o impõem

Se uma organização GitHub impõe SAML SSO, reconecte GitHub e autorize o aplicativo Claude para essa organização. Até que você faça isso, os repositórios privados dessa organização não aparecem no diálogo New project ou Project settings > Environment.
Quando uma dessas etapas está incompleta, o diálogo New project e a página do projeto nomeiam a etapa ausente e vinculam a onde você a conclui. Conclua a etapa lá, depois clique Check again se o diálogo oferecer. Se um repositório ainda estiver faltando na lista depois, abra a instalação do Claude GitHub App no GitHub, em github.com/settings/installations para uma conta pessoal, e confirme que o repositório está listado em Repository access. Para as mensagens de erro que uma thread ou o projeto relata quando o acesso ainda está errado, veja Erros de acesso ao repositório.

Trabalhar em um projeto

Dê trabalho a Claude através da conversa do projeto: tarefas uma de cada vez ou várias de uma vez, mais atualizações e pensamentos soltos conforme surgem. Claude roteia cada mensagem, e as threads fazem o trabalho e relatam de volta.

Seu primeiro lote

Antes de enviar a um novo projeto um lote de trabalho, configure-o para que as primeiras threads voltem da maneira que você quer:
  1. Escrever instruções do projeto: o resumo a partir do qual cada thread começa, como qual branch direcionar, como uma thread verifica seu trabalho e o que precisa de sua aprovação.
  2. Envie uma pequena peça do trabalho real, ou inicie uma das threads que Claude sugeriu, se ele tiver oferecido alguma, e abra a thread quando terminar para ver como ela relata de volta e o que fez em seu branch. Se ela assumiu algo errado ou não conseguiu alcançar o que precisava, Threads adivinharam ou travaram em vez de perguntar cobre onde corrigir isso.
  3. Verifique Thread model e Thread effort em Project settings > General. Um novo projeto executa cada thread em Opus com alto esforço, que usa seu plano mais rapidamente; Escolher modelos e deixar Claude gerenciar contexto cobre as alternativas.
  4. Peça a Claude para propor threads antes de iniciá-las e executar algumas de cada vez, e solte esses limites uma vez que algumas threads voltem da maneira que você quer.

Enviar trabalho e ler resultados

Claude decide para onde cada mensagem que você envia na conversa vai:
  • Uma pergunta rápida geralmente recebe uma resposta na conversa.
  • Novo trabalho vai para uma nova thread ou para uma thread já trabalhando nessa área, e Claude diz qual. Cada nova thread aparece sob sua mensagem como um cartão: uma caixa com o título e status da thread, que você clica para abrir a thread.
  • Várias tarefas não relacionadas em uma mensagem se tornam threads separadas.
Se Claude rotear algo diferente do que você queria, diga. Ajustar como Claude executa um projeto lista coisas que você pode dizer a ele, como reutilizar uma thread existente para acompanhamentos ou responder no local em vez de iniciar uma thread. Os resultados completos de uma thread permanecem na thread, e você abre seu cartão na conversa para lê-los. Os arquivos que uma thread produziu também estão na aba Library em Overview. Às vezes Claude propõe threads em vez de iniciá-las, em uma lista Suggested threads. Clique na seta em uma sugestão para iniciar essa thread. Quando várias estão listadas, um botão sob a lista inicia todas elas.

Revisar o pull request de uma thread

Quando uma thread muda código, é isso que ela faz a menos que você diga o contrário:
  • Branch: funciona em um novo branch, iniciado a partir do branch padrão do repositório.
  • Pull request: abre um quando você pede, e pode abrir um por conta própria para uma correção de bug ou outra mudança concreta.
  • Depois que abre: observa o pull request com auto-fix ligado, independentemente de auto-fix estar ligado para suas outras sessões em nuvem. Ele empurra correções quando CI falha, aborda comentários de revisão e responde na thread quando as verificações passam e o pull request está pronto para você.
Quando uma thread empurrou um branch ou abriu um pull request, seu cartão na conversa pode mostrar um botão para o próximo passo:
  • Resolve conflicts, Fix CI, Address comments e Merge it enviam essa instrução para a thread como uma mensagem sua, então você pode solicitar a thread você mesmo em vez de esperar que ela reaja ao pull request.
  • Review PR abre o pull request no GitHub.
  • Create PR aparece quando uma thread ociosa empurrou um branch mas não abriu um pull request. Clicar nele cria o pull request desse branch diretamente em vez de enviar à thread uma instrução para abrir um.
Para mudar quando as threads abrem pull requests, por exemplo apenas quando você pede, ou a partir de qual branch elas começam, diga na tarefa ou em instruções do projeto.

Ver o que precisa de você em Overview

O painel Overview ao lado da conversa rastreia as threads do projeto. Ele já está aberto na primeira vez que você abre um novo projeto. O botão Overview no cabeçalho do projeto o fecha e reabre, e mostra um ponto quando uma thread está aguardando você. No aplicativo desktop, você também recebe uma notificação desktop quando Claude posta na conversa, uma thread atinge um erro ou uma thread precisa de sua entrada, então você não precisa manter o projeto aberto para descobrir. Para também receber uma cada vez que uma thread termina uma volta, ou para desligá-las para um projeto, escolha Notifications no menu da barra lateral do projeto. Essas notificações são apenas desktop: em um navegador, verifique o ponto no botão Overview. A aba Threads do painel agrupa threads por estado: As outras abas do painel são:
  • Library: os arquivos e pastas que você adicionou e os arquivos que as threads produziram
  • Pull requests: mostrada uma vez que as threads abriram algum
  • Scheduled tasks: as tarefas agendadas na nuvem que Claude configurou a partir deste projeto

Abrir uma thread quando você precisa de controle

Clique no cartão de uma thread na conversa ou sua linha em Overview para abrir sua transcrição no painel Overview. De lá você pode:
  • Ler o que Claude fez, passo a passo.
  • Direcionar a tarefa escrevendo na caixa de mensagem própria da thread. Uma mensagem lá vai direto para essa thread, enquanto um acompanhamento na conversa do projeto a alcança apenas quando Claude corresponde o acompanhamento a essa thread.
  • Responder a um prompt de permissão que a thread está aguardando.
  • Interromper a thread com Stop, que substitui o botão enviar enquanto a thread está funcionando, ou pressionando Esc.

Escolher modelos e deixar Claude gerenciar contexto

Defina modelos e esforço em Project settings > General. Um novo projeto executa Opus em todos os lugares, com alto esforço para threads e baixo esforço para a conversa:
  • Thread model e Thread effort se aplicam a threads. Para usar um modelo diferente para uma tarefa, peça na tarefa; para uma thread já em execução, use o seletor de modelo dessa thread.
  • Coordinator model e Coordinator effort se aplicam a Claude na conversa do projeto.
Você não gerencia janelas de contexto em um projeto. As threads compactam automaticamente, e a conversa funciona a partir de mensagens recentes, threads recentes e memória do projeto em vez de seu histórico completo, então continua enquanto o projeto funciona. Coloque qualquer coisa que nunca deve ser descartada em memória do projeto. Se uma thread ultrapassar seu contexto, ela mostra Claude ran out of context on this turn.

Ajustar como Claude executa um projeto

Diga a Claude na conversa quantas threads executar de uma vez, quando postar atualizações e quando abrir pull requests. Se Claude está coordenando de uma maneira que você não quer, diga. Por exemplo, você pode dizer:
  • “Proponha threads e aguarde minha aprovação antes de iniciá-las” ou “Inicie estas agora sem me pedir para confirmar”
  • “Execute no máximo duas threads de uma vez” ou “Reutilize uma thread existente para acompanhamentos na mesma área”
  • “Poste atualizações mais curtas” ou “Apenas poste quando algo terminar ou ficar bloqueado”
  • “Dê-me uma atualização de status em cada thread”
  • “Faça esta tarefa com um modelo menor”
  • “Não abra um pull request até que eu tenha visto o plano”
  • “Diga-me o que está errado nesses repositórios e não corrija nada ainda”, quando você quer passar pelos achados antes que qualquer um deles se torne uma thread
  • “Responda isso aqui em vez de iniciar uma thread”, quando Claude inicia uma thread para algo que você quis dizer como uma pergunta rápida
Claude salva preferências como essas em memória do projeto por conta própria e as segue em threads posteriores. São instruções que Claude segue, não configurações impostas, então um limite de thread que você dá dessa maneira não é um limite rígido. Adicione um às instruções do projeto quando quiser que seja redigido exatamente e aplicado a cada thread desde o início.

Desbloquear uma thread aguardando aprovação

As threads são executadas em modo auto quando o modelo da thread o suporta, então a maioria das chamadas de ferramenta são executadas sem pedir a você. Quando uma thread precisa de sua aprovação, o prompt está dentro dessa thread e a thread aguarda até que você responda lá. Dizer a Claude na conversa do projeto para prosseguir não a alcança. Cada aprovação cobre esse prompt, ou o resto dessa thread se você escolher a opção mais ampla. As threads na nuvem não leem regras de permissão do .claude/settings.json de um repositório, então você depende do modo auto e das aprovações que você dá dentro de cada thread.

Executar uma thread no seu próprio computador

Quando uma tarefa precisa de algo que apenas seu computador tem, como um banco de dados local, um emulador de dispositivo ou uma API atrás de seu VPN, peça a Claude para executar a thread para essa tarefa no seu computador em vez de na nuvem. Quando você pede na conversa do projeto, a thread é uma sessão Claude Code em uma pasta na sua máquina, conectada através de Remote Control. As outras threads do projeto continuam funcionando na nuvem. Comparado com uma thread na nuvem, uma thread no seu computador:
  • Funciona com os arquivos, ferramentas, servidores MCP e configurações Claude Code naquela máquina, incluindo seus hooks e regras de permissão, em vez do ambiente em nuvem do projeto
  • Começa com as instruções do projeto, mas não com seus arquivos de memória carregados
  • Executa apenas enquanto esse computador está acordado com Remote Control ligado
1

Conectar a pasta

No computador que tem a pasta que a tarefa precisa, disponibilize-a através de Remote Control de uma de duas maneiras. Ambas precisam de Claude Code v2.1.280 ou posterior naquele computador.
  • No aplicativo desktop Claude: abra Settings > Code ou Settings > Claude Code e ative Use this computer from your phone and claude.ai. Adicione a pasta à lista sob esse switch. As threads podem ser executadas neste computador enquanto o aplicativo está aberto.
  • Em um terminal: execute claude remote-control na pasta e deixe-a funcionando. Em um repositório git, adicione --spawn worktree para dar a cada thread lá seu próprio worktree em vez da pasta em si.
2

Peça a tarefa com Work locally

Na conversa do projeto, escolha Work locally no menu + ao lado da caixa de mensagem, que marca sua mensagem como Local, e escreva o que você quer que seja feito. Dizer na mensagem que a tarefa deve ser executada no seu computador também funciona.
3

Permitir no cartão

Claude responde com um cartão Allow Claude to work in a folder on your device. Escolha a pasta se você conectou várias. Duas threads trabalhando em uma pasta ao mesmo tempo podem sobrescrever as mudanças uma da outra, então se a pasta é um repositório git, você pode ativar Worktree nas opções da pasta para dar a essa thread seu próprio worktree em vez disso. Então clique em Allow once.
A thread é executada em modo auto, então Claude executa comandos e edita arquivos naquela pasta sem pedir a você cada vez. Se o modo auto não estiver disponível ou estiver desligado no Claude Code daquele computador, a thread é executada sem ele, e qualquer prompt de permissão que ela levanta aguarda sua resposta na thread, como Desbloquear uma thread aguardando aprovação descreve. Enquanto a thread é executada, um ícone de laptop em seu cabeçalho mostra se seu computador está conectado. Clique nele para ver qual pasta a thread está usando ou para desligar a conexão. A thread pausa enquanto esse computador está dormindo, e para se o aplicativo desktop ou claude remote-control sair.
  • Para colocar a thread funcionando novamente: consulte Perda de contato com sua pasta
  • Para impedir que o computador durma por conta própria: no aplicativo desktop, ative Keep this computer awake for Remote Control em Settings > Code ou Settings > Claude Code
Um projeto não pode executar uma thread no seu computador enquanto Require trusted devices está ativado para sua conta.

Dar contexto permanente a um projeto

Memória do projeto, instruções do projeto e os repositórios, arquivos e ambiente do projeto carregam contexto entre threads. Você define cada um uma vez. Project settings > Memory lista esses arquivos em Auto memory, porque Claude os escreve por conta própria conforme trabalha no projeto. Eles são separados da memória automática que Claude Code mantém na sua máquina, mesmo que ambas usem um índice MEMORY.md. A memória do projeto também é separada dos arquivos CLAUDE.md nos repositórios do projeto. Cada thread em nuvem ainda lê esses arquivos CLAUDE.md de seu clone quando começa, então coloque instruções sobre um repositório em seu CLAUDE.md e notas sobre o projeto em memória do projeto.

Escrever instruções do projeto

Instruções do projeto são o resumo a partir do qual cada nova thread começa. Clique no ícone de engrenagem no cabeçalho do projeto para abrir Project settings, depois vá para Memory > Project instructions. Um resumo útil cobre:
  • Para que serve o projeto
  • Onde o trabalho acontece: quais repositórios, a partir de qual branch começar, como nomear pull requests
  • Como uma thread verifica seu próprio trabalho antes de chamá-lo de concluído
  • O que fazer quando algo que precisa está faltando
  • O que precisa de sua aprovação primeiro
Por exemplo:
Regras sobre um repositório, como seus comandos de build, pertencem ao CLAUDE.md desse repositório, que cada thread em nuvem lê quando o repositório faz parte do projeto. Uma vez que o trabalho está em andamento, quando você corrige uma thread, também diga a Claude para lembrar da correção: ela vai para memória do projeto e threads posteriores começam com ela.

Decidir quais repositórios adicionar

Os repositórios que você adiciona a um projeto vêm com seu código e CLAUDE.md em cada thread em nuvem, mas não com suas skills, .claude/settings.json ou .mcp.json. Repositórios que você não adiciona ainda estão ao alcance: uma thread em nuvem pode adicionar um a si mesma quando sua tarefa precisa. A maioria dos projetos usa ambos:
  • Adicione-o ao projeto, no diálogo New project, em Project settings > Environment, ou pedindo a Claude na conversa para adicioná-lo ao projeto. Cada thread em nuvem a partir de então o clona e começa com seu CLAUDE.md carregado, independentemente de a tarefa tocá-lo.
  • Deixe-o de fora e deixe as threads adicionarem quando necessário. Uma thread em nuvem cuja tarefa precisa de um repositório que o projeto não tem pode adicioná-lo a si mesma, e uma nota na thread diz que foi adicionado apenas a essa thread. O clone acontece no meio da tarefa, então o CLAUDE.md desse repositório não estava lá quando a thread começou. A próxima thread começa sem ele. Um repositório adicionado dessa forma precisa dos mesmos pré-requisitos que um repositório de projeto: o Claude GitHub App instalado nele e acesso push de sua conta GitHub.
Um projeto não precisa de nenhum repositório. Suas threads em nuvem ainda podem pesquisar, escrever documentos e escrever e executar código em seu próprio sandbox, e entregam arquivos à aba Library. Qualquer uma de suas threads em nuvem ainda pode adicionar um repositório a si mesma quando uma tarefa exigir. Uma vez que o projeto tem repositórios, Claude só pode adicionar repositórios de um proprietário GitHub que o projeto já usa, seja adicionando um ao projeto ou uma thread adicionando um a si mesma. Para trazer um repositório de um proprietário diferente, adicione-o ao projeto você mesmo em Project settings > Environment. Para um projeto que abrange muitos repositórios, como um recurso com código de servidor, web, mobile e desktop, adicione o um ou dois repositórios que quase cada tarefa toca e nomeie os outros em instruções do projeto para que Claude saiba onde o resto do código vive. As threads em nuvem então começam pequenas e puxam os outros repositórios apenas para as tarefas que precisam deles.

Adicionar arquivos e pastas

Adicione os arquivos e pastas que você quer que as threads leiam no campo Context do diálogo New project, ou depois com Add na aba Library em Overview. Esses limites se aplicam ao que você adiciona:
  • Library tab: até 100 arquivos e 2 GB em uma seleção, com um único arquivo até 480 MB.
  • New project dialog: arquivos acima de 30 MB são ignorados, então adicione arquivos maiores da aba Library depois de criar o projeto.
  • Folders: quando você adiciona uma pasta de qualquer lugar, o projeto recebe uma cópia de seus primeiros 100 arquivos até 200 MB, sem nenhum arquivo acima de 30 MB, arquivos ocultos ou node_modules. Um projeto contém até 10 pastas e pastas do Google Drive combinadas, e arquivos únicos não contam para esse limite.
  • Changes after upload: uploads são cópias, então uma mudança que você faz no seu computador depois não chega ao projeto até que você carregue o arquivo novamente e escolha Replace quando perguntado sobre o nome existente.

O que as threads pegam de seus repositórios

As threads em nuvem carregam as instruções CLAUDE.md de cada repositório, mas não suas skills, servidores do .mcp.json ou .claude/settings.json, seja o projeto com um repositório ou vários.

Escolher um ambiente para threads

Cada nova thread em nuvem começa no ambiente em nuvem do projeto. O ambiente define quais domínios as threads podem alcançar, quais variáveis de ambiente elas têm, quais segredos de rede são adicionados a suas requisições e o que o script de configuração instala antes de Claude começar. As threads em nuvem usam um ambiente padrão hospedado pela Anthropic até que você escolha um em Project settings > Environment. Se as threads em nuvem precisam alcançar uma API interna ou um registro de pacotes privado, ou precisam de um token que sua máquina normalmente mantém, mude o ambiente em vez do projeto: veja Acesso à rede, Adicionar segredos de rede e Scripts de configuração.

Obter skills, plugins, conectores e ferramentas em threads

As threads em nuvem não têm as skills, servidores MCP, plugins e ferramentas instalados apenas na sua máquina. Uma thread que Claude executa na sua máquina através de Remote Control usa o que está instalado lá. Para disponibilizar cada um desses para threads em nuvem:
  • Skills: habilite-as para sua conta claude.ai, e as threads em nuvem carregam as skills que você habilita lá, exceto algumas threads em um ambiente auto-hospedado. Skills com commit no .claude/skills/ de um repositório não carregam em threads em nuvem.
  • Plugins: adicione-os em Project settings > Plugins; eles carregam em cada nova thread em nuvem. Plugins que um repositório declara em seu .claude/settings.json não carregam em threads em nuvem.
  • Servidores MCP: as threads em nuvem obtêm suas ferramentas MCP dos conectores em sua conta claude.ai, que são servidores MCP que você conecta uma vez em claude.ai/customize/connectors. Cada thread em nuvem pode usar todos eles sem configuração por projeto. A conversa do projeto em si não tem conectores, então envie trabalho que precisa de um como uma tarefa para uma thread em nuvem. Como conectores alcançam Claude Code lista as regras para sessões na nuvem e as configurações que desativam conectores.
  • Ferramentas de linha de comando e pacotes: instale-os no script de configuração do ambiente.
Para ver quais conectores uma thread em nuvem em execução tem em claude.ai/code, abra a thread e selecione Connectors no menu + ao lado de sua caixa de mensagem. Desativar um conector lá o remove dessa thread e salva isso como seu padrão de conta, então novas threads e chats claude.ai começam sem ele até que você o ative novamente. Uma thread em nuvem pega um conector que você adiciona ou reconecta após a próxima mensagem que você envia a ela.

Referência de configurações do projeto

Você muda as configurações do projeto em claude.ai/code ou no aplicativo desktop, não em settings.json. Abra Project settings de Settings no menu da barra lateral do projeto ou do ícone de engrenagem no cabeçalho do projeto. As configurações são salvas conforme você as altera; um campo de texto que você está editando, como o objetivo ou instruções, mostra Save changes e Discard até que você o deixe. Mudanças em instruções, repositórios, plugins e ambiente em Project settings alcançam novas threads, não threads já em execução.

Pausar, arquivar ou deletar um projeto

Todos os três controles estão na parte inferior de Project settings > General:
  • Pause: para tudo de uma vez. Cada thread em execução e a conversa são interrompidas, nenhuma nova thread começa, tarefas agendadas não são executadas e o projeto não aceita mensagens até que você o retome. Clique Resume no mesmo lugar ou no banner acima da caixa de mensagem do projeto; uma thread pausada continua quando você envia uma mensagem a ela depois disso.
  • Archive: oculta o projeto da barra lateral e arquiva suas threads, o que para qualquer thread que estava em execução ou observando um pull request. Tarefas agendadas no projeto não são executadas enquanto ele está arquivado. Para trazer o projeto de volta, abra-o na página Projects e clique Unarchive. Suas threads permanecem arquivadas até que você as desarquive individualmente da lista de sessões.
  • Delete: remove permanentemente o projeto junto com suas threads, sua memória e seus arquivos, e desativa as tarefas agendadas do projeto. Isso não pode ser desfeito. Branches e pull requests que as threads empurraram para o GitHub não são afetados.

Uso e custo

O uso do projeto conta contra os mesmos limites de plano que suas outras sessões Claude Code, e um projeto não pode gastar além desses limites por conta própria. Uma thread que atinge o limite do seu plano aguarda e continua por conta própria quando o limite é redefinido, então o trabalho que você deixou em execução começa a usar sua próxima janela de uso sem uma mensagem sua. Uma thread atingiu o limite de uso cobre o que você vê, como pará-la e o único caso que não aguarda. O trabalho vai além dos limites do seu plano apenas se você tiver ligado créditos de uso para sua conta. Uma thread não pode ligá-los para você.

O que usa seu plano

Um projeto usa seus limites mais rapidamente que uma única sessão, e em um plano Pro em particular você deve esperar atingir seu limite mais cedo em dias em que executa um. Estas são as partes de um projeto que usam seu plano:
  • Threads em execução: cada uma é uma sessão completa, e várias podem ser executadas ao mesmo tempo. Não há um número fixo; Claude inicia quantas o trabalho exigir, e um limite que você pede é uma preferência em vez de um limite. O limite imposto é 500 novas threads por dia em seus projetos.
  • A conversa: Claude usa tokens lendo o que as threads relatam e decidindo o que fazer a seguir.
  • Threads observando um pull request: uma thread ociosa acorda e usa seu plano novamente quando CI falha ou um comentário de revisão chega em seu pull request. Para parar isso, peça na thread para ela parar de observar o pull request.
Um projeto sem threads em execução, sem pull requests observados e sem novas mensagens não usa seu plano enquanto fica ocioso, e nem um projeto arquivado.

Ver e reduzir o uso de um projeto

Abra Usage em Project settings para ver o uso de token por thread e por modelo, e quanto foi para a conversa do projeto. Para reduzi-lo:
  • Em Pro, Max e Ultra dentro dos limites do seu plano, o tempo de vida do cache é de uma hora. Uma thread que está ociosa há mais tempo que isso relê toda a sua conversa antes de fazer qualquer coisa quando um acompanhamento chega a ela. Para novo trabalho, peça a Claude para iniciar uma thread nova, o que pode usar menos que reviver uma grande antiga.
  • Para trabalho que não precisa do maior modelo, escolha um modelo menor ou um nível de esforço mais baixo para threads, a conversa ou ambos.
  • Peça a Claude na conversa do projeto para executar menos threads de uma vez, ou para responder pequenas perguntas ela mesma em vez de iniciar uma thread.

Como projetos se relacionam com outros recursos Claude Code

Vários recursos Claude Code permitem que mais de uma sessão funcione ao mesmo tempo, então executar trabalho em paralelo não é por si só para que um projeto serve. Em um projeto, Claude inicia e rastreia as sessões em vez de você, e cada uma começa a partir das mesmas instruções. É assim que cada recurso vizinho se conecta a um projeto:
  • Claude Tag: Claude Tag é Claude nos canais Slack da sua equipe, em planos Team e Enterprise. Qualquer pessoa em um canal pode dar trabalho a ele, todos no canal veem e o direcionam, e ele usa conexões que um administrador configurou para esse canal. Projetos estão disponíveis nos planos Pro, Max e Ultra. Um projeto é só seu: você é o único que envia trabalho a ele ou vê suas threads, e ele usa seu próprio acesso GitHub e seus conectores. Como Claude Tag difere de Cowork e Claude Code tem o lado a lado.
  • Sessões na nuvem: cada thread é uma sessão na nuvem, a menos que você peça a Claude para executá-la na sua máquina. De qualquer forma, Claude inicia e rastreia em vez de você. Você também pode trazer o trabalho de uma sessão na nuvem que você mesmo iniciou para um projeto: escolha Continue in project no menu da barra lateral dessa sessão.
  • Tarefas agendadas: quando você pede trabalho agendado em um projeto, Claude cria uma tarefa agendada na nuvem que é executada como threads nesse projeto e aparece em sua aba Scheduled tasks. Tarefas agendadas que você cria fora de um projeto continuam funcionando por conta própria.
  • Remote Control: Remote Control conecta claude.ai a uma sessão Claude Code em execução na sua máquina. Quando você pede a Claude em um projeto para executar uma thread no seu computador, o projeto usa Remote Control para fazer isso.
  • Sessões locais e agent view: uma sessão que você mesmo inicia em seu terminal, IDE ou no ambiente local do aplicativo desktop fica fora dos seus projetos, embora você possa trazer o trabalho dela para um deles. Agent view é uma tela para rastrear várias sessões locais lado a lado, e você ainda inicia cada uma e dá sua tarefa a ela mesmo.
  • Worktrees: um worktree dá a cada sessão local sua própria cópia de trabalho de um repositório. As threads na nuvem não precisam deles: cada uma clona seus repositórios em seu próprio sandbox na nuvem e trabalha em seu próprio branch.
  • Agent teams: um agent team é uma sessão que inicia sessões de colega de trabalho para uma única tarefa, na sua máquina ou dentro de uma sessão em nuvem, e termina com essa tarefa.
  • Subagents: um subagent é executado dentro de uma sessão, faz uma tarefa secundária em sua própria janela de contexto e retorna um resumo para essa sessão. As threads de um projeto são sessões completas que Claude inicia e que reportam de volta para a conversa do projeto, e uma thread ainda pode usar subagents para suas próprias tarefas secundárias.
  • Projects no chat claude.ai e Cowork: a experiência anterior de Projects, que agrupa conversas e arquivos de referência sem threads ou um coordenador. Esses projetos continuam funcionando como fazem hoje até que a experiência redesenhada os alcance.
Executar agentes em paralelo compara essas opções lado a lado.

Limitações

  • Projects estão disponíveis em claude.ai/code, no aplicativo desktop e no aplicativo móvel Claude, não no CLI do terminal, na extensão VS Code ou no plugin JetBrains, e não através de Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry.
  • As threads do projeto são sessões em nuvem, ou sessões em sua própria máquina através de Remote Control, com Anthropic como provedor de modelo em ambos os casos. Segurança e Uso de dados cobrem como as sessões em nuvem são isoladas e o que é retido, e Conexão e segurança cobre como uma thread em sua máquina se conecta e o que é armazenado.
  • Você não pode adicionar a um projeto uma sessão que você mesmo iniciou em sua máquina, embora possa trazer o trabalho dela para um projeto. Um projeto alcança sua máquina executando uma thread lá através de Remote Control, e essa seção lista o que é necessário.
  • O sandbox de uma thread em nuvem pausa entre voltas e retoma quando a thread continua. Se o sandbox não puder ser retomado, a thread continua de um clone fresco, então mudanças não confirmadas podem ser perdidas. Em tarefas longas, peça a Claude para confirmar e enviar trabalho em progresso.
  • Um projeto pertence a um usuário. Você não pode compartilhar um projeto ou suas threads com outro usuário, e transcrições de thread não têm a opção de compartilhamento que outras sessões em nuvem têm. Não há controles de nível de organização para projetos durante o beta.
  • Uma thread pertence ao único projeto que a iniciou. Você não pode mover ou copiar uma thread para outro projeto, ou movê-la para ficar sozinha. Continue in project vai apenas na outra direção: traz o trabalho de uma sessão na nuvem para um projeto. Você não pode mesclar dois projetos em um.

Solução de problemas

Para os prompts de configuração do GitHub no diálogo New project, veja Configurar acesso ao GitHub.

Uma thread parece estar travada

Claude não posta cada passo que uma thread toma, então uma thread que mostra como em execução sem novas mensagens na conversa do projeto geralmente ainda está funcionando. Uma nova thread em nuvem também provisiona seu ambiente em nuvem antes de Claude começar, então sua primeira atualização leva um momento. Abra a thread para ler sua transcrição. Se a thread está aguardando um prompt de permissão, responda lá.

Threads adivinharam ou travaram em vez de perguntar

Quando várias threads voltam tendo assumido algo errado, contornado acesso ausente ou parado com “bloqueado”, a causa geralmente é a mesma lacuna na configuração do projeto em vez de um problema com cada tarefa. Classifique quais threads são sólidas antes de corrigir qualquer coisa:
  1. Peça a Claude na conversa: “Para cada thread aberta, liste o que você pediu a ela para fazer, o que ela assumiu ou não conseguiu alcançar e no que está aguardando.” Claude lê cada thread e responde na conversa.
  2. Para threads que começaram de uma suposição errada, abra a thread de Overview e marque-a como resolvida de seu menu, ou diga a ela o que fazer em vez disso em sua caixa de mensagem. Seu branch e qualquer pull request permanecem no GitHub até que você os delete.
  3. Corrija a lacuna uma vez, em instruções do projeto ou no ambiente, depois envie uma thread antes de enviar o resto do trabalho novamente como novas threads.

Claude não respondeu

A conversa do projeto mostra um banner “Claude hasn’t responded” quando Claude está em execução mas suas respostas não estão alcançando o projeto. Clique Restart Claude no banner, ou vá para Project settings > General e clique Restart na linha Restart Claude. Claude se reconecta à conversa; qualquer resposta que estava no meio de escrever é perdida, e as threads não são afetadas.

Erros de acesso ao repositório

Três mensagens significam que uma thread ou o projeto não consegue alcançar um de seus repositórios. Uma thread de projeto em nuvem precisa dos pré-requisitos do GitHub mesmo quando suas outras sessões em nuvem clonam o mesmo repositório sem problemas.
  • “Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository”, relatado antes da thread começar, quando o Claude GitHub App não está instalado nesse repositório, está suspenso ou não está vinculado à conta GitHub que você conectou.
  • “Unable to access your repository”, relatado por uma thread quando seu clone falha: GitHub rejeitou o clone, o repositório não foi encontrado sob o nome que o projeto tem, ou o branch do qual a thread foi pedida para começar não existe.
  • “Claude can’t access” um repositório, mostrado quando você salva repositórios no diálogo New project ou Project settings. A mensagem continua com um link de instalação e um link de reconexão. Use o link de instalação se o Claude GitHub App não estiver nesse repositório, e o link de reconexão se estiver, já que o GitHub App pode ser instalado no GitHub sem estar vinculado à conta que você conectou a Claude. Se a mensagem disser que o GitHub App está suspenso ou não inclui esse repositório, siga seu link para o GitHub para corrigir isso.
Para corrigir qualquer um deles, clique no botão que a mensagem oferece, como Install GitHub App ou Select repositories on GitHub, depois Check again. Quando o bloqueio está no lado da organização GitHub, como um proprietário que não aprovou o app ou uma lista de permissão de IP que exclui Claude, a mensagem mostra um link See how to fix. Se não houver botão, siga Configurar acesso ao GitHub, depois envie outra mensagem para tentar novamente.

Uma thread atingiu o limite de uso

Quando uma thread ou a conversa do projeto atinge o limite de cinco horas ou semanal do seu plano, ela continua tentando por conta própria e continua quando o limite é redefinido. Uma thread que uma tarefa agendada iniciou não aguarda: seu turno para com um erro de limite, e você envia uma mensagem a ela após o limite ser redefinido. Enquanto aguarda, a thread mostra Service is busy com “Claude is still retrying and will continue automatically.” Você não precisa fazer nada para o trabalho continuar. Se preferir que não use sua próxima janela de uso, clique Stop na thread, ou pause o projeto para suspender todas as threads. Erros de limite de uso explicam os limites e quando eles são redefinidos.

Créditos de uso adicionais são necessários

Uma thread ou a conversa do projeto fez uma solicitação que seu plano cobre apenas com créditos de uso, como uma para um modelo ou tamanho de contexto que seu plano não inclui, e créditos de uso não estão ligados para sua conta. Adicionar créditos de uso à sua assinatura cobre quem pode ligá-los ou comprá-los em cada plano. Uma vez que créditos estão disponíveis, envie outra mensagem para tentar novamente.

Perda de contato com sua pasta

Uma thread em execução no seu computador mostra isso quando a sessão Claude Code lá parou de responder, geralmente porque o computador entrou em modo de suspensão ou o aplicativo desktop ou claude remote-control saiu. Acorde o computador. Se o aplicativo desktop ou claude remote-control não estiver mais em execução lá, inicie-o novamente:
  • Aplicativo desktop: reabra o aplicativo e confirme que Use this computer from your phone and claude.ai ainda está ativado em Settings > Code ou Settings > Claude Code
  • Terminal: execute claude remote-control novamente na mesma pasta

Outras mensagens

Essas mensagens nomeiam sua própria causa. A tabela dá o próximo passo para cada uma.