Use Claude Code na nuvem - Claude Code Docs

As sessões na nuvem estão disponíveis nos planos Pro, Max, Ultra e Team, e para usuários Enterprise com assentos premium ou assentos Chat + Claude Code. Se funções personalizadas regem seu acesso, você também precisa de uma função com a permissão de sessões na nuvem para iniciar sessões na infraestrutura da Anthropic a partir do navegador, dos aplicativos ou do terminal. Peça a um Owner para adicioná-la a uma de suas funções em Organization settings > Roles.

Uma sessão na 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. Ela conta para os limites de uso do seu plano junto com o restante do seu uso do Claude e do Claude Code, e não há cobrança separada pela VM na nuvem. Para permitir que as sessões na nuvem clonem seu código do GitHub e enviem branches, conecte o GitHub com um dos métodos de conexão do GitHub. Se o seu repositório estiver no GitLab, Bitbucket ou outro host, consulte Restrições de plataforma para saber o que funciona. Você pode iniciar uma sessão em nuvem a partir de qualquer uma dessas superfícies:

Navegador: claude.ai/code, também chamado Claude Code na web
Móvel: a aba Code no aplicativo Claude
Aplicativo desktop: selecione um ambiente em Cloud no seletor de ambiente quando você inicia uma sessão
Terminal: claude --cloud
Tarefas agendadas na nuvem: execuções agendadas e acionadas cada uma é executada como uma sessão na nuvem

Depois de configurar tudo, use esta página para mover trabalho entre seu terminal e a nuvem, gerenciar e compartilhar sessões, ativar a correção automática de pull requests e solucionar problemas.

Estes casos são abordados em outras páginas:

Iniciar sua primeira sessão na nuvem: Começar com sessões na nuvem conecta o GitHub e percorre uma tarefa no navegador
Muitas sessões na nuvem para um corpo de trabalho: um projeto faz com que Claude as inicie e acompanhe para você
Direcionar uma sessão local a partir de outro dispositivo: sessões em seu terminal, IDE ou no aplicativo Desktop com Local selecionado são executadas em sua máquina, e o Remote Control permite que você as acesse a partir do seu telefone ou navegador

Ambientes em nuvem

Cada sessão na nuvem é executada em um ambiente em nuvem, a configuração salva que controla acesso à rede, variáveis de ambiente e scripts de configuração.

Seu primeiro ambiente: se você ainda não tem um, o onboarding configura um ambiente Default com acesso à rede Limited. Veja O ambiente Default para saber como isso funciona no seu plano
Qual ambiente uma sessão usa: veja O ambiente Default para saber como as sessões escolhem um ambiente quando você tem mais de um
Alterar o que as sessões podem acessar ou executar na inicialização: veja Configurar ambientes em nuvem
O que vem instalado sem nenhuma configuração: veja Ferramentas instaladas

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:

Método	Como você se conecta	Repositórios que as sessões podem alcançar	Melhor para
GitHub App	Autorize o Claude GitHub App durante onboarding na web	Qualquer repositório público e repositórios privados nos quais o Claude GitHub App está instalado	Onboarding no navegador; equipes que desejam Auto-fix
`/web-setup`	Execute `/web-setup` em seu terminal para enviar seu token CLI `gh` local para sua conta Claude	Qualquer repositório que seu token `gh` possa acessar, independentemente de o Claude GitHub App estar instalado	Desenvolvedores individuais que já usam `gh`

Estes recursos dependem de o Claude GitHub App estar instalado no repositório:

Auto-fix: a instalação do Claude GitHub App em um repositório também habilita Auto-fix para pull requests nele
Projetos: 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. 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.

Organizações com Zero Data Retention habilitado, ou com a configuração HIPAA aplicada, não podem usar /web-setup ou outros recursos de sessão na nuvem. Organizações que usam chaves de criptografia gerenciadas pelo cliente (CMEK) também não podem iniciar sessões na nuvem.

Quick setup para Team e Enterprise

Quick setup é uma configuração de organização que remove etapas da configuração do GitHub e do ambiente dos membros. Nos planos Team e Enterprise, ela está desabilitada por padrão. Veja o que muda para os membros quando ela está ativada:

