O que são as sessões na nuvem do Claude Code? Como seguem rodando com o notebook fechado, como começar e como resgatar o crédito de US$ 100 no Pro / US$ 250 no Max

Em 24 de setembro de 2026 (por volta das 6h23 no horário do Japão, JST), a conta oficial do Claude Code @ClaudeDevs anunciou que as sessões na nuvem saíram do research preview e estão disponíveis oficialmente. Ao mesmo tempo, quem já assina um plano pago está recebendo um crédito único para experimentar (US$ 100 no Pro, US$ 250 no Max).

As sessões na nuvem rodam o Claude Code na nuvem da Anthropic, e não no seu computador. O seu repositório do GitHub é clonado numa máquina virtual na nuvem, onde o Claude edita o código, roda os testes e faz push de uma branch. Fechar o notebook não interrompe o trabalho. Dá também para acompanhar e responder pelo celular.

Este artigo se baseia na documentação oficial do Claude Code (Use Claude Code in the cloud, Configure cloud environments e Get started with Claude Code in the cloud), nos posts da @ClaudeDevs e no texto integral dos termos da oferta de crédito para explicar o que as sessões na nuvem fazem, o que não fazem, quanto custam e como resgatar o crédito. As informações valem para 24 de setembro de 2026.

1. O que são as sessões na nuvem: quem trabalha não é o seu computador

A definição da documentação oficial é curta: uma sessão do Claude Code que roda em infraestrutura de nuvem, e não na sua máquina. Por padrão ela roda em infraestrutura gerenciada pela Anthropic (se a sua organização tiver um ambiente próprio auto-hospedado, as sessões podem ser direcionadas para lá). O claude.ai/code, que você abre no navegador, também é chamado de "Claude Code on the web" e é uma das formas de iniciar uma sessão na nuvem.

Quando você envia uma tarefa, é isto que acontece na nuvem.

A etapa ④ é fácil de entender errado. O pull request não é aberto sozinho: quem cria é você, com "Create PR" na tela do diff (como PR completo, como rascunho ou indo direto para a página de criação do GitHub). A sessão não se encerra depois do push da branch, então a criação do PR e os ajustes seguintes acontecem na mesma conversa.

A sessão continuar depois que você fecha a aba é proposital. Segundo a documentação oficial, fechar a aba não interrompe a sessão, que segue rodando em segundo plano até o Claude terminar a tarefa atual e então fica ociosa. Se ela continuar ociosa, porém, a máquina virtual é recolhida. O histórico da conversa é mantido, e reabrir a sessão pelo claude.ai/code a retoma numa VM nova, mas subagents ou comandos de shell que estavam rodando naquele momento não são restaurados.

As sessões na nuvem estão disponíveis nos planos Pro, Max e Team, e para usuários Enterprise com licenças premium ou licenças Chat + Claude Code. Organizações com Zero Data Retention ativado não podem usá-las.

2. Em que diferem do Claude Code local e do Remote Control

A documentação oficial resume assim: o Claude Code se comporta igual em todo lugar; o que muda é onde a sessão roda e se a sua configuração local está disponível. Há duas coisas com que comparar: a sessão local, que você roda num terminal ou IDE, e o Remote Control, que permite comandar uma sessão local pelo celular ou pelo navegador.

A linha que mais pesa é "a configuração local não é usada". Toda sessão na nuvem começa de um clone novo do repositório, então só vem junto o que está commitado no repositório. Resumindo as listas da documentação oficial:

• Vem junto: o CLAUDE.md do repositório, .claude/rules/, .claude/skills/, agents/ e commands/, além das configurações gerenciadas pelo servidor da sua organização. Numa sessão com um único repositório, também os hooks e as regras de permissão de .claude/settings.json e o .mcp.json
• Não vem junto: o seu ~/.claude/CLAUDE.md e o ~/.claude/skills/, servidores MCP que você adicionou só localmente com claude mcp add, plugins ativados só nas suas configurações de usuário e autenticação que exige login pelo navegador, como o AWS SSO

