Skip to main content
As sessões em nuvem estão disponíveis nos planos Pro, Max e Team, e para usuários Enterprise com assentos premium ou assentos Chat + Claude Code.
Uma sessão em nuvem é uma sessão Claude Code que é executada em infraestrutura em nuvem em vez de em sua máquina. Por padrão, ela é executada em infraestrutura que a Anthropic gerencia, ou no ambiente auto-hospedado da sua organização quando roteada para lá. A sessão continua em execução depois que você fecha seu laptop, e você pode verificá-la ou direcioná-la a partir de qualquer dispositivo. Você pode iniciar uma sessão em nuvem a partir de qualquer uma dessas superfícies: Para que Claude inicie e acompanhe muitas sessões em nuvem para um corpo de trabalho, use um projeto. Uma sessão em seu terminal, seu IDE, ou o aplicativo Desktop com Local selecionado é executada em sua própria máquina. Para direcionar uma dessas sessões locais a partir do seu telefone ou navegador, use Controle Remoto.
Novo em sessões em nuvem? Comece com Começar para conectar sua conta GitHub e enviar sua primeira tarefa.
Esta página cobre:

​
Ambientes em nuvem

Cada sessão em nuvem é executada em um ambiente em nuvem, a configuração salva que controla acesso à rede, variáveis de ambiente e scripts de configuração. Se você ainda não tem um ambiente, o onboarding configura um ambiente Default com acesso à rede Trusted, criando-o para você ou pedindo que você o crie. Veja O ambiente Default para saber qual desses acontece no seu plano e como as sessões escolhem um ambiente quando você tem mais de um. Os mesmos ambientes se aplicam em qualquer lugar que você inicie uma sessão em nuvem: a web, o terminal, Claude Tag, routines e os aplicativos móvel e Desktop. As sessões de canal Claude Tag usam apenas ambientes no nível da organização, seja ambientes compartilhados ou ambientes auto-hospedados. Veja Configurar ambientes em nuvem para alterar o que um ambiente permite, definir variáveis ou adicionar um script de configuração, e Ferramentas instaladas para o que as sessões incluem sem nenhuma configuração.

​
Opções de autenticação do GitHub

As sessões em nuvem precisam de acesso aos seus repositórios GitHub para clonar código e enviar branches. Você pode conceder acesso de duas maneiras: A instalação do Claude GitHub App em um repositório também habilita Auto-fix para pull requests nele. As threads em um projeto precisam que o Claude GitHub App esteja instalado em cada repositório que elas clonam, independentemente do método com o qual você se conectou. Consulte Configurar acesso ao GitHub. Em ambientes hospedados pela Anthropic, suas credenciais do GitHub permanecem criptografadas nos servidores da Anthropic e nunca entram na VM de uma sessão. As operações do GitHub da VM passam pelo proxy do GitHub, que anexa a credencial no lado do servidor. Para saber como /schedule verifica o acesso ao repositório antes de criar uma routine, consulte Repositórios e permissões de branch. Consulte Conectar a partir do seu terminal para o passo a passo de /web-setup, incluindo o que /web-setup armazena e como removê-lo. Quick web setup é uma configuração de organização que permite que membros conectem o GitHub com /web-setup, pula o prompt de instalação do Claude GitHub App durante o onboarding do navegador e faz com que o onboarding do navegador crie o ambiente Default para eles em vez de mostrar o formulário de ambiente. Nos planos Team e Enterprise está desabilitado por padrão, o que oculta /web-setup. Um Owner o ativa com o toggle Quick web setup em Admin settings > Claude Code.
Organizações com Zero Data Retention habilitado não podem usar /web-setup ou outros recursos de sessão em nuvem.

​
Mover tarefas entre terminal e nuvem

Esses fluxos de trabalho exigem o Claude Code CLI conectado à mesma conta claude.ai. Você pode iniciar novas sessões na nuvem a partir do seu terminal, ou puxar sessões na nuvem para seu terminal para continuar localmente. As sessões na nuvem persistem mesmo se você fechar seu laptop, e você pode monitorá-las de qualquer lugar, incluindo o aplicativo móvel Claude.
A partir da CLI, a transferência de sessão é unidirecional: você pode puxar sessões na nuvem para seu terminal com --teleport, mas não pode enviar uma sessão de terminal existente para a nuvem. O sinalizador --cloud com uma descrição de tarefa cria uma nova sessão na nuvem para seu repositório atual; com -p e um ID de sessão ou URL claude.ai/code, ele enfileira uma mensagem nessa sessão existente. O aplicativo Desktop fornece um menu Continue in que pode enviar uma sessão local para a nuvem.

