Uma sessão na nuvem é uma sessão do Claude Code que é executada em infraestrutura de nuvem em vez de na sua máquina, funcionando com código de seus repositórios do GitHub. Você pode iniciar uma a partir do Claude Code na web em claude.ai/code, no Claude Mobile, no Claude Desktop ou no seu terminal com claude --cloud. Este artigo explica como as sessões na nuvem funcionam, quando usá-las em vez de uma sessão local no seu terminal ou IDE, e quais fluxos de trabalho elas permitem.
O que as sessões na nuvem oferecem
As sessões na nuvem permitem que você delegue tarefas ao Claude que são executadas sem sua supervisão ativa. Você seleciona um repositório do GitHub, descreve o que deseja fazer e o Claude trabalha na tarefa na nuvem. Depois que o Claude Code começar a trabalhar em uma tarefa, você pode sair da página completamente; o Claude continuará seu trabalho. Quando terminar, o Claude criará automaticamente um pull request com as alterações para você revisar.
Este recurso funciona com repositórios que você pode não ter na sua máquina local. Você pode iniciar tarefas em qualquer repositório do GitHub ao qual tenha acesso sem precisar cloná-lo localmente ou configurar um ambiente de desenvolvimento. Isso o torna útil para projetos aos quais você contribui ocasionalmente ou para explorar bases de código que ainda está aprendendo.
As sessões na nuvem permitem fluxos de trabalho de desenvolvimento assíncrono. Em uma sessão local no seu terminal ou editor, você normalmente trabalha de forma síncrona: você faz uma solicitação, aguarda a resposta do Claude, revisa as alterações e faz outra solicitação. O trabalho síncrono como este lhe dá controle refinado, mas requer sua atenção durante todo o processo. Uma sessão na nuvem funciona de forma diferente: você pode atribuir uma tarefa maior, deixar o Claude trabalhar independentemente e retornar mais tarde para revisar o trabalho concluído.
Você também pode executar várias tarefas em paralelo. Como cada tarefa é executada em seu próprio ambiente isolado, você pode ter o Claude trabalhando em vários problemas ou repositórios diferentes simultaneamente. Cada tarefa prossegue independentemente e cria seu próprio pull request quando concluída. Mais de uma tarefa pode trabalhar no mesmo repositório ao mesmo tempo.
Como funciona
Quando você inicia uma sessão na nuvem, o Claude Code cria uma máquina virtual isolada para seu trabalho. Seu repositório do GitHub é clonado neste ambiente, que vem pré-configurado com ferramentas de desenvolvimento comuns e ecossistemas de linguagem.
O Claude prepara o ambiente executando qualquer comando de configuração que você tenha definido na configuração do seu repositório. Isso inclui instalar dependências, configurar bancos de dados ou executar outras etapas de inicialização que seu projeto precisa. Se sua tarefa exigir acesso à rede, talvez para instalar pacotes ou buscar dados, você pode configurar o nível de acesso à internet que o ambiente possui.
Quando o ambiente está pronto, o Claude começa a trabalhar em sua tarefa. O Claude lê seu código, faz alterações, escreve testes e executa comandos para verificar o trabalho. Você pode monitorar o progresso e fornecer orientação através da interface web, se necessário.
Quando o Claude conclui a tarefa, ele envia as alterações para uma nova ramificação em seu repositório do GitHub. Você recebe uma notificação e pode revisar as alterações, depois criar um pull request diretamente da interface. O pull request inclui todo o trabalho do Claude, pronto para sua revisão e quaisquer alterações adicionais que você queira fazer.
Cada tarefa é executada em isolamento completo. A máquina virtual existe apenas para essa tarefa específica e inclui controles de segurança como acesso à rede restrito e tratamento de credenciais protegido. Sua autenticação do GitHub é gerenciada através de um proxy seguro, portanto as credenciais nunca existem diretamente no ambiente onde o Claude está trabalhando.
Quando usar sessões na nuvem vs. sessões locais
Algumas tarefas são bem adequadas para serem executadas de forma assíncrona na nuvem, enquanto outras são melhor executadas localmente no seu terminal ou IDE.
Use sessões na nuvem para:
Tarefas bem definidas com requisitos claros: Quando você pode descrever exatamente o que precisa ser feito e não espera precisar orientar o Claude durante a tarefa, uma sessão na nuvem permite que você inicie o trabalho e retorne quando estiver concluído.
Trabalho em segundo plano em backlogs de bugs: Você pode atribuir ao Claude vários problemas do seu backlog e deixá-los executar em paralelo. Cada tarefa prossegue independentemente, permitindo que você resolva vários problemas de uma vez sem monitorar cada um individualmente.
Repositórios que você não tem localmente: Se você precisar fazer alterações em um repositório que não clonou ou não deseja configurar na sua máquina, uma sessão na nuvem cuida da configuração do ambiente para você.
Tarefas que você deseja enfileirar: Quando você tem uma lista de alterações a fazer, mas não quer trabalhar nelas agora, você pode iniciá-las na nuvem e revisar os resultados mais tarde. Isso permite que você agrupe trabalho semelhante ou delegue tarefas durante momentos em que está focado em outra coisa.
Use sessões locais no seu terminal ou IDE para:
Tarefas que precisam de correção frequente de curso: Quando você não tem certeza exatamente qual é a abordagem correta ou espera que precise redirecionar o Claude com base no que vê, trabalhar no seu terminal oferece feedback imediato. Você pode ajustar a direção enquanto o Claude trabalha em vez de esperar por um resultado completo.
Trabalho exploratório com requisitos pouco claros: Se você está descobrindo como resolver um problema ou investigando diferentes abordagens, o terminal permite que você refine sua solicitação conforme aprende. A interação ajuda a esclarecer requisitos que não eram óbvios no início.
Desenvolvimento local com alterações não confirmadas: Quando você está desenvolvendo ativamente e tem trabalho não confirmado em seu repositório local, usar o Claude Code no seu terminal mantém tudo em um só lugar. Você pode iterar rapidamente sobre as alterações sem precisar confirmar ou enviar trabalho que ainda não está pronto.
Tarefas que exigem feedback imediato: Se você precisa ver resultados rapidamente e deseja iterar rapidamente, o terminal oferece latência mais baixa. Você pode observar o Claude trabalhar em tempo real e parar ou redirecionar se algo der errado no início do processo.
Exemplos de casos de uso
Alterações de backend com desenvolvimento orientado por testes
Deixe o Claude escrever testes que definem o comportamento esperado e depois implemente o código para fazer esses testes passarem. Isso funciona particularmente bem para alterações de backend onde o comportamento pode ser validado através de testes automatizados.
Exemplo de prompt:
Add rate limiting to the /api/search endpoint.
The rate limiter should:
- Allow 100 requests per minute per API key
- Return 429 status when limit exceeded
- Reset limits after 60 seconds
- Track different API keys independently
Use a TDD approach: write comprehensive tests first, then implement the rate limiting logic to pass them.
Quando usar esta abordagem: Isso funciona bem em uma sessão na nuvem porque os testes dão ao Claude critérios de validação claros para trabalhar. Você não precisa monitorar o progresso do Claude, pois os testes detectarão problemas e guiarão a iteração para uma solução funcional. A natureza autossuficiente da tarefa, onde o Claude escreve testes e depois os faz passar, não requer sua entrada uma vez iniciada.
O que torna isso eficaz: O Claude pode iterar na implementação sem sua supervisão, usando falhas de teste para identificar e corrigir problemas. A tarefa leva mais tempo do que uma simples alteração de código, mas você pode deixá-la ser concluída em segundo plano. Quando você revisa o pull request, tanto os testes quanto a implementação estão prontos, e você tem confiança de que a solução funciona porque os testes passam.
Atualizações de documentação
Gere ou atualize documentação técnica, como arquivos README, documentação de API, comentários de código ou guias do usuário.
Exemplo de prompt:
Update CHANGELOG.md with all changes since the v2.3.0 release:
- Review commits on main branch since that tag.
- Categorize changes into "Added, "Changed, "Fixed", and "Removed" sections.
- Include the commit hash for each entry.
Quando usar esta abordagem: As atualizações de changelog são bem adequadas para uma sessão na nuvem porque o Claude pode revisar o histórico de commits independentemente e formatar entradas sem orientação. A tarefa é tediosa de fazer manualmente, mas direta o suficiente para que o Claude a conclua sem dúvidas sobre quais commits incluir ou como categorizá-los.
O que torna isso eficaz: Você pode delegar a atualização completa do changelog e revisar o resultado quando concluído. O Claude lê os commits, extrai alterações significativas e segue seu formato de changelog existente.
Refatoração com escopo claro
Reestruture o código para melhorar a organização ou legibilidade quando você pode definir limites claros para a alteração. Isso inclui extrair código, dividir arquivos grandes ou organizar a estrutura do módulo.
Exemplo de prompt:
The UserService class in /src/services/user.go has 800 lines long.
Split it into three focused services:
- UserAuthService (login/logout/sessions)
- UserProfileService (profile CRUD operations)
- UserPreferencesService (settings/preferences)
Ensure all tests still pass.
Quando usar esta abordagem: A refatoração com restrições claras funciona bem em uma sessão na nuvem porque você pode definir limites claros para o Claude seguir. Os conjuntos de testes podem fornecer validação, permitindo que o Claude verifique se a refatoração não quebrou nenhuma funcionalidade existente.
O que torna isso eficaz: A tarefa leva tempo, mas não precisa de sua entrada ativa uma vez que a estrutura é definida. Você pode iniciar a refatoração e revisar o resultado organizado mais tarde, em vez de monitorar o Claude enquanto trabalha na tarefa. O escopo claro significa que o Claude é improvável que precise de orientação durante a tarefa.
Dicas para uso eficaz
Considere adicionar um conjunto de testes ao seu repositório para que o Claude verifique mais facilmente que concluiu uma tarefa com sucesso
Especifique critérios de sucesso em vez de objetivos vagos como "melhorar" ou "corrigir"
Defina o que deve mudar e o que deve permanecer igual em seu prompt
Escopo de tarefas com limites claros para que o Claude não precise de orientação durante a tarefa
Se você está pensando "Vou precisar ver como isso vai primeiro", considere usar seu terminal
Use "Abrir no CLI" se você perceber durante a tarefa que precisa fornecer orientação