Os modos de permissão também mudam. Numa sessão na nuvem você pode escolher Auto (um classificador revisa as ações do Claude; só aparece se a sua organização permitir e o modelo selecionado tiver suporte), Accept edits (as alterações são feitas e a branch recebe o push sem esperar aprovação) ou Plan (o Claude propõe uma abordagem e espera a sua aprovação). Não existe o modo Manual, em que você aprova cada ação, nem o Bypass permissions, que pula as verificações. Quanto aos comandos, /compact e /context funcionam, mas /clear não; para recomeçar, você abre uma nova sessão pela barra lateral. /model e /effort não abrem um seletor, então você os digita já com o valor, como em /model sonnet.

Se o que você quer é comandar a sua própria máquina, com os arquivos e a rede dela, de outro lugar, a ferramenta certa é o Remote Control, não a nuvem. O nosso guia do Remote Control compara os dois em detalhe.

3. Como começar pelo navegador ou pelo terminal

Há cinco portas de entrada: o claude.ai/code no navegador, a aba Code do app Claude para celular, uma sessão do app de desktop iniciada com Cloud selecionado no lugar de Local, o claude --cloud no terminal e as routines (execuções disparadas por agendamento ou por evento). A orientação oficial é fazer a primeira pelo navegador.

Pelo navegador (a sua primeira sessão)

1. Abra o claude.ai/code e faça login
2. Conecte o GitHub: siga as instruções e aprove na tela de autorização do GitHub. Isso libera o trabalho com repositórios públicos
3. Para usar repositórios privados, instale o Claude GitHub App: só é possível trabalhar em repositórios privados onde o app estiver instalado. Numa organização do GitHub, pode ser necessária a aprovação de um owner da organização
4. Um ambiente Default é criado: no Pro e no Max, ele é criado automaticamente. No Team e no Enterprise aparece um formulário de criação; mantenha os valores padrão e clique em "Create & finish"
5. Escolha um repositório, uma branch e um modo de permissão, depois escreva e envie a tarefa

Na hora de escrever a tarefa, a documentação oficial recomenda nomear o arquivo ou a função em vez de só pedir para "consertar os testes", colar a saída do erro se você a tiver e descrever o comportamento esperado, não apenas o sintoma. Cada tarefa ganha a própria sessão e a própria branch, então dá para enviar a próxima sem esperar a anterior terminar.

Pelo terminal

Se você já usa o GitHub CLI (gh) localmente, também pode digitar /web-setup dentro do Claude Code. O comando envia o seu token do gh para a Anthropic, onde ele fica guardado criptografado na sua conta do claude.ai, e qualquer repositório que esse token alcance passa a ser utilizável sem instalar o app. No Team e no Enterprise, o comando só aparece depois que um Owner da organização ativa o "Quick web setup".

Depois de conectado, você pode enviar tarefas direto do terminal.

# Inicia uma nova sessão na nuvem para o repositório em que você está
claude --cloud "Fix the authentication bug in src/auth/login.ts"

# Envia uma instrução complementar para uma sessão na nuvem em andamento
claude -p "Add tests too" --cloud <session-id>

# Traz uma sessão na nuvem para o seu terminal local
claude --teleport

Uma sessão iniciada com --cloud clona a sua branch atual no GitHub, e não a sua cópia de trabalho local. Commits que só existem na sua máquina não estarão lá, então faça o push antes. Também não dá para levar uma sessão local para a nuvem pela CLI (só o caminho inverso, com --teleport). O app de desktop, por sua vez, tem um menu "Continue in" que envia uma sessão local para a nuvem.

Para usar isso pelo terminal, o Claude Code precisa estar logado com uma conta do claude.ai. Com autenticação por chave de API, ou quando ele está configurado para um provedor terceiro como o Amazon Bedrock ou o Agent Platform do Google Cloud, nem --cloud nem --teleport funcionam.

4. Ambientes, acesso à rede e segredos