​
Do terminal para a nuvem

Inicie uma sessão na nuvem a partir da linha de comando com o sinalizador --cloud:
Isso cria uma nova sessão na nuvem em claude.ai. A VM na nuvem clona o remoto GitHub do diretório atual em sua ramificação atual, não seu checkout local, portanto, faça push primeiro se você tiver commits locais. Consulte Enviar repositórios locais sem GitHub para os casos em que Claude Code carrega seu repositório local em vez de clonar. --cloud funciona com um único repositório por vez. A tarefa é executada na nuvem enquanto você continua trabalhando localmente. A ortografia --remote mais antiga ainda funciona como um alias descontinuado para --cloud. Enquanto o contêiner na nuvem inicia, a CLI mostra uma lista de verificação ao vivo das etapas de configuração, como clonar o repositório e executar seu script de configuração. Ela enfileira mensagens que você digita durante o provisionamento e as envia assim que a sessão estiver pronta.
--cloud cria sessões na nuvem. --remote-control não está relacionado: permite que você monitore e dirija uma sessão CLI local a partir de claude.ai ou do aplicativo Claude. Consulte Remote Control.
Abra a sessão em claude.ai ou no aplicativo móvel Claude para verificar o progresso ou interagir diretamente. De lá, você pode dirigir Claude, fornecer feedback ou responder perguntas como em qualquer outra conversa. Se Claude fizer uma pergunta e a sessão ficar ociosa, você ainda pode responder quando voltar, até expiração do ambiente, e a sessão continua a partir de sua resposta.

​
Dicas para tarefas na nuvem

Planeje localmente, execute na nuvem: para tarefas complexas, inicie Claude no modo de plano para colaborar na abordagem, depois envie o trabalho para a nuvem:
No modo de plano, Claude lê arquivos, executa comandos para explorar e propõe um plano sem editar código-fonte. Depois de estar satisfeito, salve o plano no repositório, faça commit e push para que a VM na nuvem possa cloná-lo. Em seguida, inicie uma sessão na nuvem para execução autônoma:
Execute tarefas em paralelo: cada comando --cloud cria sua própria sessão na nuvem que é executada independentemente. Você pode iniciar várias tarefas e todas serão executadas simultaneamente em sessões separadas:
Quando uma sessão é concluída, você pode criar um PR a partir de claude.ai/code ou teleportar a sessão para seu terminal para continuar trabalhando.

​
Enviar repositórios locais sem GitHub

Quando você executa claude --cloud a partir de um repositório que não tem um remoto git, ou a partir de um repositório github.com no qual o Claude GitHub App não está instalado, Claude Code agrupa seu repositório local e o carrega diretamente para a sessão na nuvem. Isso se aplica mesmo se você conectou GitHub com /web-setup. O pacote inclui seu histórico completo de repositório em todas as ramificações, além de alterações não confirmadas em arquivos rastreados. No macOS, Linux e WSL, Claude Code deixa alterações não confirmadas em arquivos nomeados como credenciais ou chaves fora do upload e nomeia os arquivos que deixou de fora. Isso cobre arquivos .env, arquivos Terraform *.tfvars e arquivos de chave como id_rsa e *.pem. A sessão inicia com a versão confirmada de cada um, ou sem o arquivo se nenhum estiver confirmado. Para carregar um pacote mesmo quando Claude Code clonaria do remoto, defina CCR_FORCE_BUNDLE=1:
Os repositórios agrupados devem atender a esses limites:
  • O diretório deve ser um repositório git com pelo menos um commit
  • O repositório agrupado deve ter menos de 100 MB. Repositórios maiores voltam a agrupar apenas a ramificação atual, depois a um único snapshot compactado da árvore de trabalho, e falham se o snapshot ainda for muito grande
  • Arquivos não rastreados não são incluídos; execute git add em arquivos que você deseja que a sessão na nuvem veja
  • Sessões criadas a partir de um pacote podem fazer push de volta para um remoto GitHub apenas quando sua conexão GitHub tem acesso de push a esse repositório

