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.
- 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.
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.mddescreve” 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.
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.
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:
- Os repositórios e arquivos do projeto, mais suas instruções e memória
- O
CLAUDE.mdem cada um dos repositórios do projeto, mas não as skills, o.claude/settings.jsonou o.mcp.jsondos repositórios - Os conectores na sua conta claude.ai
- Um ambiente em nuvem que define seu acesso à rede, variáveis de ambiente, segredos de rede e ferramentas instaladas
- 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.
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.
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.
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.
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.
- Se a sessão ainda não estiver conectada, execute
/remote-controlnela. Se ela se conectou enquanto essa configuração estava ativada, desconecte-a e conecte-a novamente primeiro. - 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.
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.
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:- 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.
- 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.
- 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.
- 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.
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ê.
- 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.
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.
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
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-controlna pasta e deixe-a funcionando. Em um repositório git, adicione--spawn worktreepara 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.
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
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
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 eCLAUDE.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.mdcarregado, 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.mddesse 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.
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çõesCLAUDE.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.jsonnã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.
Referência de configurações do projeto
Você muda as configurações do projeto em claude.ai/code ou no aplicativo desktop, não emsettings.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.
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.
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:- 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.
- 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.
- 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.
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 ouclaude 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-controlnovamente na mesma pasta
Outras mensagens
Essas mensagens nomeiam sua própria causa. A tabela dá o próximo passo para cada uma.Recursos relacionados
- Usar Claude Code na nuvem: como as sessões em nuvem por trás de cada thread funcionam, incluindo opções de acesso ao GitHub e auto-fix em pull requests
- Configurar ambientes em nuvem: mude o que as threads na nuvem podem alcançar na rede, dê a elas variáveis de ambiente e segredos de rede, e instale ferramentas com um script de configuração
- Automatizar trabalho com tarefas agendadas: cronogramas, gatilhos e gerenciamento para tarefas agendadas, incluindo as que Claude cria a partir de um projeto
- Gerenciar múltiplos agentes com agent view: execute e rastreie várias sessões na sua própria máquina quando o trabalho precisa de ferramentas ou serviços que apenas sua máquina pode alcançar
- Projects redesigned: from folder to conversation: o anúncio de lançamento, com o raciocínio por trás de tornar um projeto uma conversa com Claude