Toda sessão na nuvem roda dentro de um "ambiente de nuvem". Um ambiente é uma configuração salva que reúne o nível de acesso à rede, as variáveis de ambiente e um script de setup. O ambiente Default com que você começa tem acesso à rede Trusted (veja abaixo) e nenhuma variável de ambiente nem script.

O que há dentro da VM

Nos ambientes gerenciados pela Anthropic, cada sessão recebe uma máquina virtual nova com Ubuntu 24.04 (x86_64). Mesmo que você use Mac ou Windows, lá dentro é Linux, então dependências com binários nativos usam as builds de Linux x86_64. Python, Node.js (20/21/22), Ruby, PHP 8.3, Java 21, Go, Rust, C/C++, Docker, PostgreSQL 16, Redis 7.0 e outros já vêm instalados. Os recursos aproximados são 4 vCPUs, 16GB de RAM e 30GB de disco, e a documentação oficial avisa que esses valores podem mudar. Trabalhos que passam bem da memória, como uma build grande, podem ser encerrados à força.

Ferramentas que não vêm instaladas vão no script de setup do ambiente (Bash, executado como root). O script roda uma vez na primeira sessão; depois disso o estado do sistema de arquivos é salvo e reaproveitado, e as sessões seguintes começam mais rápido. As exigências são que o script termine em cerca de cinco minutos e não falhe (um código de saída diferente de zero impede a sessão de iniciar). O estado salvo é reconstruído mais ou menos a cada sete dias.

Os 4 níveis de acesso à rede

Atenção: None não corta tudo. O tráfego para o GitHub passa por um proxy dedicado, os conectores MCP que você ativar passam pelos servidores da Anthropic, e o próprio Claude Code conversa com a API da Anthropic. A documentação oficial é direta: "When running with network access disabled, Claude Code can still communicate with the Anthropic API, which may allow data to exit the VM." Ou seja, mesmo com a rede desativada, dados podem sair da VM por esse caminho.

Onde guardar segredos

• As suas credenciais do GitHub nunca entram na VM: um proxy usa credenciais com escopo limitado em nome da sessão. O git push só funciona para a branch de trabalho daquela sessão
• Variáveis de ambiente podem ser lidas por todos que usam o ambiente: a própria tela de configuração traz um aviso para não colocar segredos ali
• Coloque chaves de API em "API credentials" (só Pro e Max): o proxy da Anthropic anexa a chave apenas às requisições destinadas aos hosts que você indicar. A chave não fica visível nem para o Claude nem para os comandos que ele executa. Ainda não está disponível no Team e no Enterprise

5. Preço: o uso normal do seu plano mais um crédito por tempo limitado

O modelo de cobrança é simples. A documentação oficial diz que as sessões na nuvem dividem os limites de uso com todo o resto do Claude e do Claude Code na sua conta e afirma que não há cobrança de computação à parte pela VM na nuvem. Se você rodar tarefas em paralelo, os limites se esgotam proporcionalmente mais rápido.

Às 10h57 (JST) do mesmo dia, a @ClaudeDevs publicou um post complementar que começava pedindo desculpas pela confusão. Em resumo: as sessões na nuvem rodam no seu plano Pro ou Max como o resto do Claude Code, e este crédito é uma promoção opcional e única que as sessões na nuvem consomem primeiro, antes de voltar ao uso normal do plano.

O que o Claude Code local mostra quando você atinge o limite, e o que fazer nesse caso, está no nosso artigo sobre o limite de uso.

O texto integral dos termos da oferta (Claude Promotional Credit Offer Terms) traz várias cláusulas que vale conhecer antes de resgatar.

• O crédito não tem valor em dinheiro e não pode ser transferido
• Se você cancelar a assinatura, voltar para o plano gratuito ou tiver a conta suspensa, o crédito é perdido e não é restituído, salvo indicação em contrário
• Ele é concedido na moeda da sua conta de cobrança; se ela for diferente da moeda anunciada, a Anthropic converte a uma taxa escolhida por ela e pode arredondar para um valor conveniente
• A Anthropic pode alterar ou encerrar a oferta sem aviso e pode revogar créditos ou retirar a sua elegibilidade se concluir que houve fraude, abuso ou violação dos termos. A palavra final sobre elegibilidade e valores é da Anthropic
• Ao participar, você concorda que a Anthropic pode ativar o "Usage Credit" na sua conta, caso ainda não esteja ativado