​
Enviar acompanhamentos a partir da CLI

Depois que uma sessão na nuvem está em execução, onde quer que seja executada, envie uma mensagem de acompanhamento a partir da CLI claude em qualquer máquina onde você esteja conectado com claude auth login. A CLI autentica com suas credenciais de conta Anthropic e não envia nenhum estado de sessão local, portanto o comando não precisa ser executado a partir da máquina que iniciou a sessão, e é o mesmo em cada shell, incluindo PowerShell. O comando publica uma mensagem e sai:
A CLI enfileira a mensagem na sessão e sai sem esperar por uma resposta. Use-a para dirigir uma sessão de longa duração, enfileire a próxima etapa enquanto a atual ainda está terminando, ou envie acompanhamentos a partir de um script CI. Você também pode canalizar a mensagem em stdin em vez de passá-la como um argumento: echo "your message" | claude -p --cloud <session-id>. Para <session-id>, passe o ID simples, como session_... ou cse_..., ou a URL claude.ai/code/<id> da sessão, com ou sem o esquema ou string de consulta. Encontre o ID em sua lista de sessões em claude.ai/code.
--cloud requer uma conta Anthropic. Não está disponível quando Claude Code é configurado para Amazon Bedrock, Google Cloud’s Agent Platform ou outro provedor de terceiros. Um gateway LLM configurado apenas através de ANTHROPIC_BASE_URL não conta como um provedor de terceiros para esta verificação, mas você ainda precisa se conectar com claude auth login. A política allow_remote_sessions da sua organização também deve estar habilitada. Um Owner pode ativá-la nas configurações de administrador do Claude Code em claude.ai/admin-settings/claude-code.

​
Saída e erros

Com sucesso, o comando imprime o ID da sessão e um link para visualizar a sessão:
Passe --output-format json para um resultado legível por máquina: {ok, session_id, url} com sucesso, ou {ok: false, session_id, error} quando o envio falha, por exemplo quando a sessão está ausente ou arquivada. Erros de configuração, como um provedor não suportado ou uma política organizacional desabilitada, são impressos em stderr sem JSON. --output-format stream-json não é suportado com --cloud <session-id>. A CLI prefixos erros com Error: . Uma entrega com falha é envolvida como failed to send message to cloud session <id>: <reason>.

​
Da nuvem para o terminal

Puxe uma sessão na nuvem para seu terminal usando qualquer um destes:
  • Usando --teleport: a partir da linha de comando, execute claude --teleport para um seletor de sessão interativo, ou claude --teleport <session-id> para retomar uma sessão específica diretamente. Se você tiver alterações não confirmadas, será solicitado que você as guarde primeiro.
  • Usando /teleport: dentro de uma sessão CLI existente, execute /teleport ou /tp para abrir o mesmo seletor de sessão sem reiniciar Claude Code.
  • De /tasks: execute /tasks para ver suas sessões em segundo plano, depois pressione t para teleportar para uma.
  • De claude.ai/code: selecione Open in > Terminal no menu de sessão para copiar um comando que você pode colar em seu terminal.
  • De dentro da sessão na nuvem: digite /teleport e Claude Code responde com o comando exato claude --teleport <session-id> para essa sessão, pronto para ser executado a partir de um checkout do repositório. Requer Claude Code v2.1.223 ou posterior no ambiente da sessão.
Quando você teleporta uma sessão, Claude verifica se você está no repositório correto, busca e faz checkout da ramificação da sessão na nuvem e carrega o histórico completo da conversa em seu terminal. O terminal obtém sua própria cópia da sessão: novo trabalho lá permanece local e não aparece na sessão na nuvem em claude.ai ou no aplicativo móvel Claude. Para continuar dirigindo a partir do seu telefone após teleportar, inicie /remote-control na sessão local. --teleport é distinto de --resume. --resume reabre uma conversa do histórico local desta máquina e não lista sessões na nuvem; --teleport puxa uma sessão na nuvem e sua ramificação.

​
Requisitos de teleporte

