46 46
47Antes de enviar sua primeira mensagem, configure quatro coisas na área de prompt:47Antes de enviar sua primeira mensagem, configure quatro coisas na área de prompt:
48 48
49* **Ambiente**: escolha onde Claude é executado. Selecione **Local** para sua máquina, **Cloud** para uma [sessão em 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). Veja [configuração de ambiente](#environment-configuration).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).
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* **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).
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* **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.
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* **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.
236 Executar comandos no terminal236 Executar comandos no terminal
237</h3>237</h3>
238 238
239O 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**. O terminal está disponível em sessões locais e [SSH](#ssh-sessions).239O 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**.
240
241O terminal está disponível em sessões locais e [SSH](#ssh-sessions), com uma limitação em [máquinas remotas Windows](#windows-remote-machines).
240 242
241<h3 id="open-and-edit-files">243<h3 id="open-and-edit-files">
242 Abrir e editar arquivos244 Abrir e editar arquivos
468 470
469Veja [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.471Veja [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.
470 472
473<Note>
474 Uma tarefa em uma [sessão SSH](#ssh-sessions) também pode [continuar enquanto o Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected), mas com uma conta Claude ela pode parar quando seu login expirar.
475</Note>
476
471<h3 id="continue-in-another-surface">477<h3 id="continue-in-another-surface">
472 Continuar em outra superfície478 Continuar em outra superfície
473</h3>479</h3>
772 778
773* **Local**: é executado em sua máquina com acesso direto aos seus arquivos779* **Local**: é executado em sua máquina com acesso direto aos seus arquivos
774* **Cloud**: é executado na infraestrutura gerenciada pela Anthropic por padrão. Sessões continuam mesmo se você fechar o aplicativo.780* **Cloud**: é executado na infraestrutura gerenciada pela Anthropic por padrão. Sessões continuam mesmo se você fechar o aplicativo.
775* **SSH**: é executado em uma máquina remota à qual você se conecta via SSH, como seus próprios servidores, VMs em nuvem ou dev containers781* **SSH**: é executado em uma máquina remota à qual você se conecta via SSH, como seus próprios servidores, VMs em 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.
776* **WSL** (Windows): é executado dentro de uma [distribuição WSL 2](/docs/pt/desktop-wsl) em sua máquina, usando sua cadeia de ferramentas Linux e caminhos nativos782* **WSL** (Windows): é executado dentro de uma [distribuição WSL 2](/docs/pt/desktop-wsl) em sua máquina, usando sua cadeia de ferramentas Linux e caminhos nativos
777 783
778<h3 id="local-sessions">784<h3 id="local-sessions">
812 818
813Sessões SSH permitem que você execute Claude Code em uma máquina remota enquanto usa o aplicativo desktop como sua interface. Isso é útil para trabalhar com bases de código que vivem em VMs em nuvem, dev containers ou servidores com hardware ou dependências específicas.819Sessões SSH permitem que você execute Claude Code em uma máquina remota enquanto usa o aplicativo desktop como sua interface. Isso é útil para trabalhar com bases de código que vivem em VMs em nuvem, dev containers ou servidores com hardware ou dependências específicas.
814 820
821<Note>
822 Se você usa o Desktop com um [provedor de terceiros](/docs/pt/third-party-integrations), as sessões SSH precisam de sua própria configuração. Veja [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
823</Note>
824
815Para 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:825Para 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:
816 826
817* **Name**: um rótulo amigável para esta conexão827* **Name**: um rótulo amigável para esta conexão
822 832
823Uma vez adicionada, a conexão aparece em **SSH** no menu suspenso de ambiente. Selecione-a para iniciar uma sessão naquela máquina. Claude é executado na máquina remota com acesso aos seus arquivos e ferramentas.833Uma vez adicionada, a conexão aparece em **SSH** no menu suspenso de ambiente. Selecione-a para iniciar uma sessão naquela máquina. Claude é executado na máquina remota com acesso aos seus arquivos e ferramentas.
824 834
825A máquina remota deve executar Linux ou macOS. O aplicativo desktop instala Claude Code na máquina remota automaticamente na primeira vez que você se conecta. Uma vez conectado, sessões SSH suportam modos de permissão, conectores, plugins e MCP servers.835A máquina remota pode executar Linux, macOS ou [Windows](#windows-remote-machines). O Desktop instala Claude Code na máquina remota automaticamente na primeira vez que você se conecta. Uma vez conectado, sessões SSH suportam modos de permissão, conectores, plugins e servidores MCP.
836
837<h4 id="remote-machine-requirements-for-ssh-sessions">
838 Requisitos da máquina remota para sessões SSH
839</h4>
840
841Uma máquina remota Linux ou macOS precisa de um processador compatível, um servidor SSH com SFTP, uma pasta de instalação que não esteja montada com `noexec`, um shell funcional e acesso à rede. Verifique cada requisito antes de se conectar, ou quando uma conexão falhar depois que você fizer login:
842
843* **Sistema**: um processador x86\_64 ou arm64. A máquina também precisa atender aos [requisitos de sistema](/docs/pt/setup#system-requirements) do Claude Code.
844* **SFTP**: o servidor SSH precisa oferecer o subsistema SFTP, que uma linha `Subsystem sftp` em seu `sshd_config` ativa. Para verificar, conecte-se ao mesmo host e porta com `sftp` em um terminal no seu computador. Um servidor funcional mostra o prompt `sftp>`.
845* **Sessões por conexão**: o Desktop no macOS e no Linux abre várias sessões em uma única conexão SSH. Se o `sshd_config` do servidor definir `MaxSessions 1`, aumente o valor, por exemplo para o padrão do OpenSSH, que é 10.
846* **Pasta de instalação**: o Desktop instala um programa auxiliar e o Claude Code em `~/.claude/remote/` no seu diretório pessoal. Ele os executa a partir dali, então essa pasta não pode estar em um sistema de arquivos montado com `noexec`. Reserve cerca de 1 GB de espaço em disco no diretório pessoal de cada usuário que se conecta.
847* **Shell**: o shell definido para sua conta na máquina remota precisa executar comandos enviados via SSH, como Bash, Zsh e `sh` fazem
848* **Rede**: o Claude Code é executado na máquina remota e faz suas requisições de rede a partir dela, então a máquina precisa do [acesso à rede que o Claude Code requer](/docs/pt/network-config#network-access-requirements). Se a máquina não conseguir baixar o Claude Code, o Desktop o baixa no seu computador e o envia. As outras requisições do Claude Code continuam saindo da máquina remota.
849
850<h4 id="use-your-ssh-configuration-on-macos-and-linux">
851 Usar sua configuração SSH no macOS e no Linux
852</h4>
853
854No macOS e no Linux, o Desktop se conecta executando o cliente OpenSSH no seu computador, então ele usa o seu `~/.ssh/config`. Conectar-se pelo cliente OpenSSH requer Claude Desktop v1.37937.0 ou posterior. Insira um nome de `Host` desse arquivo no campo **SSH host** para usar as configurações da entrada correspondente, como `HostName`, `User`, `IdentityFile`, `CertificateFile`, `ProxyJump` e `ProxyCommand`.
855
856Antes de adicionar a conexão, verifique o cliente e a entrada em um terminal no seu computador:
857
858* **Versão do cliente**: execute `ssh -V`. O cliente precisa ser OpenSSH 7.6 ou posterior.
859* **Entrada**: execute `ssh` com o nome do `Host`, como `ssh devbox`. Se isso falhar, corrija a entrada primeiro.
860
861Você pode deixar os campos **SSH port** e **SSH key (optional)** vazios. Se preencher um deles, o Desktop o usa junto com a entrada:
862
863* **SSH port**: um valor aqui sobrescreve o `Port` da entrada
864* **SSH key (optional)**: o Desktop oferece o arquivo de chave que você escolher, além do `IdentityFile` da entrada e das chaves no seu agente SSH
865
866<h5 id="reach-a-machine-behind-a-jump-host">
867 Acessar uma máquina atrás de um jump host
868</h5>
869
870Para acessar uma máquina atrás de um jump host, também chamado de bastion, defina `ProxyJump` ou `ProxyCommand` na entrada. A entrada a seguir acessa `devbox.internal.example.com` por meio de `bastion.example.com`:
871
872```text ~/.ssh/config theme={null}
873Host devbox
874 HostName devbox.internal.example.com
875 User alice
876 ProxyJump bastion.example.com
877```
878
879Insira `devbox` no campo **SSH host**.
880
881<h5 id="raise-the-ssh-connection-timeout">
882 Aumentar o timeout de conexão SSH
883</h5>
884
885Se sua configuração SSH não definir nenhum `ConnectTimeout` para o host, o Desktop dá ao `ssh` 30 segundos para se conectar. Por meio de um jump host ou de um `ProxyCommand`, esse tempo inclui o tempo que a rota leva para se conectar. Se sua rota precisar de mais tempo, adicione um valor maior à entrada:
886
887```text ~/.ssh/config theme={null}
888Host devbox
889 HostName devbox.internal.example.com
890 User alice
891 ProxyJump bastion.example.com
892 ConnectTimeout 120
893```
894
895O `ssh` usa o primeiro valor que encontra para um host, então mantenha a entrada acima de qualquer entrada `Host *` que defina `ConnectTimeout`. Para confirmar, execute `ssh -G devbox` em um terminal no seu computador. A saída inclui `connecttimeout 120`. Depois de alterar o valor, feche e reabra o Desktop.
896
897<h4 id="windows-remote-machines">
898 Máquinas remotas Windows
899</h4>
900
901Uma máquina remota Windows requer Claude Desktop v2.31226.0 ou posterior.
902
903Use o OpenSSH Server da Microsoft. A máquina pode ser x64 ou ARM64. O shell que o servidor SSH inicia pode ser `cmd.exe`, Windows PowerShell 5.1 ou Git Bash.
904
905Máquinas remotas Windows são menos testadas que as Linux. Experimente seu próprio trabalho ali antes de depender dela.
906
907Espere estes limites, entre outros, em uma máquina remota Windows:
908
909* **Terminal**: o [terminal](#run-commands-in-the-terminal) não abre em uma sessão cuja pasta é um caminho Windows, como `C:/projects/app`
910* **Sandbox**: o Claude Code é executado ali no Windows nativo, onde executa comandos sem sandbox. Veja [onde o sandbox é executado](/docs/pt/sandboxing).
911* **Plugins**: o Desktop não copia um plugin que contenha um nome de arquivo ou pasta que o Windows não consegue armazenar, como um nome com `:`. A sessão lista os plugins que o Desktop deixou de fora.
912* **Servidores MCP**: em algumas máquinas remotas Windows, as chamadas do Claude a servidores MCP de `claude_desktop_config.json` passam pelo Desktop, então Claude não pode chamar as ferramentas deles [enquanto o Desktop está desconectado](#limits-while-desktop-is-disconnected). Antes do Claude Desktop v2.37337.0, isso vale para todas as máquinas remotas Windows.
913* **Worktrees**: os worktrees ficam em `<project-root>/.claude/worktrees/`. Se você [escolher outra pasta](#choose-where-ssh-session-worktrees-go), o Desktop a ignora.
914* **Mensagens anteriores**: se o shell do servidor SSH for `cmd.exe` ou Windows PowerShell, talvez você precise se conectar antes de ver as mensagens anteriores de uma sessão
915* **Forks**: se o shell do servidor SSH for `cmd.exe` ou Windows PowerShell, você só pode fazer fork de uma sessão na primeira mensagem dela
916* **Execução enquanto desconectado**: uma tarefa [continua em execução enquanto o Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected) somente se o servidor SSH permitir que um programa sobreviva à conexão que o iniciou. Para descobrir, [teste a máquina remota](#prepare-a-long-task).
917* **Processos remanescentes**: depois que uma sessão terminar, verifique na máquina se há programas que o Claude Code iniciou, porque eles podem continuar em execução. O [programa auxiliar em segundo plano](#keep-a-task-running-while-desktop-is-disconnected) que o Desktop instala não para sozinho ali.
918
919<h4 id="keep-a-task-running-while-desktop-is-disconnected">
920 Manter uma tarefa em execução enquanto o Desktop está desconectado
921</h4>
922
923Se seu computador entrar em suspensão, você perder a rede ou fechar o Desktop, a tarefa continua até terminar, precisar de você ou atingir um dos [limites](#limits-while-desktop-is-disconnected). Fechar a tampa conta como suspensão. Uma reinicialização do Desktop ou do seu computador, inclusive para uma atualização, conta como fechar o aplicativo.
924
925O Claude Code é executado como um processo na máquina remota, sob um programa auxiliar em segundo plano que o Desktop instala ali, então ele não precisa da sua conexão SSH para continuar em execução. O comportamento desta seção requer Claude Desktop v2.31226.0 ou posterior.
926
927<Warning>
928 Se você fizer login no Desktop com uma conta Claude, não conte com uma tarefa sendo executada durante a noite. O Desktop renova esse login para a tarefa apenas enquanto o Desktop está em execução e conectado, então o login da tarefa pode expirar depois que você se desconecta, e a tarefa então para. O tempo restante quando você se desconecta varia.
929
930 O trabalho feito até então permanece na máquina remota, e você pode continuar com uma mensagem quando voltar.
931
932 Se a tarefa precisar ser executada durante a noite:
933
934 * [Mantenha seu computador acordado](/docs/pt/desktop-scheduled-tasks#how-scheduled-tasks-run) e online, com a tampa aberta e o Desktop em execução
935 * Use um login que funcione sem prompt, como uma chave mantida pelo seu agente SSH, para a máquina remota e para qualquer jump host no caminho. O Desktop pode então se reconectar sozinho após uma queda.
936
937 Para uma tarefa que precisa ser executada enquanto seu computador está em suspensão ou desligado, inicie uma [sessão na nuvem](#run-long-running-tasks-in-the-cloud) em vez disso.
938</Warning>
939
940* **Após suspensão ou perda de rede**: você recupera a tarefa em execução se o processo [ainda estiver em execução](#limits-while-desktop-is-disconnected) e o Desktop conseguir fazer login sem prompt. Se não conseguir, [envie uma mensagem](#reconnect-after-sleep-or-a-network-loss).
941* **Após fechar o aplicativo, com o Desktop no macOS ou Linux e uma conta Claude**: você recupera a tarefa em execução se o Desktop conseguir [se reconectar ao processo](#reopen-a-session-after-you-quit-desktop). Se não conseguir, a tarefa para. Se ela continuar parada, envie uma mensagem.
942* **Após fechar o aplicativo, com o Desktop no Windows ou um [provedor de terceiros](/docs/pt/third-party-integrations)**: você perde a tarefa em execução, porque o Desktop encerra o processo quando a sessão é aberta. Envie uma mensagem para continuar.
943
944Quando você voltar e a tarefa não estiver concluída, verifique se há aviso de que o Desktop não consegue se reconectar, um erro de autenticação ou uma solicitação pendente:
945
946* **O Desktop não consegue se reconectar**: a sessão diz o motivo, e uma notificação também pode dizer. O Desktop pode [precisar que você faça login](#reconnect-after-sleep-or-a-network-loss).
947* **Erro de autenticação**: o [token de login ou a credencial](#limits-while-desktop-is-disconnected) pode ter expirado. Com uma conta Claude, envie uma mensagem para continuar. Com um provedor de terceiros, veja [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
948* **Solicitação pendente**: [responda a ela](#handle-requests-that-arrive-while-you-are-away)
949* **Nenhum desses**: envie uma mensagem para continuar
950
951<a id="prepare-a-long-task" />
952
953<h5 id="prepare-a-long-task">
954 Preparar uma tarefa longa
955</h5>
956
957* **Atualize primeiro**: atualize o Desktop antes de iniciar uma tarefa longa. No macOS e no Windows, o Desktop pode reiniciar sozinho para instalar uma atualização que baixou. Essa reinicialização espera enquanto Claude está trabalhando em uma tarefa SSH. No macOS com uma conta Claude, por padrão a reinicialização pode acontecer mesmo assim depois que a atualização tiver esperado 72 horas.
958* **Não feche o Desktop**: se o Desktop for executado no Windows ou usar um provedor de terceiros, deixe-o aberto enquanto a tarefa longa é executada. Depois de ser fechado, ele [encerra a tarefa em execução](#reopen-a-session-after-you-quit-desktop) quando a sessão é aberta. Deixá-lo aberto não protege uma solicitação que [espera por você](#handle-requests-that-arrive-while-you-are-away).
959* **Reduza as solicitações**: escolha um modo de permissão, regras ou hooks que [façam a tarefa esperar por você com menos frequência](#handle-requests-that-arrive-while-you-are-away)
960* **Verifique o jump host**: se seu jump host pedir um login, por exemplo uma notificação push para um telefone, mude para um login que funcione sem prompt. Caso contrário, o Desktop pode enviar outra notificação push cada vez que tentar se reconectar.
961* **Teste a máquina remota**: inicie uma tarefa curta, feche o Desktop enquanto a tarefa ainda está em execução e abra a sessão novamente bem depois de a tarefa já dever ter terminado. Se a tarefa não estiver concluída e a sessão não mostrar nenhum erro de autenticação, verifique na máquina remota [o que pode encerrar uma tarefa](#limits-while-desktop-is-disconnected).
962* **Mantenha comandos fora do terminal do Desktop**: se a máquina remota [faz logout de terminais ociosos](#limits-while-desktop-is-disconnected), execute seus próprios comandos a partir de um login SSH fora do Desktop
963
964<a id="limits-while-desktop-is-disconnected" />
965
966<h5 id="limits-while-desktop-is-disconnected">
967 Limites enquanto o Desktop está desconectado
968</h5>
969
970Uma tarefa que você deixa em execução pode terminar quando o login dela expira, quando a máquina remota a encerra ou quando o programa auxiliar para ou é substituído:
971
972* **Token de login ou credencial**: com uma conta Claude, a tarefa para com um erro de autenticação quando o token expira. Com um provedor de terceiros, o mesmo vale para uma credencial que expira, como uma de single sign-on ou de um credential helper. Veja [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). Com uma conta Claude, [mantenha o Desktop em execução e conectado](#keep-a-task-running-while-desktop-is-disconnected) para que ele possa renovar o login.
973* **A máquina remota**: se a máquina remota reiniciar, ou encerrar seus processos quando sua conexão SSH for fechada, a tarefa em execução termina. Nada a inicia novamente enquanto o Desktop está desconectado. Máquinas Linux em que o `KillUserProcesses` do systemd-logind é `yes` e se aplica ao seu usuário encerram seus processos dessa forma. Para manter uma tarefa em execução ali, peça ao administrador que isente seu usuário, por exemplo com `KillExcludeUsers`.
974* **Terminais ociosos**: algumas máquinas remotas Linux fazem logout de um terminal em que ninguém digita por um tempo definido (`StopIdleSessionSec` do systemd-logind). Com o Desktop no macOS ou Linux, o [terminal](#run-commands-in-the-terminal) de uma sessão e os comandos `!` compartilham a conexão SSH do Desktop por padrão. Esse logout então encerra a conexão enquanto o Desktop está conectado, e a tarefa em execução pode terminar junto. Fechar o painel do terminal não impede isso, então [mantenha comandos fora desse terminal](#prepare-a-long-task).
975* **Atualizações do Desktop**: se uma atualização trouxer um novo programa auxiliar, o Desktop substitui o programa auxiliar na máquina remota em uma conexão posterior, o que pode encerrar uma tarefa que ainda está em execução
976* **Ausências longas**: em uma máquina remota Linux ou macOS, se o Desktop não se conectar por 30 dias, o programa auxiliar para e encerra todos os processos do Claude Code executados sob ele. Conecte-se antes disso.
977
978Edições de arquivos e algumas ferramentas podem falhar enquanto o Desktop está desconectado. Se a tarefa precisar delas, mantenha o Desktop conectado:
979
980* **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 espera cerca de 30 segundos e então falha. Comandos de shell continuam sendo 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.
981* **Restrições de pastas**: se sua organização restringe quais pastas as sessões podem usar, o Desktop verifica cada leitura, busca e edição de arquivo, com ou sem worktree. Enquanto o Desktop está desconectado, cada uma espera até 10 minutos e então falha.
982* **Conectores**: [conectores](#connect-external-tools) e outras ferramentas fornecidas pelo Desktop são executados por meio do Desktop, então, enquanto ele está desconectado, cada chamada falha após cerca de 30 segundos
983* **Workflows**: o Desktop verifica cada novo [workflow](/docs/pt/workflows) antes que ele comece, então, enquanto o Desktop está desconectado, um novo workflow espera até 10 minutos e então falha
984* **Servidores MCP**: servidores MCP que o Claude Code inicia na máquina remota não passam pelo Desktop, então Claude ainda pode chamar as ferramentas deles. Os servidores de `claude_desktop_config.json` estão entre eles somente se o Desktop não usar seu [cliente SSH integrado](#worktree-edits-while-disconnected). Caso contrário, e em [algumas máquinas remotas Windows](#windows-remote-machines), Claude não pode chamar as ferramentas deles enquanto o Desktop está desconectado.
985
986<span id="worktree-edits-while-disconnected" />
987
988<Accordion title="Quando as edições em um worktree continuam funcionando">
989 Em uma máquina remota Linux ou macOS, a verificação não passa pelo Desktop, então as edições dentro do worktree continuam funcionando enquanto o Desktop está desconectado. Antes do Claude Desktop v2.37337.0, isso vale apenas para máquinas remotas Linux.
990
991 As edições ainda falham em alguns casos, incluindo estes:
992
993 * **Cliente SSH integrado**: o Desktop o usa, por exemplo em uma instalação da Microsoft Store, em um computador Windows sem o OpenSSH 9.4 ou posterior da Microsoft, ou por padrão no Windows com um provedor de terceiros
994 * **Local do repositório**: o repositório é seu diretório pessoal, uma pasta acima dele ou `~/.claude`
995 * **Caminhos no macOS**: em uma máquina remota macOS, o repositório está em `/Volumes`, ou um nome de pasta no caminho do repositório ou do worktree contém `~` ou um caractere não ASCII
996 * **Restrições de pastas**: sua organização restringe quais pastas as sessões podem usar
997 * **Launcher corporativo**: antes do Claude Desktop v2.37337.0, você faz login com uma conta Claude e sua organização inicia o Claude Code na máquina remota por meio de um [launcher corporativo](/docs/pt/corporate-launcher)
998
999 Uma sessão sem worktree não tem essa verificação, a menos que sua organização restrinja quais pastas as sessões podem usar.
1000</Accordion>
1001
1002<a id="handle-requests-that-arrive-while-you-are-away" />
1003
1004<h5 id="handle-requests-that-arrive-while-you-are-away">
1005 Lidar com solicitações que chegam enquanto você está ausente
1006</h5>
1007
1008Se Claude precisar da sua aprovação ou lhe fizer uma pergunta enquanto o Desktop está desconectado, Claude espera na máquina remota. A espera não tem limite de tempo próprio. Quando o Desktop se reconecta ao processo, ele mostra a solicitação. Se o Desktop iniciar um novo processo em vez disso, você perde a solicitação.
1009
1010Enquanto uma tarefa espera por você, o Desktop pode reiniciar sozinho, por exemplo para instalar uma atualização. Se o Desktop for executado no Windows ou usar um provedor de terceiros, você perde a solicitação após essa reinicialização.
1011
1012Se você perder uma solicitação, envie uma mensagem para continuar.
1013
1014Para reduzir a frequência com que uma tarefa para e espera por você, e para receber notícias dela enquanto está ausente, configure qualquer um destes antes de sair:
1015
1016* **Modo auto**: escolha o [modo auto](#choose-a-permission-mode) se [ele estiver disponível para você](#auto-mode-availability). Após bloqueios repetidos, [você é consultado novamente](/docs/pt/permission-modes#when-auto-mode-falls-back).
1017* **Regras de permissão allow**: no seu arquivo de configurações de usuário na máquina remota, `~/.claude/settings.json`, adicione [regras allow](/docs/pt/permissions#manage-permissions) para os comandos de que a tarefa precisa. Se sua organização [aceita regras de permissão apenas das configurações gerenciadas](/docs/pt/settings-reference#allowmanagedpermissionrulesonly), peça ao seu administrador que as adicione às [configurações gerenciadas](#managed-settings) que chegam à máquina remota. Para regras allow no `.claude/settings.json` de um projeto, veja [Project allow rules and workspace trust](/docs/pt/permissions#project-allow-rules-and-workspace-trust).
1018* **Um hook que responde**: configure um [hook `PermissionRequest`](/docs/pt/hooks#permissionrequest) em `~/.claude/settings.json` na máquina remota para permitir ou negar solicitações no seu lugar
1019* **Um hook que alerta você**: configure um [hook `Notification`](/docs/pt/hooks#notification) com o matcher `permission_prompt` no mesmo arquivo para enviar a si mesmo uma mensagem quando uma solicitação estiver pendente
1020* **Um hook que avisa quando Claude termina**: configure um [hook `Stop`](/docs/pt/hooks#stop) no mesmo arquivo para enviar a si mesmo uma mensagem quando Claude terminar de responder. Ele não é executado quando um erro de API encerra o turno. Para esse caso, configure um [hook `StopFailure`](/docs/pt/hooks#stopfailure).
1021
1022Se sua organização [executa apenas hooks gerenciados](/docs/pt/settings-reference#allowmanagedhooksonly), peça ao seu administrador que adicione o hook às [configurações gerenciadas](#managed-settings) que chegam à máquina remota.
1023
1024O Claude Code não aprova automaticamente [algumas ações](/docs/pt/permission-modes#actions-no-mode-auto-approves) em nenhum modo de permissão, incluindo Bypass permissions. Dependendo do modo de permissão, o Claude Code nega essa ação ou pergunta a você, e a tarefa então espera pela sua resposta.
1025
1026<a id="reconnect-after-sleep-or-a-network-loss" />
1027
1028<h5 id="reconnect-after-sleep-or-a-network-loss">
1029 Reconectar após suspensão ou perda de rede
1030</h5>
1031
1032Se o Desktop não tiver se reconectado quando você voltar, envie uma mensagem na sessão. O Desktop se reconecta sozinho apenas quando consegue fazer login sem prompt, por exemplo com uma chave mantida pelo seu agente SSH.
1033
1034* **Senha lembrada**: uma senha que você permitiu que o Desktop lembrasse também funciona sem prompt, mas, para uma ausência longa, prefira uma chave mantida pelo seu agente SSH. Se os logins com essa senha forem interrompidos ou travarem, o Desktop pode parar de se reconectar e esperar por você.
1035* **Qualquer outro prompt**: se a máquina remota solicitar qualquer outra coisa, como um código de uso único, você pode receber uma notificação no seu computador. Clique na notificação, ou envie uma mensagem na sessão, e o Desktop mostra o prompt.
1036
1037<Accordion title="Se um jump host pedir um login, a interrupção for longa, faltar saída ou o processo tiver desaparecido">
1038 - **Jump host, as notificações push param enquanto você está ausente**: isso pode acontecer com o Desktop no macOS ou Linux quando ninguém responde ao login de um jump host, por exemplo uma notificação push para um telefone. O Desktop então para de se reconectar enquanto não há ninguém no seu computador. Quando você desbloqueia ou usa o computador, pode receber outra notificação push, porque o Desktop pode tentar novamente. Após três tentativas sem resposta, ele espera até que você tente novamente ou envie uma mensagem.
1039 - **Jump host, as notificações push continuam chegando**: onde o Desktop não consegue perceber que ninguém responde, como no Desktop no Windows, ele continua tentando enquanto tiver um processo ao qual se reconectar, esteja esse processo ainda em execução ou não. Você pode receber outra notificação push a cada tentativa. Para encerrar as tentativas, feche o Desktop, o que [pode custar a tarefa em execução](#reopen-a-session-after-you-quit-desktop).
1040 - **Interrupção longa**: o Desktop diminui o ritmo para cerca de uma tentativa a cada cinco minutos. Para se reconectar mais cedo, tente novamente na sessão ou envie uma mensagem, que o Desktop entrega assim que estiver conectado.
1041 - **Saída ausente**: enquanto o Desktop está desconectado, o programa auxiliar mantém a saída mais recente do Claude Code de cada sessão em um buffer de 16 MiB e descarta a saída mais antiga. Depois que o Desktop se reconecta, a sessão pode mostrar `Loading recent output from <host>…`. Se o Desktop não conseguir carregar toda a saída, você vê a linha `Some output produced while you were disconnected may be missing here.` A linha não significa que a tarefa parou.
1042 - **Processo desaparecido**: se o processo tiver desaparecido quando o Desktop se reconectar, o Desktop pode iniciar um novo a partir do histórico salvo da conversa e dizer a Claude para continuar a tarefa. O Desktop não continua a tarefa sozinho se o processo continuar terminando, ou se o Desktop usar um provedor de terceiros. Envie uma mensagem para continuar.
1043</Accordion>
1044
1045<a id="reopen-a-session-after-you-quit-desktop" />
1046
1047<h5 id="reopen-a-session-after-you-quit-desktop">
1048 Reabrir uma sessão depois de fechar o Desktop
1049</h5>
1050
1051Depois que você fecha o Desktop, a tarefa continua em execução na máquina remota até terminar, precisar de você ou atingir um dos [limites](#limits-while-desktop-is-disconnected).
1052
1053* **Desktop no macOS ou Linux, com uma conta Claude**: inicie o Desktop e abra a sessão. Você recupera a tarefa em execução quando o Desktop consegue se reconectar ao processo. Nem sempre ele consegue, por exemplo após algumas atualizações do Desktop ou depois que sua organização altera as configurações gerenciadas.
1054* **No macOS ou Linux, quando o Desktop não consegue se reconectar**: o Desktop encerra o processo e inicia um novo a partir do histórico salvo da conversa. Sua tarefa em execução para, e você perde qualquer aprovação ou pergunta que estava esperando por você. Após uma atualização, o Desktop pode então dizer a Claude para continuar. Se a tarefa continuar parada, envie uma mensagem.
1055* **Desktop no Windows, ou com um provedor de terceiros em qualquer plataforma**: inicie o Desktop novamente somente quando esperar que a tarefa esteja concluída. Você não recupera a tarefa em execução, porque o Desktop nunca se reconecta depois de ser fechado. Ele encerra o processo quando a sessão é aberta, o que pode acontecer quando o Desktop é iniciado. Envie uma mensagem para continuar.
1056
1057Para implantações de terceiros, veja [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
1058
1059<Warning>
1060 Enquanto o processo do Claude Code de uma conversa ainda estiver em execução, não execute [`claude --resume`](/docs/pt/cli-reference#cli-flags) para ela na máquina remota. O Claude Code não impede você, e os dois processos então escrevem na mesma conversa. Se não tiver certeza, adicione `--fork-session`, que continua em uma cópia da conversa, mas os dois processos ainda trabalham nos mesmos arquivos.
1061</Warning>
826 1062
827<h4 id="choose-where-ssh-session-worktrees-go">1063<h4 id="choose-where-ssh-session-worktrees-go">
828 Escolher onde ficam os worktrees das sessões SSH1064 Escolher onde ficam os worktrees das sessões SSH
8342. [`worktree.location`](/docs/pt/settings-reference#worktree-location) em `~/.claude/settings.json` na máquina remota10702. [`worktree.location`](/docs/pt/settings-reference#worktree-location) em `~/.claude/settings.json` na máquina remota
8353. `<project-root>/.claude/worktrees/`, o padrão10713. `<project-root>/.claude/worktrees/`, o padrão
836 1072
837Cada projeto recebe sua própria subpasta na pasta que você definir, então 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.1073Cada projeto recebe sua própria subpasta na pasta que você definir, então 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.
838 1074
839Para 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.1075Para 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.
840 1076