Esse último ponto passa despercebido com facilidade, então, depois de resgatar, vale abrir uma vez as configurações de cobrança do claude.ai e conferir se tudo está como você pretende.

6. Como resgatar o crédito, e um alerta sobre contas

O passo a passo está num post da @ClaudeDevs.

1. No navegador, abra a página de resgate (claude.ai/code/claim-credit). No terminal, digite /claim-credit no Claude Code
2. Conecte o GitHub: o post diz "You'll need GitHub connected to start a session." Se ainda não conectou, siga os passos de "3. Como começar"
3. Inicie uma sessão na nuvem: o crédito é consumido primeiro, automaticamente

Observe que, em 24 de setembro de 2026, o /claim-credit ainda não aparece na documentação de comandos nem no CHANGELOG. A única fonte é o post da @ClaudeDevs. Se o comando não aparecer quando você digitar, resgatar pela página no navegador é o caminho garantido.

7. Onde as sessões na nuvem se encaixam, e onde não

A documentação oficial separa com clareza os trabalhos em que as sessões na nuvem vão bem daqueles que devem ficar na sua máquina.

Sobre repositórios fora do GitHub: para um repositório sem remote, ou um repositório do github.com sem o Claude GitHub App instalado, o claude --cloud inicia a sessão enviando o seu repositório local como um bundle. Dá para fazer o mesmo com GitLab ou Bitbucket definindo CCR_FORCE_BUNDLE=1. O bundle precisa ter menos de 100MB, arquivos não rastreados ficam de fora e não é possível fazer push do resultado de volta para aquele repositório do GitLab ou do Bitbucket.

Se você precisa do ambiente local, mas ainda quer rodar coisas em paralelo, o agent view, que roda várias sessões lado a lado na sua própria máquina, é a melhor opção.

8. O que saber antes de começar

Compartilhar como público significa "qualquer pessoa logada no claude.ai"

No Pro e no Max, a visibilidade de uma sessão é Private ou Public. Public a torna visível para qualquer usuário logado no claude.ai, e a verificação de acesso ao repositório não vem ativada por padrão. A documentação oficial avisa: "Sessions may contain code and credentials from private GitHub repositories." Ou seja, uma sessão pode conter código e credenciais de repositórios privados. As opções para exigir que os destinatários tenham acesso ao repositório, ou para ocultar o seu nome, ficam em Settings > Claude Code > Sharing settings no claude.ai.

O Auto-fix responde com a sua conta do GitHub

Em repositórios com o Claude GitHub App instalado, você pode usar o Auto-fix, que acompanha um PR e responde automaticamente a falhas de CI e comentários de revisão (no terminal, é o /autofix-pr). Essas respostas são publicadas com a sua conta do GitHub (identificadas como escritas pelo Claude Code). Em repositórios que usam Atlantis, Terraform Cloud ou GitHub Actions disparadas por issue_comment, um comentário pode disparar mudanças de infraestrutura, por isso a documentação oficial sugere desligar o Auto-fix nesses repositórios.

Arquivos secretos ao enviar da sua máquina

Quando o seu repositório local é enviado como bundle no macOS, no Linux e no WSL, alterações não commitadas em arquivos com nomes como .env, *.tfvars, id_rsa ou *.pem ficam de fora. Dito de outro modo, as versões commitadas são enviadas, e esses três ambientes são os únicos que a documentação oficial cita para essa exclusão. Ela não diz se a mesma exclusão vale no Windows nativo, então confira o que está enviando antes de enviar.

Outros pontos

• Excluir não tem volta: excluir pela barra lateral ou pelo menu da sessão remove a sessão e os dados dela de forma permanente. Se a ideia é só organizar, arquivar basta
• Se a sua organização usa lista de IPs permitidos, tudo falha: as sessões na nuvem chamam a API a partir da infraestrutura da Anthropic, então será preciso pedir uma exceção ao suporte
• Hooks SessionStart do nível de usuário não vêm junto: hooks em ~/.claude/settings.json ficam na sua máquina. O que você quiser rodar também na nuvem deve ir para as configurações do repositório