Teleport verifica esses requisitos antes de retomar uma sessão. Se algum requisito não for atendido, você verá um erro ou será solicitado a resolver o problema.

​
--teleport não está disponível

Teleport requer autenticação de assinatura claude.ai. Se você estiver autenticado via chave de API, execute /login para se conectar com sua conta claude.ai. Se o erro nomear seu provedor, as sessões na nuvem não estão disponíveis através de provedores de terceiros; consulte a tabela de erros. Se você já estiver conectado via claude.ai e --teleport ainda não estiver disponível, sua organização pode ter desabilitado as sessões na nuvem.

​
Trabalhar com sessões

As sessões aparecem na barra lateral em claude.ai/code. De lá, você pode revisar alterações, compartilhar com colegas de equipe, arquivar trabalho concluído ou excluir sessões permanentemente.

​
Recuperar uma mensagem enfileirada

Se você enviar uma mensagem enquanto Claude está trabalhando, a mensagem fica enfileirada até que Claude a leia. Para recuperar uma mensagem enfileirada, clique no ✕ nela. O texto retorna à caixa de mensagem para que você possa editá-lo ou enviar algo diferente. Se Claude já tiver lido a mensagem, ela permanece na conversa.

​
Gerenciar contexto

As sessões em nuvem suportam comandos integrados que produzem saída de texto. Comandos que só funcionam na interface do terminal, como /plugin ou /resume, não estão disponíveis. Comandos que abrem um seletor ou painel no terminal se comportam de forma diferente nas sessões em nuvem:
  • /model, /effort, /color e /rename: passe o valor como um argumento, por exemplo /model sonnet, em vez de abrir o seletor do terminal ou controle deslizante. Os formulários de argumento exigem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as notas de disponibilidade de cada comando.
  • /fast: alterna o modo rápido para a sessão quando o modo rápido está disponível em sua conta. Requer Claude Code v2.1.271 ou posterior no ambiente da sessão.
  • /config: no seu navegador em claude.ai/code, abre a seção Claude Code de suas configurações em vez de definir um valor, e o texto após o comando, incluindo key=value, é ignorado. Para alterar uma configuração para uma sessão em nuvem, defina uma variável de ambiente no ambiente, ou em uma sessão com um repositório, confirme a chave no .claude/settings.json desse repositório. Configurações em sessões em nuvem lista o que cada sessão lê.
Para gerenciamento de contexto especificamente: A compactação automática é executada automaticamente quando a janela de contexto se aproxima da capacidade. As sessões em nuvem definem CLAUDE_AUTOCOMPACT_PCT_OVERRIDE por si só, portanto a compactação é acionada no meio da janela de compactação automática em vez de quando a janela se enche. Esse valor substitui um que você adiciona em suas variáveis de ambiente, portanto adicionar a variável lá não altera quando a compactação é acionada. Para alterar a janela de compactação automática, defina CLAUDE_CODE_AUTO_COMPACT_WINDOW em suas variáveis de ambiente, ou execute /autocompact com uma contagem de tokens em uma sessão onde a variável não está definida. Subagentes funcionam da mesma forma que funcionam localmente. Claude pode gerá-los com a ferramenta Agent para descarregar pesquisa ou trabalho paralelo em uma janela de contexto separada, mantendo a conversa principal mais leve. Subagentes definidos no .claude/agents/ do seu repositório são detectados automaticamente. Equipes de agentes estão desativadas por padrão, mas podem ser habilitadas adicionando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 às suas variáveis de ambiente.

​
Modos de permissão em sessões em nuvem

Você escolhe o modo de permissão de uma sessão em nuvem no menu suspenso de modo, tanto quando você cria a tarefa quanto enquanto a sessão é executada. Quando você reabre uma sessão cujo ambiente hospedado pela Anthropic expirou, ou envia uma mensagem para uma sessão que um executor auto-hospedado liberou enquanto estava ocioso, Claude Code retoma a sessão no modo de permissão em que estava.

​
Revisar alterações