/web-setup: os membros podem conectar o GitHub com /web-setup. Enquanto a configuração estiver desativada, o comando fica oculto
Prompt do GitHub App: o onboarding no navegador pula o prompt de instalação do Claude GitHub App
Primeiro ambiente: o onboarding no navegador cria o ambiente Default para os membros em vez de mostrar o formulário de ambiente

Um Owner a ativa com o toggle Quick setup em Organization settings > Claude Code.

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. A flag --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, ela enfileira uma mensagem nessa sessão existente. O aplicativo Desktop pode enviar uma sessão local da sua aba Code para a nuvem a partir do seu menu Open in.

Iniciar uma sessão na nuvem a partir do seu terminal

Inicie uma sessão na nuvem a partir da linha de comando com o sinalizador --cloud:

claude --cloud "Fix the authentication bug in src/auth/login.ts"

Isso cria uma nova sessão na nuvem em claude.ai. A VM na nuvem clona o remoto GitHub do diretório atual em seu branch 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. Se o terminal imprimir Branch <name> is not on GitHub, consulte Branch is not on GitHub. --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:

claude --permission-mode plan

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:

claude --cloud "Execute the migration plan in docs/migration-plan.md"

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:

claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

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. Para um clone completo, o pacote inclui o histórico do seu repositório em todos os branches, além de alterações sem commit em arquivos rastreados. O que acontece com alterações sem commit em arquivos sensíveis depende da sua plataforma:

macOS, Linux e WSL: Claude Code deixa fora do upload as alterações sem commit em arquivos nomeados como credenciais ou chaves. Isso inclui arquivos .env, arquivos Terraform *.tfvars e arquivos de chave como id_rsa e *.pem. Também deixa de fora alterações sem commit em arquivos gerenciados por um filtro git, como o Git LFS. Um aviso Left on this machine: nomeia os arquivos deixados de fora, e a sessão inicia com a versão com commit de cada um, ou sem o arquivo se nenhuma versão tiver commit.
Windows nativo: alterações sem commit em arquivos rastreados são carregadas como estão, seja qual for o nome do arquivo. Guarde (stash) ou reverta uma edição que você não quer na sessão na nuvem antes de iniciá-la.

Para carregar um pacote mesmo quando Claude Code clonaria do remoto, defina CCR_FORCE_BUNDLE=1:

CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

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
No macOS, Linux e WSL, Claude Code recusa o upload quando não consegue seguir uma configuração git que afeta quais regras de atributo se aplicam aos seus arquivos, como core.attributesFile definido em um arquivo de configuração incluído. A mensagem de recusa nomeia a configuração e a correção
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

No macOS, Linux e WSL, o upload também precisa do git 2.31 ou posterior e de um layout de checkout compatível, enquanto no Windows nativo Claude Code faz o upload sem nenhuma dessas verificações. Quando um checkout não atende a esses requisitos, Claude Code não inicia a sessão. Ele imprime um erro que contém Not uploading this working tree:, nomeia a causa e diz o que alterar. Estas são as causas comuns:

Git mais antigo: o git instalado é anterior ao 2.31. Atualize o git e tente novamente.
Um layout de checkout que o upload não suporta: você iniciou dentro de um submódulo, em um clone feito com git clone --separate-git-dir, --shared ou --reference, em um checkout com core.worktree definido, ou em um repositório que mantém suas refs no formato reftable. Em vez disso, inicie a partir do checkout principal de um clone feito com um git clone simples.
Um worktree vinculado com sparse checkout: git sparse-checkout grava configurações no próprio arquivo config.worktree do worktree, que o upload não aceita, portanto um worktree que tenha essas configurações não é carregado, nem um que Claude Code criou com worktree.sparsePaths. Em vez disso, inicie a partir do checkout principal do repositório.
Configuração do git mantida dentro da árvore de trabalho: sua configuração do git inclui um arquivo que fica dentro do checkout, por exemplo uma entrada include.path que aponta para dentro do repositório. Mova esse arquivo para fora da árvore de trabalho ou remova o include e tente novamente.

No macOS, Linux e WSL, um clone parcial feito com git clone --filter é carregado como um snapshot de sua árvore de trabalho sem histórico, desde que o clone contenha localmente todos os arquivos rastreados. Para claude --cloud, se o repositório estiver no GitHub, você pode evitar o upload e seus requisitos: faça push do seu branch, instale o Claude GitHub App no repositório e inicie a sessão novamente para que ela clone a partir do GitHub.

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. O comando publica uma mensagem e sai:

