44 Iniciar uma sessão44 Iniciar uma sessão
45</h2>45</h2>
46 46
47Antes de enviar sua primeira mensagem, configure quatro coisas na área de prompt:47Antes de enviar sua primeira mensagem, escolha o ambiente, a pasta do projeto, o modo de permissão e o modelo na linha abaixo da caixa de prompt:
48 48
49* **Ambiente**: escolha onde Claude é executado. Selecione **Local** para sua máquina, **Cloud** para uma [sessão na nuvem](#cloud-sessions) que continua após você fechar o aplicativo, uma [**conexão SSH**](#ssh-sessions) para uma máquina remota que você gerencia, ou no Windows uma [**distribuição WSL**](/docs/pt/desktop-wsl). Uma tarefa em uma sessão SSH pode [continuar enquanto o Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected), mas com uma conta Claude ela pode parar quando o login dela expirar. Veja [configuração de ambiente](#environment-configuration).49* **Ambiente**: use o seletor de ambiente, o primeiro controle da linha, para escolher onde Claude é executado. Veja [configuração de ambiente](#environment-configuration).
50* **Pasta do projeto**: selecione a pasta ou repositório em que Claude trabalha. Para sessões em nuvem, você pode adicionar [múltiplos repositórios](#run-long-running-tasks-in-the-cloud).50 * Se uma nova sessão não tiver um seletor de ambiente abaixo da caixa de prompt, siga as [etapas do layout anterior](#check-which-layout-you-have).
51* **Modelo**: escolha um [modelo](/docs/pt/model-config#available-models) no menu suspenso ao lado do botão enviar. Você pode alterar isso durante a sessão.51* **Pasta do projeto**: clique no controle de pasta do projeto, ao lado do seletor de ambiente, para escolher a pasta em que Claude trabalha.
52* **Modo de permissão**: escolha quanto de autonomia Claude tem no [seletor de modo](#choose-a-permission-mode). Você pode alterar isso durante a sessão.52 * **Sessão na nuvem**: selecione [repositórios](#run-long-running-tasks-in-the-cloud) em vez de uma pasta
53 * **[Ambiente local ou SSH salvo](#create-a-saved-environment)**: o ambiente já contém suas pastas, então a linha não mostra nenhum controle de pasta do projeto. Para alterar as pastas, [edite o ambiente](#use-edit-or-remove-a-saved-environment).
54* **Modo de permissão**: use o [seletor de modo](#choose-a-permission-mode) para escolher quanto de autonomia Claude tem. Você pode alterar o modo de permissão durante a sessão.
55* **Modelo**: escolha um [modelo](/docs/pt/model-config#available-models) no seletor de modelo próximo à extremidade direita da linha. Você pode alterar o modelo durante a sessão.
53 56
54Digite sua tarefa e pressione **Enter** para começar. Cada sessão rastreia seu próprio contexto e alterações independentemente.57Digite sua tarefa e pressione **Enter** para começar. Cada sessão rastreia seu próprio contexto e alterações independentemente.
55 58
65 68
66Digite o que você quer que Claude faça e pressione **Enter** para enviar. Claude lê seus arquivos de projeto, faz alterações e executa comandos com base no seu [modo de permissão](#choose-a-permission-mode). Você pode redirecionar Claude a qualquer momento: clique no botão parar para interromper imediatamente, ou digite uma correção e pressione **Enter** para enviá-la sem parar a ação em execução. Claude lê a correção assim que a ação atual é concluída e se ajusta antes de seu próximo passo.69Digite o que você quer que Claude faça e pressione **Enter** para enviar. Claude lê seus arquivos de projeto, faz alterações e executa comandos com base no seu [modo de permissão](#choose-a-permission-mode). Você pode redirecionar Claude a qualquer momento: clique no botão parar para interromper imediatamente, ou digite uma correção e pressione **Enter** para enviá-la sem parar a ação em execução. Claude lê a correção assim que a ação atual é concluída e se ajusta antes de seu próximo passo.
67 70
68O botão **+** ao lado da caixa de prompt oferece acesso a anexos de arquivo, [skills](#use-skills), [conectores](#connect-external-tools) e [plugins](#install-plugins).71Clique no botão **+** ao lado da caixa de prompt para anexos de arquivo, [skills](#use-skills), [conectores](#connect-external-tools) e [plugins](#install-plugins).
69 72
70<h3 id="accept-a-suggested-prompt">73<h3 id="accept-a-suggested-prompt">
71 Aceitar um prompt sugerido74 Aceitar um prompt sugerido
82 Adicionar arquivos e contexto aos prompts85 Adicionar arquivos e contexto aos prompts
83</h3>86</h3>
84 87
85A caixa de prompt suporta duas maneiras de trazer contexto externo:88Para fornecer um arquivo a Claude, faça uma @mention dele ou anexe-o na caixa de prompt:
86 89
87* **@mention de arquivos**: digite `@` seguido de um nome de arquivo para adicionar um arquivo ao contexto da conversa. Claude pode então ler e referenciar esse arquivo. @mention não está disponível em sessões na nuvem ou WSL.90* **@mention de arquivos**: digite `@` seguido de um nome de arquivo para adicionar um arquivo ao contexto da conversa.
88* **Anexar arquivos**: anexe imagens, PDFs e outros arquivos ao seu prompt usando o botão de anexo, ou arraste e solte arquivos diretamente no prompt. Isso é útil para compartilhar capturas de tela de bugs, mockups de design ou documentos de referência.91 * **Em uma sessão na nuvem**: `@` só consegue listar arquivos depois que você envia sua primeira mensagem. Se `@` não listar nenhum, envie sua primeira mensagem sem o arquivo e, em seguida, faça uma @mention do arquivo na sua próxima mensagem.
92* **Anexar arquivos**: anexe imagens, PDFs e outros arquivos ao seu prompt usando o botão **+** ao lado da caixa de prompt, ou arraste e solte arquivos diretamente no prompt. Isso é útil para compartilhar capturas de tela de bugs, mockups de design ou documentos de referência.
93 * **Em uma [sessão WSL](/docs/pt/desktop-wsl)**: se o menu **+** mostrar **Add image** em vez de **Add files or photos**, você só pode anexar imagens. Para fornecer a Claude qualquer outro arquivo da pasta da sessão, faça uma @mention dele.
89 94
90<h3 id="choose-a-permission-mode">95<h3 id="choose-a-permission-mode">
91 Escolher um modo de permissão96 Escolher um modo de permissão
92</h3>97</h3>
93 98
94Os modos de permissão controlam quanto de autonomia Claude tem durante uma sessão: se ele pergunta antes de editar arquivos, executar comandos ou ambos. Você pode alternar modos de permissão a qualquer momento usando o seletor de modo ao lado do botão enviar. Para aprovar cada alteração você mesmo, mude para Manual.99Os modos de permissão controlam quanto de autonomia Claude tem durante uma sessão: se ele pergunta antes de editar arquivos, executar comandos ou ambos. Você pode alternar modos de permissão a qualquer momento usando o seletor de modo na linha abaixo da caixa de prompt. Para aprovar cada alteração você mesmo, mude para Manual.
95 100
96Para definir um modo padrão para novas sessões locais, adicione `permissions.defaultMode` ao seu [arquivo de configurações](/docs/pt/settings#where-settings-live). O aplicativo desktop lê os mesmos arquivos de configurações que o CLI. Um modo que você escolhe no seletor é lembrado por pasta e tem precedência sobre `defaultMode` para essa pasta, exceto Plan, que se aplica apenas à sessão atual.101Para definir um modo padrão para novas sessões locais, adicione `permissions.defaultMode` ao seu [arquivo de configurações](/docs/pt/settings#where-settings-live). O aplicativo desktop lê os mesmos arquivos de configurações que o CLI. Um modo que você escolhe no seletor é lembrado por pasta e tem precedência sobre `defaultMode` para essa pasta, exceto Plan, que se aplica apenas à sessão atual.
97 102
129 134
130Claude pode iniciar um servidor de desenvolvimento e abri-lo no painel de navegador para verificar suas alterações. Isso funciona para aplicativos web frontend e também para servidores backend: Claude pode testar endpoints de API, visualizar logs do servidor e iterar em problemas que encontra. Na maioria dos casos, Claude inicia o servidor automaticamente após editar arquivos de projeto. Você também pode pedir a Claude para visualizar a qualquer momento. Por padrão, Claude [verifica automaticamente](#auto-verify-changes) alterações após cada edição.135Claude pode iniciar um servidor de desenvolvimento e abri-lo no painel de navegador para verificar suas alterações. Isso funciona para aplicativos web frontend e também para servidores backend: Claude pode testar endpoints de API, visualizar logs do servidor e iterar em problemas que encontra. Na maioria dos casos, Claude inicia o servidor automaticamente após editar arquivos de projeto. Você também pode pedir a Claude para visualizar a qualquer momento. Por padrão, Claude [verifica automaticamente](#auto-verify-changes) alterações após cada edição.
131 136
132O painel de navegador também pode abrir arquivos HTML estáticos, PDFs, imagens e vídeos do seu projeto. Clique em um caminho HTML, PDF, imagem ou vídeo no chat para abri-lo lá.137Em uma sessão local, clique em um caminho HTML, PDF ou de vídeo no chat para abri-lo no painel de navegador.
133 138
134<Note>139<Note>
135 Em uma [sessão SSH](#ssh-sessions), Claude não consegue abrir seu aplicativo no painel de navegador, porque não tem as ferramentas do painel lá. Para ver o aplicativo você mesmo, [encaminhe a porta dele para o seu computador](#reach-a-port-on-the-remote-machine).140 Em uma [sessão SSH](#ssh-sessions), Claude não consegue abrir seu aplicativo no painel de navegador, porque não tem as ferramentas do painel lá. Para ver o aplicativo você mesmo, [encaminhe a porta dele para o seu computador](#reach-a-port-on-the-remote-machine).
136</Note>141</Note>
137 142
143Se o painel de navegador não estiver aberto depois que Claude iniciar um servidor em uma sessão local, clique em **Open** no cartão do servidor no chat.
144
138No painel de navegador, você pode:145No painel de navegador, você pode:
139 146
140* Interagir com seu aplicativo em execução diretamente no painel de navegador147* Interagir com seu aplicativo em execução diretamente no painel de navegador
185 Revisar alterações com visualização de diff192 Revisar alterações com visualização de diff
186</h3>193</h3>
187 194
188Depois que Claude faz alterações em seu código, a visualização de diff permite que você revise modificações arquivo por arquivo antes de criar um pull request.195Depois que Claude faz alterações em seu código, a visualização de diff permite que você revise modificações arquivo por arquivo antes de criar um pull request. Para abrir a visualização de diff, clique nas contagens de linhas, como `+12 -1`, no cartão **Changes** do [painel de detalhes da sessão](#see-session-details). Você também pode clicar em **Changes** na barra de título da sessão.
189
190Quando Claude altera arquivos, um indicador de estatísticas de diff aparece mostrando o número de linhas adicionadas e removidas, como `+12 -1`. Clique neste indicador para abrir o visualizador de diff, que exibe uma lista de arquivos à esquerda e as alterações para cada arquivo à direita.
191 196
192Para comentar em linhas específicas, clique em qualquer linha no diff para abrir uma caixa de comentário. Digite seu feedback e pressione **Enter** para adicionar o comentário. Depois de adicionar comentários a várias linhas, envie todos os comentários de uma vez:197Para comentar em linhas específicas, clique em qualquer linha no diff para abrir uma caixa de comentário. Digite seu feedback e pressione **Enter** para adicionar o comentário. Depois de adicionar comentários a várias linhas, envie todos os comentários de uma vez:
193 198
213 Monitorar status de pull request218 Monitorar status de pull request
214</h3>219</h3>
215 220
216Depois de abrir um pull request, uma barra de status de CI aparece na sessão. Claude Code usa o GitHub CLI para pesquisar resultados de verificação e exibir falhas.221Para que Claude corrija verificações com falha, ou para que o GitHub mescle o pull request, ative **Auto-fix** ou **Merge when ready**. Depois que você abre um pull request, ele aparece no cartão **Changes** do [painel de detalhes da sessão](#see-session-details) com o status de suas verificações de CI. Abra o menu **⋮** ao lado do título dele:
217 222
218* **Auto-fix CI & address comments**: quando ativado, Claude tenta automaticamente corrigir verificações de CI falhando lendo a saída de falha e iterando. Em uma sessão local, Claude também responde a novos comentários de revisão deixados por alguém além de você, quando o autor é o proprietário do repositório, um membro da organização, um colaborador ou um GitHub App.223* **Auto-fix**: em uma sessão local, Claude também responde a novos comentários de revisão deixados por alguém além de você. O autor do comentário precisa ser o proprietário do repositório, um membro da organização, um colaborador ou um GitHub App.
219* **Auto-merge when ready**: quando ativado, Claude mescla o PR assim que todas as verificações passam. O método de merge é squash. Ative auto-merge em suas [configurações do repositório GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository) primeiro; sem isso, Claude não pode mesclar o PR.224* **Merge when ready**: ativa o auto-merge do GitHub para o PR. Em uma sessão local, o Desktop solicita um squash merge, a menos que o branch base use uma fila de merge.
225 * **Em sessões SSH e WSL**: **Merge when ready** fica desativado, então ative o auto-merge para o pull request no GitHub
226 * **Se o repositório não permitir auto-merge**: **Merge when ready** não é ativado, então ative o auto-merge nas suas [configurações do repositório GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository) primeiro
227* **[Layout anterior](#check-which-layout-you-have)**: assim que a sessão tiver um pull request, clique em **CI** na barra de status dela.
220 228
221Para ativá-los, clique em **CI** na barra de status. Para arquivar a sessão automaticamente assim que o PR for mesclado ou fechado, ative [auto-archive](#work-in-parallel-with-sessions) em **Settings > Claude Code**.229Para arquivar a sessão automaticamente assim que o PR for mesclado ou fechado, ative [auto-archive](#archive-a-session) em **Settings > Claude Code**.
222 230
223<Note>231<Note>
224 O monitoramento de PR requer que o [GitHub CLI (`gh`)](https://cli.github.com/) esteja instalado e autenticado em sua máquina. Se `gh` não estiver instalado, Desktop o solicita a instalar na primeira vez que você tentar criar um PR.232 O monitoramento de PR requer que o [GitHub CLI (`gh`)](https://cli.github.com/) esteja instalado e autenticado em sua máquina. Se `gh` não estiver instalado, Desktop o solicita a instalar na primeira vez que você tentar criar um PR.
235Para trabalhar em várias telas, extraia um painel como o diff ou terminal para sua própria janela e encaixe-o novamente quando terminar. Claude continua trabalhando na janela principal.243Para trabalhar em várias telas, extraia um painel como o diff ou terminal para sua própria janela e encaixe-o novamente quando terminar. Claude continua trabalhando na janela principal.
236 244
237<Note>245<Note>
238 O layout do painel, terminal, editor de arquivo e modos de visualização nesta seção requerem Claude Desktop v1.2581.0 ou posterior. Abra **Claude → Check for Updates** no macOS ou **Help → Check for Updates** no Windows para atualizar.246 O layout do painel, terminal, editor de arquivo e modos de visualização nesta seção requerem Claude Desktop v1.2581.0 ou posterior. Abra **Claude > Check for Updates…** no macOS ou **Help > Check for Updates…** no Windows para atualizar.
239</Note>247</Note>
240 248
249<h3 id="see-session-details">
250 Ver detalhes da sessão
251</h3>
252
253O painel de detalhes da sessão é um conjunto de cartões ao lado do chat que mostram onde a sessão é executada, o que ela alterou e o que ela está executando. O painel aparece depois que você inicia uma sessão, enquanto o chat for largo o suficiente para ele.
254
255<h4 id="hide-or-show-the-session-details-panel">
256 Ocultar ou mostrar o painel de detalhes da sessão
257</h4>
258
259Para ocultar ou mostrar o painel, clique em **Hide session rail** ou **Show session rail** na barra de título da sessão, ou no menu **⋮** da barra quando a janela for estreita. Se você ainda não vir o painel, [verifique qual layout da aba Code você tem](#check-which-layout-you-have).
260
241<h3 id="run-commands-in-the-terminal">261<h3 id="run-commands-in-the-terminal">
242 Executar comandos no terminal262 Executar comandos no terminal
243</h3>263</h3>
244 264
245O terminal integrado permite que você execute comandos ao lado de sua sessão sem alternar para outro aplicativo. Clique em **Terminal** na barra de título da sessão ou pressione **Ctrl+\`** no macOS ou Windows. O terminal abre no diretório de trabalho de sua sessão e compartilha o mesmo ambiente que Claude, então comandos como `npm test` ou `git status` veem os mesmos arquivos que Claude está editando. Para abrir uma segunda aba de terminal, clique em **+** no cabeçalho do painel de terminal ou clique com o botão direito em uma pasta no chat para escolher **Open in terminal**.265O terminal integrado permite que você execute comandos ao lado de sua sessão sem alternar para outro aplicativo. Clique em **Terminal** na barra de título da sessão ou pressione **Ctrl+\`** no macOS ou Windows. O terminal abre no diretório de trabalho de sua sessão e compartilha o mesmo ambiente que Claude, então comandos como `npm test` ou `git status` veem os mesmos arquivos que Claude está editando. Para abrir uma segunda aba de terminal, clique em **+** no cabeçalho do painel de terminal ou clique com o botão direito em uma pasta no chat para escolher **Open in terminal**.
246 266
247O terminal está disponível em sessões locais e [SSH](#ssh-sessions), com uma limitação em [máquinas remotas Windows](#windows-remote-machines).267Se uma sessão WSL não tiver terminal, consulte [Se o terminal ou os conectores não estiverem disponíveis](/docs/pt/desktop-wsl#check-for-the-terminal-and-connectors). O terminal está disponível em sessões locais e [SSH](#ssh-sessions), com uma limitação em [máquinas remotas Windows](#windows-remote-machines).
248 268
249<h3 id="open-and-edit-files">269<h3 id="open-and-edit-files">
250 Abrir e editar arquivos270 Abrir e editar arquivos
251</h3>271</h3>
252 272
253Clique em um caminho de arquivo no chat ou visualizador de diff para abri-lo no painel de arquivo. Caminhos HTML, PDF, imagem e vídeo abrem no [painel Browser](#preview-your-app) em vez disso. Faça edições pontuais e clique em **Save** para escrevê-las de volta. Se o arquivo mudou no disco desde que você o abriu, o painel o avisa e permite que você sobrescreva ou descarte. Clique em **Discard** para reverter suas edições, ou clique no caminho no cabeçalho do painel para copiar o caminho absoluto.273Para abrir um arquivo que Claude menciona, clique em seu caminho no chat.
254 274
255O painel de arquivo está disponível em sessões locais e SSH. Para sessões na nuvem, peça a Claude para fazer a alteração.275Para editar um arquivo você mesmo, use o [painel de arquivo](#arrange-your-workspace):
276
277* **Sessões locais**: você pode editar arquivos dentro do diretório de trabalho da sessão, exceto alguns somente leitura, como `.mcp.json` e `.claude/settings.json`. Para alterar um deles, [abra-o em outro aplicativo](#open-files-in-other-apps).
278* **Sessões na nuvem, SSH e WSL**: o painel de arquivo é somente leitura, então peça a Claude para fazer as edições.
279
280<h4 id="save-edits-in-the-file-pane">
281 Salvar edições no painel de arquivo
282</h4>
283
284Por padrão, suas edições no painel de arquivo são salvas automaticamente, então o painel não mostra nenhum botão **Save**. Para salvar suas edições você mesmo, desmarque **Auto save** no menu **⋮** do painel. Com **Auto save** desativado, clique em **Save** depois de alterar um arquivo para gravar suas edições, ou em **Cancel** para revertê-las.
285
286Se o painel avisar que o arquivo mudou no disco, clique em **Override** para sobrescrever a versão no disco com suas edições, ou em **Discard** para descartar suas edições.
256 287
257<h3 id="open-files-in-other-apps">288<h3 id="open-files-in-other-apps">
258 Abrir arquivos em outros aplicativos289 Abrir arquivos em outros aplicativos
283 Atalhos de teclado314 Atalhos de teclado
284</h3>315</h3>
285 316
286Pressione **Cmd+/** no macOS ou **Ctrl+/** no Windows para ver todos os atalhos disponíveis na aba Code. No Windows, use **Ctrl** no lugar de **Cmd** para os atalhos abaixo. Ciclagem de sessão, alternância de terminal e alternância de modo de visualização usam **Ctrl** em todas as plataformas.317Pressione **Cmd+/** no macOS ou **Ctrl+/** no Windows para ver todos os atalhos disponíveis na aba Code. A tabela nesta seção mostra as teclas do macOS. No Windows e no Linux, troque estas teclas:
318
319* **Cmd+Option**: pressione **Alt**
320* **Cmd**: pressione **Ctrl**
321
322Ciclagem de sessão, alternância de terminal e alternância de modo de visualização usam **Ctrl** em todas as plataformas.
287 323
288| Atalho | Ação |324| Atalho | Ação |
289| - | - |325| - | - |
290| `Cmd` `/` | Mostrar atalhos de teclado |326| `Cmd` `/` | Mostrar atalhos de teclado |
291| `Cmd` `N` | Nova sessão |327| `Cmd` `N` | Nova sessão |
328| `Cmd` `Option` `1`–`9` | Na tela de nova sessão no [layout atual](#check-which-layout-you-have), selecionar um ambiente |
329| `Cmd` `Option` `0` | Na tela de nova sessão no layout atual, abrir a [caixa de diálogo **New environment**](#create-a-saved-environment) |
292| `Cmd` `W` | Fechar sessão |330| `Cmd` `W` | Fechar sessão |
293| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Próxima ou sessão anterior |331| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Próxima ou sessão anterior |
294| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Próxima ou sessão anterior |332| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Próxima ou sessão anterior |
404 Trabalhar em paralelo com sessões442 Trabalhar em paralelo com sessões
405</h3>443</h3>
406 444
407Clique em **+ New session** na barra lateral, ou pressione **Cmd+N** no macOS ou **Ctrl+N** no Windows, para trabalhar em múltiplas tarefas em paralelo. Pressione **Ctrl+Tab** e **Ctrl+Shift+Tab** para ciclar através de sessões na barra lateral. Para repositórios Git, selecione a opção **worktree** ao lado do nome do branch para dar à sessão sua própria cópia isolada do seu projeto usando [Git worktrees](/docs/pt/worktrees).445Clique em **+ New** na barra lateral, ou pressione **Cmd+N** no macOS ou **Ctrl+N** no Windows, para trabalhar em múltiplas tarefas em paralelo. Pressione **Ctrl+Tab** e **Ctrl+Shift+Tab** para ciclar através de sessões na barra lateral.
408 446
409Para visualizar duas sessões ao mesmo tempo, mantenha **Cmd** no macOS ou **Ctrl** no Windows e clique em uma sessão na barra lateral. A sessão abre em um segundo painel ao lado daquele que você já tem aberto. Enquanto a divisão está ativa, clicar em outra sessão da barra lateral substitui o painel que tem foco. Pressione **Cmd+\\** no macOS ou **Ctrl+\\** no Windows para fechar o painel focado e retornar a uma única sessão.447Para visualizar duas sessões ao mesmo tempo, mantenha **Cmd** no macOS ou **Ctrl** no Windows e clique em uma sessão na barra lateral. A sessão abre em um segundo painel ao lado daquele que você já tem aberto. Enquanto a divisão está ativa, clicar em outra sessão da barra lateral substitui o painel que tem foco. Pressione **Cmd+\\** no macOS ou **Ctrl+\\** no Windows para fechar o painel focado e retornar a uma única sessão.
410 448
411Os worktrees são armazenados em `<project-root>/.claude/worktrees/` por padrão. Você pode alterar isso para um diretório personalizado:449<h4 id="run-a-session-in-its-own-worktree">
450 Executar uma sessão em seu próprio worktree
451</h4>
452
453Em um projeto que é um repositório Git, ative **Worktree** antes de iniciar uma sessão para executá-la em seu próprio [Git worktree](/docs/pt/worktrees), uma cópia isolada do projeto. Por padrão, **Worktree** fica desativado e Claude trabalha na própria pasta do projeto. Clique no controle da pasta do projeto na [linha abaixo da caixa de prompt](#start-a-session) e ative **Worktree**.
454
455* **Com um [ambiente salvo](#create-a-saved-environment)**: defina **Worktree** ao criar ou editar o ambiente
456* **[Layout anterior](#check-which-layout-you-have)**: marque a caixa de seleção **worktree** ao lado do nome do branch, acima da caixa de prompt
457
458Os worktrees são armazenados em `<project-root>/.claude/worktrees/` por padrão. Para armazená-los em um diretório personalizado:
412 459
413* **Sessões locais**: defina **Worktree location** em **Settings > Claude Code**460* **Sessões locais**: defina **Worktree location** em **Settings > Claude Code**
414* **Sessões SSH**: defina **Worktree folder** na [conexão SSH](#choose-where-ssh-session-worktrees-go)461* **Sessões SSH**: defina **Worktree folder** na [conexão SSH](#choose-where-ssh-session-worktrees-go)
415 462
416Você também pode definir um **Branch prefix** em **Settings > Claude Code**. O Desktop o adiciona antes de cada nome de branch de worktree, o que é útil para manter organizados os branches criados por Claude.463Você também pode definir um **Branch prefix** em **Settings > Claude Code**. O Desktop o adiciona antes de cada nome de branch de worktree, o que é útil para manter organizados os branches criados por Claude.
417 464
418Para remover um worktree quando terminar, passe o mouse sobre a sessão na barra lateral e clique no ícone de arquivo. Para ter sessões se arquivarem automaticamente quando seu pull request for mesclado ou fechado, ative **Auto-archive after PR merge or close** em **Settings > Claude Code**. O arquivamento automático se aplica apenas a sessões locais que terminaram de executar.
419
420Para incluir arquivos gitignored como `.env` em novos worktrees, crie um [arquivo `.worktreeinclude`](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) na raiz do seu projeto. Veja [O que os worktrees compartilham com o checkout principal](/docs/pt/worktrees#what-worktrees-share-with-the-main-checkout) para saber de onde uma sessão de worktree lê as configurações do projeto, hooks e skills.465Para incluir arquivos gitignored como `.env` em novos worktrees, crie um [arquivo `.worktreeinclude`](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) na raiz do seu projeto. Veja [O que os worktrees compartilham com o checkout principal](/docs/pt/worktrees#what-worktrees-share-with-the-main-checkout) para saber de onde uma sessão de worktree lê as configurações do projeto, hooks e skills.
421 466
422<Note>467<Note>
423 O isolamento de sessão requer [Git](https://git-scm.com/downloads). A maioria dos Macs inclui Git por padrão. Execute `git --version` no Terminal para verificar; se imprimir um número de versão, Git está instalado. Se você encontrar erros de Git, peça a Claude na aba [Cowork](https://claude.com/product/cowork) para ajudar a solucionar problemas de sua configuração.468 O isolamento de sessão requer [Git](https://git-scm.com/downloads). A maioria dos Macs inclui Git por padrão. Execute `git --version` no Terminal para verificar; se imprimir um número de versão, Git está instalado. Se você encontrar erros de Git, peça a Claude na aba [Cowork](https://claude.com/product/cowork) para ajudar a solucionar problemas de sua configuração.
424</Note>469</Note>
425 470
426Use os controles no topo da barra lateral para filtrar sessões por status, projeto ou ambiente, e para agrupar sessões por projeto. Para renomear uma sessão, clique no título da sessão na barra de ferramentas no topo da sessão ativa.471<h3 id="add-folders-to-a-session">
472 Adicionar pastas a uma sessão
473</h3>
474
475Adicione pastas antes de a sessão iniciar ou enquanto ela é executada:
476
477* **Antes de uma sessão local iniciar**: adicione as pastas em **Folders** ao [criar um ambiente salvo](#create-a-saved-environment) ou editar um e, em seguida, [inicie a sessão a partir desse ambiente salvo](#use-edit-or-remove-a-saved-environment).
478* **Enquanto uma sessão local ou [SSH](#ssh-sessions) é executada**: clique em **+** ao lado da caixa de prompt e selecione **Add folder**. Claude trabalha na própria pasta, sem [worktree](#run-a-session-in-its-own-worktree).
479
480<h3 id="archive-a-session">
481 Arquivar uma sessão
482</h3>
483
484Antes de arquivar uma sessão cujo worktree tem alterações sem commit, veja [Manter alterações sem commit quando uma sessão é arquivada](#keep-uncommitted-changes-when-a-session-is-archived). Para arquivar uma sessão, passe o mouse sobre ela na barra lateral, abra o menu dela e selecione **Archive**. A sessão é movida para suas [sessões arquivadas](#organize-and-find-sessions).
485
486Para que as sessões se arquivem automaticamente quando seu pull request for mesclado ou fechado, ative **Auto-archive after PR merge or close** em **Settings > Claude Code**. Sessões na nuvem e sessões que ainda estão em execução não se arquivam automaticamente.
487
488<h4 id="keep-uncommitted-changes-when-a-session-is-archived">
489 Manter alterações sem commit quando uma sessão é arquivada
490</h4>
491
492Você pode perder alterações sem commit no worktree de uma sessão quando a sessão é arquivada, então faça commit primeiro do que deseja manter:
493
494* **Se o Desktop perguntar sobre as alterações**: selecione **Archive anyway** para descartá-las, ou cancele e faça commit delas
495* **Se as únicas alterações forem arquivos não rastreados**: faça commit dos que deseja manter antes que um pull request que Claude abriu na sessão seja mesclado, porque o Desktop pode então excluí-los sem perguntar
496* **Em qualquer outro caso**: o worktree permanece no disco com suas alterações. Para uma sessão local, o Desktop remove ambos cerca de 30 dias depois de a sessão ser arquivada ou de você abri-la pela última vez, o que ocorrer por último. Para manter as alterações, abra a sessão a partir da [aba **Archived**](#organize-and-find-sessions) e selecione **Unarchive**
497
498<h3 id="organize-and-find-sessions">
499 Organizar e encontrar sessões
500</h3>
501
502Você agrupa, ordena e encontra sessões a partir de um ícone na lista de sessões da barra lateral:
503
504* **Layout atual**: passe o mouse sobre um título na lista de sessões para mostrar o ícone **Group and sort** e, em seguida, clique nele. Para encontrar sessões arquivadas, selecione **View all**, a última linha do menu, e depois abra a aba **Archived**.
505* **[Layout anterior](#check-which-layout-you-have)**: o ícone **Filter** aparece sem precisar passar o mouse. Clique nele para organizar a lista com **Group by** ou **Sort by**. Para mostrar sessões arquivadas, selecione **Status** e depois **Archived**.
506
507Para renomear uma sessão, abra-a e clique no título da sessão na barra de título.
508
509<h3 id="check-and-free-up-context">
510 Verificar e liberar contexto
511</h3>
427 512
428Para verificar o uso de contexto, veja [Verificar uso](#check-usage). Quando o contexto se enche, Claude automaticamente resume a conversa e continua trabalhando. Você também pode digitar `/compact` para disparar a sumarização mais cedo e liberar espaço de contexto. Veja [a janela de contexto](/docs/pt/how-claude-code-works#the-context-window) para detalhes sobre como a compactação funciona.513Para verificar o uso de contexto, veja [Verificar uso](#check-usage). Quando o contexto se enche, Claude automaticamente resume a conversa e continua trabalhando. Você também pode digitar `/compact` para disparar a sumarização mais cedo e liberar espaço de contexto. Veja [a janela de contexto](/docs/pt/how-claude-code-works#the-context-window) para detalhes sobre como a compactação funciona.
429 514
515<h3 id="get-notified-when-a-session-finishes">
516 Ser notificado quando uma sessão termina
517</h3>
518
430O aplicativo desktop envia uma notificação do SO quando uma sessão de Code termina uma tarefa e você não está visualizando essa sessão no momento. Para sessões que pertencem a um [projeto](/docs/pt/claude-projects#see-what-needs-you-in-overview), você recebe as notificações do projeto em vez disso.519O aplicativo desktop envia uma notificação do SO quando uma sessão de Code termina uma tarefa e você não está visualizando essa sessão no momento. Para sessões que pertencem a um [projeto](/docs/pt/claude-projects#see-what-needs-you-in-overview), você recebe as notificações do projeto em vez disso.
431 520
432<h3 id="ask-a-side-question-without-derailing-the-session">521<h3 id="ask-a-side-question-without-derailing-the-session">
451 Trabalhar entre sessões540 Trabalhar entre sessões
452</h3>541</h3>
453 542
454Claude pode listar suas outras sessões da aba Code, ler o que cada uma tem feito e enviar mensagens entre elas. Pergunte em linguagem natural: "qual sessão tocou na refatoração de autenticação?", "o que a sessão de API concluiu?" ou "diga à sessão de pagamentos que o esquema mudou". Você também pode pedir a Claude para renomear ou arquivar uma sessão. Claude arquiva uma sessão da mesma forma que o ícone de arquivo da barra lateral faz, então peça a ela para limpar sessões cujos PRs foram mesclados.543Claude pode listar suas outras sessões da aba Code, ler o que cada uma tem feito e enviar mensagens entre elas. Pergunte em linguagem natural: "qual sessão tocou na refatoração de autenticação?", "o que a sessão de API concluiu?" ou "diga à sessão de pagamentos que o esquema mudou".
544
545Você também pode pedir a Claude para renomear ou arquivar uma sessão. Por exemplo, peça a ele para arquivar as sessões cujos PRs foram mesclados.
455 546
456Através desta superfície, Claude vê apenas as sessões que o aplicativo desktop executa por si mesmo: local, [SSH](#ssh-sessions) e sessões [WSL](/docs/pt/desktop-wsl) na aba Code. Claude não vê sessões na nuvem, ou sessões que você iniciou do CLI do terminal ou da extensão VS Code, mesmo em worktrees do mesmo projeto, então com nove worktrees de terminal abertos e duas sessões desktop, Claude respondendo em uma delas relata a outra sessão desktop. Claude nunca lista a sessão de que você está perguntando. Por padrão, ele vê as 20 sessões mais recentemente ativas e pula sessões arquivadas a menos que você peça por elas. [Mensagens entre sessões](/docs/pt/cross-session-messaging) permite separadamente que Claude envie mensagens para [suas outras sessões Claude Code](/docs/pt/cross-session-messaging#see-which-sessions-claude-can-reach), incluindo sessões de terminal.547Através desta superfície, Claude vê apenas as sessões que o aplicativo desktop executa por si mesmo: local, [SSH](#ssh-sessions) e sessões [WSL](/docs/pt/desktop-wsl) na aba Code. Claude não vê sessões na nuvem, ou sessões que você iniciou do CLI do terminal ou da extensão VS Code, mesmo em worktrees do mesmo projeto, então com nove worktrees de terminal abertos e duas sessões desktop, Claude respondendo em uma delas relata a outra sessão desktop. Claude nunca lista a sessão de que você está perguntando. Por padrão, ele vê as 20 sessões mais recentemente ativas e pula sessões arquivadas a menos que você peça por elas. [Mensagens entre sessões](/docs/pt/cross-session-messaging) permite separadamente que Claude envie mensagens para [suas outras sessões Claude Code](/docs/pt/cross-session-messaging#see-which-sessions-claude-can-reach), incluindo sessões de terminal.
457 548
470 Executar tarefas de longa duração na nuvem561 Executar tarefas de longa duração na nuvem
471</h3>562</h3>
472 563
473Para grandes refatorações, suites de teste, migrações ou outras tarefas de longa duração, selecione **Cloud** em vez de **Local** ao iniciar uma sessão. Sessões na nuvem são executadas na infraestrutura gerenciada pela Anthropic por padrão e continuam mesmo se você fechar o aplicativo ou desligar seu computador. Verifique a qualquer momento para ver o progresso ou direcionar Claude em uma direção diferente. Você também pode monitorar sessões na nuvem de [claude.ai/code](https://claude.ai/code) ou do [aplicativo Claude mobile](/docs/pt/mobile).564Para grandes refatorações, suites de teste, migrações ou outras tarefas de longa duração, selecione um ambiente em **Cloud** no [seletor de ambiente](#start-a-session) ao iniciar uma sessão. Sessões na nuvem são executadas na infraestrutura gerenciada pela Anthropic por padrão e continuam mesmo se você fechar o aplicativo ou desligar seu computador. Verifique a qualquer momento para ver o progresso ou direcionar Claude em uma direção diferente. Você também pode monitorar sessões na nuvem de [claude.ai/code](https://claude.ai/code) ou do [aplicativo Claude mobile](/docs/pt/mobile).
565
566Sessões na nuvem também suportam múltiplos repositórios. Escolha os repositórios:
474 567
475Sessões na nuvem também suportam múltiplos repositórios. Depois de selecionar um ambiente em nuvem, clique no botão **+** ao lado do repositório selecionado para adicionar mais repositórios à sessão. Cada repo obtém seu próprio seletor de branch. Isso é útil para tarefas que abrangem múltiplas bases de código, como atualizar uma biblioteca compartilhada e seus consumidores.568* **Layout atual**: na linha abaixo da caixa de prompt, depois de selecionar um ambiente na nuvem.
569* **[Layout anterior](#check-which-layout-you-have)**: acima da caixa de prompt. Para adicionar outro repositório, clique em **+** ao lado do selecionado.
476 570
477Veja [Use Claude Code na nuvem](/docs/pt/claude-code-on-the-web) para mais sobre como sessões na nuvem funcionam. Quando um corpo de trabalho precisa de muitas sessões na nuvem, selecione **Projects** na barra lateral para criar um [projeto](/docs/pt/claude-projects), onde Claude inicia e rastreia as sessões para você de uma conversa.571Veja [Use Claude Code na nuvem](/docs/pt/claude-code-on-the-web) para mais sobre como sessões na nuvem funcionam. Quando um corpo de trabalho precisa de muitas sessões na nuvem, selecione **Projects** na barra lateral para criar um [projeto](/docs/pt/claude-projects), onde Claude inicia e rastreia as sessões para você de uma conversa.
478 572
500* **Você o ativa para essa sessão**: com o botão **Remote Control** da sessão, ou digitando `/remote-control` na caixa de prompt dela.594* **Você o ativa para essa sessão**: com o botão **Remote Control** da sessão, ou digitando `/remote-control` na caixa de prompt dela.
501* **Ela se conecta ao iniciar**: novas sessões se conectam automaticamente enquanto **Connect new sessions to Remote Control** estiver ativado em **Settings > Claude Code**. Se você nunca alterou essa configuração, o Desktop segue [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) em suas configurações de usuário ou configurações gerenciadas e, em seguida, o padrão da sua organização.595* **Ela se conecta ao iniciar**: novas sessões se conectam automaticamente enquanto **Connect new sessions to Remote Control** estiver ativado em **Settings > Claude Code**. Se você nunca alterou essa configuração, o Desktop segue [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) em suas configurações de usuário ou configurações gerenciadas e, em seguida, o padrão da sua organização.
502 596
503Para ver se uma sessão está conectada, observe o ícone de laptop antes do título da sessão na barra de ferramentas. O ícone fica destacado enquanto a sessão está conectada ou se conectando. Clique nele para abrir o botão **Remote Control** da sessão.597Para ver se uma sessão está conectada, verifique o botão **Remote Control** no card **Environment** do [painel de detalhes da sessão](#see-session-details).
504 598
505Para manter sessões fora de seus outros dispositivos, desative o Remote Control no nível de que você precisa:599Para manter sessões fora de seus outros dispositivos, desative o Remote Control no nível de que você precisa:
506 600
538 Conectar ferramentas externas632 Conectar ferramentas externas
539</h3>633</h3>
540 634
541Para sessões locais e [SSH](#ssh-sessions), clique no botão **+** ao lado da caixa de prompt e selecione **Connectors** para adicionar integrações como Google Calendar, Slack, GitHub, Linear, Notion e muito mais. Você pode adicionar conectores antes ou durante uma sessão. O botão **+** não está disponível em sessões cloud ou WSL, mas [routines](/docs/pt/routines) configuram conectores no momento da criação da rotina.635Conectores são [servidores MCP](/docs/pt/mcp) com um fluxo de configuração gráfica.
636
637Clique em **+** ao lado da caixa de prompt, antes ou durante a sessão, para adicionar conectores em uma sessão local ou [SSH](#ssh-sessions) com uma conta Claude. Selecione **Add connectors** para abrir o diretório de conectores. Se o menu mostrar **Connectors** em vez disso, selecione-o e depois **Browse connectors**.
638
639<Note>
640 Estes casos são abordados em outras páginas:
542 641
543Para gerenciar ou desconectar conectores, vá para Settings → Connectors no aplicativo desktop, ou selecione **Manage connectors** no menu Connectors na caixa de prompt.642 * **Connectors está desativado (acinzentado) em uma sessão WSL**: veja [Se o terminal ou os conectores não estiverem disponíveis](/docs/pt/desktop-wsl#check-for-the-terminal-and-connectors)
643 * **Sessões na nuvem**: veja [Como os conectores chegam ao Claude Code](/docs/pt/mcp#how-connectors-reach-claude-code)
644</Note>
544 645
545Uma vez conectado, Claude pode ler seu calendário, enviar mensagens, criar problemas e interagir com suas ferramentas diretamente. Você pode perguntar a Claude quais conectores estão configurados em sua sessão.646Uma vez conectado, Claude pode ler seu calendário, enviar mensagens, criar problemas e interagir com suas ferramentas diretamente. Você pode perguntar a Claude quais conectores estão configurados em sua sessão. Para gerenciar ou desconectar conectores, vá para **Settings > Connectors** no aplicativo desktop.
546 647
547Conectores são [MCP servers](/docs/pt/mcp) com um fluxo de configuração gráfica. Use-os para integração rápida com serviços suportados. Para integrações não listadas em Connectors, adicione MCP servers manualmente via [arquivos de configuração](/docs/pt/mcp#installing-mcp-servers). Você também pode [criar conectores personalizados](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).648Para integrações não listadas em Connectors, adicione servidores MCP manualmente via [arquivos de configuração](/docs/pt/mcp#installing-mcp-servers). Você também pode [criar conectores personalizados](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).
548 649
549<h3 id="use-skills">650<h3 id="use-skills">
550 Use skills651 Use skills
564 665
565[Plugins](/docs/pt/plugins/overview) são pacotes reutilizáveis que adicionam skills, agents, hooks, MCP servers e configurações LSP ao Claude Code. Você pode instalar plugins do aplicativo desktop sem usar o terminal.666[Plugins](/docs/pt/plugins/overview) são pacotes reutilizáveis que adicionam skills, agents, hooks, MCP servers e configurações LSP ao Claude Code. Você pode instalar plugins do aplicativo desktop sem usar o terminal.
566 667
567Para sessões locais e [SSH](#ssh-sessions), clique no botão **+** ao lado da caixa de prompt e selecione **Plugins** para ver seus plugins instalados e seus skills. Para adicionar um plugin, selecione **Add plugin** no submenu para abrir o navegador de plugins, que mostra plugins disponíveis de seus [marketplaces](/docs/pt/plugins/overview) configurados incluindo o marketplace oficial da Anthropic. Selecione **Manage plugins** para ativar, desativar ou desinstalar plugins.668Em uma sessão local ou em uma [sessão SSH](#ssh-sessions), clique em **+** ao lado da caixa de prompt e selecione **Add plugins** para abrir o navegador de plugins. Se o menu mostrar **Plugins** em vez disso, selecione-o e depois **Browse plugins**, ou **Manage plugins** para ativar, desativar ou desinstalar plugins.
568 669
569Você pode escopar plugins para sua conta de usuário, um projeto específico ou apenas local. Se sua organização gerencia plugins centralmente, esses plugins estão disponíveis em sessões desktop da mesma forma que estão no CLI, exceto os que o aplicativo desktop [retém sob `disableSideloadFlags`](/docs/pt/settings-reference#disablesideloadflags).670Você pode escopar plugins para sua conta de usuário, um projeto específico ou apenas local. Se sua organização gerencia plugins centralmente, esses plugins estão disponíveis em sessões desktop da mesma forma que estão no CLI, exceto os que o aplicativo desktop [retém sob `disableSideloadFlags`](/docs/pt/settings-reference#disablesideloadflags).
570 671
632| `runtimeArgs` | string\[] | Argumentos passados para `runtimeExecutable`, como `["run", "dev"]` |733| `runtimeArgs` | string\[] | Argumentos passados para `runtimeExecutable`, como `["run", "dev"]` |
633| `port` | number | A porta em que seu servidor escuta. Padrão é 3000 |734| `port` | number | A porta em que seu servidor escuta. Padrão é 3000 |
634| `cwd` | string | Diretório de trabalho relativo à raiz do seu projeto. Padrão é a raiz do projeto. Use `${workspaceFolder}` para referenciar a raiz do projeto explicitamente |735| `cwd` | string | Diretório de trabalho relativo à raiz do seu projeto. Padrão é a raiz do projeto. Use `${workspaceFolder}` para referenciar a raiz do projeto explicitamente |
635| `env` | object | Variáveis de ambiente adicionais como pares chave-valor, como `{ "NODE_ENV": "development" }`. Não coloque segredos aqui já que este arquivo é commitado em seu repo. Para passar segredos ao seu servidor de desenvolvimento, defina-os no [editor de ambiente local](#local-sessions) em vez disso. |736| `env` | object | Variáveis de ambiente adicionais como pares chave-valor, como `{ "NODE_ENV": "development" }`. Não coloque segredos aqui já que este arquivo é commitado em seu repo. Para segredos, veja [Definir variáveis de ambiente para servidores de desenvolvimento](#set-environment-variables-for-dev-servers). |
636| `autoPort` | boolean | Como lidar com conflitos de porta. Veja [Conflitos de porta](#port-conflicts) |737| `autoPort` | boolean | Como lidar com conflitos de porta. Veja [Conflitos de porta](#port-conflicts) |
637| `program` | string | Um script a executar com `node`. Veja [quando usar `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |738| `program` | string | Um script a executar com `node`. Veja [quando usar `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) |
638| `args` | string\[] | Argumentos passados para `program`. Usado apenas quando `program` está definido |739| `args` | string\[] | Argumentos passados para `program`. Usado apenas quando `program` está definido |
795* **SSH**: é executado em uma máquina remota à qual você se conecta via SSH, como seus próprios servidores, VMs na nuvem ou dev containers. Uma tarefa em execução pode [continuar enquanto o Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected), mas com uma conta Claude ela pode parar quando o login dela expirar.896* **SSH**: é executado em uma máquina remota à qual você se conecta via SSH, como seus próprios servidores, VMs na nuvem ou dev containers. Uma tarefa em execução pode [continuar enquanto o Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected), mas com uma conta Claude ela pode parar quando o login dela expirar.
796* **WSL** (Windows): é executado dentro de uma [distribuição WSL 2](/docs/pt/desktop-wsl) na sua máquina, usando o conjunto de ferramentas Linux dela e caminhos nativos897* **WSL** (Windows): é executado dentro de uma [distribuição WSL 2](/docs/pt/desktop-wsl) na sua máquina, usando o conjunto de ferramentas Linux dela e caminhos nativos
797 898
899<h3 id="create-a-saved-environment">
900 Criar um ambiente salvo
901</h3>
902
903Um ambiente salvo é uma entrada no [seletor de ambiente](#start-a-session) que registra onde o Claude é executado, para que você possa iniciar sessões posteriores ali. Um ambiente local ou SSH também guarda as pastas em que o Claude trabalha. Ambientes locais e SSH salvos [exigem o Claude Desktop v2.37337.0 ou posterior](#check-which-layout-you-have).
904
905<Steps>
906 <Step title="Abra a caixa de diálogo New environment">
907 Abra o seletor de ambiente abaixo da caixa de prompt e selecione **New environment** na parte inferior do menu.
908 </Step>
909
910 <Step title="Escolha onde o Claude é executado">
911 Selecione a aba **Local**, **SSH** ou [**Cloud**](#cloud-sessions) e preencha o formulário dessa aba. Na aba **SSH**, escolha uma [conexão](#ssh-sessions) e uma pasta na máquina remota.
912 </Step>
913
914 <Step title="Salve o ambiente">
915 Selecione **Create environment**, ou **Add environment** na aba **Cloud**.
916 </Step>
917</Steps>
918
919<h4 id="environments-that-desktop-creates-for-you">
920 Ambientes que o Desktop cria para você
921</h4>
922
923Se o seletor de ambiente listar ambientes locais ou SSH que você não criou, o Desktop os criou para você. Na primeira vez que você abre a aba Code no [layout atual](#check-which-layout-you-have), o Desktop cria até oito ambientes. Os ambientes vêm das pastas locais e SSH que você mais usou no último mês. Você pode [editá-los ou excluí-los](#use-edit-or-remove-a-saved-environment).
924
925<h4 id="use-edit-or-remove-a-saved-environment">
926 Usar, editar ou remover um ambiente salvo
927</h4>
928
929Encontre a entrada do ambiente no [seletor de ambiente](#start-a-session):
930
931* **Iniciar uma sessão**: selecione a entrada.
932* **Editar ou excluir**: passe o cursor sobre a entrada e clique no ícone de engrenagem. Para excluir um ambiente local ou SSH, clique em **Delete environment** em **Edit environment**.
933* **Arquivar ambientes na nuvem**: consulte [Arquivar um ambiente](/docs/pt/cloud-environments#archive-an-environment).
934
798<h3 id="local-sessions">935<h3 id="local-sessions">
799 Sessões locais936 Sessões locais
800</h3>937</h3>
801 938
802O aplicativo desktop nem sempre herda todo o ambiente do seu shell. No macOS, quando você inicia o aplicativo pelo Dock ou pelo Finder, ele lê o perfil do seu shell, como `~/.zshrc` ou `~/.bashrc`, para fornecer ao Claude Code o `PATH` e um conjunto fixo de variáveis do Claude Code, mas não outras variáveis que você exporta ali. No Windows, o aplicativo herda as variáveis de ambiente do usuário e do sistema, mas não lê perfis do PowerShell.939O aplicativo desktop nem sempre herda todo o ambiente do seu shell. No macOS, quando você inicia o aplicativo pelo Dock ou pelo Finder, ele lê o perfil do seu shell, como `~/.zshrc` ou `~/.bashrc`, para fornecer ao Claude Code o `PATH` e um conjunto fixo de variáveis do Claude Code, mas não outras variáveis que você exporta ali. No Windows, o aplicativo herda as variáveis de ambiente do usuário e do sistema, mas não lê perfis do PowerShell.
803 940
804Para definir variáveis de ambiente para sessões locais e servidores de desenvolvimento em qualquer plataforma, abra o menu suspenso de ambiente na caixa de prompt, passe o mouse sobre **Local** e clique no ícone de engrenagem para abrir o editor de ambiente local. As variáveis que você salva aqui são armazenadas criptografadas na sua máquina e se aplicam a todas as sessões locais e servidores de pré-visualização que você iniciar. Você também pode adicionar variáveis à chave `env` no seu arquivo `~/.claude/settings.json`, embora elas cheguem apenas às sessões do Claude e não aos servidores de desenvolvimento. Consulte [variáveis de ambiente](/docs/pt/env-vars) para a lista completa de variáveis suportadas.941<h4 id="set-environment-variables-for-local-sessions">
942 Definir variáveis de ambiente para sessões locais
943</h4>
944
945Adicione as variáveis a um ambiente local salvo e inicie suas sessões a partir dele. O Desktop [define algumas variáveis por conta própria](#environment-variables-desktop-sets-itself), como `API_TIMEOUT_MS`, e suas sessões recebem o valor dele para essas variáveis em vez do seu.
946
947<Note>
948 Se o seu seletor de ambiente estiver acima da caixa de prompt, você tem o [layout anterior](#check-which-layout-you-have), que não tem ambientes locais salvos. Use o [editor de ambiente local](#use-the-local-environment-editor) em vez disso.
949</Note>
950
951<Steps>
952 <Step title="Abra o formulário do ambiente">
953 Abra [**New environment**](#create-a-saved-environment) ou [**Edit environment**](#use-edit-or-remove-a-saved-environment).
954 </Step>
955
956 <Step title="Insira as variáveis">
957 Selecione **Environment variables**, insira um `KEY=value` por linha e selecione **Done**.
958 </Step>
959
960 <Step title="Salve o ambiente">
961 Selecione **Create environment** ou **Save**.
962 </Step>
963</Steps>
964
965Somente as sessões que você inicia a partir desse ambiente recebem as variáveis.
966
967Para definir uma variável para todas as sessões locais, adicione-a à [chave `env`](/docs/pt/env-vars#set-variables-in-settings-files) no seu arquivo `~/.claude/settings.json`. O Claude Code [ignora o valor](/docs/pt/settings-reference#how-env-values-interact-with-your-shell) se essa variável já estiver no ambiente com o qual o Desktop inicia a sessão. Consulte [variáveis de ambiente](/docs/pt/env-vars) para ver a lista completa de variáveis compatíveis.
968
969<h4 id="set-environment-variables-for-dev-servers">
970 Definir variáveis de ambiente para servidores de desenvolvimento
971</h4>
972
973Para fornecer um segredo a um servidor de desenvolvimento sem fazer commit dele no [`launch.json`](#configure-preview-servers), defina-o em um destes lugares e depois reinicie o Desktop:
974
975* **macOS e Linux**: exporte-o no perfil do seu shell
976* **Windows**: adicione-o às suas variáveis de ambiente do usuário ou do sistema
977* **Qualquer plataforma**: salve-o no [editor de ambiente local](#use-the-local-environment-editor), se você conseguir abri-lo
978
979Os servidores de desenvolvimento não recebem as variáveis que você adiciona a um [ambiente salvo](#create-a-saved-environment) ou ao `~/.claude/settings.json`.
980
981<h4 id="use-the-local-environment-editor">
982 Usar o editor de ambiente local
983</h4>
984
985Para abrir o editor de ambiente local, clique no ícone de engrenagem na entrada do seu próprio computador, não no de um ambiente salvo:
986
987* **Seletor abaixo da caixa de prompt**: passe o cursor sobre a entrada do seu computador, a primeira em **Local**. Se aparecer um ícone de engrenagem, clique nele. Caso contrário, o editor não está disponível; então, defina a variável para [sessões locais](#set-environment-variables-for-local-sessions) ou [servidores de desenvolvimento](#set-environment-variables-for-dev-servers) de outra forma.
988* **Seletor acima da caixa de prompt**: passe o cursor sobre **Local** e clique no ícone de engrenagem
989
990Insira um `KEY=value` por linha e selecione **Save changes**. As variáveis que você salva aqui são armazenadas criptografadas na sua máquina. As sessões locais as recebem, exceto qualquer variável que o [Desktop define por conta própria](#environment-variables-desktop-sets-itself), como `API_TIMEOUT_MS`. Reinicie o Desktop para fornecer suas variáveis aos servidores de desenvolvimento.
991
992<h4 id="environment-variables-desktop-sets-itself">
993 Variáveis de ambiente que o Desktop define por conta própria
994</h4>
995
996Se você definiu `API_TIMEOUT_MS` ou `ANTHROPIC_BASE_URL` e nada mudou nas suas sessões locais, é porque o Desktop define essas [variáveis](/docs/pt/env-vars#variables), entre outras, por conta própria. Uma sessão local recebe o valor do Desktop, quer você defina o seu no perfil do shell, nas variáveis de usuário ou de sistema do Windows, no editor de ambiente local ou em um ambiente salvo. Mover o seu para um arquivo de configurações não ajuda, porque o Claude Code [ignora esse valor](/docs/pt/settings-reference#how-env-values-interact-with-your-shell) em uma sessão local.
997
998* `API_TIMEOUT_MS`: uma sessão local recebe `900000`, que equivale a 15 minutos. Para um timeout maior, [instale a CLI do Claude Code](/docs/pt/quickstart) e use-a em vez do Desktop. [Defina a variável no seu shell](/docs/pt/env-vars#set-variables-in-your-shell) e execute `claude` no seu terminal.
999* `ANTHROPIC_BASE_URL`: uma sessão local recebe o host da API da Anthropic quando você está conectado com uma conta Claude. Para usar um gateway, configure a [configuração de inferência de terceiros](/docs/pt/llm-gateway-connect#desktop-app) do Desktop em vez disso.
1000
1001<h4 id="turn-off-extended-thinking">
1002 Desativar o pensamento estendido
1003</h4>
805 1004
806O [pensamento estendido](/docs/pt/model-config#extended-thinking) é ativado por padrão, o que melhora o desempenho em tarefas de raciocínio complexo, mas usa tokens adicionais. Na API da Anthropic, defina `MAX_THINKING_TOKENS` como `0` no editor de ambiente local para desativar o pensamento; isso não tem efeito no Opus 5.5, Sonnet 5.5, Haiku 5.5 ou nos modelos Fable, que sempre usam pensamento estendido. Com o pensamento desativado na API da Anthropic, o Claude Code envia o esforço `high` em vez de um nível mais alto para modelos que ele sabe que [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como o Opus 5.1005O [pensamento estendido](/docs/pt/model-config#extended-thinking) é ativado por padrão, o que melhora o desempenho em tarefas de raciocínio complexas, mas usa tokens adicionais. Para desativá-lo, defina `MAX_THINKING_TOKENS` como `0` em um [ambiente local salvo](#set-environment-variables-for-local-sessions) ou no [editor de ambiente local](#use-the-local-environment-editor). O pensamento então é desativado na API da Anthropic, exceto no Opus 5.5, Sonnet 5.5, Haiku 5.5 e nos modelos Fable, que sempre usam pensamento estendido.
1006
1007No Opus 5, selecione também o esforço `high` ou inferior antes de iniciar a sessão. No [layout atual](#check-which-layout-you-have), abra o seletor de modelo e selecione um nível em **Effort**. Se você iniciou a sessão em um nível mais alto, inicie uma nova em `high` ou inferior.
1008
1009<h4 id="fixed-thinking-budgets">
1010 Orçamentos fixos de pensamento
1011</h4>
807 1012
808Em modelos com [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level), o Claude Code ignora o próprio número em um valor positivo de `MAX_THINKING_TOKENS`, porque o raciocínio adaptativo controla a profundidade do pensamento. No Opus 4.6 e no Sonnet 4.6, defina `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` como `1` para usar um orçamento fixo de pensamento; os modelos Fable, o Sonnet 5 e posteriores, o Haiku 5.5 e o Opus 4.7 e posteriores sempre usam raciocínio adaptativo e não têm modo de orçamento fixo.1013Em modelos com [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level), o Claude Code ignora o próprio número em um valor positivo de `MAX_THINKING_TOKENS`, porque o raciocínio adaptativo controla a profundidade do pensamento. No Opus 4.6 e no Sonnet 4.6, defina `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` como `1` para usar um orçamento fixo de pensamento; os modelos Fable, o Sonnet 5 e posteriores, o Haiku 5.5 e o Opus 4.7 e posteriores sempre usam raciocínio adaptativo e não têm modo de orçamento fixo.
809 1014
811 Sessões locais em dispositivos gerenciados1016 Sessões locais em dispositivos gerenciados
812</h4>1017</h4>
813 1018
814Seu administrador pode desativar as sessões locais com a [configuração gerenciada `disableDesktopLocalSessions`](#managed-settings). Quando isso acontece, **Local** permanece no menu suspenso de ambiente, mas fica esmaecido e não pode ser selecionado, com uma dica informando que sua organização o desativou, e no Windows a entrada [WSL](/docs/pt/desktop-wsl), cuja disponibilidade em dispositivos gerenciados é [controlada separadamente](/docs/pt/admin-setup#wsl-sessions-in-claude-code-desktop), fica esmaecida da mesma forma. Novas sessões usam por padrão a primeira conexão SSH, se houver uma configurada, e o Desktop mostra uma mensagem informando que sessões locais não estão disponíveis neste dispositivo se você tentar continuar uma existente. Escolha um ambiente [SSH](#ssh-sessions) ou [na nuvem](#cloud-sessions) em vez disso, ou entre em contato com sua equipe de TI.1019Se a entrada do seu computador estiver esmaecida no seletor de ambiente, com a dica **Disabled by your organization**, seu administrador [desativou as sessões locais](#managed-settings). No Windows, a entrada do [WSL](/docs/pt/desktop-wsl), cuja disponibilidade em dispositivos gerenciados é [controlada separadamente](/docs/pt/admin-setup#wsl-sessions-in-claude-code-desktop), fica esmaecida da mesma forma.
1020
1021Novas sessões usam por padrão a primeira conexão SSH, se houver uma configurada. Se você tentar continuar uma sessão local existente, o Desktop mostra uma mensagem informando que as sessões locais não estão disponíveis neste dispositivo. [Ambientes locais salvos](#create-a-saved-environment) mostram este erro quando você seleciona um deles: `Couldn’t switch environments: the Local environment isn’t available anymore.` Escolha um ambiente [SSH](#ssh-sessions) ou [na nuvem](#cloud-sessions) em vez disso, ou entre em contato com sua equipe de TI.
815 1022
816<h3 id="cloud-sessions">1023<h3 id="cloud-sessions">
817 Sessões na nuvem1024 Sessões na nuvem
819 1026
820As sessões na nuvem continuam em segundo plano mesmo que você feche o aplicativo. O uso conta para os [limites do seu plano de assinatura](/docs/pt/costs), sem cobranças de computação separadas.1027As sessões na nuvem continuam em segundo plano mesmo que você feche o aplicativo. O uso conta para os [limites do seu plano de assinatura](/docs/pt/costs), sem cobranças de computação separadas.
821 1028
822Você pode criar ambientes de nuvem personalizados com diferentes níveis de acesso à rede e variáveis de ambiente. Para gerenciá-los, abra o menu suspenso de ambiente na caixa de prompt e selecione **Cloud**:1029Para adicionar, editar ou [arquivar](/docs/pt/cloud-environments#archive-an-environment) um ambiente na nuvem, abra o [seletor de ambiente](#start-a-session):
823 1030
824* **Adicionar um ambiente**: selecione **Add cloud environment**1031* **Adicionar um ambiente**: selecione **New environment** na parte inferior do menu do seletor e, em seguida, a aba **Cloud** da [caixa de diálogo **New environment**](#create-a-saved-environment)
825* **Editar ou arquivar um dos seus próprios ambientes**: passe o mouse sobre ele e clique no ícone de engrenagem1032* **Editar ou arquivar um dos seus próprios ambientes**: passe o mouse sobre ele e clique no ícone de engrenagem
826 1033
827Consulte [Configurar ambientes de nuvem](/docs/pt/cloud-environments) para detalhes sobre como configurar o acesso à rede e as variáveis de ambiente.1034Consulte [Configurar ambientes de nuvem](/docs/pt/cloud-environments) para detalhes sobre como configurar o acesso à rede e as variáveis de ambiente.
836 Se você usa o Desktop com um [provedor terceirizado](/docs/pt/third-party-integrations), as sessões SSH precisam de sua própria configuração. Consulte [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).1043 Se você usa o Desktop com um [provedor terceirizado](/docs/pt/third-party-integrations), as sessões SSH precisam de sua própria configuração. Consulte [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
837</Note>1044</Note>
838 1045
839Para adicionar uma conexão SSH, abra o menu suspenso de ambiente na caixa de prompt antes de iniciar uma sessão, depois selecione **SSH > Add SSH connection…** e preencha os detalhes da conexão:1046Adicione uma conexão SSH na [caixa de diálogo **New environment**](#create-a-saved-environment) e, em seguida, inicie uma sessão nessa conexão. Se uma nova sessão não tiver um seletor de ambiente abaixo da caixa de prompt, você tem o layout anterior. Consulte [Verificar qual layout você tem](#check-which-layout-you-have).
1047
1048<Steps>
1049 <Step title="Abra a caixa de diálogo New environment">
1050 Antes de iniciar uma sessão, abra o seletor de ambiente abaixo da caixa de prompt e selecione **New environment** na parte inferior do menu.
1051 </Step>
1052
1053 <Step title="Adicione a conexão">
1054 Na aba **SSH** da caixa de diálogo **New environment**, abra a lista **Host**, selecione **Add SSH connection…** e preencha os detalhes da conexão:
840 1055
841* **Name**: um rótulo amigável para esta conexão1056 * **Name**: um rótulo amigável para esta conexão.
842* **SSH host**: `user@hostname` ou um host definido em `~/.ssh/config`1057 * **SSH host**: `user@hostname` ou um host definido em `~/.ssh/config`.
843* **SSH port**: usa 22 por padrão se deixado vazio, ou usa a porta da sua configuração SSH1058 * **SSH port**: usa 22 por padrão se deixado vazio, ou usa a porta da sua configuração SSH.
844* **SSH key (optional)**: caminho para sua chave privada, como `~/.ssh/id_ed25519`. Deixe vazio para usar sua configuração SSH ou seu agente SSH.1059 * **SSH key (optional)**: caminho para sua chave privada, como `~/.ssh/id_ed25519`. Deixe vazio para usar sua configuração SSH ou seu agente SSH.
845* **Worktree folder**: uma pasta na máquina remota, como `~/worktrees`, onde novas sessões criam seus worktrees. Deixe vazio para usar o [padrão da máquina remota](#choose-where-ssh-session-worktrees-go).1060 * **Worktree folder**: uma pasta na máquina remota, como `~/worktrees`, onde as novas sessões criam seus worktrees. Deixe vazio para usar o [padrão da máquina remota](#choose-where-ssh-session-worktrees-go).
846 1061
847Depois de adicionada, a conexão aparece em **SSH** no menu suspenso de ambiente. Selecione-a para iniciar uma sessão nessa máquina. Claude é executado na máquina remota com acesso aos arquivos e ferramentas dela.1062 Em seguida, selecione **Add SSH connection**.
1063 </Step>
1064
1065 <Step title="Inicie uma sessão na conexão">
1066 Selecione uma pasta na máquina remota e clique em **Create environment**. Você mantém a máquina e a pasta juntas como um [ambiente salvo](#create-a-saved-environment) para sessões posteriores. O Desktop o seleciona para a nova sessão; então, digite sua tarefa e pressione **Enter**.
1067 </Step>
1068</Steps>
848 1069
849A máquina remota pode executar Linux, macOS ou [Windows](#windows-remote-machines). O Desktop instala o Claude Code na máquina remota automaticamente na primeira vez que você se conecta. Depois de conectadas, as sessões SSH suportam modos de permissão, conectores, plugins e servidores MCP.1070A máquina remota pode executar Linux, macOS ou [Windows](#windows-remote-machines). O Desktop instala o Claude Code na máquina remota automaticamente na primeira vez que você se conecta. Depois de conectadas, as sessões SSH suportam modos de permissão, conectores, plugins e servidores MCP.
850 1071
1175 1396
1176Edições de arquivos e algumas ferramentas podem falhar enquanto o Desktop está desconectado. Se a tarefa precisar delas, mantenha o Desktop conectado:1397Edições de arquivos e algumas ferramentas podem falhar enquanto o Desktop está desconectado. Se a tarefa precisar delas, mantenha o Desktop conectado:
1177 1398
1178* **Worktrees**: em uma sessão que usa um [worktree](#work-in-parallel-with-sessions), o Desktop verifica cada edição de arquivo antes que Claude a faça. Enquanto o Desktop está desconectado, cada edição aguarda cerca de 30 segundos e depois falha. Comandos do shell ainda são executados. Em uma máquina remota Linux ou macOS, [as edições podem continuar funcionando](#worktree-edits-while-disconnected). Se não tiver certeza, inicie a sessão sem um worktree.1399* **Worktrees**: em uma sessão que usa um [worktree](#run-a-session-in-its-own-worktree), o Desktop verifica cada edição de arquivo antes que o Claude a faça. Enquanto o Desktop está desconectado, cada edição aguarda cerca de 30 segundos e depois falha. Os comandos do shell continuam sendo executados. Em uma máquina remota Linux ou macOS, [as edições podem continuar funcionando](#worktree-edits-while-disconnected). Se você não tiver certeza, inicie a sessão sem um worktree.
1179* **Restrições de pastas**: se sua organização restringe quais pastas as sessões podem usar, o Desktop verifica cada leitura, pesquisa e edição de arquivo, com ou sem worktree. Enquanto o Desktop está desconectado, cada uma aguarda até 10 minutos e depois falha.1400* **Restrições de pastas**: se sua organização restringe quais pastas as sessões podem usar, o Desktop verifica cada leitura, pesquisa e edição de arquivo, com ou sem worktree. Enquanto o Desktop está desconectado, cada uma aguarda até 10 minutos e depois falha.
1180* **Conectores**: [conectores](#connect-external-tools) e outras ferramentas que o Desktop fornece passam pelo Desktop, portanto, enquanto ele está desconectado, cada chamada falha após cerca de 30 segundos1401* **Conectores**: [conectores](#connect-external-tools) e outras ferramentas que o Desktop fornece passam pelo Desktop, portanto, enquanto ele está desconectado, cada chamada falha após cerca de 30 segundos
1181* **Fluxos de trabalho**: o Desktop verifica cada novo [fluxo de trabalho](/docs/pt/workflows) antes que ele comece, portanto, enquanto o Desktop está desconectado, um novo aguarda até 10 minutos e depois falha1402* **Fluxos de trabalho**: o Desktop verifica cada novo [fluxo de trabalho](/docs/pt/workflows) antes que ele comece, portanto, enquanto o Desktop está desconectado, um novo aguarda até 10 minutos e depois falha
1264 Escolher onde ficam os worktrees das sessões SSH1485 Escolher onde ficam os worktrees das sessões SSH
1265</h4>1486</h4>
1266 1487
1267A menos que sua organização restrinja quais pastas as sessões podem usar, novas sessões SSH criam seus [worktrees](#work-in-parallel-with-sessions) no primeiro destes que estiver definido:1488A menos que sua organização restrinja quais pastas as sessões podem usar, as novas sessões SSH criam seus [worktrees](#run-a-session-in-its-own-worktree) no primeiro destes locais que estiver definido:
1268 1489
12691. **Worktree folder** na conexão SSH14901. **Worktree folder** na conexão SSH
12702. [`worktree.location`](/docs/pt/settings-reference#worktree-location) em `~/.claude/settings.json` na máquina remota14912. [`worktree.location`](/docs/pt/settings-reference#worktree-location) em `~/.claude/settings.json` na máquina remota
1272 1493
1273Cada projeto recebe sua própria subpasta na pasta que você define, portanto, com `~/worktrees`, o caminho de um worktree é `~/worktrees/<project>-<id>/<worktree-name>`. Se a pasta que você definir estiver dentro do projeto, o Desktop a ignora para esse projeto e usa o padrão. Em uma [máquina remota Windows](#windows-remote-machines), o Desktop sempre usa o padrão.1494Cada projeto recebe sua própria subpasta na pasta que você define, portanto, com `~/worktrees`, o caminho de um worktree é `~/worktrees/<project>-<id>/<worktree-name>`. Se a pasta que você definir estiver dentro do projeto, o Desktop a ignora para esse projeto e usa o padrão. Em uma [máquina remota Windows](#windows-remote-machines), o Desktop sempre usa o padrão.
1274 1495
1275Para definir **Worktree folder** em uma conexão que você adicionou anteriormente ou em uma que sua organização gerencia, passe o mouse sobre ela no menu suspenso de ambiente e clique no ícone de engrenagem.1496<a id="set-the-worktree-folder-on-an-existing-connection" />
1276 1497
1277O campo requer o Claude Desktop v1.44121.0 ou posterior. Se sua organização restringe quais pastas as sessões podem usar, o Desktop oculta o campo e mantém os worktrees dentro do projeto.1498<h5 id="set-the-worktree-folder-on-an-existing-connection">
1499 Definir a pasta de worktrees em uma conexão existente
1500</h5>
1501
1502Defina **Worktree folder** nas configurações de uma conexão que você adicionou anteriormente ou de uma que sua organização gerencia. O campo exige o Claude Desktop v1.44121.0 ou posterior. Se sua organização restringir quais pastas as sessões podem usar, o Desktop oculta o campo e mantém os worktrees dentro do projeto.
1503
1504<Steps>
1505 <Step title="Encontre a conexão">
1506 Abra o [seletor de ambiente](#start-a-session) e encontre a conexão em **SSH**.
1507 </Step>
1508
1509 <Step title="Abra as configurações da conexão">
1510 Passe o cursor sobre a conexão e clique no ícone de engrenagem. Se a caixa de diálogo que abrir mostrar **Edit connection…** ao lado de **Host**, selecione **Edit connection…**.
1511 </Step>
1512
1513 <Step title="Defina a pasta">
1514 Em **Worktree folder**, insira uma pasta na máquina remota, como `~/worktrees`, e selecione **Save changes**.
1515 </Step>
1516</Steps>
1278 1517
1279<h4 id="files-and-processes-on-the-remote-machine">1518<h4 id="files-and-processes-on-the-remote-machine">
1280 Arquivos e processos na máquina remota1519 Arquivos e processos na máquina remota
1321 Encerrar o processo de uma sessão1560 Encerrar o processo de uma sessão
1322</h5>1561</h5>
1323 1562
1324Para encerrar o processo do Claude Code de uma sessão, [arquive a sessão](#work-in-parallel-with-sessions) no Desktop enquanto o Desktop estiver conectado à máquina remota. O processo continua em execução depois que sua tarefa é concluída e depois que você sai do Desktop.1563Para finalizar o processo do Claude Code de uma sessão, [arquive a sessão](#archive-a-session) no Desktop enquanto o Desktop estiver conectado à máquina remota. O processo continua em execução depois que a tarefa dele termina e depois que você encerra o Desktop.
1325 1564
1326Antes de arquivar uma sessão que tem um worktree, consulte [Trabalhar em paralelo com sessões](#work-in-parallel-with-sessions).1565Antes de arquivar uma sessão cujo worktree tenha alterações sem commit, consulte [Manter alterações sem commit quando uma sessão é arquivada](#keep-uncommitted-changes-when-a-session-is-archived).
1327 1566
1328<h5 id="see-which-user-the-processes-run-as">1567<h5 id="see-which-user-the-processes-run-as">
1329 Ver com qual usuário os processos são executados1568 Ver com qual usuário os processos são executados
1474 Pré-configurar conexões SSH para sua equipe1713 Pré-configurar conexões SSH para sua equipe
1475</h4>1714</h4>
1476 1715
1477Os administradores podem distribuir conexões SSH aos membros da equipe definindo `sshConfigs` nas [configurações gerenciadas](/docs/pt/managed-settings). As conexões definidas dessa forma aparecem automaticamente no menu suspenso de ambiente de cada usuário e são mostradas como gerenciadas. Os usuários podem selecioná-las e [definir sua própria **Worktree folder**](#choose-where-ssh-session-worktrees-go) para elas, mas não podem editar mais nada nem excluí-las no aplicativo.1716Os administradores podem distribuir conexões SSH para os membros da equipe definindo `sshConfigs` nas [configurações gerenciadas](/docs/pt/managed-settings).
1717
1718* **O que os usuários veem**: as conexões definidas dessa forma aparecem automaticamente no seletor de ambiente de cada usuário.
1719* **O que os usuários podem alterar**: os usuários podem selecionar uma conexão gerenciada e [definir sua própria **Worktree folder**](#set-the-worktree-folder-on-an-existing-connection) para ela. Eles não podem editar os outros campos nem excluí-la no aplicativo.
1478 1720
1479O exemplo a seguir pré-configura uma única conexão:1721O exemplo a seguir pré-configura uma única conexão:
1480 1722
1563Para confirmar que as configurações se aplicam, verifique o computador de um desenvolvedor:1805Para confirmar que as configurações se aplicam, verifique o computador de um desenvolvedor:
1564 1806
1565<Steps>1807<Steps>
1566 <Step title="Verifique o menu suspenso de ambiente">1808 <Step title="Verificar o seletor de ambiente">
1567 Saia do Desktop e abra-o novamente, depois abra o menu suspenso de ambiente na caixa de prompt. **Local** fica esmaecido, e **Shared Dev VM** aparece em **SSH**. Se **Local** ainda estiver disponível, verifique a versão do Desktop, se o arquivo é um JSON válido e qual fonte gerenciada o computador lê.1809 Feche e reabra o Desktop e, em seguida, abra o [seletor de ambiente](#start-a-session). As configurações foram aplicadas se ele mostrar:
1810
1811 * A entrada desse computador, em cinza
1812 * **Shared Dev VM** em **SSH**. Se ela não estiver listada ali, clique na linha única **SSH** ou em **More** no final do grupo.
1813
1814 Se a entrada do computador ainda estiver disponível, verifique estas causas:
1815
1816 * **Versão do Desktop**: atualize o Desktop se ele for anterior à v1.37937.0.
1817 * **Arquivo de configurações gerenciadas**: certifique-se de que o arquivo é um JSON válido.
1818 * **Fonte gerenciada**: certifique-se de que o computador lê a [fonte gerenciada](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) que contém as chaves.
1568 </Step>1819 </Step>
1569 1820
1570 <Step title="Adicione um host que não está na allowlist">1821 <Step title="Adicionar um host que não está na allowlist">
1571 [Adicione uma conexão SSH](#ssh-sessions) com um nome de host que não está na allowlist, como `other.example.com`. O Desktop salva a conexão, mas se recusa a se conectar, e informa que as configurações da sua organização não permitem a conexão.1822 [Adicione uma conexão SSH](#ssh-sessions) com um hostname que não está na allowlist, como `other.example.com`. O Desktop salva a conexão, mas se recusa a conectar e informa que as configurações da sua organização não permitem a conexão.
1572 </Step>1823 </Step>
1573</Steps>1824</Steps>
1574 1825
1612| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |1863| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |
1613| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](/docs/pt/desktop-ios-simulator#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |1864| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](/docs/pt/desktop-ios-simulator#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |
1614| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |1865| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |
1615| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no dropdown de ambiente. Usuários não podem excluir conexões gerenciadas nem editar nada além de sua própria **Worktree folder**. |1866| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no seletor de ambiente. Usuários não podem excluir conexões gerenciadas nem editar nada além de sua própria **Worktree folder**. |
1616| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Lido apenas de configurações gerenciadas. |1867| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Lido apenas de configurações gerenciadas. |
1617| `disableDesktopLocalSessions` | defina como `true` para desativar [sessões Code que são executadas no dispositivo](#local-sessions-on-managed-devices), deixando sessões SSH para outros hosts e sessões na nuvem disponíveis. O valor deve ser o booleano JSON `true`. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.37937.0 ou posterior. |1868| `disableDesktopLocalSessions` | defina como `true` para desativar [sessões Code que são executadas no dispositivo](#local-sessions-on-managed-devices), deixando sessões SSH para outros hosts e sessões na nuvem disponíveis. O valor deve ser o booleano JSON `true`. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.37937.0 ou posterior. |
1618| `disableSshSavedPasswords` | defina como `true` para impedir que o Desktop ofereça lembrar senhas SSH e que use ou mostre as que salvou anteriormente. Ativá-la não as exclui. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.49585.0 ou posterior. |1869| `disableSshSavedPasswords` | defina como `true` para impedir que o Desktop ofereça lembrar senhas SSH e que use ou mostre as que salvou anteriormente. Ativá-la não as exclui. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.49585.0 ou posterior. |
1756 2007
1757| CLI | Equivalente desktop |2008| CLI | Equivalente desktop |
1758| - | - |2009| - | - |
1759| `--model sonnet` | Menu suspenso de modelo ao lado do botão enviar |2010| `--model sonnet` | Seletor de modelo na linha abaixo da caixa de prompt |
1760| `--resume`, `--continue` | Clique em uma sessão na barra lateral, ou digite `/resume` na caixa de prompt para retomar uma sessão que você iniciou a partir do CLI |2011| `--resume`, `--continue` | Clique em uma sessão na barra lateral, ou digite `/resume` na caixa de prompt para retomar uma sessão que você iniciou a partir do CLI |
1761| `--permission-mode` | Seletor de modo ao lado do botão enviar |2012| `--permission-mode` | Seletor de modo na linha abaixo da caixa de prompt |
1762| `--dangerously-skip-permissions` | Modo Bypass permissions. Em planos Pro e Max, ative em Configurações → Claude Code → "Allow bypass permissions mode"; em planos Team e Enterprise, a política organizacional controla |2013| `--dangerously-skip-permissions` | Modo Bypass permissions. Em planos Pro e Max, ative em Configurações → Claude Code → "Allow bypass permissions mode"; em planos Team e Enterprise, a política organizacional controla |
1763| `--add-dir` | Adicione múltiplos repos com o botão **+** em sessões na nuvem |2014| `--add-dir` | [Adicione pastas a uma sessão](#add-folders-to-a-session) em sessões locais e SSH, ou selecione [vários repositórios](#run-long-running-tasks-in-the-cloud) em uma sessão na nuvem |
1764| `--allowedTools`, `--disallowedTools` | Nenhum equivalente por sessão. Regras de permissão em [arquivos de configuração](/docs/pt/settings) ainda se aplicam. |2015| `--allowedTools`, `--disallowedTools` | Nenhum equivalente por sessão. Regras de permissão em [arquivos de configuração](/docs/pt/settings) ainda se aplicam. |
1765| `--verbose` | [Modo de visualização Verbose](#switch-view-modes) |2016| `--verbose` | [Modo de visualização Verbose](#switch-view-modes) |
1766| `--print`, `--output-format` | Não disponível. Desktop é apenas interativo. |2017| `--print`, `--output-format` | Não disponível. Desktop é apenas interativo. |
1767| Variável de ambiente `ANTHROPIC_MODEL` | Menu suspenso de modelo ao lado do botão enviar |2018| Variável de ambiente `ANTHROPIC_MODEL` | Seletor de modelo na linha abaixo da caixa de prompt |
1768| Variável de ambiente `MAX_THINKING_TOKENS` | Defina no editor de ambiente local. Veja [configuração de ambiente](#environment-configuration). |2019| Variável de ambiente `MAX_THINKING_TOKENS` | Veja [Desativar o pensamento estendido](#turn-off-extended-thinking) |
1769 2020
1770<h3 id="shared-configuration">2021<h3 id="shared-configuration">
1771 Shared configuration2022 Shared configuration
1777* **[MCP servers](/docs/pt/mcp)** configurados em `~/.claude.json` ou `.mcp.json` funcionam em ambos2028* **[MCP servers](/docs/pt/mcp)** configurados em `~/.claude.json` ou `.mcp.json` funcionam em ambos
1778* **[Hooks](/docs/pt/hooks)** e **[skills](/docs/pt/skills)** definidos em configurações se aplicam a ambos2029* **[Hooks](/docs/pt/hooks)** e **[skills](/docs/pt/skills)** definidos em configurações se aplicam a ambos
1779* **[Configurações](/docs/pt/settings)** em `~/.claude.json` e `~/.claude/settings.json` são compartilhadas. Regras de permissão, ferramentas permitidas e outras configurações em `settings.json` se aplicam a sessões Desktop.2030* **[Configurações](/docs/pt/settings)** em `~/.claude.json` e `~/.claude/settings.json` são compartilhadas. Regras de permissão, ferramentas permitidas e outras configurações em `settings.json` se aplicam a sessões Desktop.
1780* **Modelos**: os mesmos [modelos](/docs/pt/model-config#available-models) estão disponíveis em ambos. Em Desktop, selecione o modelo no menu suspenso ao lado do botão enviar. Você pode alterar o modelo durante a sessão a partir do mesmo menu suspenso.2031* **Modelos**: os mesmos [modelos](/docs/pt/model-config#available-models) estão disponíveis em ambos. Em Desktop, selecione o modelo no seletor de modelo na linha abaixo da caixa de prompt. Você pode alterar o modelo durante a sessão a partir do mesmo seletor.
1781 2032
1782<h4 id="mcp-servers-from-the-claude-desktop-chat-app">2033<h4 id="mcp-servers-from-the-claude-desktop-chat-app">
1783 MCP servers from the Claude Desktop chat app2034 MCP servers from the Claude Desktop chat app
1805| [Provedores de terceiros](/docs/pt/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API da Anthropic por padrão. Para roteamento de gateway, veja [conectar o aplicativo desktop a um gateway](/docs/pt/llm-gateway-connect#desktop-app). Para executar a aba Code em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado, veja [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |2056| [Provedores de terceiros](/docs/pt/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API da Anthropic por padrão. Para roteamento de gateway, veja [conectar o aplicativo desktop a um gateway](/docs/pt/llm-gateway-connect#desktop-app). Para executar a aba Code em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado, veja [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |
1806| [MCP servers](/docs/pt/mcp) | Configure em arquivos de configuração | UI de Connectors para sessões locais e SSH, ou arquivos de configuração |2057| [MCP servers](/docs/pt/mcp) | Configure em arquivos de configuração | UI de Connectors para sessões locais e SSH, ou arquivos de configuração |
1807| [Plugins](/docs/pt/plugins/overview) | Comando `/plugin` | UI do gerenciador de plugins |2058| [Plugins](/docs/pt/plugins/overview) | Comando `/plugin` | UI do gerenciador de plugins |
1808| @mention de arquivos | Baseado em texto | Com autocompletar; sessões locais e SSH apenas |2059| @mention de arquivos | Baseado em texto | Com autocompletar, exceto na primeira mensagem de uma sessão na nuvem |
1809| Anexos de arquivo | Não disponível | Imagens, PDFs |2060| Anexos de arquivo | Não disponível | Imagens, PDFs |
1810| Isolamento de sessão | Flag [`--worktree`](/docs/pt/cli-reference) | Opção **worktree** ao iniciar uma sessão |2061| Isolamento de sessão | Flag [`--worktree`](/docs/pt/cli-reference) | [Executar uma sessão em seu próprio worktree](#run-a-session-in-its-own-worktree) |
1811| Múltiplas sessões | Terminais separados | Abas na barra lateral |2062| Múltiplas sessões | Terminais separados | Abas na barra lateral |
1812| Tarefas recorrentes | Cron jobs, pipelines CI | [Tarefas agendadas](/docs/pt/desktop-scheduled-tasks) |2063| Tarefas recorrentes | Cron jobs, pipelines CI | [Tarefas agendadas](/docs/pt/desktop-scheduled-tasks) |
1813| Computer use | [Ativar via `/mcp`](/docs/pt/computer-use) no macOS | [Controle de aplicativo e tela](#let-claude-use-your-computer) no macOS e Windows |2064| Computer use | [Ativar via `/mcp`](/docs/pt/computer-use) no macOS | [Controle de aplicativo e tela](#let-claude-use-your-computer) no macOS e Windows |
1833 Solução de problemas2084 Solução de problemas
1834</h2>2085</h2>
1835 2086
1836As seções abaixo cobrem problemas específicos do aplicativo desktop. Para erros de API de tempo de execução que aparecem no chat como `API Error: 500`, `529 Overloaded`, `429` ou `Prompt is too long`, veja a [referência de erros](/docs/pt/errors). Esses erros e suas correções são os mesmos em CLI, desktop e web.2087As seções abaixo cobrem problemas específicos do aplicativo desktop. Para erros de API de tempo de execução que aparecem no chat como `API Error: 500`, `529 Overloaded`, `429` ou `Prompt is too long`, veja a [referência de erros](/docs/pt/errors).
1837 2088
1838<h3 id="check-your-version">2089<h3 id="check-your-version">
1839 Verificar sua versão2090 Verificar sua versão
1852 2103
1853Para ver qual versão do Claude Code uma sessão executa, digite `/status` em uma sessão local na aba **Code** e leia a linha **Claude Code**, que mostra uma versão como `2.1.286`.2104Para ver qual versão do Claude Code uma sessão executa, digite `/status` em uma sessão local na aba **Code** e leia a linha **Claude Code**, que mostra uma versão como `2.1.286`.
1854 2105
1855Para obter uma versão mais recente para sessões locais, abra **Claude → Check for Updates** no macOS ou **Help → Check for Updates** no Windows e, em seguida, inicie uma nova sessão.2106Para obter uma versão mais recente para sessões locais, abra **Claude > Check for Updates…** no macOS ou **Help > Check for Updates…** no Windows e, em seguida, inicie uma nova sessão.
1856 2107
1857Em uma sessão local, a aba **Code** executa sua própria cópia do Claude Code, que tem seu próprio número de versão. O aplicativo desktop baixa e atualiza essa cópia, portanto ela pode ser diferente do comando `claude` no seu terminal, e atualizar um não atualiza o outro.2108Em uma sessão local, a aba **Code** executa sua própria cópia do Claude Code, que tem seu próprio número de versão. O aplicativo desktop baixa e atualiza essa cópia, portanto ela pode ser diferente do comando `claude` no seu terminal, e atualizar um não atualiza o outro.
1858 2109
2110<h3 id="check-which-layout-you-have">
2111 Verificar qual layout você tem
2112</h3>
2113
2114Se uma nova sessão não tem um [seletor de ambiente](#start-a-session) abaixo da caixa de prompt, você tem o layout anterior:
2115
2116* **[Desktop anterior à v2.37337.0](#check-your-version)**: atualize para obter o layout atual. Selecione **Claude > Check for Updates…** no macOS ou **Help > Check for Updates…** no Windows.
2117* **[Provedor terceirizado](/docs/pt/third-party-integrations)**: você mantém o layout anterior, então não há nada a fazer.
2118
2119No layout anterior, escolha o ambiente e a pasta do projeto acima da caixa de prompt, e o modo de permissão e o modelo na linha abaixo dela. O layout anterior não tem o [painel de detalhes da sessão](#see-session-details) nem os [ambientes locais e SSH salvos](#create-a-saved-environment).
2120
1859<h3 id="403-or-authentication-errors-in-the-code-tab">2121<h3 id="403-or-authentication-errors-in-the-code-tab">
1860 Erros 403 ou autenticação na aba Code2122 Erros 403 ou autenticação na aba Code
1861</h3>2123</h3>