Cada sessão mostra um indicador de diff com linhas adicionadas e removidas, como +42 -18. Selecione-o para abrir a visualização de diff, deixe comentários inline em linhas específicas e envie-os para Claude com sua próxima mensagem. A visualização de diff compara as alterações da sessão em relação ao seu branch base por padrão. Para comparar com qualquer outro branch no repositório, selecione Compare against e escolha um. Claude Code calcula esses diffs, incluindo os diffs por arquivo mostrados conforme Claude edita, a partir do conteúdo bruto do blob git, portanto os drivers de diff e filtros textconv configurados no repositório não se aplicam. Para um arquivo em um repositório que não é um dos checkouts da própria sessão, como um clonado dentro do workspace durante a sessão, o diff por arquivo mostra a edição de Claude em si em vez de uma comparação git. Consulte Revisar e iterar para o passo a passo completo, incluindo criação de PR. Para fazer Claude monitorar o PR para falhas de CI e comentários de revisão automaticamente, consulte Corrigir automaticamente pull requests.

​
Compartilhar sessões

Para compartilhar uma sessão, alterne sua visibilidade de acordo com os tipos de conta abaixo. Depois disso, compartilhe o link da sessão como está. Os destinatários veem o estado mais recente quando abrem o link, mas sua visualização não é atualizada em tempo real.

​
Compartilhar de uma conta Enterprise ou Team

Para contas Enterprise e Team, as duas opções de visibilidade são Private e Team. A visibilidade de Team torna a sessão visível para outros membros de sua organização claude.ai. As sessões do Claude no Slack são compartilhadas automaticamente com visibilidade de Team. A verificação de acesso ao repositório está habilitada por padrão, com base na conta do GitHub conectada à conta do destinatário. O nome de exibição de sua conta é visível para todos os destinatários com acesso.

​
Compartilhar de uma conta Max ou Pro

Para contas Max e Pro, as duas opções de visibilidade são Private e Public. A visibilidade Public torna a sessão visível para qualquer usuário conectado a claude.ai. Verifique sua sessão para conteúdo sensível antes de compartilhar. As sessões podem conter código e credenciais de repositórios privados do GitHub. A verificação de acesso ao repositório não está habilitada por padrão. Para exigir que os destinatários tenham acesso ao repositório ou para ocultar seu nome de sessões compartilhadas, vá para Settings > Claude Code > Sharing settings.

​
Arquivar sessões

Você pode arquivar sessões para manter sua lista de sessões organizada. As sessões arquivadas ficam ocultas da lista de sessões padrão, mas podem ser visualizadas filtrando por sessões arquivadas. Para arquivar uma sessão, passe o mouse sobre a sessão na barra lateral e selecione o ícone de arquivo.

​
Excluir sessões

Excluir uma sessão remove permanentemente a sessão e seus dados. Esta ação não pode ser desfeita. Você pode excluir uma sessão de duas maneiras:
  • Na barra lateral: filtre por sessões arquivadas, passe o mouse sobre a sessão que deseja excluir e selecione o ícone de exclusão
  • No menu da sessão: abra uma sessão, selecione o menu suspenso ao lado do título da sessão e selecione Delete
Você será solicitado a confirmar antes de uma sessão ser excluída.

​
Corrigir automaticamente pull requests

Claude pode observar um pull request e responder automaticamente a falhas de CI e comentários de revisão. Claude se inscreve na atividade do GitHub no PR, e quando uma verificação falha ou um revisor deixa um comentário, Claude investiga e envia uma correção se uma for clara.
Auto-fix requer que o Claude GitHub App esteja instalado em seu repositório. Se você ainda não fez isso, instale-o a partir da página do GitHub App.
Existem algumas maneiras de ativar auto-fix dependendo de onde o PR veio e qual dispositivo você está usando:
  • PRs criados em uma sessão na nuvem: abra a sessão em claude.ai/code, abra a barra de status de CI e selecione Auto-fix
  • A partir do seu terminal: execute /autofix-pr enquanto estiver na branch do PR. Claude Code detecta o PR aberto com gh, gera uma sessão na nuvem e ativa auto-fix em uma etapa
  • A partir do aplicativo móvel: diga a Claude para corrigir automaticamente o PR, por exemplo “watch this PR and fix any CI failures or review comments”
  • Qualquer PR existente: cole a URL do PR em uma sessão e diga a Claude para corrigir automaticamente
Auto-fix é um toggle por PR. Para parar de monitorar, abra a barra de status de CI na sessão em claude.ai/code e desmarque o toggle Auto-fix, ou diga a Claude para parar de observar o PR.