claude -p "your message" --cloud <session-id>

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

Com sucesso, o comando imprime o ID da sessão e um link para visualizar a sessão:

Sent to cloud session.
Session ID: session_01HJKLMNOPQRSTUVWXYZ
View: https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ?from=cli&m=0

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>. Se o envio falhar, consulte Erros ao enviar para uma sessão na nuvem.

Continuar uma sessão na nuvem no seu 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 sem commit, será solicitado que você as guarde primeiro. --resume reabre uma conversa do histórico local desta máquina e não lista sessões na nuvem.
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.

Quando você teleporta uma sessão, Claude verifica se você está no repositório correto, busca e faz checkout do branch da sessão na nuvem e carrega a conversa em seu terminal.

Se Claude Code tiver compactado a sessão na nuvem, o que ele faz automaticamente em uma sessão longa, as mensagens anteriores que ele resumiu não são copiadas para o seu terminal. Claude continua a partir do resumo. Para ler as mensagens originais, role para cima na sessão na nuvem em claude.ai ou no aplicativo móvel Claude.

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.

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.

Requisito	Detalhes
Estado git limpo	Seu diretório de trabalho não deve ter alterações não confirmadas. Teleport solicita que você guarde as alterações se necessário.
Repositório correto	Você deve executar `--teleport` a partir de um checkout do mesmo repositório, não de um fork. Se você executá-lo a partir de um checkout de um repositório diferente, Claude Code mostra um erro que nomeia tanto o repositório da sessão quanto o do seu checkout. Se Claude Code não conseguir analisar seu remoto em um nome de host, por exemplo um alias de host SSH como `git@work:owner/repo.git`, ele pede que você confirme e aceita o checkout quando o proprietário do remoto e o nome do repositório correspondem ao repositório da sessão.
Ramificação disponível	A ramificação da sessão na nuvem deve ter sido enviada para o remoto. Teleport busca e faz checkout automaticamente.
Mesma conta	Você deve estar autenticado na mesma conta claude.ai usada na sessão na nuvem.

Quando o teleport busca o branch da sessão, o fetch nunca espera por entrada no seu terminal. Se o git ou o ssh pedissem uma senha, uma passphrase de chave ou a confirmação de um novo host SSH, o fetch falha, e o checkout então só funciona se o seu clone local já tiver o branch. Para os dois casos de SSH, carregue sua chave no ssh-agent e execute git fetch uma vez manualmente antes, para registrar o host.

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

Teleport requer autenticação de assinatura claude.ai. Encontre o caso que corresponde ao seu:

Você está conectado com uma chave de API ou conta do Console: execute claude auth login no seu shell e, em seguida, entre com claude.ai
O erro nomeia seu provedor: as sessões na nuvem não estão disponíveis através de provedores de terceiros. Consulte a tabela de erros
Você já está conectado via claude.ai: 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.

Modos de permissão em sessões na nuvem

Você escolhe o modo de permissão de uma sessão na nuvem no menu suspenso de modo, tanto quando você cria a tarefa quanto enquanto a sessão é executada. Claude Code retoma uma sessão no modo de permissão em que ela estava quando você faz qualquer uma destas ações:

Reabre uma sessão cujo ambiente hospedado pela Anthropic expirou
Envia uma mensagem para uma sessão que um executor auto-hospedado liberou enquanto estava ocioso

Revisar alterações

Depois que Claude envia suas alterações para um branch, o cartão Changes no painel ao lado do chat mostra as linhas adicionadas e removidas, como +42 -18. Clique nas contagens de linhas no cartão Changes para abrir a visualização de diff.

Você também pode clicar em Changes na barra de título da sessão ou no menu ⋮ da barra.
Para mostrar o painel quando ele estiver oculto, clique no ícone Show session rail na barra de título da sessão ou no menu ⋮ da barra.

Na visualização de diff, você pode comentar em linhas e comparar com outro branch:

Comentar: deixe comentários inline em linhas específicas e, em seguida, envie os comentários para Claude com sua próxima mensagem
Comparar: 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 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. Estas etapas são abordadas em outros lugares:

