Deixe Claude coordenar trabalho contínuo com Projects

• 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 os repositórios, instruções e memória 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 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.

​

Quando algo mais se encaixa melhor

• Uma tarefa que cabe em uma sessão: “Corrigir o teste de login instável.” Inicie uma sessão em nuvem você mesmo.
• Trabalho que precisa de ferramentas ou serviços que apenas sua máquina pode alcançar: um banco de dados local, um emulador de dispositivo, 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 routine 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

• 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 em nuvem separada com sua própria janela de contexto que faz uma peça de trabalho em seu próprio branch, abre um pull request quando o trabalho exigir e relata de volta à conversa quando termina.
• O que cada thread começa com:
  • Os repositórios e arquivos do projeto, mais suas instruções e memória
  • O CLAUDE.md, skills e plugins em cada um dos repositórios do projeto, e em um projeto com um repositório, as regras de permissão e hooks desse repositório também
  • Os connectors na sua conta claude.ai
  • Um ambiente em nuvem que define seu acesso à rede, variáveis de ambiente, credenciais de API 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 Routines para trabalho agendado no projeto.

​

Criar 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 em nuvem que já está fazendo o trabalho: escolha Continue as a project no menu dessa sessão, e 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 em nuvem existente.

​

Verificar os pré-requisitos

• Plano: você está no Pro ou Max e Projects aparece na sua barra lateral.
• 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.
• Rede, credenciais e ferramentas: estes vêm do ambiente em 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 connectors claude.ai.

​

Iniciar um novo projeto do zero

​

Iniciar a partir de uma sessão em nuvem existente

• Continue as a project cria um novo projeto nomeado após a sessão e o abre. Claude lê a sessão e posta Setup recommendations na conversa para você confirmar. A sessão original permanece na sua lista de sessões, e se estava no meio de uma volta ela continua funcionando, então pare-a você mesmo se não quiser que ambas funcionem ao mesmo tempo. Se você usar o banner Set up project que pode aparecer acima da caixa de mensagem da sessão em nuvem, o resultado é o mesmo, exceto que a volta em execução da sessão para uma vez que o projeto abre.
• Move to project traz o trabalho da sessão para um projeto existente. Ele posta uma mensagem na conversa desse projeto pedindo a Claude para ler a sessão e continuar de onde parou, e o novo trabalho continua nas próprias threads do projeto. A sessão original permanece na sua lista de sessões, inalterada.

​

Configurar acesso ao GitHub

​

Trabalhar em um projeto

​

Seu primeiro lote

1. Escrever instruções do projeto: o resumo que 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, 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

• 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

• 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ê.

​

Ver o que precisa de você em Overview

​

Abrir uma thread quando você precisa de controle

• 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

• 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

• “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

​

Dar contexto permanente a um projeto

​

Escrever instruções do projeto

• Para que serve o projeto
• Onde o trabalho acontece: quais repositórios, 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

Este projeto mantém a latência p95 da API de pagamentos abaixo de 200 ms: criação de perfil, correções de consulta e cache, e as atualizações de dependência que vêm com elas, no repositório payments-api.

- Ramifique a partir de main e abra um pull request de rascunho por thread.
- Antes de chamar o trabalho de concluído, execute `make test` e `make lint` e cole as linhas de resumo em sua mensagem final.
- Se você não conseguir alcançar algo que precisa, como um repositório, um segredo, uma API ou um connector, diga exatamente o que está faltando em sua primeira mensagem e pare. Não substitua, simule ou adivinhe.
- Não mescle, force-push ou mude a configuração de CI sem me perguntar na thread.

​

Decidir quais repositórios adicionar

• Adicione-o ao projeto, no diálogo New project, em Project settings > Environment, ou pedindo a Claude na conversa para adicionar ao projeto. Cada thread a partir de então clona e começa com seu CLAUDE.md e skills carregados, independentemente de a tarefa tocá-lo. Ir de um repositório para vários também muda o que as threads pegam do .claude/settings.json de cada repositório; veja O que as threads pegam de seus repositórios.
• Deixe-o de fora e deixe as threads adicionarem quando necessário. Uma thread 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 e skills desse repositório não estavam lá quando a thread começou. A próxima thread começa sem ele novamente. Um repositório que uma thread adiciona precisa dos mesmos pré-requisitos que um repositório de projeto: o Claude GitHub App instalado nele e acesso push de sua conta GitHub.