​
Como Claude responde à atividade de PR

Quando auto-fix está ativo, Claude recebe eventos do GitHub para o PR incluindo novos comentários de revisão e falhas de verificação de CI. Para cada evento, Claude investiga e decide como proceder:
  • Correções claras: se Claude está confiante em uma correção e ela não entra em conflito com instruções anteriores, Claude faz a alteração, envia e explica o que foi feito na sessão
  • Solicitações ambíguas: se um comentário de revisor pode ser interpretado de múltiplas maneiras ou envolve algo arquitetonicamente significativo, Claude pergunta a você antes de agir
  • Eventos duplicados ou sem ação: se um evento é duplicado ou não requer alteração, Claude o anota na sessão e continua
GitHub não emite um webhook quando a branch base avança e cria um conflito de merge, então auto-fix não pode reagir a conflitos por conta própria. Para resolver um conflito, abra a sessão e peça a Claude para fazer rebase. Claude pode responder a threads de comentários de revisão no GitHub como parte da resolução deles. Essas respostas são postadas usando sua conta GitHub, então aparecem sob seu nome de usuário, mas cada resposta é rotulada como vindo de Claude Code para que os revisores saibam que foi escrita pelo agente e não por você diretamente.
Se seu repositório usa automação acionada por comentário, como Atlantis, Terraform Cloud ou GitHub Actions personalizadas que são executadas em eventos issue_comment, esteja ciente de que Claude pode responder em seu nome, o que pode acionar esses fluxos de trabalho. Revise a automação de seu repositório antes de ativar auto-fix e considere desabilitar auto-fix para repositórios onde um comentário de PR pode implantar infraestrutura ou executar operações privilegiadas.

​
Segurança e isolamento

Cada sessão em nuvem é separada de sua máquina e de outras sessões através de várias camadas:
  • Máquinas virtuais isoladas: cada sessão é executada em uma VM isolada gerenciada pela Anthropic. As sessões que sua organização roteia para um ambiente auto-hospedado são executadas em sua própria infraestrutura em vez disso, onde o isolamento é responsabilidade de sua implantação
  • Controles de acesso à rede: em ambientes hospedados pela Anthropic, o acesso à rede é limitado por padrão e pode ser desabilitado. Veja Acesso à rede para os níveis de acesso, os domínios padrão permitidos e o tráfego que não passa pela lista de permissões. Em um ambiente auto-hospedado, você restringe a saída da sessão em seu próprio limite de rede. Ao executar com acesso à rede desabilitado, Claude Code ainda pode se comunicar com a API Anthropic, o que pode permitir que dados saiam da VM.
  • Proteção de credenciais: em ambientes hospedados pela Anthropic, credenciais git e chaves de assinatura ficam fora da sandbox, e um proxy autentica em nome da sessão com credenciais com escopo. Em um ambiente auto-hospedado, sua implantação fornece credenciais git; veja Configure git
  • Credenciais de API: em ambientes hospedados pela Anthropic nos planos Pro e Max, chaves que você adiciona a um ambiente em nuvem ficam fora da sandbox da mesma forma, anexadas a solicitações correspondentes depois que saem da sessão. Um ambiente auto-hospedado não tem credenciais de API, e os planos Team e Enterprise ainda não têm
  • Análise segura: o código é analisado e modificado dentro do ambiente isolado da sessão antes de criar PRs

​
Troubleshooting

Para erros de API de tempo de execução que aparecem na conversa como API Error: 500, 529 Overloaded, 429 ou Prompt is too long, veja a referência de erros. Esses erros e suas correções são compartilhados com o CLI e aplicativo Desktop. As seções abaixo cobrem problemas específicos para sessões em nuvem.

​
Session creation failed

Se uma nova sessão falha ao iniciar com Session creation failed ou fica presa em provisioning, Claude Code não conseguiu alocar uma VM para a sessão.

​
Unable to get organization UUID