O passo a passo completo, incluindo criação de PR: consulte Revisar e iterar
Fazer Claude monitorar o PR para falhas de CI e comentários de revisão automaticamente: consulte Corrigir automaticamente pull requests

Solucionar problemas de um arquivo ausente na visualização de diff

Um arquivo que você esperava pode estar ausente da lista de arquivos da visualização de diff quando ela compara com o branch base, quer a sessão tenha enviado alterações ou não:

Nenhuma alteração enviada ainda: a lista contém as edições do próprio Claude, mas não as alterações feitas por comandos que Claude executou, como um formatador
Alterações enviadas: a lista contém os commits enviados, mas não as alterações feitas após o último push

Para adicionar uma alteração ausente à lista, peça a Claude para fazer commit e push.

Gerenciar contexto

As sessões na 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 na 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 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 Settings > Code ou Settings > Claude Code em vez de definir um valor. Para alterar uma configuração para uma sessão na nuvem, defina uma variável de ambiente no ambiente. Em uma sessão com um repositório fora das threads de um projeto, faça commit da chave no .claude/settings.json desse repositório em vez disso. Configurações em sessões na nuvem lista o que cada sessão lê.

Para gerenciamento de contexto em uma sessão na nuvem fora das threads de um projeto:

Comando	Funciona em sessões na nuvem	Notas
`/compact`	Sim	Resume a conversa para liberar contexto. Aceita instruções de foco opcionais como `/compact keep the test output`
`/context`	Sim	Mostra o que está atualmente na janela de contexto
`/clear`	Sim	Inicia uma nova conversa com contexto vazio na mesma sessão na nuvem

A compactação automática é executada automaticamente quando a janela de contexto se aproxima da capacidade. As sessões na 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 sobrescreve 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. Fora das threads de um projeto, os subagentes definidos no .claude/agents/ do seu repositório são carregados 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.

Sugestões de plugins na conversa

Um cartão na conversa que lista um ou mais plugins, com um botão Add, significa que Claude está sugerindo plugins para sua tarefa. Claude pode fazer essas sugestões sem que você peça. Você não precisa responder, e Claude continua com a tarefa de qualquer forma.

Adicionar ou remover um plugin sugerido

Selecione Add em um plugin para ativá-lo na sua conta claude.ai, onde ele permanece ativado após o término da sessão. Para desfazer, abra o plugin adicionado a partir do cartão, selecione Manage para acessar a página do plugin em claude.ai e remova o plugin nessa página.

Desativar sugestões de plugins

Para impedir que Claude sugira plugins, negue as ferramentas SearchPlugins e SuggestPluginInstall com regras de permissão. Em uma sessão com um repositório fora de um projeto, faça commit das regras no .claude/settings.json desse repositório, listando os dois nomes de ferramentas em permissions.deny:

{
  "permissions": {
    "deny": ["SearchPlugins", "SuggestPluginInstall"]
  }
}

Claude Code ignora as regras de permissão no .claude/settings.json do repositório, incluindo essas regras de negação, quando as configurações gerenciadas que se aplicam à sessão definem allowManagedPermissionRulesOnly. Nesse caso, coloque as regras nessas configurações gerenciadas. Para outras configurações, como uma sessão com vários repositórios ou uma thread na nuvem em um projeto, veja quais configurações chegam a uma sessão na nuvem.

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. 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. O compartilhamento funciona da seguinte forma para contas Enterprise e Team:

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

Opções de visibilidade: Private e Public. A visibilidade Public torna a sessão visível para qualquer usuário conectado a claude.ai
Acesso ao repositório: a verificação não está habilitada por padrão
Conteúdo sensível: verifique sua sessão antes de compartilhar. As sessões podem conter código e credenciais de repositórios privados do GitHub

Para exigir que os destinatários tenham acesso ao repositório ou para ocultar seu nome de sessões compartilhadas, abra Settings em claude.ai e, em seguida:

Se o menu Settings mostrar Code em vez de Claude Code: vá para Privacy, que contém essas configurações
Caso contrário: vá para Claude Code > Sharing settings

Arquivar sessões

Arquive uma sessão para removê-la da lista de sessões da barra lateral. Para arquivar uma, passe o mouse sobre ela na barra lateral, abra seu menu ⋯ e selecione Archive.

Encontrar uma sessão arquivada