​

O que as threads pegam de seus repositórios

​

Escolher um ambiente para threads

​

Obter skills, plugins, connectors e ferramentas em threads

• Skills, subagentes e comandos: confirme-os em um repositório que você adicionou ao projeto, por exemplo um skill em .claude/skills/<skill-name>/SKILL.md. Cada thread clona cada repositório no projeto e carrega .claude/skills/, .claude/agents/ e .claude/commands/ de cada um deles, então um skill confirmado em um repositório está disponível em cada nova thread. As threads também carregam os skills que você habilita para sua conta claude.ai.
• Plugins: adicione-os em Project settings > Plugins; eles carregam em cada nova thread. Plugins que um repositório declara em seu .claude/settings.json também carregam; veja O que se carrega de sua configuração.
• Servidores MCP: as threads obtêm suas ferramentas MCP dos connectors em sua conta claude.ai, que são servidores MCP que você conecta uma vez em claude.ai/customize/connectors ou através do link Manage connectors em Project settings > Environment. Cada thread pode usar todos eles sem configuração por projeto. A conversa do projeto em si não tem connectors, então envie trabalho que precisa de um como uma tarefa para uma thread. Em um projeto com um repositório, as threads também carregam servidores MCP do .mcp.json desse repositório. Como connectors alcançam Claude Code lista as regras para sessões em nuvem e as configurações que desligam connectors.
• Ferramentas de linha de comando e pacotes: instale-os no script de configuração do ambiente.

​

Referência de configurações do projeto

​

Pausar, arquivar ou deletar um projeto

• Pause: para tudo de uma vez. Cada thread em execução e a conversa são interrompidas, nenhuma nova thread começa, routines 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. Routines no projeto não são executadas enquanto 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 desliga as routines 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 que usa 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 é 200 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

• Um acompanhamento roteado para uma thread que está ociosa há mais tempo que o tempo de vida do cache, uma hora em Pro e Max dentro dos limites do seu plano, relê toda a conversa dessa thread antes de fazer qualquer coisa. Para novo trabalho, pedir a Claude para iniciar uma thread fresca 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

• 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 usa conexões que um admin configurou para esse canal. Um projeto é seu: você é o único que envia trabalho a ele ou vê suas threads, usa seu próprio acesso GitHub e connectors, e está em Pro e Max. Como Claude Tag difere de Cowork e Claude Code tem o lado a lado.
• Sessões em nuvem: cada thread é uma sessão em nuvem, iniciada e rastreada por Claude em vez de por você. Uma sessão em nuvem que você iniciou pode se tornar um projeto ou alimentar um através de Continue as a project ou Move to project.
• Routines: quando você pede trabalho agendado em um projeto, Claude cria uma routine que é executada como threads nesse projeto e aparece em sua aba Routines. Routines que você cria fora de um projeto continuam funcionando por conta própria.
• Sessões locais e agent view: sessões em seu terminal, IDE ou ambiente local do aplicativo desktop são executadas na sua máquina e não podem fazer parte de um projeto. Agent view é uma tela para rastrear várias dessas sessões locais; não tem coordenador.
• Worktrees: um worktree dá a cada sessão local sua própria cópia de trabalho de um repositório para que sessões paralelas na sua máquina não se sobrescrevam. As threads não precisam deles: cada thread clona seus repositórios em seu próprio sandbox em nuvem e funciona 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.
• 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 e no aplicativo desktop, não no CLI do terminal ou através de Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry. O comando claude project do CLI, que gerencia o estado local do Claude Code para um diretório, não está relacionado.
• As threads do projeto são sessões em nuvem com Anthropic como provedor de modelo. Segurança e Uso de dados cobrem como as sessões em nuvem são isoladas e o que é retido.
• Uma sessão local não pode fazer parte de um projeto.
• O sandbox de uma thread 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 empurrar 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. Move to project vai apenas na outra direção: traz o trabalho de uma sessão em nuvem para um projeto.

​

Solução de problemas

​

Uma thread parece estar travada

​

Threads adivinharam ou travaram em vez de perguntar

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

​

Erros de acesso ao repositório

• “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

​

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

​

Outras mensagens

​

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 podem alcançar na rede, dê a elas variáveis de ambiente e credenciais de API, e instale ferramentas com um script de configuração
• Automatizar trabalho com routines: cronogramas, gatilhos e gerenciamento para routines, 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