Claude Code Projects: coordenador, /btw, /fork e limites
O Claude Code Projects coordena tarefas de programação em threads paralelas. Veja como criar um projeto, usar /btw e /fork, configurar lembretes e compartilhamento somente leitura, reduzir o consumo de tokens e controlar o Auto-continue. Compare o recurso com sessões locais do Claude Code, agent view e T3 Code.
Conteúdo

O Claude Code Projects é indicado para quem precisa distribuir tarefas de programação relacionadas entre várias sessões, com um coordenador acompanhando o trabalho. Em 14 de novembro de 2026, o recurso estava em beta pública, com liberação gradual para os planos Pro, Max e Ultra. A configuração padrão usa Opus com esforço alto nas threads, o que pode esgotar os limites compartilhados da assinatura mais rapidamente.
Comece com uma thread pequena, reduza o modelo e o esforço nas tarefas simples e desligue o Auto-continue se quiser preservar a próxima janela de uso.
A atualização de 14 de novembro tornou o coordenador mais ativo. Ela também trouxe /btw, /fork, lembretes, compartilhamento de threads em modo somente leitura e uma navegação melhor pelos artefatos.
O principal benefício do Projects é centralizar as instruções enquanto Claude administra as sessões que executam o trabalho. O cuidado necessário é que cada thread ativa corresponde a uma sessão completa do Claude Code e consome a cota do seu plano.
O que é o Claude Code Projects e quem pode usar?
Um projeto do Claude Code é uma conversa contínua com um coordenador que distribui tarefas entre sessões independentes chamadas threads.
Por exemplo, você pode pedir:
- Corrigir uma regressão de autenticação.
- Adicionar testes que faltam em um endpoint de pagamentos.
- Investigar uma consulta lenta ao banco de dados.
O coordenador encaminha cada tarefa, acompanha o andamento e apresenta os resultados na conversa principal. Todas as threads novas recebem as instruções do projeto e podem trabalhar separadamente.
A maioria roda como sessões do Claude Code na nuvem. Cada thread na nuvem usa um ambiente isolado, um clone próprio do repositório e uma branch separada.
Você também pode pedir que uma thread rode no seu computador por meio do Remote Control, quando ela precisar de arquivos ou ferramentas locais.
A diferença é importante para tarefas demoradas: threads na nuvem continuam trabalhando depois que você fecha o notebook. Uma thread local depende de o computador permanecer disponível.
O recurso não deve ser confundido com os Projects antigos do Claude.ai. A experiência anterior organizava conversas e arquivos de referência. A versão do Claude Code acrescenta coordenação ativa e sessões que executam tarefas.
Disponibilidade e lista de espera
Em 14 de novembro de 2026, a documentação da Anthropic indicava:
| Plano | Disponibilidade do Projects |
|---|---|
| Pro | Beta pública, liberação gradual |
| Max | Beta pública, liberação gradual |
| Ultra | Beta pública, liberação gradual |
| Team | Ainda não disponível |
| Enterprise | Ainda não disponível |
Ter uma assinatura elegível não garante que o recurso já tenha sido liberado para sua conta.
Para conferir:
- Abra o Claude Code na web.
- Procure Projects na barra lateral.
- Se não aparecer, abra More.
- Confira também a aba Code no aplicativo Claude para desktop.
- Caso Projects continue ausente, acesse a lista de espera.
Você também pode tentar a página de navegação dos projetos.
A liberação começou por contas que já tinham usado sessões na nuvem e não possuíam projetos antigos no Claude.ai chat ou no Cowork.
Atualizar o Claude Code no terminal não habilita o Projects. O recurso fica nas interfaces web, desktop e móvel, conforme a elegibilidade da conta.
O que mudou na atualização do Projects de 14 de novembro?
Em 14 de novembro de 2026, às 06:51 UTC+8, a conta @ClaudeDevs da Anthropic anunciou várias novidades no Projects.
As mudanças facilitam a conversa com o coordenador, o acompanhamento das threads e a localização dos resultados.
| Recurso | O que faz | Quando usar |
|---|---|---|
| Coordenador proativo | Responde no chat do projeto e informa o andamento das threads | Para acompanhar várias tarefas sem abrir cada thread |
/btw | Cria uma thread separada para um assunto paralelo | Para investigar outra questão sem interromper o trabalho atual |
/fork | Abre uma nova thread a partir da atual | Para testar uma implementação alternativa |
| Lembretes | Retiram temporariamente uma thread da frente e a trazem de volta no momento indicado | Para retomar uma tarefa após uma revisão ou dependência |
| Compartilhamento somente leitura | Permite anunciar links para threads individuais, com restrições | Para mostrar o trabalho a outra pessoa conectada ao Claude |
| Navegação por artefatos | Mostra artefatos recentes ou fixados e suas miniaturas | Para encontrar resultados anteriores |
O coordenador agora acompanha o trabalho de forma mais ativa
O coordenador passou a responder perguntas na própria conversa do projeto e a fornecer atualizações mais frequentes.
Depois de iniciar algumas tarefas, você pode perguntar:
Quais threads ainda estão trabalhando, quais pull requests precisam de revisão e quais tarefas estão bloqueadas?
O coordenador consegue resumir os relatórios recebidos das threads. Mas ele não acompanha cada etapa interna de todas as sessões.
Se você precisar investigar uma falha, abra a thread correspondente. Lá estarão os comandos, as chamadas de ferramentas e os resultados detalhados.
A Anthropic descreveu a mudança no anúncio do coordenador de 14 de novembro.
Quando usar /btw ou /fork
Os dois comandos agora funcionam dentro do Projects, mas têm finalidades diferentes.
Use /btw quando surgir uma questão nova durante outra tarefa.
Imagine uma thread modificando o middleware de autenticação. Enquanto isso, aparece um erro de cobrança que não tem relação com o código atual.
Com /btw, você abre uma thread específica para investigar a cobrança. O trabalho de autenticação permanece no contexto original.
Use /fork quando quiser testar outra abordagem para a mesma tarefa.
Por exemplo, uma thread está substituindo uma consulta ao banco por um JOIN. Você pode criar uma ramificação para avaliar uma visão materializada sem descartar a implementação original.
A distinção é:
/btwsepara uma tarefa paralela do assunto atual./forkcria outra linha de trabalho a partir da thread atual.
Ambos podem iniciar novas sessões e consumir mais do seu plano. Evite criar várias ramificações sem um motivo claro para comparar os resultados.
A Anthropic detalhou a novidade no anúncio dos dois comandos. Não presuma que o comportamento no Projects é idêntico em todas as versões do CLI.
Lembretes, compartilhamento e navegação por artefatos
Você pode adicionar um lembrete a qualquer thread ou pedir ao Claude que lembre você de uma tarefa.
Segundo o anúncio dos lembretes, a thread sai temporariamente do seu caminho. Quando chega o momento definido, ela reaparece e Claude a menciona na conversa do projeto.
Isso ajuda quando uma tarefa depende de uma revisão futura. Ainda assim, você precisa conferir o resultado.
A Anthropic também anunciou links individuais de compartilhamento em modo somente leitura:
- Abra a thread desejada.
- Abra o menu dela.
- Se estiver disponível, selecione Share.
- Envie o link para alguém que tenha feito login no Claude.
Uma thread que teve acesso ao seu computador não pode ser compartilhada por esse recurso.
Em 14 de novembro, havia uma divergência entre o anúncio e a documentação. O anúncio oficial apresenta os links de compartilhamento, mas a página de limitações do Projects ainda afirmava que transcrições de threads não podiam ser compartilhadas.
Considere o anúncio como a introdução do recurso e verifique se Share aparece de fato no menu da sua thread. Não foi confirmado um requisito específico de versão do CLI para essa atualização da interface.
O acesso somente leitura também não impede a exposição de informações sensíveis. Revise os detalhes do repositório, os logs e outros dados antes de enviar o link.
No anúncio sobre a navegação por artefatos, a Anthropic descreve uma linha no topo do painel de threads. Ela reúne artefatos abertos, atualizados ou fixados recentemente. Cada thread também pode mostrar miniaturas dos próprios artefatos, que podem ser desativadas nas configurações de visualização.
As interfaces renovadas de configuração e acesso a pastas locais foram anunciadas para web e desktop. O novo visual também chegou à versão mais recente do aplicativo móvel.
Como configurar seu primeiro Claude Code Project
Crie um projeto com um objetivo contínuo e teste uma thread pequena antes de distribuir várias tarefas.
1. Verifique o acesso ao repositório
Para threads na nuvem que vão trabalhar com código, a Anthropic exige:
- Repositório hospedado em
github.com, não em GitHub Enterprise Server, GitLab ou Bitbucket. - Permissão de push na conta GitHub conectada.
- Claude GitHub App instalado e autorizado para o repositório.
Um token configurado por /web-setup não é suficiente, por si só, para as threads na nuvem do Projects.
Se o repositório não aparecer, siga as instruções oficiais de configuração do GitHub. Conecte sua conta e conceda ao Claude GitHub App acesso ao repositório necessário.
Em organizações com SAML SSO, talvez seja preciso autorizar o aplicativo Claude separadamente para aquela organização.
Lembre-se de que o ambiente na nuvem não herda toda a configuração local.
As threads carregam as instruções de CLAUDE.md de cada repositório. Porém, não carregam as skills do repositório, os servidores definidos em .mcp.json nem os ajustes de .claude/settings.json.
Isso inclui hooks, regras de permissão e variáveis de ambiente definidas em .claude/settings.json.
Ferramentas instaladas apenas no seu computador também não ficam disponíveis automaticamente.
Configure os recursos necessários no ambiente de nuvem do projeto e nas integrações compatíveis da sua conta Claude. Para ferramentas exclusivamente locais, considere o Remote Control.
2. Crie o projeto
A documentação oficial de criação de projetos descreve os seguintes controles:
- Abra
claude.ai/codeou a aba Code no aplicativo de desktop. - Selecione Projects na barra lateral ou em More e depois New project.
- Digite um nome em Name.
- Se quiser, informe o objetivo em What do you want to work on?.
- Em Context, use + para adicionar os repositórios GitHub, arquivos ou pastas necessários.
- Selecione Create project.
Apenas Name é obrigatório. Você pode adicionar o objetivo e os arquivos de contexto depois.
Se aparecer Get started em vez de New project, talvez seja necessário atualizar ou arquivar projetos antigos do Claude.ai primeiro.
Ao criar seu primeiro projeto, Claude pode realizar uma ação inicial sem esperar outro comando. Essa ação consome sua franquia e pode iniciar uma thread exploratória ou sugerir mudanças na configuração.
Revise os repositórios e as tarefas agendadas sugeridos antes de aceitar.
3. Defina instruções e configurações de uso
Abra Project settings pelo menu lateral ou pelo menu do cabeçalho do projeto.
Acesse Project settings > Memory > Project instructions para definir regras para novas threads.
Por exemplo:
Trabalhe somente no repositório selecionado. Use uma branch separada para cada implementação. Execute os testes relevantes antes de informar a conclusão. Peça aprovação antes de mudar o comportamento de uma API pública. Não abra um pull request até eu aprovar o plano.
Essas instruções são enviadas às novas threads.
Alterações de instruções, repositórios, plugins e ambientes feitas em Project settings passam a valer para threads novas. As threads já em execução não são reconfiguradas automaticamente.
Depois abra Project settings > General e revise os modelos e níveis de esforço.
4. Execute uma tarefa pequena e confira o resultado
Comece com uma tarefa que tenha um critério claro de sucesso:
Investigue por que o endpoint de pedidos retorna um status HTTP incorreto para entradas inválidas. Inicie apenas uma thread. Identifique o caso com falha, adicione um teste de regressão e proponha uma correção mínima. Não abra um pull request antes de eu aprovar o plano.
Esse é um exemplo de prompt, não um teste executado durante a elaboração do artigo.
Acompanhe o andamento em Overview. O painel organiza as threads em estados como Working, Waiting on you e Ready for review.
Abra a thread e verifique:
- Quais arquivos ela leu ou alterou?
- Os testes solicitados foram executados?
- A explicação corresponde ao diff?
- Falta alguma permissão, dependência ou decisão sua?
Normalmente, as threads na nuvem trabalham em branches separadas. Elas podem abrir pull requests quando solicitado e, em algumas correções concretas, também podem fazer isso por iniciativa própria.
Se aparecer Couldn’t start the session ou Unable to access your repository, revise a instalação do Claude GitHub App e o acesso ao repositório. Use a ação de recuperação mostrada no erro e depois inicie uma nova thread para a tarefa.
A coordenação não elimina conflitos de merge. Duas threads podem modificar os mesmos trechos de código, então revise as alterações antes de integrá-las.
Quando a primeira thread entregar um resultado correto, inicie uma segunda tarefa independente.
Como reduzir o consumo do Claude Code Projects
O primeiro passo para economizar é revisar o modelo e o esforço padrão antes de executar várias threads.
Segundo a Anthropic, um projeto novo utiliza Opus tanto no coordenador quanto nas threads. O esforço inicial das threads é high, enquanto o da conversa principal é low.
Essa configuração pode ser mais pesada do que o necessário para correções simples, testes pequenos e documentação.
Ajuste Thread model, esforço e Auto-continue
Abra Project settings > General.
| Configuração | Padrão de um novo projeto | Opção inicial para economizar |
|---|---|---|
| Thread model | Opus | Modelo menor disponível na sua conta |
| Thread effort | High | Medium ou low para tarefas limitadas |
| Coordinator model | Opus | Modelo menor para distribuir tarefas e informar o andamento |
| Coordinator effort | Low | Mantenha low se a coordenação estiver adequada |
| Auto-continue when usage limits reset | On | Off se o trabalho não deve recomeçar automaticamente |
As opções de modelo podem variar conforme a conta e a disponibilidade atual.
Mantenha Opus com high effort quando a tarefa exigir depuração difícil, decisões de arquitetura ou raciocínio mais elaborado.
Para alterações diretas e testes isolados, comece com um modelo menor e esforço reduzido. Se o resultado não for suficiente, aumente a configuração.
Os ajustes têm funções diferentes:
- Thread model e Thread effort controlam as sessões que executam o trabalho.
- Coordinator model e Coordinator effort controlam a conversa principal.
Você pode pedir outro modelo para uma tarefa nova. Para uma thread em andamento, use o seletor de modelo da própria thread.
Essas configurações pertencem à interface do Projects, não ao seu settings.json local.
Peça menos threads, mas não trate isso como um limite rígido
A Anthropic recomenda pedir ao coordenador que proponha as threads antes de começar.
Uma instrução útil seria:
Proponha as threads antes de iniciar o trabalho. Execute no máximo duas threads ao mesmo tempo. Responda perguntas pequenas nesta conversa sem abrir outra thread. Informe os resultados e os bloqueios. Espere minha aprovação antes de iniciar o próximo grupo.
Isso orienta o fluxo de trabalho, mas não estabelece um limite técnico de concorrência.
A Anthropic explica que a quantidade solicitada de threads simultâneas funciona como preferência, não como limite garantido.
O limite obrigatório é de 500 novas threads por dia, somando todos os seus Projects.
Isso não significa 500 sessões gratuitas nem garante a execução simultânea de 500 threads.
Confira em Overview quantas threads realmente foram iniciadas.
Onde os tokens são consumidos
A documentação de uso e custos do Projects apresenta quatro fontes importantes de consumo.
Threads em execução: cada thread é uma sessão completa. Várias sessões podem consumir sua franquia simultaneamente.
Coordenador: ler relatórios, decidir o próximo passo e responder no chat principal também consome tokens.
Monitoramento de pull requests: uma thread inativa pode voltar a trabalhar quando o CI falha ou chega um comentário de revisão.
Conversas longas: retomar uma thread antiga pode exigir a leitura de grande parte do histórico novamente.
Para o uso dentro dos limites incluídos nos planos Pro, Max e Ultra, a Anthropic informa uma validade de cache de uma hora.
Se uma thread ficar inativa por mais de uma hora, ela relê toda a conversa antes de processar uma nova mensagem.
Para trabalho realmente novo, iniciar outra thread pode consumir menos do que retomar uma conversa antiga e extensa.
Mas não crie uma thread nova para toda mensagem. Se a investigação anterior for necessária, manter o contexto pode ser mais útil.
A Anthropic não publica um multiplicador fixo de consumo para Projects. Não há base para afirmar que ele sempre gasta o dobro, o triplo ou cinco vezes a franquia de uma sessão.
O consumo depende do número de threads, dos modelos, do esforço, do tamanho do histórico e do trabalho repetido.
Em Project settings > Usage, você pode consultar o uso de tokens por thread, por modelo e pela conversa principal.
Para conhecer outra fonte de consumo fora do Projects, leia nossa análise dos tokens de agent_summary no Claude Code. Os números desse estudo não representam uma medição específica do custo adicional do Projects.
Um Project parado consome sua franquia?
Não, desde que não haja threads em execução, pull requests sendo monitorados nem mensagens novas.
Segundo a Anthropic, um projeto totalmente inativo não consome a franquia enquanto permanece parado. Projetos arquivados também não consomem.
Portanto, você não precisa apagar um projeto concluído apenas para economizar tokens.
O cuidado é com threads que continuam monitorando pull requests. Elas podem voltar a consumir recursos depois de eventos do CI ou de revisão.
Quando esse monitoramento não for mais necessário, peça à thread que pare de acompanhar o pull request.
O que acontece quando Projects atinge um limite de uso?
Projects compartilha os limites da assinatura com as demais sessões do Claude Code. Não existe uma reserva independente de tokens gratuitos.
Em 14 de novembro de 2026, as regras relevantes eram:
| Plano | Limites aplicáveis |
|---|---|
| Pro | Limite de sessão de cinco horas e limites semanais |
| Max | Limite de sessão de cinco horas e limites semanais |
| Ultra | Limites semanais; contas Ultra verificadas não têm limite de cinco horas |
Uma conta Ultra ainda não verificada pode ter um limite temporário de sessão.
A Anthropic explica a exceção na documentação do plano Ultra. Veja também nossa comparação dos limites de uso do Ultra e do Max.
Auto-continue pode consumir sua próxima janela de uso
Quando uma thread ou o coordenador atinge um limite aplicável, a execução para.
Por padrão, o trabalho interrompido recomeça automaticamente quando o limite é redefinido. Esse consumo entra na próxima janela.
Para impedir a retomada automática:
- Abra
Project settings > General. - Encontre Auto-continue when usage limits reset.
- Desligue a opção antes do horário de redefinição mostrado.
- Depois da redefinição, envie uma mensagem à thread ou conversa principal para continuar manualmente.
A configuração vale para todo o projeto, não somente para a thread aberta.
Desligar Auto-continue não desativa as opções de uso pago. Verifique essas opções separadamente.
Usage credits são diferentes da franquia incluída
Assinantes Pro, Max e Ultra podem ativar usage credits para pagar pelo consumo adicional.
Com esse recurso habilitado, solicitações elegíveis podem continuar após o limite incluído mediante cobrança. Uma thread do Projects não pode ativar usage credits por conta própria.
Antes de iniciar um grande lote de tarefas, abra Settings > Usage na sua conta Claude.
Se os usage credits estiverem ativos, configure um teto mensal de gastos. Desative-os se não quiser cobranças adicionais após o fim da franquia.
Esses créditos são diferentes dos API credits mensais incluídos nos planos Max e Ultra.
Se a thread mostrar Additional usage credits are required, o modelo ou tamanho de contexto solicitado pode exigir créditos que não estão habilitados.
Primeiro verifique se existe um modelo ou contexto disponível dentro do seu plano. Caso contrário, consulte as regras de usage credits da Anthropic antes de decidir pagar pelo uso adicional.
Projects, sessões locais do Claude Code ou T3 Code: qual escolher?
Escolha Projects quando precisar que Claude distribua e acompanhe tarefas relacionadas ao longo do tempo. Escolha sessões locais quando o controle do ambiente for mais importante.
| Alternativa | Melhor aplicação | Quem coordena | Principal limitação |
|---|---|---|---|
| Claude Code Projects | Trabalho relacionado entre sessões, repositórios ou vários dias | Coordenador do Claude | Apenas Anthropic como provedor, beta e limites compartilhados |
| Várias sessões locais do Claude Code CLI | Poucas tarefas independentes com ferramentas locais | Você | Precisa iniciar, acompanhar e coordenar as sessões |
| Claude Code agent view | Acompanhar várias sessões locais em uma tela | Você | Research preview; não tem coordenador do Projects |
| T3 Code | Gerenciar agentes locais, incluindo Claude Code e Codex | Você ou fluxos configurados | Exige agentes configurados e um computador hospedeiro |
Use sessões locais quando precisar de controle direto
Para duas tarefas independentes, duas sessões locais do Claude Code com Git worktrees podem ser suficientes.
Cada worktree fornece um checkout separado do repositório. Isso evita que sessões paralelas alterem acidentalmente os mesmos arquivos de trabalho.
Sessões locais podem usar ferramentas instaladas, hooks, configurações e provedores compatíveis. Elas não se tornam automaticamente threads do Projects.
O Claude Code também oferece claude agents, uma interface em research preview para iniciar e acompanhar várias sessões.
A Anthropic compara essas opções em Run agents in parallel.
Prefira esse caminho quando todas as tarefas precisarem de um banco de dados local, hooks personalizados ou serviços inacessíveis pelo ambiente de nuvem.
Use T3 Code para gerenciar agentes diferentes
O T3 Code é uma interface de código aberto para controlar agentes de programação executados no seu computador.
Sua documentação inclui Claude Code, Codex, Cursor, OpenCode e outros agentes compatíveis.
De acordo com o README público, o T3 Code reúne as threads em uma interface e permite conexões remotas. Cada thread também pode usar um Git worktree para manter suas alterações isoladas.
A ferramenta utiliza os agentes e métodos de autenticação que você configurar. O T3 Code não revende tokens.
Isso é útil para passar uma tarefa do Claude Code para o Codex ou acompanhar trabalho local por outro dispositivo.
Porém, o T3 Code não transforma sessões de terceiros em Claude Code Projects nem oferece o coordenador hospedado pela Anthropic.
O provedor subjacente continua determinando autenticação, disponibilidade e cobrança.
Confira nosso guia de configuração do T3 Code com Claude Code, Codex e gateways de API para seguir esse caminho.
É possível usar uma API key ou um provedor personalizado no Projects?
A Anthropic não documenta um caminho para configurar provedores personalizados no Projects.
As limitações oficiais dizem que tanto as threads na nuvem quanto aquelas executadas via Remote Control usam Anthropic como provedor do modelo.
Projects também não pode ser usado diretamente no CLI, na extensão do VS Code ou no plugin do JetBrains.
Se você precisa de um endpoint de API personalizado, escolha uma ferramenta local compatível ou uma interface de orquestração de terceiros. Verifique separadamente quais provedores ela aceita.
O acesso a modelos por API com pagamento por uso não substitui o coordenador do Projects, a elegibilidade da assinatura nem o gerenciamento das sessões na nuvem.
Configuração inicial para controlar o consumo
Se você tem uma conta Pro elegível e vários bugs pequenos em um serviço, comece assim:
- Crie um Project para o serviço e conecte apenas o repositório necessário.
- Defina as regras de branches, testes e aprovação em Project instructions.
- Escolha um Thread model menor e reduza Thread effort nas tarefas rotineiras.
- Mantenha Coordinator effort em low e avalie um Coordinator model menor.
- Peça sugestões de threads e aprove uma ou duas tarefas de cada vez.
- Desligue Auto-continue se precisar preservar a próxima janela de uso.
- Confira
Project settings > Usageapós o primeiro lote.
Reserve Opus com high effort para problemas que realmente justifiquem esse nível. Use /btw e /fork quando separar o contexto ajudar a investigar ou comparar soluções.
Para uma migração longa entre vários repositórios, Projects pode reduzir bastante a coordenação manual. Para poucas alterações locais, sessões independentes ou agent view podem ser mais simples.
Antes de aumentar o número de threads, confira como o coordenador está distribuindo as tarefas e quanto da sua franquia está sendo consumido.