claude --cloud e claude --teleport requerem entrada com uma conta claude.ai. Se você autenticar com uma chave de API, ou seus detalhes de conta armazenados estão obsoletos, esses comandos falham com Unable to get organization UUID ou uma mensagem de que a autenticação de chave de API não é suficiente. Com autenticação de chave de API ou detalhes de conta obsoletos, executar claude --teleport sem um ID de sessão mostra Error loading Claude Code sessions no seletor de sessão em vez de qualquer mensagem, e a mesma correção se aplica. Execute /login para entrar com sua conta claude.ai, depois tente novamente o comando. Se o erro nomear seu provedor em vez disso, veja a tabela de erros: as sessões em nuvem não estão disponíveis através de provedores de terceiros.

​
Remote Control session expired or access denied

--teleport se conecta através da mesma infraestrutura de sessão Remote Control que as sessões em nuvem usam, então erros de autenticação e expiração de sessão aparecem com wording de Remote Control. Você pode ver Remote Control session expired ou Access denied. O token de conexão é de curta duração e limitado à sua conta.
  • Execute /login localmente para atualizar suas credenciais, depois reconecte
  • Confirme que você está conectado à mesma conta que possui a sessão
  • Se você ver Remote Control may not be available for this organization, um Owner não habilitou as sessões em nuvem para sua organização

​
Environment expired

As sessões em nuvem param após um período de inatividade e a VM da sessão é recuperada. Uma sessão é considerada inativa enquanto aguarda você aprovar uma chamada de ferramenta MCP connector ou entrar em um servidor MCP, e pode expirar durante essa espera. Reabra a sessão de claude.ai/code para provisionar uma VM fresca com seu histórico de conversa restaurado. O trabalho em segundo plano que ainda estava em execução quando a VM foi recuperada, como subagentes e comandos shell, não é restaurado.

​
Limitações

Antes de confiar em sessões em nuvem para um fluxo de trabalho, leve em conta essas restrições:
  • Limites de taxa: sessões em nuvem compartilham limites de taxa com todo o outro uso de Claude e Claude Code dentro de sua conta. Executar múltiplas tarefas em paralelo consome mais limites de taxa proporcionalmente. Não há cobrança de computação separada para a VM em nuvem.
  • Limites de tempo: comandos que Claude executa e hooks SessionStart têm tempos limite padrão que você pode alterar, e um script de configuração é armazenado em cache apenas quando termina em aproximadamente cinco minutos. Veja Limites de tempo
  • Autenticação de repositório: você pode apenas mover uma sessão em nuvem para seu terminal quando está autenticado na mesma conta
  • Restrições de plataforma: clonagem de repositório e criação de pull request requerem GitHub. Instâncias GitHub Enterprise Server auto-hospedadas são suportadas para planos Team e Enterprise. Você pode enviar um repositório GitLab, Bitbucket ou outro repositório não-GitHub para uma sessão em nuvem como um pacote local definindo CCR_FORCE_BUNDLE=1, mas a sessão não pode enviar resultados de volta para esse remoto
  • IP allowlist da organização: sessões em nuvem chamam a API Anthropic a partir de infraestrutura gerenciada pela Anthropic, não de sua rede, enquanto sessões em um ambiente auto-hospedado a chamam a partir de sua própria rede. Se sua organização tem IP allowlisting habilitado, cada sessão em nuvem hospedada pela Anthropic falha com um erro de autenticação. O mesmo se aplica a Code Review e a routines que são executadas em ambientes hospedados pela Anthropic; uma routine roteada para um ambiente auto-hospedado chama a API a partir de sua própria rede. Entre em contato com suporte Anthropic para isentar serviços hospedados pela Anthropic do allowlist de IP de sua organização.
  • Ambientes em nuvem: configure acesso à rede, variáveis de ambiente e scripts de configuração para sessões em nuvem
  • Projetos: uma conversa onde Claude coordena sessões em nuvem paralelas em seus repositórios e relata de volta
  • Ultrareview: execute uma revisão de código profunda multi-agente em uma sandbox em nuvem
  • Routines: automatize trabalho em um cronograma, via chamada de API ou em resposta a eventos do GitHub
  • Configuração de hooks: execute scripts em eventos do ciclo de vida da sessão
  • Todas as configurações: todas as opções de configuração
  • Segurança: garantias de isolamento e tratamento de dados
  • Uso de dados: o que Anthropic retém de sessões em nuvem
  • Claude Tag: um @Claude gerenciado pela organização no Slack que é executado na mesma infraestrutura em nuvem