Para ver suas sessões arquivadas, acesse claude.ai/code/sessions e abra a aba Archived. Para colocar uma de volta na lista de sessões da barra lateral, passe o mouse sobre ela nessa aba, abra seu menu ⋮ e selecione Unarchive.

Excluir sessões

Excluir uma sessão remove permanentemente a sessão e seus dados. Esta ação não pode ser desfeita. Exclua uma sessão pela barra lateral, pelo menu da sessão ou pela aba Archived, se você já a tiver arquivado:

Na barra lateral: passe o mouse sobre a sessão, abra seu menu ⋯ e selecione Delete
No menu da sessão: abra uma sessão, selecione o menu suspenso ao lado do título da sessão e selecione Delete
Na aba Archived: passe o mouse sobre a sessão na aba Archived, abra seu menu ⋮ 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 e encontre o pull request no card Changes. Abra o menu ⋮ ao lado do título do pull request e ative 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

Para parar de monitorar, desative Auto-fix no menu ⋮ do pull request no card Changes da sessão, 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
Segredos de rede: em ambientes hospedados pela Anthropic, chaves que você adiciona a um ambiente na nuvem ficam fora do sandbox da mesma forma, anexadas a requisições correspondentes depois que saem da sessão. Um ambiente auto-hospedado não tem segredos de rede
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.

Verifique status.claude.com para incidentes de sessão em nuvem
Tente novamente após um minuto, já que a capacidade é provisionada sob demanda
Confirme que sua conexão GitHub pode acessar o repositório seguindo No repositories appear after connecting GitHub

Your new session couldn’t start

Seu prompt está de volta na caixa de onde você o enviou.

Conexão perdida: verifique sua conexão com a internet e qualquer VPN ou proxy que você use, depois envie seu prompt novamente
Erro do servidor: aguarde um momento, depois envie seu prompt novamente. Se o aviso reaparecer, verifique status.claude.com

Can’t rewind to this message

Rewind to here falha com este erro em qualquer mensagem, exceto a mais recente, quando sua sessão é executada em um runner auto-hospedado com Claude Code anterior à v2.1.246. Peça a quem gerencia os runners da sua organização para atualizá-los.

Unable to get organization UUID

claude --cloud e claude --teleport requerem entrada com uma conta claude.ai. Se, em vez disso, você autenticar com uma chave de API ou com um login do Console, ou se seus detalhes de conta armazenados estiverem obsoletos, você verá uma mensagem como:

Unable to get organization UUID
Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
Error loading Claude Code sessions no seletor de sessão, quando você executa claude --teleport sem um ID de sessão

Execute claude auth login no seu shell para entrar com sua conta claude.ai, depois tente novamente o comando. Dentro de uma sessão em execução, /login faz o mesmo. Se o erro nomear seu provedor em vez disso, veja a tabela de erros: as sessões na nuvem não estão disponíveis através de provedores de terceiros. Da v2.1.274 até a v2.1.289, a mensagem de entrada dizia

Claude Code cloud sessions require authentication with a Claude.ai account. API key authentication is not sufficient. Please run /login to authenticate, or check your authentication status with /status.

Branch is not on GitHub

Quando claude --cloud imprime uma linha começando com Branch <name> is not on GitHub, a sessão na nuvem ainda é iniciada, mas não a partir do seu branch. A linha indica onde a sessão é iniciada em vez disso: um commit enviado do histórico do seu branch, ou o branch padrão do repositório. Commits que existem apenas na sua máquina e alterações sem commit não estão na sessão. Você vê essa linha quando, por exemplo, você nunca fez push do branch, ou o GitHub o excluiu depois que o pull request dele foi mesclado. Se o ponto de partida indicado pela linha tiver o que sua tarefa precisa, use a sessão como está. Caso contrário, faça push do branch e inicie uma nova sessão para que ela clone seu branch.

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

Erros ao enviar para uma sessão na nuvem

Esses erros vêm da execução de claude com --cloud <session-id>, com ou sem -p. O CLI prefixa os erros com Error: . Uma entrega com falha é envolvida como failed to send message to cloud session <id>: <reason>.