9. Sessões na nuvem ou Projects: quem faz o quê

O Projects do Claude Code, reconstruído em 17 de setembro, também roda na nuvem. Por baixo dos panos, cada "thread" de um projeto é uma sessão na nuvem. A diferença está em quem distribui as tarefas.

O fato de o crédito cobrir só as sessões na nuvem pesa diretamente na forma de dividir o trabalho. Se você vai experimentar com o crédito, comece pelas sessões na nuvem, enviando as tarefas você mesmo, uma de cada vez, e passe para o Projects quando o trabalho virar algo de longo prazo. Essa é a ordem natural. O nosso artigo sobre o Projects detalha as condições de liberação e a velocidade com que ele consome tokens.

Resumo

As sessões na nuvem são o recurso para rodar o Claude Code desvinculado do seu próprio computador. Entregue um repositório do GitHub e escreva uma tarefa: o Claude trabalha numa VM na nuvem, faz push de uma branch e fica esperando. Ele continua quando você fecha o notebook, dá para responder pelo celular e não há cobrança à parte pela VM.

Em troca, a sua configuração e as suas ferramentas locais não vêm junto, o GitHub é pressuposto e não dá para aprovar cada passo. A divisão mais simples é manter na sua máquina ou no Remote Control o trabalho que depende do ambiente local, e mandar para a nuvem as tarefas pontuais bem definidas e tudo o que você quiser rodar em paralelo.

Se você já assina Pro ou Max, resgate até 7 de outubro e o crédito será consumido primeiro até 5 de novembro, 16h59 JST. É uma janela para experimentar sem se preocupar com os limites, então comece enviando uma tarefa pequena e veja como fica o diff e quanto tempo leva para voltar.

FAQ

P. Dá para usar no plano gratuito?

R. Não. A documentação oficial lista Pro, Max e Team, além de usuários Enterprise com licenças premium ou licenças Chat + Claude Code. Este crédito também é só para quem já assina Pro ou Max.

P. As sessões na nuvem custam a mais?

R. Não há cobrança de computação à parte pela VM. Elas consomem os limites de uso do seu plano, os mesmos do Claude Code local e do chat. Se você resgatou o crédito distribuído a partir de 24 de setembro, ele é consumido primeiro e, quando acaba ou vence, você volta aos limites normais.

P. Posso usar o crédito no Projects ou nas Routines?

R. Não. A tela de resgate diz que Projects e Routines ficam de fora. As execuções de routines também rodam como sessões na nuvem, mas foram excluídas do que o crédito cobre.

P. Dá para experimentar sem usar o GitHub?

R. Para iniciar uma sessão, o GitHub precisa estar conectado. Dito isso, o claude --cloud também consegue iniciar uma sessão enviando um repositório local sem remote do GitHub (menos de 100MB, e o resultado não pode voltar para o GitLab ou similares). Se você não quer conectar o GitHub, a alternativa que a documentação oficial aponta é o Remote Control, que roda na sua própria máquina e permite acompanhar pelo navegador ou pelo celular.

P. Posso levar para a nuvem um trabalho que comecei localmente?

R. Não pela CLI. O --teleport só traz uma sessão da nuvem para a sua máquina. O --cloud cria uma sessão nova e clona a sua branch atual no GitHub. O app de desktop tem um menu "Continue in" que envia uma sessão local para a nuvem.

P. O que acontece se o Claude me fizer uma pergunta e eu deixar sem resposta?

R. Até o ambiente expirar, você pode voltar, responder e seguir dali. Mesmo depois que ele expira e a VM é recolhida, reabrir a sessão pelo claude.ai/code provisiona uma VM nova com o histórico da conversa. Subagents ou comandos de shell que estavam rodando em segundo plano naquele momento, porém, não são restaurados.