4 4
5# Use Claude Code na web5# Use Claude Code na web
6 6
7> Configure ambientes em nuvem, scripts de configuração, acesso à rede e Docker na sandbox da Anthropic. Mova sessões entre web e terminal com `--cloud` e `--teleport`.7> Mova sessões entre web e terminal com `--cloud` e `--teleport`, gerencie e compartilhe sessões, e corrija automaticamente pull requests da nuvem.
8 8
9<Note>9<Note>
10 Claude Code na web está em visualização de pesquisa para usuários Pro, Max e Team, e para usuários Enterprise com assentos premium ou assentos Chat + Claude Code.10 Claude Code na web está em visualização de pesquisa para usuários Pro, Max e Team, e para usuários Enterprise com assentos premium ou assentos Chat + Claude Code.
11</Note>11</Note>
12 12
13Claude Code na web executa tarefas em infraestrutura em nuvem gerenciada pela Anthropic em [claude.ai/code](https://claude.ai/code). As sessões persistem mesmo se você fechar seu navegador, e você pode monitorá-las a partir do aplicativo móvel Claude.13Claude Code na web executa tarefas em infraestrutura em nuvem gerenciada pela Anthropic em [claude.ai/code](https://claude.ai/code), ou no [ambiente auto-hospedado](/docs/pt/self-hosted-environments) da sua organização quando roteado para lá. As sessões persistem mesmo se você fechar seu navegador, e você pode monitorá-las a partir do aplicativo móvel Claude.
14 14
15<Tip>15<Tip>
16 Novo no Claude Code na web? Comece com [Começar](/docs/pt/web-quickstart) para conectar sua conta GitHub e enviar sua primeira tarefa.16 Novo no Claude Code na web? Comece com [Começar](/docs/pt/web-quickstart) para conectar sua conta GitHub e enviar sua primeira tarefa.
17</Tip>17</Tip>
18 18
19Esta página cobre:19Esta página cobre o produto web em si:
20 20
21* [Ambientes em nuvem](#cloud-environments): onde as sessões são executadas e onde configurar isso
21* [Opções de autenticação do GitHub](#github-authentication-options): duas maneiras de conectar o GitHub22* [Opções de autenticação do GitHub](#github-authentication-options): duas maneiras de conectar o GitHub
22* [O ambiente em nuvem](#the-cloud-environment): qual configuração é transferida, quais ferramentas estão instaladas e como configurar ambientes
23* [Scripts de configuração](#setup-scripts) e gerenciamento de dependências
24* [Acesso à rede](#network-access): níveis, proxies e a lista de permissões padrão
25* [Mover tarefas entre web e terminal](#move-tasks-between-web-and-terminal) com `--cloud` e `--teleport`23* [Mover tarefas entre web e terminal](#move-tasks-between-web-and-terminal) com `--cloud` e `--teleport`
26* [Trabalhar com sessões](#work-with-sessions): revisar, compartilhar, arquivar, deletar24* [Trabalhar com sessões](#work-with-sessions): modos de permissão, revisão, compartilhamento, arquivamento, exclusão
27* [Corrigir automaticamente pull requests](#auto-fix-pull-requests): responder automaticamente a falhas de CI e comentários de revisão25* [Corrigir automaticamente pull requests](#auto-fix-pull-requests): responder automaticamente a falhas de CI e comentários de revisão
28* [Segurança e isolamento](#security-and-isolation): como as sessões são isoladas26* [Segurança e isolamento](#security-and-isolation): como as sessões são isoladas
29* [Limitações](#limitations): limites de taxa e restrições de plataforma27* [Limitações](#limitations): limites de taxa e restrições de plataforma
30 28
29<h2 id="cloud-environments">
30 Ambientes em nuvem
31</h2>
32
33Cada sessão em nuvem é executada em um [ambiente em nuvem](/docs/pt/cloud-environments), 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**](/docs/pt/cloud-environments#access-levels), criando-o para você ou pedindo que você o crie. Veja [O ambiente Default](/docs/pt/cloud-environments#the-default-environment) para saber qual desses acontece no seu plano e como as sessões escolhem um ambiente quando você tem mais de um.
34
35Os mesmos ambientes se aplicam em qualquer lugar que você inicie uma sessão em nuvem: a web, o terminal, [Claude Tag](https://claude.com/docs/claude-tag/overview), [routines](/docs/pt/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](/docs/pt/cloud-environments#organization-shared-environments) ou [ambientes auto-hospedados](/docs/pt/self-hosted-environments).
36
37Veja [Configurar ambientes em nuvem](/docs/pt/cloud-environments) para alterar o que um ambiente permite, definir variáveis ou adicionar um script de configuração, e [Ferramentas instaladas](/docs/pt/cloud-environments#installed-tools) para o que as sessões incluem sem nenhuma configuração.
38
31<h2 id="github-authentication-options">39<h2 id="github-authentication-options">
32 Opções de autenticação do GitHub40 Opções de autenticação do GitHub
33</h2>41</h2>
43 Com qualquer método, uma sessão em nuvem pode acessar qualquer repositório que a conta GitHub conectada possa ver, não apenas os repositórios nos quais o Claude GitHub App está instalado. A instalação do App habilita webhooks de PR para [Auto-fix](#auto-fix-pull-requests); não é um controle de acesso no nível da sessão. Para restringir quais repositórios sua equipe pode alcançar a partir de sessões em nuvem, restrinja o acesso no próprio GitHub, por exemplo, limitando a associação de equipe ou repositório para as contas GitHub conectadas.51 Com qualquer método, uma sessão em nuvem pode acessar qualquer repositório que a conta GitHub conectada possa ver, não apenas os repositórios nos quais o Claude GitHub App está instalado. A instalação do App habilita webhooks de PR para [Auto-fix](#auto-fix-pull-requests); não é um controle de acesso no nível da sessão. Para restringir quais repositórios sua equipe pode alcançar a partir de sessões em nuvem, restrinja o acesso no próprio GitHub, por exemplo, limitando a associação de equipe ou repositório para as contas GitHub conectadas.
44</Note>52</Note>
45 53
46Qualquer método funciona. [`/schedule`](/docs/pt/routines) verifica qualquer forma de acesso e solicita que você execute `/web-setup` se nenhum estiver configurado. Veja [Conectar a partir do seu terminal](/docs/pt/web-quickstart#connect-from-your-terminal) para o passo a passo de `/web-setup`.54Qualquer método funciona. Para como `/schedule` verifica esse acesso antes de criar uma routine, veja [Repositórios e permissões de branch](/docs/pt/routines#repositories-and-branch-permissions). Veja [Conectar a partir do seu terminal](/docs/pt/web-quickstart#connect-from-your-terminal) para o passo a passo de `/web-setup`.
47
48O GitHub App é necessário para [Auto-fix](#auto-fix-pull-requests), que usa o App para receber webhooks de PR. Se você conectar com `/web-setup` e depois quiser Auto-fix, instale o App nesses repositórios.
49 55
50Administradores de Team e Enterprise podem desabilitar `/web-setup` com o toggle Quick web setup em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).56Quick 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**](/docs/pt/cloud-environments#the-default-environment) 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](/docs/pt/server-managed-settings#access-control) o ativa com o toggle **Quick web setup** em [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code).
51 57
52<Note>58<Note>
53 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem.59 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem.
54</Note>60</Note>
55 61
56<h2 id="the-cloud-environment">
57 O ambiente em nuvem
58</h2>
59
60Cada sessão é executada em uma VM gerenciada pela Anthropic com seu repositório clonado. Esta seção cobre o que está disponível quando uma sessão inicia e como personalizá-lo.
61
62<h3 id="what’s-available-in-cloud-sessions">
63 O que está disponível em sessões em nuvem
64</h3>
65
66As sessões em nuvem começam a partir de um clone fresco do seu repositório. Qualquer coisa confirmada no repositório está disponível. Qualquer coisa que você tenha instalado ou configurado apenas em sua própria máquina não está disponível na sessão. A política da sua organização chega separadamente através de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings).
67
68| | Disponível em sessões em nuvem | Por quê |
69| :---------------------------------------------------------------------------------------- | :----------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
70| Seu `CLAUDE.md` do repositório | Sim | Parte do clone |
71| Seus hooks `.claude/settings.json` do repositório | Sim | Parte do clone |
72| Seus servidores MCP `.mcp.json` do repositório | Sim | Parte do clone |
73| Seu `.claude/rules/` do repositório | Sim | Parte do clone |
74| Seu `.claude/skills/`, `.claude/agents/`, `.claude/commands/` do repositório | Sim | Parte do clone |
75| Plugins declarados em `.claude/settings.json` | Sim | Instalados no início da sessão a partir do [marketplace](/docs/pt/plugin-marketplaces) que você declarou. Requer acesso à rede para alcançar a fonte do marketplace |
76| [Configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) da sua organização | Sim | Obtidas dos servidores da Anthropic quando a sessão inicia. Veja [Cobertura de superfície](/docs/pt/model-config#surface-coverage) para como `availableModels` é aplicado em sessões em nuvem. As configurações implantadas em seu dispositivo através de MDM ou arquivos de configurações gerenciadas não se aplicam, porque a sessão é executada em uma VM gerenciada pela Anthropic |
77| Seu `CLAUDE.md` do usuário `~/.claude/` | Não | Vive em sua máquina, não no repositório |
78| Suas `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` do usuário | Não | Vivem em sua máquina, não no repositório. Confirme-os no diretório `.claude/` do repositório. Skills que você habilita em claude.ai são carregadas em sessões em nuvem automaticamente |
79| Plugins habilitados apenas em suas configurações de usuário | Não | `enabledPlugins` com escopo de usuário vive em `~/.claude/settings.json`. Declare-os em `.claude/settings.json` do repositório |
80| Servidores MCP que você adicionou com `claude mcp add` | Não | Aqueles escrevem em sua configuração de usuário local, não no repositório. Declare o servidor em [`.mcp.json`](/docs/pt/mcp#project-scope) |
81| Tokens de API estáticos e credenciais | Não | Nenhum armazenamento de segredos dedicado existe ainda. Veja abaixo |
82| Autenticação interativa como AWS SSO | Não | Não suportado. SSO requer login baseado em navegador que não pode ser executado em uma sessão em nuvem |
83
84Para disponibilizar sua própria configuração em sessões em nuvem, confirme-a no repositório; a política da organização chega separadamente através de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings).
85
86Um armazenamento de segredos dedicado ainda não está disponível. Tanto variáveis de ambiente quanto scripts de configuração são armazenados na configuração de ambiente, visíveis para qualquer pessoa que possa editar esse ambiente. Se você precisar de segredos em uma sessão em nuvem, adicione-os como variáveis de ambiente com essa visibilidade em mente.
87
88<h3 id="installed-tools">
89 Ferramentas instaladas
90</h3>
91
92As sessões em nuvem vêm com tempos de execução de linguagem comuns, ferramentas de compilação e bancos de dados pré-instalados. A tabela abaixo resume o que está incluído por categoria.
93
94| Categoria | Incluído |
95| :------------------ | :----------------------------------------------------------------------------- |
96| **Python** | Python 3.x com pip, poetry, uv, black, mypy, pytest, ruff |
97| **Node.js** | 20, 21 e 22 via nvm, com npm, yarn, pnpm, bun¹, eslint, prettier, chromedriver |
98| **Ruby** | 3.1, 3.2, 3.3 com gem, bundler, rbenv |
99| **PHP** | 8.4 com Composer |
100| **Java** | OpenJDK 21 com Maven e Gradle |
101| **Go** | estável mais recente com suporte a módulos |
102| **Rust** | rustc e cargo |
103| **C/C++** | GCC, Clang, cmake, ninja, conan |
104| **Docker** | docker, dockerd, docker compose |
105| **Bancos de dados** | PostgreSQL 16, Redis 7.0 |
106| **Utilitários** | git, jq, yq, ripgrep, tmux, vim, nano |
107
108¹ Bun está instalado mas tem [problemas de compatibilidade com proxy](#install-dependencies-with-a-sessionstart-hook) conhecidos para busca de pacotes.
109
110Para versões exatas, peça a Claude para executar `check-tools` em uma sessão em nuvem. Este comando existe apenas em sessões em nuvem.
111
112<h3 id="work-with-github-issues-and-pull-requests">
113 Trabalhar com problemas e pull requests do GitHub
114</h3>
115
116As sessões em nuvem incluem ferramentas GitHub integradas que permitem que Claude leia problemas, liste pull requests, busque diffs e poste comentários sem nenhuma configuração. Essas ferramentas autenticam através do [proxy GitHub](#github-proxy) usando qualquer método que você configurou em [Opções de autenticação do GitHub](#github-authentication-options), então seu token nunca entra no contêiner.
117
118Você pode definir `GH_TOKEN` ou `GITHUB_TOKEN` você mesmo em [configurações de ambiente](#configure-your-environment), ou deixar ambos não definidos e deixar o [proxy GitHub](#github-proxy) autenticar para você:
119
120* Se você definir um token, ele passa através do contêiner inalterado, então `gh` e seus scripts o usam diretamente.
121* Se você não definir nenhum, o contêiner define ambas as variáveis para a string de espaço reservado `proxy-injected` e o proxy substitui suas credenciais reais em solicitações GitHub de saída. `gh` funciona sem um token seu, mas um script que lê `GITHUB_TOKEN` diretamente obtém o espaço reservado, não um token utilizável.
122
123Para verificar qual caso se aplica à sua sessão, peça a Claude para executar `echo $GH_TOKEN`.
124
125O CLI `gh` não está pré-instalado. Se você precisar de um comando `gh` que as ferramentas integradas não cobrem, como `gh release` ou `gh workflow run`, instale e autentique você mesmo:
126
127<Steps>
128 <Step title="Instale gh em seu script de configuração">
129 Adicione `apt update && apt install -y gh` ao seu [script de configuração](#setup-scripts).
130 </Step>
131
132 <Step title="Forneça um token se o proxy não estiver tratando a autenticação">
133 Se `echo $GH_TOKEN` imprime `proxy-injected`, o [proxy GitHub](#github-proxy) autentica `gh` para você e esta etapa é desnecessária. Caso contrário, adicione uma variável de ambiente `GH_TOKEN` às suas [configurações de ambiente](#configure-your-environment) com um token de acesso pessoal do GitHub. `gh` lê `GH_TOKEN` automaticamente, então nenhuma etapa `gh auth login` é necessária.
134 </Step>
135</Steps>
136
137<h3 id="link-output-back-to-the-session">
138 Vincule a saída de volta à sessão
139</h3>
140
141Cada sessão em nuvem tem uma URL de transcrição em claude.ai, e a sessão pode ler seu próprio ID a partir da variável de ambiente `CLAUDE_CODE_REMOTE_SESSION_ID`. Use isso para colocar um link rastreável em corpos de PR, mensagens de commit, posts do Slack ou relatórios gerados para que um revisor possa abrir a execução que os produziu.
142
143A partir da v2.1.179, commits que Claude cria em uma sessão web incluem um trailer git `Claude-Session: <url>`, e corpos de PR incluem a URL da sessão em sua própria linha. A partir da v2.1.182, defina [`attribution.sessionUrl`](/docs/pt/settings#attribution-settings) como `false` para omitir o trailer e o link do corpo de PR.
144
145Para incluir o link da sessão em algo diferente de um commit ou PR, como uma mensagem do Slack que Claude posta ou um arquivo de relatório que ele escreve, peça a Claude para executar o seguinte comando e use sua saída. O comando converte o prefixo `cse_` no valor da variável de ambiente para o prefixo `session_` que a URL de transcrição espera:
146
147```bash theme={null}
148echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
149```
150
151<h3 id="run-tests-start-services-and-add-packages">
152 Execute testes, inicie serviços e adicione pacotes
153</h3>
154
155Claude executa testes como parte do trabalho em uma tarefa. Peça no seu prompt, como "fix the failing tests in `tests/`" ou "run pytest after each change." Executores de teste como pytest, jest e cargo test estão pré-instalados e funcionam sem configuração adicional.
156
157PostgreSQL e Redis estão pré-instalados mas não estão em execução por padrão. Peça a Claude para iniciar cada um durante a sessão:
158
159```bash theme={null}
160service postgresql start
161```
162
163```bash theme={null}
164service redis-server start
165```
166
167Docker está disponível para executar serviços em contêiner. Peça a Claude para executar `docker compose up` para iniciar os serviços do seu projeto. O acesso à rede para puxar imagens segue o [nível de acesso](#access-levels) do seu ambiente, e os [Padrões confiáveis](#default-allowed-domains) incluem Docker Hub e outros registros comuns.
168
169Se suas imagens são grandes ou lentas para puxar, adicione `docker compose pull` ou `docker compose build` ao seu [script de configuração](#setup-scripts). As imagens puxadas são salvas no [ambiente em cache](#environment-caching), então cada nova sessão as tem no disco. O cache armazena apenas arquivos, não processos em execução, então Claude ainda inicia os contêineres cada sessão.
170
171Para adicionar pacotes que não estão pré-instalados, use um [script de configuração](#setup-scripts). A saída do script é [armazenada em cache](#environment-caching), então os pacotes que você instala lá estão disponíveis no início de cada sessão sem reinstalar cada vez. Você também pode pedir a Claude para instalar pacotes durante a sessão, mas essas instalações não persistem entre sessões.
172
173<h3 id="resource-limits">
174 Limites de recursos
175</h3>
176
177As sessões em nuvem são executadas com limites de recursos aproximados que podem mudar ao longo do tempo:
178
179* 4 vCPUs
180* 16 GB de RAM
181* 30 GB de disco
182
183Tarefas que requerem significativamente mais memória, como grandes trabalhos de compilação ou testes com uso intensivo de memória, podem falhar ou ser encerradas. Para cargas de trabalho além desses limites, use [Remote Control](/docs/pt/remote-control) para executar Claude Code em seu próprio hardware.
184
185<h3 id="configure-your-environment">
186 Configure seu ambiente
187</h3>
188
189Os ambientes controlam [acesso à rede](#network-access), variáveis de ambiente e o [script de configuração](#setup-scripts) que é executado antes de uma sessão iniciar. Veja [Ferramentas instaladas](#installed-tools) para o que está disponível sem nenhuma configuração. Você pode gerenciar ambientes a partir da interface web ou do terminal:
190
191| Ação | Como |
192| :------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
193| Adicione um ambiente | Selecione o ambiente atual para abrir o seletor, depois selecione **Add environment**. O diálogo inclui nome, nível de acesso à rede, variáveis de ambiente e script de configuração. |
194| Edite um ambiente | Selecione o ícone de nuvem mostrando o nome do ambiente atual para abrir o seletor, passe o mouse sobre um ambiente e clique no ícone de configurações que aparece à direita. |
195| Arquive um ambiente | Abra o ambiente para edição e selecione **Archive**. Ambientes arquivados ficam ocultos do seletor mas as sessões existentes continuam em execução. |
196| Defina o padrão para `--remote` | Execute `/remote-env` em seu terminal. Se você tiver um único ambiente, este comando mostra sua configuração atual. `/remote-env` apenas seleciona o padrão; adicione, edite e arquive ambientes a partir da interface web. |
197
198As variáveis de ambiente usam formato `.env` com um par `KEY=value` por linha. Não envolva valores em aspas, já que as aspas são armazenadas como parte do valor. Este exemplo define três variáveis:
199
200```text theme={null}
201NODE_ENV=development
202LOG_LEVEL=debug
203DATABASE_URL=postgres://localhost:5432/myapp
204```
205
206<h3 id="organization-shared-environments">
207 Ambientes compartilhados da organização
208</h3>
209
210Proprietários e administradores em planos Team e Enterprise podem criar ambientes em nuvem que são compartilhados com cada membro da organização. Ambientes compartilhados aparecem no seletor de ambiente de cada membro ao lado dos seus pessoais, então um time pode padronizar em uma configuração em vez de cada membro recriá-la.
211
212Gerencie ambientes compartilhados a partir da página **Cloud environments** em [configurações de administrador](https://claude.ai/admin-settings). De lá você pode:
213
214* Criar, editar e arquivar ambientes compartilhados. Cada um tem os mesmos campos que um ambiente pessoal: um nome, um [nível de acesso à rede](#access-levels), [variáveis de ambiente](#configure-your-environment) em formato `.env`, e um [script de configuração](#setup-scripts).
215* Defina o ambiente padrão para a organização.
216
217Valores em um ambiente compartilhado chegam às sessões de cada membro naquele ambiente. Como ambientes pessoais, ambientes compartilhados não têm armazenamento de segredos dedicado, então não inclua segredos.
218
219<h2 id="setup-scripts">
220 Scripts de configuração
221</h2>
222
223Um script de configuração é um script Bash que é executado quando uma nova sessão em nuvem inicia, antes de Claude Code ser lançado. Use scripts de configuração para instalar dependências, configurar ferramentas ou buscar qualquer coisa que a sessão precise que não esteja pré-instalada.
224
225Os scripts são executados como root no Ubuntu 24.04, então `apt install` e a maioria dos gerenciadores de pacotes de linguagem funcionam.
226
227Para adicionar um script de configuração, abra o diálogo de configurações de ambiente e insira seu script no campo **Setup script**.
228
229Este exemplo instala o CLI `gh`, que não está pré-instalado:
230
231```bash theme={null}
232#!/bin/bash
233apt update && apt install -y gh
234```
235
236Se o script sair com código diferente de zero, a sessão falha ao iniciar. Acrescente `|| true` a comandos não críticos para evitar bloquear a sessão em uma falha de instalação intermitente.
237
238Mantenha o tempo de execução total do script abaixo de aproximadamente cinco minutos para que o [cache de ambiente](#environment-caching) possa ser construído. Execute instalações independentes em paralelo com `&` e `wait`. Se um único download não se encaixar no limite de cinco minutos, mova-o para um [hook SessionStart](#setup-scripts-vs-sessionstart-hooks) que o inicia em segundo plano.
239
240<Note>
241 Scripts de configuração que instalam pacotes precisam de acesso à rede para alcançar registros. O acesso à rede padrão **Trusted** permite conexões com [domínios comuns permitidos](#default-allowed-domains) incluindo npm, PyPI, RubyGems e crates.io. Os scripts falharão ao instalar pacotes se seu ambiente usar acesso à rede **None**.
242</Note>
243
244<h3 id="environment-caching">
245 Armazenamento em cache de ambiente
246</h3>
247
248O script de configuração é executado na primeira vez que você inicia uma sessão em um ambiente. Depois que é concluído, a Anthropic tira um snapshot do sistema de arquivos e reutiliza esse snapshot como ponto de partida para sessões posteriores. Novas sessões começam com suas dependências, ferramentas e imagens Docker já no disco, e a etapa de script de configuração é ignorada. Isso mantém a inicialização rápida mesmo quando o script instala grandes cadeias de ferramentas ou puxa imagens de contêiner.
249
250O cache captura arquivos, não processos em execução. Qualquer coisa que o script de configuração escreve no disco é transferida. Serviços ou contêineres que ele inicia não são, então inicie-os por sessão pedindo a Claude ou com um [hook SessionStart](#setup-scripts-vs-sessionstart-hooks).
251
252O script de configuração é executado novamente para reconstruir o cache quando você altera o script de configuração do ambiente ou hosts de rede permitidos, e quando o cache atinge sua expiração após aproximadamente sete dias. Retomar uma sessão existente nunca executa novamente o script de configuração.
253
254Você não precisa habilitar armazenamento em cache ou gerenciar snapshots você mesmo.
255
256<h3 id="setup-scripts-vs-sessionstart-hooks">
257 Scripts de configuração vs. SessionStart hooks
258</h3>
259
260Use um script de configuração para instalar coisas que a nuvem precisa mas seu laptop já tem, como um tempo de execução de linguagem ou ferramenta CLI. Use um [SessionStart hook](/docs/pt/hooks#sessionstart) para configuração de projeto que deve ser executada em todos os lugares, nuvem e local, como `npm install`.
261
262Ambos são executados no início de uma sessão, mas pertencem a lugares diferentes:
263
264| | Scripts de configuração | SessionStart hooks |
265| -------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
266| Anexado a | O ambiente em nuvem | Seu repositório |
267| Configurado em | Interface do usuário do ambiente em nuvem | `.claude/settings.json` em seu repositório |
268| Executa | Antes de Claude Code ser lançado, quando nenhum [ambiente em cache](#environment-caching) está disponível | Depois de Claude Code ser lançado, em todas as sessões incluindo retomadas |
269| Escopo | Apenas ambientes em nuvem | Ambientes locais e em nuvem |
270
271Os SessionStart hooks também podem ser definidos em seu `~/.claude/settings.json` no nível do usuário localmente, mas as configurações no nível do usuário não são transferidas para sessões em nuvem. Na nuvem, hooks vêm do repositório e das [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) da sua organização.
272
273<h3 id="install-dependencies-with-a-sessionstart-hook">
274 Instale dependências com um SessionStart hook
275</h3>
276
277Para instalar dependências apenas em sessões em nuvem, adicione um SessionStart hook ao `.claude/settings.json` do seu repositório:
278
279```json theme={null}
280{
281 "hooks": {
282 "SessionStart": [
283 {
284 "matcher": "startup|resume",
285 "hooks": [
286 {
287 "type": "command",
288 "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
289 }
290 ]
291 }
292 ]
293 }
294}
295```
296
297Crie o script em `scripts/install_pkgs.sh` e torne-o executável com `chmod +x`. A variável de ambiente `CLAUDE_CODE_REMOTE` é definida como `true` em sessões em nuvem, então você pode usá-la para pular execução local:
298
299```bash theme={null}
300#!/bin/bash
301
302if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
303 exit 0
304fi
305
306npm install
307pip install -r requirements.txt
308exit 0
309```
310
311Os SessionStart hooks têm algumas limitações em sessões em nuvem:
312
313* **Sem escopo apenas para nuvem**: os hooks são executados em sessões locais e em nuvem. Para pular execução local, verifique a variável de ambiente `CLAUDE_CODE_REMOTE` conforme mostrado acima.
314* **Requer acesso à rede**: os comandos de instalação precisam alcançar registros de pacotes. Se seu ambiente usar acesso à rede **None**, esses hooks falham. A [lista de permissões padrão](#default-allowed-domains) em **Trusted** cobre npm, PyPI, RubyGems e crates.io.
315* **Compatibilidade com proxy**: todo o tráfego de saída passa por um [proxy de segurança](#security-proxy). Alguns gerenciadores de pacotes não funcionam corretamente com este proxy. Bun é um exemplo conhecido.
316* **Adiciona latência de inicialização**: os hooks são executados cada vez que uma sessão inicia ou é retomada, diferentemente de scripts de configuração que se beneficiam do [armazenamento em cache de ambiente](#environment-caching). Mantenha os scripts de instalação rápidos verificando se as dependências já estão presentes antes de reinstalar.
317
318Para persistir variáveis de ambiente para comandos Bash subsequentes, escreva no arquivo em `$CLAUDE_ENV_FILE`. Veja [SessionStart hooks](/docs/pt/hooks#sessionstart) para detalhes.
319
320Substituir a imagem base pela sua própria imagem Docker ainda não é suportado. Use um script de configuração para instalar o que você precisa no topo da [imagem fornecida](#installed-tools), ou execute sua imagem como um contêiner ao lado de Claude com `docker compose`.
321
322<h2 id="network-access">
323 Acesso à rede
324</h2>
325
326O acesso à rede controla conexões de saída do ambiente em nuvem. Cada ambiente especifica um nível de acesso, e você pode estendê-lo com domínios permitidos personalizados. O padrão é **Trusted**, que permite registros de pacotes e outros [domínios na lista de permissões](#default-allowed-domains).
327
328Para alterar o acesso à rede de um ambiente, [abra-o para edição](#configure-your-environment) e use o seletor **Network access** no diálogo. Não há uma página Environments separada. O ícone de nuvem aparece em qualquer lugar que você inicie uma sessão em nuvem ou configure uma [routine](/docs/pt/routines#environments-and-network-access).
329
330<Note>
331 O tráfego do conector MCP é roteado através dos servidores da Anthropic, então os conectores que você habilita em uma sessão ou routine funcionam sem adicionar seus hosts aos **Allowed domains**. Os conectores são configurados por sessão ou por routine; remova qualquer um que você não precise para limitar quais ferramentas Claude pode alcançar. Isso depende do mesmo canal vinculado à Anthropic observado em [Segurança e isolamento](#security-and-isolation).
332</Note>
333
334<h3 id="access-levels">
335 Níveis de acesso
336</h3>
337
338Escolha um nível de acesso quando você criar ou editar um ambiente:
339
340| Nível | Conexões de saída |
341| :---------- | :-------------------------------------------------------------------------------------------------------------- |
342| **None** | Sem acesso à rede de saída |
343| **Trusted** | [Domínios na lista de permissões](#default-allowed-domains) apenas: registros de pacotes, GitHub, SDKs em nuvem |
344| **Full** | Qualquer domínio |
345| **Custom** | Sua própria lista de permissões, opcionalmente incluindo os padrões |
346
347As operações do GitHub usam um [proxy separado](#github-proxy) que é independente desta configuração.
348
349<h3 id="allow-specific-domains">
350 Permita domínios específicos
351</h3>
352
353Para permitir domínios que não estão na lista Trusted, selecione **Custom** nas configurações de acesso à rede do ambiente. Um campo **Allowed domains** aparece. Insira um domínio por linha:
354
355```text theme={null}
356api.example.com
357*.internal.example.com
358registry.example.com
359```
360
361Use `*.` para correspondência de subdomínio curinga. Marque **Also include default list of common package managers** para manter os [domínios Trusted](#default-allowed-domains) junto com suas entradas personalizadas, ou deixe desmarcado para permitir apenas o que você listar.
362
363Os domínios permitidos são configurados por ambiente. Não há uma lista de permissões no nível da organização que os Proprietários possam enviar para os ambientes de todos os usuários; [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) podem restringir sessões em nuvem, mas não podem adicionar domínios permitidos.
364
365<h3 id="github-proxy">
366 Proxy GitHub
367</h3>
368
369Para segurança, todas as operações do GitHub passam por um serviço de proxy dedicado que mantém suas credenciais reais do GitHub fora da sandbox. O proxy autentica dois tipos de tráfego:
370
371* Interações Git: o cliente git dentro da sandbox usa uma credencial com escopo personalizado, que o proxy verifica e traduz para seu token de autenticação GitHub real
372* Solicitações da API do GitHub: o proxy substitui suas credenciais reais em solicitações das ferramentas GitHub integradas e de `gh` quando sua sessão define o placeholder `proxy-injected` descrito em [Trabalhe com problemas e pull requests do GitHub](#work-with-github-issues-and-pull-requests)
373
374O proxy também restringe operações git push para a branch de trabalho atual por segurança, e permite clonagem, busca e operações de PR enquanto mantém limites de segurança.
375
376O proxy limita solicitações de API do GitHub e de ativos de lançamento a repositórios anexados à sessão, independentemente do [nível de acesso à rede](#access-levels) do ambiente. Scripts de configuração que baixam ativos de lançamento de repositórios não anexados retornam um 403. Arquivos confirmados de repositórios públicos são buscados através de `raw.githubusercontent.com`, que o [proxy de segurança](#security-proxy) trata em vez disso. Esse domínio está na [lista Trusted](#default-allowed-domains) padrão, então os arquivos permanecem acessíveis a menos que o [nível de acesso](#access-levels) do ambiente o exclua.
377
378<h3 id="security-proxy">
379 Proxy de segurança
380</h3>
381
382Os ambientes são executados atrás de um proxy de rede HTTP/HTTPS para fins de segurança e prevenção de abuso. Todo o tráfego de Internet de saída passa por este proxy, que fornece:
383
384* Proteção contra solicitações maliciosas
385* Limitação de taxa e prevenção de abuso
386* Filtragem de conteúdo para segurança aprimorada
387* Uma trilha de auditoria em nível de DNS de nomes de host solicitados
388
389<h3 id="default-allowed-domains">
390 Domínios padrão permitidos
391</h3>
392
393Ao usar acesso à rede **Trusted**, os seguintes domínios são permitidos por padrão. Domínios marcados com `*` indicam correspondência de subdomínio curinga, então `*.gcr.io` permite qualquer subdomínio de `gcr.io`.
394
395<AccordionGroup>
396 <Accordion title="Serviços Anthropic">
397 * api.anthropic.com
398 * statsig.anthropic.com
399 * docs.claude.com
400 * platform.claude.com
401 * code.claude.com
402 * claude.ai
403 </Accordion>
404
405 <Accordion title="Controle de versão">
406 * github.com
407 * [www.github.com](http://www.github.com)
408 * api.github.com
409 * npm.pkg.github.com
410 * raw\.githubusercontent.com
411 * pkg-npm.githubusercontent.com
412 * objects.githubusercontent.com
413 * release-assets.githubusercontent.com
414 * codeload.github.com
415 * avatars.githubusercontent.com
416 * camo.githubusercontent.com
417 * gist.github.com
418 * gitlab.com
419 * [www.gitlab.com](http://www.gitlab.com)
420 * registry.gitlab.com
421 * bitbucket.org
422 * [www.bitbucket.org](http://www.bitbucket.org)
423 * api.bitbucket.org
424 </Accordion>
425
426 <Accordion title="Registros de contêiner">
427 * registry-1.docker.io
428 * auth.docker.io
429 * index.docker.io
430 * hub.docker.com
431 * [www.docker.com](http://www.docker.com)
432 * production.cloudflare.docker.com
433 * download.docker.com
434 * gcr.io
435 * \*.gcr.io
436 * ghcr.io
437 * mcr.microsoft.com
438 * \*.data.mcr.microsoft.com
439 * public.ecr.aws
440 </Accordion>
441
442 <Accordion title="Plataformas em nuvem">
443 * cloud.google.com
444 * accounts.google.com
445 * gcloud.google.com
446 * \*.googleapis.com
447 * storage.googleapis.com
448 * compute.googleapis.com
449 * container.googleapis.com
450 * azure.com
451 * portal.azure.com
452 * microsoft.com
453 * [www.microsoft.com](http://www.microsoft.com)
454 * \*.microsoftonline.com
455 * packages.microsoft.com
456 * dotnet.microsoft.com
457 * dot.net
458 * visualstudio.com
459 * dev.azure.com
460 * \*.amazonaws.com
461 * \*.api.aws
462 * oracle.com
463 * [www.oracle.com](http://www.oracle.com)
464 * java.com
465 * [www.java.com](http://www.java.com)
466 * java.net
467 * [www.java.net](http://www.java.net)
468 * download.oracle.com
469 * yum.oracle.com
470 </Accordion>
471
472 <Accordion title="Gerenciadores de pacotes JavaScript e Node">
473 * registry.npmjs.org
474 * [www.npmjs.com](http://www.npmjs.com)
475 * [www.npmjs.org](http://www.npmjs.org)
476 * npmjs.com
477 * npmjs.org
478 * yarnpkg.com
479 * registry.yarnpkg.com
480 </Accordion>
481
482 <Accordion title="Gerenciadores de pacotes Python">
483 * pypi.org
484 * [www.pypi.org](http://www.pypi.org)
485 * files.pythonhosted.org
486 * pythonhosted.org
487 * test.pypi.org
488 * pypi.python.org
489 * pypa.io
490 * [www.pypa.io](http://www.pypa.io)
491 </Accordion>
492
493 <Accordion title="Gerenciadores de pacotes Ruby">
494 * rubygems.org
495 * [www.rubygems.org](http://www.rubygems.org)
496 * api.rubygems.org
497 * index.rubygems.org
498 * ruby-lang.org
499 * [www.ruby-lang.org](http://www.ruby-lang.org)
500 * rubyforge.org
501 * [www.rubyforge.org](http://www.rubyforge.org)
502 * rubyonrails.org
503 * [www.rubyonrails.org](http://www.rubyonrails.org)
504 * rvm.io
505 * get.rvm.io
506 </Accordion>
507
508 <Accordion title="Gerenciadores de pacotes Rust">
509 * crates.io
510 * [www.crates.io](http://www.crates.io)
511 * index.crates.io
512 * static.crates.io
513 * rustup.rs
514 * static.rust-lang.org
515 * [www.rust-lang.org](http://www.rust-lang.org)
516 </Accordion>
517
518 <Accordion title="Gerenciadores de pacotes Go">
519 * proxy.golang.org
520 * sum.golang.org
521 * index.golang.org
522 * golang.org
523 * [www.golang.org](http://www.golang.org)
524 * goproxy.io
525 * pkg.go.dev
526 </Accordion>
527
528 <Accordion title="Gerenciadores de pacotes JVM">
529 * maven.org
530 * repo.maven.org
531 * central.maven.org
532 * repo1.maven.org
533 * repo.maven.apache.org
534 * jcenter.bintray.com
535 * gradle.org
536 * [www.gradle.org](http://www.gradle.org)
537 * services.gradle.org
538 * plugins.gradle.org
539 * kotlinlang.org
540 * [www.kotlinlang.org](http://www.kotlinlang.org)
541 * spring.io
542 * repo.spring.io
543 </Accordion>
544
545 <Accordion title="Outros gerenciadores de pacotes">
546 * packagist.org (PHP Composer)
547 * [www.packagist.org](http://www.packagist.org)
548 * repo.packagist.org
549 * nuget.org (.NET NuGet)
550 * [www.nuget.org](http://www.nuget.org)
551 * api.nuget.org
552 * pub.dev (Dart/Flutter)
553 * api.pub.dev
554 * hex.pm (Elixir/Erlang)
555 * [www.hex.pm](http://www.hex.pm)
556 * cpan.org (Perl CPAN)
557 * [www.cpan.org](http://www.cpan.org)
558 * metacpan.org
559 * [www.metacpan.org](http://www.metacpan.org)
560 * api.metacpan.org
561 * cocoapods.org (iOS/macOS)
562 * [www.cocoapods.org](http://www.cocoapods.org)
563 * cdn.cocoapods.org
564 * haskell.org
565 * [www.haskell.org](http://www.haskell.org)
566 * hackage.haskell.org
567 * swift.org
568 * [www.swift.org](http://www.swift.org)
569 </Accordion>
570
571 <Accordion title="Distribuições Linux">
572 * archive.ubuntu.com
573 * security.ubuntu.com
574 * ubuntu.com
575 * [www.ubuntu.com](http://www.ubuntu.com)
576 * \*.ubuntu.com
577 * ppa.launchpad.net
578 * launchpad.net
579 * [www.launchpad.net](http://www.launchpad.net)
580 * \*.nixos.org
581 </Accordion>
582
583 <Accordion title="Ferramentas de desenvolvimento e plataformas">
584 * dl.k8s.io (Kubernetes)
585 * pkgs.k8s.io
586 * k8s.io
587 * [www.k8s.io](http://www.k8s.io)
588 * releases.hashicorp.com (HashiCorp)
589 * apt.releases.hashicorp.com
590 * rpm.releases.hashicorp.com
591 * archive.releases.hashicorp.com
592 * hashicorp.com
593 * [www.hashicorp.com](http://www.hashicorp.com)
594 * repo.anaconda.com (Anaconda/Conda)
595 * conda.anaconda.org
596 * anaconda.org
597 * [www.anaconda.com](http://www.anaconda.com)
598 * anaconda.com
599 * continuum.io
600 * apache.org (Apache)
601 * [www.apache.org](http://www.apache.org)
602 * archive.apache.org
603 * downloads.apache.org
604 * eclipse.org (Eclipse)
605 * [www.eclipse.org](http://www.eclipse.org)
606 * download.eclipse.org
607 * nodejs.org (Node.js)
608 * [www.nodejs.org](http://www.nodejs.org)
609 * developer.apple.com
610 * developer.android.com
611 * pkg.stainless.com
612 * binaries.prisma.sh
613 </Accordion>
614
615 <Accordion title="Serviços em nuvem e monitoramento">
616 * statsig.com
617 * [www.statsig.com](http://www.statsig.com)
618 * api.statsig.com
619 * sentry.io
620 * \*.sentry.io
621 * downloads.sentry-cdn.com
622 * http-intake.logs.datadoghq.com
623 * browser-intake-us5-datadoghq.com
624 * \*.datadoghq.com
625 * \*.datadoghq.eu
626 * api.honeycomb.io
627 </Accordion>
628
629 <Accordion title="Entrega de conteúdo e espelhos">
630 * sourceforge.net
631 * \*.sourceforge.net
632 * packagecloud.io
633 * \*.packagecloud.io
634 * fonts.googleapis.com
635 * fonts.gstatic.com
636 </Accordion>
637
638 <Accordion title="Schema e configuração">
639 * json-schema.org
640 * [www.json-schema.org](http://www.json-schema.org)
641 * json.schemastore.org
642 * [www.schemastore.org](http://www.schemastore.org)
643 </Accordion>
644
645 <Accordion title="Model Context Protocol">
646 * \*.modelcontextprotocol.io
647 </Accordion>
648</AccordionGroup>
649
650<h2 id="move-tasks-between-web-and-terminal">62<h2 id="move-tasks-between-web-and-terminal">
651 Mover tarefas entre web e terminal63 Mover tarefas entre web e terminal
652</h2>64</h2>
654Esses fluxos de trabalho requerem o [Claude Code CLI](/docs/pt/quickstart) conectado à mesma conta claude.ai. Você pode iniciar novas sessões em nuvem a partir do seu terminal, ou puxar sessões em nuvem para seu terminal para continuar localmente. As sessões em nuvem persistem mesmo se você fechar seu laptop, e você pode monitorá-las de qualquer lugar, incluindo o aplicativo móvel Claude.66Esses fluxos de trabalho requerem o [Claude Code CLI](/docs/pt/quickstart) conectado à mesma conta claude.ai. Você pode iniciar novas sessões em nuvem a partir do seu terminal, ou puxar sessões em nuvem para seu terminal para continuar localmente. As sessões em nuvem persistem mesmo se você fechar seu laptop, e você pode monitorá-las de qualquer lugar, incluindo o aplicativo móvel Claude.
655 67
656<Note>68<Note>
657 A partir do CLI, a transferência de sessão é unidirecional: você pode puxar sessões em nuvem para seu terminal com `--teleport`, mas não pode enviar uma sessão de terminal existente para a web. O sinalizador `--cloud` cria uma nova sessão em nuvem para seu repositório atual. O [aplicativo Desktop](/docs/pt/desktop#continue-in-another-surface) fornece um menu Continue in que pode enviar uma sessão local para a web.69 A partir do CLI, a transferência de sessão é unidirecional: você pode puxar sessões em nuvem para seu terminal com `--teleport`, mas não pode enviar uma sessão de terminal existente para a web. O sinalizador `--cloud` com uma descrição de tarefa cria uma nova sessão em nuvem para seu repositório atual; com `-p` e um ID de sessão ou URL claude.ai/code, ele [enfileira uma mensagem naquela sessão existente](/docs/pt/claude-code-on-the-web#send-follow-ups-from-the-cli). O [aplicativo Desktop](/docs/pt/desktop#continue-in-another-surface) fornece um menu Continue in que pode enviar uma sessão local para a web.
658</Note>70</Note>
659 71
660<h3 id="from-terminal-to-web">72<h3 id="from-terminal-to-web">
667claude --cloud "Fix the authentication bug in src/auth/login.ts"79claude --cloud "Fix the authentication bug in src/auth/login.ts"
668```80```
669 81
670Isso cria uma nova sessão em nuvem em claude.ai. A sessão clona o remoto GitHub do seu diretório atual na sua branch atual, então envie primeiro se você tiver commits locais, já que a VM clona do GitHub em vez de sua máquina. `--cloud` funciona com um repositório por vez. A tarefa é executada na nuvem enquanto você continua trabalhando localmente. A ortografia mais antiga `--remote` ainda funciona como um alias descontinuado para `--cloud`.82Isso cria uma nova sessão em nuvem em claude.ai. A VM em nuvem clona o remoto GitHub do seu diretório atual na sua branch atual, não seu checkout local, então envie primeiro se você tiver commits locais. `--cloud` funciona com um repositório por vez. A tarefa é executada na nuvem enquanto você continua trabalhando localmente. A ortografia mais antiga `--remote` ainda funciona como um alias descontinuado para `--cloud`.
671 83
672A partir da v2.1.195, o 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](#setup-scripts), enquanto o contêiner em nuvem é iniciado. As mensagens que você digita enquanto o contêiner está sendo provisionado são enfileiradas e enviadas assim que a sessão estiver pronta.84Enquanto o contêiner em nuvem inicia, o 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](/docs/pt/cloud-environments#setup-scripts). Ele enfileira mensagens que você digita durante o provisionamento e as envia assim que a sessão estiver pronta.
673 85
674<Note>86<Note>
675 `--cloud` cria sessões em nuvem. `--remote-control` não está relacionado: expõe uma sessão CLI local para monitoramento a partir da web. Veja [Remote Control](/docs/pt/remote-control).87 `--cloud` cria sessões em nuvem. `--remote-control` não está relacionado: expõe uma sessão CLI local para monitoramento a partir da web. Veja [Remote Control](/docs/pt/remote-control).
677 89
678Use `/tasks` no Claude Code CLI para verificar o progresso, ou abra a sessão em claude.ai ou no aplicativo móvel Claude para interagir diretamente. De lá você pode orientar Claude, fornecer feedback ou responder perguntas como em qualquer outra conversa.90Use `/tasks` no Claude Code CLI para verificar o progresso, ou abra a sessão em claude.ai ou no aplicativo móvel Claude para interagir diretamente. De lá você pode orientar Claude, fornecer feedback ou responder perguntas como em qualquer outra conversa.
679 91
92Se Claude fizer uma pergunta e a sessão ficar ociosa, você ainda pode responder quando voltar, até [expiração do ambiente](#environment-expired), e a sessão continua a partir de sua resposta.
93
680<h4 id="tips-for-cloud-tasks">94<h4 id="tips-for-cloud-tasks">
681 Dicas para tarefas em nuvem95 Dicas para tarefas em nuvem
682</h4>96</h4>
693claude --cloud "Execute the migration plan in docs/migration-plan.md"107claude --cloud "Execute the migration plan in docs/migration-plan.md"
694```108```
695 109
696Este padrão oferece controle sobre a estratégia enquanto permite que Claude execute autonomamente na nuvem.
697
698**Planeje na nuvem com ultraplan**: para rascunhar e revisar o plano em si em uma sessão web, use [ultraplan](/docs/pt/ultraplan). Claude gera o plano em Claude Code na web enquanto você continua trabalhando, depois você comenta em seções em seu navegador e escolhe executar remotamente ou enviar o plano de volta para seu terminal.
699
700**Execute tarefas em paralelo**: cada comando `--cloud` cria sua própria sessão em nuvem que é executada independentemente. Você pode iniciar múltiplas tarefas e todas serão executadas simultaneamente em sessões separadas:110**Execute tarefas em paralelo**: cada comando `--cloud` cria sua própria sessão em nuvem que é executada independentemente. Você pode iniciar múltiplas tarefas e todas serão executadas simultaneamente em sessões separadas:
701 111
702```bash theme={null}112```bash theme={null}
713 123
714Quando você executa `claude --cloud` a partir de um repositório que não está conectado ao GitHub, Claude Code agrupa seu repositório local e o carrega diretamente para a sessão em nuvem. O pacote inclui seu histórico completo de repositório em todas as branches, mais quaisquer alterações não confirmadas em arquivos rastreados.124Quando você executa `claude --cloud` a partir de um repositório que não está conectado ao GitHub, Claude Code agrupa seu repositório local e o carrega diretamente para a sessão em nuvem. O pacote inclui seu histórico completo de repositório em todas as branches, mais quaisquer alterações não confirmadas em arquivos rastreados.
715 125
126Em 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. Em um worktree vinculado, submódulo ou layout similar, Claude Code carrega essas alterações com o resto e nomeia os arquivos que carrega.
127
716Este fallback é ativado automaticamente quando o acesso ao GitHub não está disponível. Para forçá-lo mesmo quando o GitHub está conectado, defina `CCR_FORCE_BUNDLE=1`:128Este fallback é ativado automaticamente quando o acesso ao GitHub não está disponível. Para forçá-lo mesmo quando o GitHub está conectado, defina `CCR_FORCE_BUNDLE=1`:
717 129
718```bash theme={null}130```bash theme={null}
726* Arquivos não rastreados não estão incluídos; execute `git add` em arquivos que você deseja que a sessão em nuvem veja138* Arquivos não rastreados não estão incluídos; execute `git add` em arquivos que você deseja que a sessão em nuvem veja
727* As sessões criadas a partir de um pacote não podem enviar de volta para um remoto a menos que você também tenha [autenticação do GitHub](#github-authentication-options) configurada139* As sessões criadas a partir de um pacote não podem enviar de volta para um remoto a menos que você também tenha [autenticação do GitHub](#github-authentication-options) configurada
728 140
141<h3 id="send-follow-ups-from-the-cli">
142 Envie follow-ups a partir do CLI
143</h3>
144
145Depois que uma sessão em nuvem está em execução, em qualquer lugar que ela seja executada, envie uma mensagem de follow-up a partir do CLI `claude` em qualquer máquina onde você esteja conectado com `claude auth login`. O CLI autentica com suas credenciais de conta Anthropic e não envia nenhum estado de sessão local, então 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.
146
147O comando publica uma mensagem e sai:
148
149```bash theme={null}
150claude -p "your message" --cloud <session-id>
151```
152
153O CLI enfileira a mensagem na sessão e sai sem esperar por uma resposta. Use-o para orientar uma sessão de longa duração, enfileire a próxima etapa enquanto a atual ainda está terminando, ou envie follow-ups a partir de um [script de CI](/docs/pt/self-hosted-environments-testing#run-the-test-loop). 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>`.
154
155Para `<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.
156
157<Note>
158 `--cloud` requer uma conta Anthropic. Não está disponível quando Claude Code está configurado para Amazon Bedrock, Google Cloud's Agent Platform ou outro provedor de terceiros. Um [gateway LLM](/docs/pt/llm-gateway) configurado apenas através de `ANTHROPIC_BASE_URL` não conta como um provedor de terceiros para esta verificação, mas você ainda precisa entrar 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.
159</Note>
160
161<h4 id="output-and-errors">
162 Saída e erros
163</h4>
164
165No sucesso, o comando imprime o ID da sessão e um link para visualizar a sessão:
166
167```
168Sent to cloud session.
169Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
170View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0
171```
172
173Passe `--output-format json` para um resultado legível por máquina: `{ok, session_id, url}` no sucesso, ou `{ok: false, session_id, error}` quando o envio falha, por exemplo quando a sessão está faltando ou arquivada. Erros de configuração, como um provedor não suportado ou uma política de organização desabilitada, imprimem em stderr sem JSON. `--output-format stream-json` não é suportado com `--cloud <session-id>`.
174
175O CLI prefixos erros com `Error: `. Uma entrega falhada é envolvida como `failed to send message to cloud session <id>: <reason>`.
176
177| Mensagem | O que significa |
178| --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
179| `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 desconfigurar `CLAUDE_CODE_USE_BEDROCK`, e entre com uma conta Anthropic (`claude auth login`). |
180| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | A política de organização `allow_remote_sessions` está desabilitada. |
181| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code não conseguiu buscar a política de sua organização, então recusa o envio em vez de assumir que as sessões em nuvem são permitidas. Verifique sua conexão de rede e tente novamente. |
182| `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>`. |
183| `Session not found: <id>` | O ID ou URL não corresponde a uma sessão que você pode acessar. Verifique-o contra a URL claude.ai/code da sessão. |
184| `cloud session <id> is archived and cannot accept new messages` | A sessão foi arquivada. Inicie uma nova sessão em vez disso. |
185
729<h3 id="from-web-to-terminal">186<h3 id="from-web-to-terminal">
730 Da web para o terminal187 Da web para o terminal
731</h3>188</h3>
735* **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.192* **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.
736* **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.193* **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.
737* **De `/tasks`**: execute `/tasks` para ver suas sessões em segundo plano, depois pressione `t` para teleportar para uma.194* **De `/tasks`**: execute `/tasks` para ver suas sessões em segundo plano, depois pressione `t` para teleportar para uma.
738* **Da interface web**: selecione **Open in CLI** para copiar um comando que você pode colar em seu terminal.195* **Da interface web**: selecione **Open in > Terminal** no menu de sessão para copiar um comando que você pode colar em seu terminal.
196* **De dentro da sessão em 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.
739 197
740Quando você teleporta uma sessão, Claude verifica se você está no repositório correto, busca e faz checkout da branch da sessão em nuvem e carrega o histórico completo da conversa em seu terminal.198Quando você teleporta uma sessão, Claude verifica se você está no repositório correto, busca e faz checkout da branch da sessão em 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á fica local e não aparece na sessão em nuvem em claude.ai ou no aplicativo móvel Claude. Para continuar orientando a partir do seu telefone após teleportar, inicie [`/remote-control`](/docs/pt/remote-control) na sessão local.
741 199
742`--teleport` é distinto de `--resume`. `--resume` reabre uma conversa do histórico local desta máquina e não lista sessões em nuvem; `--teleport` puxa uma sessão em nuvem e sua branch.200`--teleport` é distinto de `--resume`. `--resume` reabre uma conversa do histórico local desta máquina e não lista sessões em nuvem; `--teleport` puxa uma sessão em nuvem e sua branch.
743 201
748Teleport 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.206Teleport 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.
749 207
750| Requisito | Detalhes |208| Requisito | Detalhes |
751| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |209| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
752| 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. |210| 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. |
753| Repositório correto | Você deve executar `--teleport` a partir de um checkout do mesmo repositório, não de um fork. A partir da v2.1.199, Claude Code aceita um checkout mesmo quando não consegue analisar o remoto em um nome de host, como um alias de host SSH como `git@work:owner/repo.git` ou uma forma abreviada reescrita por `insteadOf`. Ele mostra um prompt de confirmação primeiro, e apenas quando o proprietário do remoto e o nome do repositório correspondem ao repositório da sessão. |211| 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 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. |
754| Branch disponível | A branch da sessão em nuvem deve ter sido enviada para o remoto. Teleport busca e faz checkout automaticamente. |212| Branch disponível | A branch da sessão em nuvem deve ter sido enviada para o remoto. Teleport busca e faz checkout automaticamente. |
755| Mesma conta | Você deve estar autenticado na mesma conta claude.ai usada na sessão em nuvem. |213| Mesma conta | Você deve estar autenticado na mesma conta claude.ai usada na sessão em nuvem. |
756 214
758 `--teleport` não está disponível216 `--teleport` não está disponível
759</h4>217</h4>
760 218
761Teleport requer autenticação de assinatura claude.ai. Se você estiver autenticado via chave de API, Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, execute `/login` para entrar com sua conta claude.ai. Se você já estiver conectado via claude.ai e `--teleport` ainda não estiver disponível, sua organização pode ter desabilitado sessões em nuvem.219Teleport requer autenticação de assinatura claude.ai. Se você estiver autenticado via chave de API, execute `/login` para entrar com sua conta claude.ai em vez disso. Se o erro nomear seu provedor em vez disso, as sessões em nuvem não estão disponíveis através de provedores de terceiros; veja a [tabela de erros](#output-and-errors). 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 em nuvem.
762 220
763<h2 id="work-with-sessions">221<h2 id="work-with-sessions">
764 Trabalhar com sessões222 Trabalhar com sessões
765</h2>223</h2>
766 224
767As 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 deletar sessões permanentemente.225As 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.
768 226
769<h3 id="manage-context">227<h3 id="manage-context">
770 Gerenciar contexto228 Gerenciar contexto
771</h3>229</h3>
772 230
773As sessões em nuvem suportam [comandos integrados](/docs/pt/commands) que produzem saída de texto. Comandos que apenas executam 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 em sessões em nuvem:231As sessões em nuvem suportam [comandos integrados](/docs/pt/commands) 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:
774 232
775* **`/model`, `/effort`, `/fast`, `/color` e `/rename`**: passam o valor como um argumento, por exemplo `/model sonnet`, em vez de abrir o seletor de terminal ou controle deslizante. As formas de argumento requerem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as [notas de disponibilidade](/docs/pt/commands#all-commands) de cada comando: `/effort` relata `Not applied` enquanto um [esforço padrão de lançamento](/docs/pt/model-config#adjust-effort-level) de modelo está em vigor, e `/fast` funciona apenas em uma sessão que começou com o modo rápido ativado.233* **`/model`, `/effort`, `/fast`, `/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](/docs/pt/commands#all-commands) de cada comando: `/effort` relata `Not applied` enquanto um [launch-default effort hold](/docs/pt/model-config#adjust-effort-level) do modelo está em vigor, e `/fast` funciona apenas em uma sessão que começou com o modo rápido ativado.
776* **`/config`**: na web, 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 as configurações de uma sessão em nuvem, use [variáveis de ambiente](#configure-your-environment) ou confirme [arquivos de configurações](/docs/pt/settings) no repositório.234* **`/config`**: na web, 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 as configurações de uma sessão em nuvem, use [variáveis de ambiente](/docs/pt/cloud-environments#set-environment-variables) ou confirme [arquivos de configurações](/docs/pt/settings) no repositório.
777 235
778Para gerenciamento de contexto especificamente:236Para gerenciamento de contexto especificamente:
779 237
781| :--------- | :--------------------------- | :---------------------------------------------------------------------------------------------------------------- |239| :--------- | :--------------------------- | :---------------------------------------------------------------------------------------------------------------- |
782| `/compact` | Sim | Resume a conversa para liberar contexto. Aceita instruções de foco opcionais como `/compact keep the test output` |240| `/compact` | Sim | Resume a conversa para liberar contexto. Aceita instruções de foco opcionais como `/compact keep the test output` |
783| `/context` | Sim | Mostra o que está atualmente na janela de contexto |241| `/context` | Sim | Mostra o que está atualmente na janela de contexto |
784| `/clear` | Não | Inicie uma nova sessão a partir da barra lateral |242| `/clear` | Não | Inicie uma nova sessão na barra lateral |
785 243
786A auto-compactação é executada automaticamente quando a janela de contexto se aproxima da capacidade. Para acioná-la mais cedo, defina [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/pt/env-vars) em suas [variáveis de ambiente](#configure-your-environment). Por exemplo, `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` compacta em 70% de capacidade em vez de esperar até que a janela esteja quase cheia. Para alterar o tamanho efetivo da janela para cálculos de compactação, use [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/env-vars).244A compactação automática é executada automaticamente quando a janela de contexto se aproxima da capacidade. Claude Code na web define [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/pt/env-vars) em sessões em nuvem por si só, portanto a compactação é acionada no meio da [janela de compactação automática](/docs/pt/model-config#set-the-auto-compact-window) em vez de quando a janela se enche. Esse valor substitui um que você adiciona em suas [variáveis de ambiente](/docs/pt/cloud-environments#set-environment-variables), portanto adicionar a variável lá não altera quando a compactação é acionada.
787 245
788[Subagentes](/docs/pt/sub-agents) funcionam da mesma forma que localmente. Claude pode gerá-los com a ferramenta Task para descarregar pesquisa ou trabalho paralelo em uma janela de contexto separada, mantendo a conversa principal mais leve. Subagentes definidos em seu `.claude/agents/` do repositório são coletados automaticamente.246Para alterar a janela de compactação automática, defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/env-vars) em suas variáveis de ambiente ou execute [`/autocompact`](/docs/pt/commands#all-commands) com uma contagem de tokens em uma sessão onde a variável não está definida.
789 247
790[Equipes de agentes](/docs/pt/agent-teams) estão desabilitadas por padrão mas podem ser habilitadas adicionando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` às suas [variáveis de ambiente](#configure-your-environment).248[Subagentes](/docs/pt/sub-agents) 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.
249
250[Equipes de agentes](/docs/pt/agent-teams) estão desativadas por padrão, mas podem ser habilitadas adicionando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` às suas [variáveis de ambiente](/docs/pt/cloud-environments#set-environment-variables).
251
252<h3 id="permission-modes-in-cloud-sessions">
253 Modos de permissão em sessões em nuvem
254</h3>
255
256Você escolhe o [modo de permissão](/docs/pt/permission-modes) de uma sessão em nuvem no [menu suspenso de modo](/docs/pt/permission-modes#switch-permission-modes), tanto quando você cria a tarefa quanto enquanto a sessão é executada. Quando você reabre uma sessão cujo [ambiente hospedado pela Anthropic expirou](#environment-expired), ou envia uma mensagem para uma sessão que um executor auto-hospedado [liberou enquanto estava ocioso](/docs/pt/self-hosted-environments-reference#runner-cli-flags), Claude Code retoma a sessão no modo de permissão em que estava.
791 257
792<h3 id="review-changes">258<h3 id="review-changes">
793 Revise alterações259 Revisar alterações
794</h3>260</h3>
795 261
796Cada 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. Veja [Review and iterate](/docs/pt/web-quickstart#review-and-iterate) para o passo a passo completo incluindo criação de PR. Para ter Claude monitorar o PR para falhas de CI e comentários de revisão automaticamente, veja [Auto-fix pull requests](#auto-fix-pull-requests).262Cada 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.
263
264Claude 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.
265
266Consulte [Revisar e iterar](/docs/pt/web-quickstart#review-and-iterate) 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](#auto-fix-pull-requests).
797 267
798<h3 id="share-sessions">268<h3 id="share-sessions">
799 Compartilhe sessões269 Compartilhar sessões
800</h3>270</h3>
801 271
802Para 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.272Para 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.
803 273
804<h4 id="share-from-an-enterprise-or-team-account">274<h4 id="share-from-an-enterprise-or-team-account">
805 Compartilhe de uma conta Enterprise ou Team275 Compartilhar de uma conta Enterprise ou Team
806</h4>276</h4>
807 277
808Para contas Enterprise e Team, as duas opções de visibilidade são **Private** e **Team**. A visibilidade Team torna a sessão visível para outros membros de sua organização claude.ai. [Claude in Slack](/docs/pt/slack) as sessões são automaticamente compartilhadas com visibilidade Team.278Para 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](/docs/pt/slack) são compartilhadas automaticamente com visibilidade de Team.
809 279
810A verificação de acesso ao repositório é habilitada por padrão, com base na conta GitHub conectada à conta do destinatário. O nome de exibição de sua conta é visível para todos os destinatários com acesso.280A 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.
811 281
812<h4 id="share-from-a-max-or-pro-account">282<h4 id="share-from-a-max-or-pro-account">
813 Compartilhe de uma conta Max ou Pro283 Compartilhar de uma conta Max ou Pro
814</h4>284</h4>
815 285
816Para 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.286Para 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.
817 287
818Verifique sua sessão para conteúdo sensível antes de compartilhar. As sessões podem conter código e credenciais de repositórios GitHub privados. A verificação de acesso ao repositório não é habilitada por padrão.288Verifique 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.
819 289
820Para 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.290Para 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**](https://claude.ai/settings/claude-code).
821 291
822<h3 id="archive-sessions">292<h3 id="archive-sessions">
823 Arquive sessões293 Arquivar sessões
824</h3>294</h3>
825 295
826Você 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.296Você 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.
827 297
828Para arquivar uma sessão, passe o mouse sobre a sessão na barra lateral e selecione o ícone de arquivo.298Para arquivar uma sessão, passe o mouse sobre a sessão na barra lateral e selecione o ícone de arquivo.
829 299
830<h3 id="delete-sessions">300<h3 id="delete-sessions">
831 Delete sessões301 Excluir sessões
832</h3>302</h3>
833 303
834Deletar uma sessão remove permanentemente a sessão e seus dados. Esta ação não pode ser desfeita. Você pode deletar uma sessão de duas maneiras:304Excluir 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:
835 305
836* **Da barra lateral**: filtre por sessões arquivadas, depois passe o mouse sobre a sessão que deseja deletar e selecione o ícone de exclusão306* **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
837* **Do menu de sessão**: abra uma sessão, selecione o menu suspenso ao lado do título da sessão e selecione **Delete**307* **No menu da sessão**: abra uma sessão, selecione o menu suspenso ao lado do título da sessão e selecione **Delete**
838 308
839Você será solicitado a confirmar antes de uma sessão ser deletada.309Você será solicitado a confirmar antes de uma sessão ser excluída.
840 310
841<h2 id="auto-fix-pull-requests">311<h2 id="auto-fix-pull-requests">
842 Corrigir automaticamente pull requests312 Corrigir automaticamente pull requests
845Claude 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.315Claude 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.
846 316
847<Note>317<Note>
848 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](https://github.com/apps/claude) ou quando solicitado durante [setup](/docs/pt/web-quickstart#connect-github-and-create-an-environment).318 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](https://github.com/apps/claude).
849</Note>319</Note>
850 320
851Existem algumas maneiras de ativar auto-fix dependendo de onde o PR veio e qual dispositivo você está usando:321Existem algumas maneiras de ativar auto-fix dependendo de onde o PR veio e qual dispositivo você está usando:
881 351
882Cada sessão em nuvem é separada de sua máquina e de outras sessões através de várias camadas:352Cada sessão em nuvem é separada de sua máquina e de outras sessões através de várias camadas:
883 353
884* **Máquinas virtuais isoladas**: cada sessão é executada em uma VM isolada gerenciada pela Anthropic354* **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](/docs/pt/self-hosted-environments) são executadas em sua própria infraestrutura em vez disso, onde o isolamento é responsabilidade de sua implantação
885* **Controles de acesso à rede**: o acesso à rede é limitado por padrão e pode ser desabilitado. 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.355* **Controles de acesso à rede**: em ambientes hospedados pela Anthropic, o acesso à rede é limitado por padrão e pode ser desabilitado. 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.
886* **Proteção de credenciais**: credenciais sensíveis como credenciais git ou chaves de assinatura nunca estão dentro da sandbox com Claude Code. A autenticação é tratada através de um proxy seguro usando credenciais com escopo.356* **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](/docs/pt/self-hosted-environments-deploy#configure-git)
887* **Análise segura**: o código é analisado e modificado dentro de VMs isoladas antes de criar PRs357* **Credenciais de API**: em ambientes hospedados pela Anthropic nos planos Pro e Max, chaves que você [adiciona a um ambiente em nuvem](/docs/pt/cloud-environments#add-api-credentials) 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
358* **Análise segura**: o código é analisado e modificado dentro do ambiente isolado da sessão antes de criar PRs
888 359
889<h2 id="troubleshooting">360<h2 id="troubleshooting">
890 Troubleshooting361 Troubleshooting
896 Session creation failed367 Session creation failed
897</h3>368</h3>
898 369
899Se uma nova sessão falha ao iniciar com `Session creation failed` ou fica presa em provisioning, Claude Code não conseguiu alocar um ambiente em nuvem.370Se 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.
900 371
901* Verifique [status.claude.com](https://status.claude.com) para incidentes de sessão em nuvem372* Verifique [status.claude.com](https://status.claude.com) para incidentes de sessão em nuvem
902* Tente novamente após um minuto, já que a capacidade é provisionada sob demanda373* Tente novamente após um minuto, já que a capacidade é provisionada sob demanda
903* Confirme que seu repositório é acessível. A conta GitHub conectada deve ter acesso ao repositório no GitHub, seja através da autorização do Claude GitHub App ou um token `gh` sincronizado via `/web-setup`. Instalar o App no repositório não é necessário. Veja [Opções de autenticação do GitHub](#github-authentication-options).374* Confirme que seu repositório é acessível. A conta GitHub conectada deve ter acesso ao repositório no GitHub, seja através da autorização do Claude GitHub App ou um token `gh` sincronizado via `/web-setup`. Instalar o App no repositório não é necessário. Veja [Opções de autenticação do GitHub](#github-authentication-options).
904 375
376<h3 id="unable-to-get-organization-uuid">
377 Unable to get organization UUID
378</h3>
379
380`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.
381
382Execute `/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](#output-and-errors): as sessões em nuvem não estão disponíveis através de provedores de terceiros.
383
905<h3 id="remote-control-session-expired-or-access-denied">384<h3 id="remote-control-session-expired-or-access-denied">
906 Remote Control session expired or access denied385 Remote Control session expired or access denied
907</h3>386</h3>
910 389
911* Execute `/login` localmente para atualizar suas credenciais, depois reconecte390* Execute `/login` localmente para atualizar suas credenciais, depois reconecte
912* Confirme que você está conectado à mesma conta que possui a sessão391* Confirme que você está conectado à mesma conta que possui a sessão
913* Se você ver `Remote Control may not be available for this organization`, um Owner não habilitou sessões em nuvem para sua organização392* 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
914 393
915<h3 id="environment-expired">394<h3 id="environment-expired">
916 Environment expired395 Environment expired
917</h3>396</h3>
918 397
919As sessões em nuvem param após um período de inatividade e o ambiente subjacente é recuperado. A partir de um terminal local, isso aparece como `Could not resume session ... its environment has expired. Creating a fresh session instead.` Na web, a sessão é marcada como expirada na lista de sessões.398As sessões em nuvem param após um período de inatividade e a VM da sessão é recuperada. Na web, a sessão é marcada como expirada na lista de sessões.
920 399
921Reabra a sessão de [claude.ai/code](https://claude.ai/code) para provisionar um ambiente fresco com seu histórico de conversa restaurado.400Reabra a sessão de [claude.ai/code](https://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.
922 401
923<h2 id="limitations">402<h2 id="limitations">
924 Limitações403 Limitações
929* **Limites de taxa**: Claude Code na web compartilha 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.408* **Limites de taxa**: Claude Code na web compartilha 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.
930* **Autenticação de repositório**: você pode apenas mover sessões de web para local quando está autenticado na mesma conta409* **Autenticação de repositório**: você pode apenas mover sessões de web para local quando está autenticado na mesma conta
931* **Restrições de plataforma**: clonagem de repositório e criação de pull request requerem GitHub. Instâncias [GitHub Enterprise Server](/docs/pt/github-enterprise-server) auto-hospedadas são suportadas para planos Team e Enterprise. GitLab, Bitbucket e outros repositórios não-GitHub podem ser enviados para sessões em nuvem como um [pacote local](#send-local-repositories-without-github), mas a sessão não pode enviar resultados de volta para o remoto410* **Restrições de plataforma**: clonagem de repositório e criação de pull request requerem GitHub. Instâncias [GitHub Enterprise Server](/docs/pt/github-enterprise-server) auto-hospedadas são suportadas para planos Team e Enterprise. GitLab, Bitbucket e outros repositórios não-GitHub podem ser enviados para sessões em nuvem como um [pacote local](#send-local-repositories-without-github), mas a sessão não pode enviar resultados de volta para o remoto
932* **IP allowlist da organização**: as sessões em nuvem chamam a API Anthropic a partir de infraestrutura gerenciada pela Anthropic, não de sua rede. Se sua organização tem [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) habilitado, cada sessão em nuvem falha com um erro de autenticação. O mesmo se aplica a [Code Review](/docs/pt/code-review) e [Routines](/docs/pt/routines). Entre em contato com [suporte Anthropic](https://support.claude.com/) para isentar serviços hospedados pela Anthropic do allowlist de IP de sua organização.411* **IP allowlist da organização**: as sessões em nuvem chamam a API Anthropic a partir de infraestrutura gerenciada pela Anthropic, não de sua rede, enquanto as sessões em um [ambiente auto-hospedado](/docs/pt/self-hosted-environments) a chamam a partir de sua própria rede. Se sua organização tem [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-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](/docs/pt/code-review) e a [routines](/docs/pt/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](https://support.claude.com/) para isentar serviços hospedados pela Anthropic do allowlist de IP de sua organização.
933 412
934<h2 id="related-resources">413<h2 id="related-resources">
935 Recursos relacionados414 Recursos relacionados
936</h2>415</h2>
937 416
938* [Ultraplan](/docs/pt/ultraplan): rascunhe um plano em uma sessão em nuvem e revise-o em seu navegador417* [Ambientes em nuvem](/docs/pt/cloud-environments): configure acesso à rede, variáveis de ambiente e scripts de configuração para sessões em nuvem
939* [Ultrareview](/docs/pt/ultrareview): execute uma revisão de código profunda multi-agente em uma sandbox em nuvem418* [Ultrareview](/docs/pt/ultrareview): execute uma revisão de código profunda multi-agente em uma sandbox em nuvem
940* [Routines](/docs/pt/routines): automatize trabalho em um cronograma, via chamada de API ou em resposta a eventos do GitHub419* [Routines](/docs/pt/routines): automatize trabalho em um cronograma, via chamada de API ou em resposta a eventos do GitHub
941* [Configuração de hooks](/docs/pt/hooks): execute scripts em eventos do ciclo de vida da sessão420* [Configuração de hooks](/docs/pt/hooks): execute scripts em eventos do ciclo de vida da sessão
942* [Referência de configurações](/docs/pt/settings): todas as opções de configuração421* [Todas as configurações](/docs/pt/settings-reference): todas as opções de configuração
943* [Segurança](/docs/pt/security): garantias de isolamento e tratamento de dados422* [Segurança](/docs/pt/security): garantias de isolamento e tratamento de dados
944* [Uso de dados](/docs/pt/data-usage): o que Anthropic retém de sessões em nuvem423* [Uso de dados](/docs/pt/data-usage): o que Anthropic retém de sessões em nuvem
945* [Claude Tag](https://claude.com/docs/claude-tag/overview): um @Claude gerenciado pela organização no Slack que é executado no mesmo ambiente em nuvem424* [Claude Tag](https://claude.com/docs/claude-tag/overview): um @Claude gerenciado pela organização no Slack que é executado na mesma infraestrutura em nuvem