Mensagem	O que significa
`Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.`	Claude Code está configurado para um provedor de terceiros. A mensagem nomeia o provedor com o rótulo que sua configuração usa, como `Amazon Bedrock` ou `Google Vertex AI`. Remova a configuração desse provedor, por exemplo removendo a definição de `CLAUDE_CODE_USE_BEDROCK`, e entre com uma conta Anthropic (`claude auth login`).
`Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.`	A política `allow_remote_sessions` da sua organização está desativada; veja Cloud sessions are disabled by your organization’s policy. Se, em vez disso, a mensagem nomear uma credencial que esta sessão está usando, veja As sessões na nuvem usam seu login do claude.ai.
`Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.`	Claude Code ainda não terminou de carregar a política da sua organização, então recusa o envio em vez de presumir que as sessões na nuvem são permitidas. Verifique sua conexão de rede e tente novamente.
`Cloud sessions aren't available:` seguido de uma causa	O carregamento da política da sua organização falhou, e o restante da mensagem diz como. Aja de acordo com a causa indicada; veja Couldn’t verify your organization’s policy for cloud sessions.
`Attaching to an existing cloud session is not enabled for your account.`	Você executou `--cloud <session-id>` sem `-p`. Envie a mensagem com `claude -p "your message" --cloud <session-id>`.
`Session not found: <id>`	O ID ou URL não corresponde a uma sessão que você pode acessar. Compare-o com o URL claude.ai/code da sessão.
`cloud session <id> is archived and cannot accept new messages`	A sessão foi arquivada. Inicie uma nova sessão em vez disso.

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 nova:

Restaurado: seu histórico de conversa
Não restaurado: trabalho em segundo plano que ainda estava em execução ou pendente quando a VM foi recuperada, incluindo:
- Comandos shell: Claude Code informa ao Claude quais comandos pararam. Peça ao Claude para executar novamente os que você ainda precisa.
- Subagentes: Claude Code informa ao Claude quais subagentes pararam e quais deles podem ser retomados em vez de reiniciados do zero. Peça ao Claude para continuar o trabalho deles.
- Tarefas agendadas com escopo de sessão: tarefas que você agendou na sessão e um /loop aguardando sua próxima iteração não são transferidos para a sessão reaberta. Peça ao Claude para agendar as tarefas novamente, ou execute /loop novamente para reiniciar o loop.

Limitações

Antes de confiar em sessões em nuvem para um fluxo de trabalho, leve em conta essas restrições:

Rate limits: sessões na nuvem compartilham rate limits com todo o outro uso de Claude e Claude Code dentro de sua conta. Executar múltiplas tarefas em paralelo consome mais rate limits proporcionalmente.
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 em ambientes hospedados pela Anthropic 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 na nuvem como um pacote local definindo CCR_FORCE_BUNDLE=1, mas a sessão não pode enviar resultados de volta para esse remoto
- Ambientes auto-hospedados: para um repositório em outro host git, veja os requisitos para iniciar uma sessão com --environment.

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
Tarefas agendadas na nuvem: 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

Ambientes em nuvem

Opções de autenticação do GitHub

Quick setup para Team e Enterprise

Mover tarefas entre terminal e nuvem

Iniciar uma sessão na nuvem a partir do seu terminal

Dicas para tarefas na nuvem

Enviar repositórios locais sem GitHub

Enviar acompanhamentos a partir da CLI

Saída

Continuar uma sessão na nuvem no seu terminal

Requisitos de teleporte

--teleport não está disponível

Trabalhar com sessões

Modos de permissão em sessões na nuvem

Revisar alterações

Solucionar problemas de um arquivo ausente na visualização de diff

Gerenciar contexto

Sugestões de plugins na conversa

Adicionar ou remover um plugin sugerido

Desativar sugestões de plugins

Recuperar uma mensagem enfileirada

Compartilhar sessões

Compartilhar de uma conta Enterprise ou Team

Compartilhar de uma conta Max, Ultra ou Pro

Arquivar sessões

Encontrar uma sessão arquivada

Excluir sessões

Corrigir automaticamente pull requests

Como Claude responde à atividade de PR

Segurança e isolamento

Troubleshooting

Session creation failed

Your new session couldn’t start

Can’t rewind to this message

Unable to get organization UUID

Branch is not on GitHub

Remote Control session expired or access denied

Erros ao enviar para uma sessão na nuvem

Environment expired

Limitações

Recursos relacionados

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