Aplicativo Desktop

Aproveite ao máximo o Claude Code Desktop: sessões paralelas com isolamento Git, layout de painel com arrastar e soltar, terminal integrado e editor de arquivo, chats laterais, computer use, Dispatch sessions do seu telefone, revisão visual de diff, visualizações de aplicativos, monitoramento de PR, conectores e configuração corporativa.

O aplicativo Claude Desktop tem três abas: Chat para conversas, Cowork para Dispatch e trabalho agentic mais longo, e Code para desenvolvimento de software. Esta página é a referência para a aba Code.

Para Windows ARM64, baixe o instalador ARM64. No Linux, instale com apt; consulte Claude Desktop no Linux.

Após instalar, inicie Claude, faça login e clique na aba Code. Para um passo a passo de sua primeira sessão, consulte o guia de primeiros passos.

Na aba Code, cada conversa é uma sessão: ela tem seu próprio histórico de chat e pasta de projeto, independente de qualquer outra sessão. A barra lateral lista suas sessões e permite que você execute várias em paralelo. Dentro de uma sessão você pode:

• Revisar e comentar em diffs, depois monitorar o PR resultante através do CI
• Visualizar seu aplicativo em execução no painel do navegador enquanto Claude verifica suas próprias alterações, e abrir sites externos ao lado dele
• Assistir Claude executar e testar seu aplicativo iOS no painel do iOS Simulator
• Organizar painéis para o chat, diff, navegador, terminal e editor de arquivo lado a lado
• Fazer uma pergunta lateral que usa o contexto da sessão sem desviá-la
• Permitir que Claude verifique, envie mensagens ou arquive suas outras sessões
• Conectar ferramentas externas como GitHub, Slack e Linear
• Permitir que Claude abra aplicativos e controle sua tela
• Executar em sua máquina, na nuvem, ou sobre SSH

Para trabalho recorrente agendado, atalhos de teclado, ou envio de tarefas do seu telefone, consulte as páginas e seções vinculadas. Se você já usa o CLI baseado em terminal, consulte a comparação CLI para ver o que é transferido.

Iniciar uma sessão

Antes de enviar sua primeira mensagem, configure quatro coisas na área de prompt:

• Ambiente: escolha onde Claude é executado. Selecione Local para sua máquina, Cloud para uma sessão na nuvem que continua após você fechar o aplicativo, uma conexão SSH para uma máquina remota que você gerencia, ou no Windows uma distribuição WSL. Uma tarefa em uma sessão SSH pode continuar enquanto o Desktop está desconectado, mas com uma conta Claude ela pode parar quando o login dela expirar. Veja configuração de ambiente.
• 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.
• Modelo: escolha um modelo no menu suspenso ao lado do botão enviar. Você pode alterar isso durante a sessão.
• Modo de permissão: escolha quanto de autonomia Claude tem no seletor de modo. Você pode alterar isso durante a sessão.

Digite sua tarefa e pressione Enter para começar. Cada sessão rastreia seu próprio contexto e alterações independentemente.

Trabalhar com código

Dê a Claude o contexto certo, controle quanto ele faz por conta própria e revise o que ele alterou.

Use a caixa de prompt

Digite 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. 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.

O botão + ao lado da caixa de prompt oferece acesso a anexos de arquivo, skills, conectores e plugins.

Aceitar um prompt sugerido

Depois que Claude responde, a aba Code pode mostrar um próximo prompt sugerido como texto cinza na caixa de prompt vazia. Claude Code gera cada sugestão a partir da sua conversa com uma breve requisição em segundo plano que conta para os limites de uso do seu plano ou para seus custos de API.

• Usar a sugestão: pressione Tab ou Seta para a direita para colocá-la na caixa de prompt, edite-a se quiser e pressione Enter para enviá-la. Pressionar Enter antes de aceitar a sugestão não a envia.
• Escrever seu próprio prompt: comece a digitar. A sugestão aparece apenas enquanto a caixa de prompt está vazia e não tem arquivos anexados.

Acesse Settings > Claude Code e desative Prompt suggestions em Sessions para interromper as sugestões em cada sessão a partir da próxima vez que ela for iniciada ou retomada.

Adicionar arquivos e contexto aos prompts

A caixa de prompt suporta duas maneiras de trazer contexto externo:

• @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.
• 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.

Escolher um modo de permissão

Os 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.

Para definir um modo padrão para novas sessões locais, adicione permissions.defaultMode ao seu arquivo de configurações. 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.

Versões anteriores da aba Code rotulavam esses modos como Ask permissions, Auto accept edits e Plan mode.

O modo de permissão dontAsk está disponível apenas no CLI.

Sessões na nuvem suportam Accept edits, Plan e Auto. Accept edits corresponde ao modo default: sessões na nuvem pré-aprovam edições de arquivo, então o seletor mostra Accept edits em vez de Manual. Bypass permissions não está disponível em sessões na nuvem, incluindo sessões em um ambiente auto-hospedado.

Administradores corporativos podem restringir quais modos de permissão estão disponíveis. Veja configuração corporativa para detalhes.

Disponibilidade do modo auto

O modo auto está disponível para todos os usuários na API Anthropic e requer Claude Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, Haiku 5.5 ou um modelo Fable. Administradores da organização podem desativar o modo auto com a chave disableAutoMode em configurações gerenciadas.

Em implantações Enterprise que roteiam Desktop para Google Cloud's Agent Platform, o modo auto também está disponível por padrão; veja Modo auto no Bedrock, Agent Platform ou Foundry para os modelos suportados.

Visualizar seu aplicativo

Claude 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 alterações após cada edição.

O 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á.

No painel de navegador, você pode:

• Interagir com seu aplicativo em execução diretamente no painel de navegador
• Assistir Claude verificar suas próprias alterações automaticamente: ele tira capturas de tela, inspeciona o DOM, clica em elementos, preenche formulários e corrige problemas que encontra
• Iniciar ou parar servidores, ou parar todos de uma vez, no menu Dev servers no cabeçalho do painel de navegador
• Escolher se o navegador mantém cookies depois que você fecha o aplicativo com Keep cookies no menu ⋮ do painel de navegador, para que você não tenha que fazer login novamente durante o desenvolvimento

Claude cria a configuração inicial do servidor com base em seu projeto. Se seu aplicativo usa um comando dev personalizado, edite .claude/launch.json para corresponder à sua configuração. Veja Configurar servidores de visualização para a referência completa.

Para limpar os dados salvos do navegador, selecione Clear browsing data no menu ⋮ do painel de navegador. Para desativar o navegador completamente, desative Browser tools em Settings > Claude Code.

Navegar em sites externos

O painel de navegador é um navegador com abas, então você pode abrir documentação, rastreadores de problemas ou qualquer outro site ao lado do seu aplicativo em execução. Para abrir o navegador, pressione Cmd+Shift+B no macOS ou Ctrl+Shift+B no Windows, ou clique em Browser na barra de título da sessão. Você pode fazer login em sites no painel, incluindo fluxos de login em popup como Google OAuth.

Na primeira vez que você clica em um link externo no chat, uma caixa de diálogo pergunta se os links devem abrir no painel de navegador ou no seu navegador padrão. Para alterar sua escolha depois, use Open links in built-in browser no menu ⋮ do painel de navegador. Cmd-clique no macOS ou Ctrl-clique no Windows abre um link diretamente no seu navegador padrão.

Claude pode ler e interagir com páginas externas usando as mesmas ferramentas que usa para verificar seu aplicativo, com duas verificações de segurança adicionais:

• Classificadores de segurança revisam as ações de escrita de Claude em páginas externas, como clicar e digitar, em todos os modos de permissão. Estes são os mesmos classificadores que o modo auto usa, e quando eles sinalizam uma ação, você recebe um prompt de permissão independentemente do modo.
• Em modos de permissão diferentes de Auto e Bypass permissions, uma verificação de allowlist de domínio também se aplica antes de Claude navegar para um novo site.

Aprovar as ações de Claude em um site

A primeira vez que Claude atua em um site externo, um cartão de permissão aparece e Claude aguarda sua escolha: Allow once, Always allow ou Deny. Allow once aprova a ação sem salvar nada. Always allow salva a aprovação para esse site em seu dispositivo, e você pode revogá-la em Configurações. Cada site precisa de sua própria aprovação, incluindo subdomínios. Seus servidores dev locais e arquivos de projeto não precisam de aprovação, então auto-verify continua funcionando sem prompts.

Mesmo em um site aprovado, Claude não comprará itens, criará contas ou contornará CAPTCHAs sem sua entrada. Navegar no painel de navegador usa o mesmo modelo de segurança que a extensão Claude no Chrome. Veja Usando Claude no Chrome com segurança para como Claude lida com sites sensíveis e ações arriscadas.

Escolher entre o painel de navegador e a extensão Chrome

O painel de navegador usa um perfil de navegador limpo, separado do seu navegador pessoal, sem nenhum de seus logins salvos ou histórico. Use-o para construir e testar seu aplicativo e para sites que não precisam de sua identidade. Quando você quer que Claude aja como você em suas sessões conectadas, use a extensão Claude no Chrome em vez disso, que compartilha o estado de login do seu navegador.

Restringir navegação externa para sua organização

O painel de navegador segue os mesmos controles de allowlist e blocklist de sites que a extensão Claude no Chrome. Se sua organização já configurou essas listas para a extensão, o painel de navegador as respeita automaticamente. Administradores também podem desativar as ferramentas de Claude em páginas externas com a configuração gerenciada browserExternalPageTools. Com ferramentas desativadas, os usuários ainda podem navegar para sites externos; as ferramentas de Claude não podem ler ou agir sobre eles.

Para desativar a navegação externa completamente, defina a configuração gerenciada disableBrowserExternalNavigation como true. Isso bloqueia toda navegação externa no painel de navegador, incluindo sites na allowlist de sua organização; servidores dev localhost e visualizações de arquivo continuam funcionando. Use browserExternalPageTools para permitir que os usuários continuem navegando em sites externos sem as ferramentas de Claude, e disableBrowserExternalNavigation para bloquear sites externos para usuários e Claude.

Revisar alterações com visualização de diff

Depois 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.

Quando 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.

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

• macOS: pressione Cmd+Enter
• Windows: pressione Ctrl+Enter

Claude lê seus comentários e faz as alterações solicitadas, que aparecem como um novo diff que você pode revisar.

Revisar seu código

Para que Claude revise suas alterações antes de você fazer commit, digite /code-review na caixa de prompt. As descobertas chegam na conversa quando a revisão é concluída.

Em sessões locais, SSH e WSL, as descobertas aparecem como um cartão Code review, agrupadas por arquivo. Use o cartão para agir sobre elas:

• Clique em Walk through in diff para abrir a visualização de diff e percorrer as descobertas uma de cada vez. Uma descoberta no diff atual aparece em sua linha, onde você pode clicar em Fix this one ou descartá-la.
• Clique em Apply fixes para pedir a Claude que corrija as descobertas que ainda estão em aberto.

Em qualquer sessão, você também pode pedir a Claude na caixa de prompt que corrija o que a revisão encontrou. Para saber o que /code-review procura e os argumentos que aceita, veja Revisar localmente com /code-review.

Monitorar status de pull request

Depois 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.

• 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.
• 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 primeiro; sem isso, Claude não pode mesclar o PR.

Para 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 em Settings > Claude Code.

Organizar seu workspace

A aba Code é construída em torno de painéis que você pode organizar em qualquer layout: chat, diff, browser, terminal, file, plan, tasks e subagent, junto com o iOS Simulator no macOS. Arraste um painel por seu cabeçalho para reposicioná-lo, ou arraste uma borda de painel para redimensioná-lo. Pressione Cmd+\ no macOS ou Ctrl+\ no Windows para fechar o painel focado. Clique em Terminal, Changes ou Browser na barra de título da sessão para abrir o painel de terminal, diff ou Browser. O menu ⋮ ao lado deles abre mais painéis, como Files, e contém esses botões quando a janela é estreita demais para exibi-los.

Para 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.

Executar comandos no terminal

O 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, com uma limitação em máquinas remotas Windows.

Abrir e editar arquivos

Clique 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 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.

O 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.

Abrir arquivos em outros aplicativos

Clique com o botão direito em qualquer caminho de arquivo no chat, visualizador de diff ou painel de arquivo para abrir um menu de contexto:

• Attach as context: adicione o arquivo ao seu próximo prompt
• Open in: abra o arquivo em um editor instalado como VS Code, Cursor ou Zed
• Show in Finder no macOS, Show in Explorer no Windows: abra a pasta contendo
• Copy path: copie o caminho absoluto para sua área de transferência

Alternar modos de visualização

Os modos de visualização controlam quanto detalhe aparece na transcrição do chat. Para alternar modos de visualização, abra o menu da sessão pelo acento circunflexo ao lado do título da sessão e selecione Transcript view, ou pressione Ctrl+O no macOS ou Windows para ciclar através deles. O modo Thinking aparece no menu apenas depois que Claude produziu pensamento na sessão que você está visualizando.

Use Thinking para seguir o raciocínio de Claude com chamadas de ferramenta ainda recolhidas. Use Verbose ao depurar por que Claude tomou uma ação particular. As versões do Claude Desktop anteriores a 1.46388.1 também listam um modo Summary, e uma sessão ainda definida para Summary abre em Normal assim que você atualiza.

Atalhos de teclado

Pressione 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.

Esses atalhos se aplicam à aba Code. No Desktop, Shift+Tab não cicla os modos de permissão como faz no modo interativo do terminal.

Verificar uso

Clique no anel de uso ao lado do seletor de modelo para ver seu uso atual da janela de contexto e seu uso do plano para o período. O uso de contexto é por sessão; o uso do plano é compartilhado em todas as suas superfícies Claude Code.

Deixar Claude usar seu computador

Computer use permite que Claude abra seus aplicativos, controle sua tela e trabalhe diretamente em sua máquina da forma como você faria. Peça a Claude para interagir com uma ferramenta de desktop que não tem CLI ou automatize algo que só funciona através de uma GUI. Para executar e testar aplicativos iOS, Desktop abre o painel dedicado do iOS Simulator em vez de controlar sua tela; o painel funciona sem ativar computer use.

Computer use está desativado por padrão. Ative-o em Configurações antes que Claude possa controlar sua tela. No macOS, você também precisa conceder permissões de Acessibilidade e Gravação de Tela.

No macOS, computer use também pode ser executado em segundo plano: Claude trabalha nos aplicativos que você aprovou enquanto você continua trabalhando.

Quando computer use se aplica

Claude tem várias maneiras de interagir com um aplicativo ou serviço, e computer use é a mais ampla e lenta. Ele tenta a ferramenta mais precisa primeiro:

• Se você tem um connector para um serviço, Claude usa o connector.
• Se a tarefa é um comando shell, Claude usa Bash.
• Se a tarefa é trabalho de navegador e você tem Claude no Chrome configurado, Claude usa isso.
• Se a tarefa é executar ou testar um aplicativo iOS, Claude usa o painel iOS Simulator, que não usa controle de tela.
• Se nenhum desses se aplica, Claude usa computer use.

Os níveis de acesso por aplicativo reforçam isso: navegadores são limitados a apenas visualização, e terminais e IDEs a apenas clique, direcionando Claude para a ferramenta dedicada mesmo quando computer use está ativo. O controle de tela é reservado para coisas que nada mais pode alcançar, como aplicativos nativos, painéis de controle de hardware ou ferramentas proprietárias sem uma API.

Ativar computer use

Computer use está desativado por padrão. Se você pedir a Claude para fazer algo que precisa disso enquanto está desativado, Claude diz que poderia fazer a tarefa se você ativar computer use em Configurações.

Permissões de aplicativo

A primeira vez que Claude precisa usar um aplicativo, um prompt aparece em sua sessão. Clique em Allow for this session ou Deny. As aprovações duram para a sessão atual, ou 30 minutos em sessões geradas por Dispatch.

O prompt também mostra que nível de controle Claude obtém para esse aplicativo. Esses níveis são fixos por categoria de aplicativo e não podem ser alterados:

Aplicativos com alcance amplo, como terminais, Finder ou File Explorer, e System Settings ou Settings, mostram um aviso extra no prompt para que você saiba o que aprovar concede.

A seção Computer use em Configurações > Este computador > Sistema inclui estas opções:

• Denied apps: adicione aplicativos aqui para rejeitá-los sem solicitar. Claude ainda pode afetar um aplicativo negado indiretamente através de ações em um aplicativo permitido, mas não pode interagir com o aplicativo negado diretamente.
• Unhide apps when Claude finishes: quando computer use não está sendo executado em segundo plano, Claude oculta suas outras janelas enquanto trabalha para que interaja apenas com o aplicativo aprovado. Quando Claude termina, as janelas ocultas são restauradas a menos que você desative essa configuração.

Gerenciar sessões

Cada sessão é uma conversa independente com seu próprio contexto e alterações. Você pode executar múltiplas sessões em paralelo, ramificar chats laterais, deixar Claude verificar e enviar mensagens para suas outras sessões, enviar trabalho para a nuvem ou deixar Dispatch iniciar sessões para você do seu telefone.

Trabalhar em paralelo com sessões

Clique 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.

Para 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.

Os worktrees são armazenados em <project-root>/.claude/worktrees/ por padrão. Você pode alterar isso para um diretório personalizado:

• Sessões locais: defina Worktree location em Settings > Claude Code
• Sessões SSH: defina Worktree folder na conexão SSH

Você 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.

Para 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.

Para incluir arquivos gitignored como .env em novos worktrees, crie um arquivo .worktreeinclude na raiz do seu projeto. Veja O que os worktrees compartilham com o checkout principal para saber de onde uma sessão de worktree lê as configurações do projeto, hooks e skills.

Use 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.

Para verificar o uso de contexto, veja Verificar uso. 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 para detalhes sobre como a compactação funciona.

O 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, você recebe as notificações do projeto em vez disso.

Fazer uma pergunta lateral sem descarrilar a sessão

Um chat lateral permite que você faça a Claude uma pergunta que usa o contexto de sua sessão mas não adiciona nada de volta à conversa principal. Use-o quando você quer entender um pedaço de código, verificar uma suposição ou explorar uma ideia sem descarrilar a sessão.

Pressione Cmd+; no macOS ou Ctrl+; no Windows para abrir um chat lateral, ou digite /btw na caixa de prompt. O chat lateral pode ler tudo no thread principal até esse ponto. Quando terminar, feche o chat lateral e continue a sessão principal onde deixou.

Chats laterais estão disponíveis em sessões locais, SSH e WSL. O aplicativo desktop não salva chats laterais em disco, então você não pode retornar a um após fechar o aplicativo.

Assistir tarefas em segundo plano

O painel de tarefas mostra o trabalho em segundo plano em execução dentro da sessão atual: subagentes, comandos shell em segundo plano e workflows dinâmicos. Quando a sessão tiver trabalho em segundo plano, abra o painel com Background tasks no menu ⋮ da barra de título.

Clique em qualquer entrada para ver sua saída no painel de subagente ou pará-la. Para ver o que outras sessões estão fazendo, use a barra lateral, ou peça a Claude para verificar nelas para você.

Trabalhar entre sessões

Claude 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.

Através desta superfície, Claude vê apenas as sessões que o aplicativo desktop executa por si mesmo: local, SSH e sessões 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 permite separadamente que Claude envie mensagens para suas outras sessões Claude Code, incluindo sessões de terminal.

Quando Claude envia uma mensagem para outra sessão através desta superfície, Claude Code a mostra lá como um card rotulado com o título da sessão de envio e um link de volta, para que você sempre possa dizer de onde uma mensagem veio. Se a sessão receptora está no meio de uma tarefa, Claude Code segura a mensagem e Claude a lê uma vez que o trabalho atual termina. O Claude receptor pode responder, e Claude Code entrega a resposta de volta através desta superfície. Claude não pode entregar a uma sessão arquivada e avisa você quando uma mensagem não passa.

Claude Code aplica quatro comportamentos de segurança entre sessões:

• Você recebe um card de aprovação antes de Claude arquivar uma sessão, exceto no modo auto e no modo Bypass permissions, nos quais Claude pode arquivar uma sessão sem ele. Para que a aprovação seja solicitada, mude para Manual.
• Através desta superfície, Claude não pode enviar mensagens entre sessões de uma sessão que ninguém está observando, como uma execução de tarefa agendada, e não pode entregar mensagens em uma.
• Claude Code verifica cada mensagem desta superfície contra os controles de entrada da sessão receptora, mesmo quando a sessão receptora não tem mensagens entre sessões por si mesma. Se você definir crossSessionInbound para refuse na sessão receptora, Claude Code descarta mensagens desta superfície. Claude Code relata a recusa ao aplicativo desktop Claude. Antes da v2.1.234, Claude Code descartava todas as mensagens desta superfície para uma sessão receptora sem mensagens entre sessões.
• Claude Code cita cada mensagem de entrada e a atribui à sessão que a enviou, e Claude ainda segue as configurações de permissão próprias da sessão receptora ao agir em uma.

Claude também pode sugerir novas sessões. Quando ele nota algo que vale a pena corrigir que está fora do escopo da tarefa atual, ele oferece o trabalho como um chip de tarefa no chat. Clique no chip para iniciar esse trabalho em uma nova sessão com seu próprio worktree; Claude continua sua sessão atual ininterruptamente.

Executar tarefas de longa duração na nuvem

Para 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 ou do aplicativo Claude mobile.

Sessõ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.

Veja Use Claude Code na nuvem 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, onde Claude inicia e rastreia as sessões para você de uma conversa.

Continuar em outra superfície

Para continuar uma sessão em outro lugar, abra o menu da sessão a partir do acento circunflexo ao lado do título da sessão ou a partir da linha da sessão na barra lateral e, em seguida, selecione Open in:

• Selecione Cloud para continuar a sessão como uma sessão na nuvem, com sua conversa transferida como um resumo. Antes de você confirmar, a caixa de diálogo informa se seus arquivos também são movidos e se esta sessão será arquivada quando a sessão na nuvem estiver pronta. Você não pode mover dessa forma uma sessão executada via SSH ou no WSL.
• Selecione um editor instalado ou seu gerenciador de arquivos para abrir nele a pasta da sessão no disco.

Controlar quais sessões aparecem em seus outros dispositivos

Uma sessão local aparece em seus outros dispositivos assim que o Remote Control a conecta. Uma sessão conectada aparece na lista de sessões em claude.ai/code e nos aplicativos Claude em dispositivos conectados à sua conta claude.ai.

Uma sessão local se conecta quando você ativa o Remote Control para ela, ou quando ela se conecta automaticamente ao iniciar:

• 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.
• 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 em suas configurações de usuário ou configurações gerenciadas e, em seguida, o padrão da sua organização.

Para 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.

Para manter sessões fora de seus outros dispositivos, desative o Remote Control no nível de que você precisa:

• Uma sessão: desative o botão Remote Control dela. Em uma sessão que se conectou ao iniciar, digitar /remote-control mantém o Remote Control ativado e mostra Remote Control is already on. This session connected automatically when it started. Clique em Turn off nessa linha para desconectar.
• Novas sessões do Desktop neste computador: desative Connect new sessions to Remote Control em Settings > Claude Code. Se já aparecer desativado, ative e depois desative para que o Desktop salve sua escolha. Depois de salva, ela tem precedência sobre remoteControlAtStartup e os padrões.
• Qualquer sessão neste computador, incluindo o CLI: defina disableRemoteControl como true em ~/.claude/settings.json para impedir que as sessões se conectem. Uma sessão que já estava conectada quando você salvou o arquivo permanece conectada até que você desative o Remote Control para ela.

Para ocultar uma sessão que já aparece em seus outros dispositivos, arquive-a no Desktop. O Desktop também arquiva a cópia do Remote Control da sessão, de modo que ela sai da lista de sessões padrão nesses dispositivos. Para visualizá-la ou excluí-la lá, veja Arquivar sessões.

Sessões do Dispatch

Dispatch é uma conversa persistente com Claude que vive na aba Cowork. Você envia uma mensagem ao Dispatch com uma tarefa, e ele decide como lidar com ela.

Uma tarefa pode acabar como uma sessão de Code de duas maneiras: você pede uma diretamente, como "abra uma sessão Claude Code e corrija o bug de login", ou Dispatch decide que a tarefa é trabalho de desenvolvimento e gera uma por conta própria. Tarefas que normalmente são roteadas para Code incluem corrigir bugs, atualizar dependências, executar testes ou abrir pull requests. Pesquisa, edição de documentos e trabalho em planilhas ficam em Cowork.

De qualquer forma, a sessão de Code aparece na barra lateral da aba Code com um badge Dispatch. Você recebe uma notificação push em seu telefone quando termina ou precisa de sua aprovação.

Se você tem computer use ativado, sessões de Code geradas por Dispatch também podem usá-lo. As aprovações de aplicativo nessas sessões expiram após 30 minutos e solicitam novamente, em vez de durarem a sessão completa como sessões de Code regulares.

Para configuração, emparelhamento e configurações de Dispatch, veja o artigo de ajuda do Dispatch. Dispatch requer um plano Pro ou Max e não está disponível em planos Team ou Enterprise.

Dispatch é uma de várias maneiras de trabalhar com Claude quando você está longe de seu terminal. Para uma comparação com as outras opções, veja Plataformas e integrações.

Estender Claude Code

Conecte serviços externos, adicione fluxos de trabalho reutilizáveis, customize o comportamento de Claude e configure servidores de visualização. Para gerenciar conectores, skills e plugins em um único lugar, clique em Customize na barra lateral. A aba Cowork no aplicativo Desktop obtém seus skills, plugins e conectores dessa configuração de Customize, que sincroniza através de sua conta claude.ai, não do diretório ~/.claude da CLI.

Claude Code também carrega os skills e plugins habilitados para sua conta claude.ai em sessões de terminal onde você se conecta com a mesma conta. Veja Skills sincronizados de claude.ai e Plugins sincronizados de claude.ai.

Conectar ferramentas externas

Para sessões locais e SSH, 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 configuram conectores no momento da criação da rotina.

Para gerenciar ou desconectar conectores, vá para Settings → Connectors no aplicativo desktop, ou selecione Manage connectors no menu Connectors na caixa de prompt.

Uma 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.

Conectores são MCP servers 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. Você também pode criar conectores personalizados.

Use skills

Skills estendem o que Claude pode fazer. Claude as carrega automaticamente quando relevante, ou você pode invocar uma diretamente: digite / na caixa de prompt ou clique no botão + e selecione Slash commands para navegar pelo que está disponível. Isso inclui comandos integrados, suas skills personalizadas, skills de projeto de sua base de código e skills de qualquer plugins instalados. Selecione uma e ela aparece destacada no campo de entrada. Digite sua tarefa depois dela e envie como usual.

Você pode enviar um comando enquanto Claude está trabalhando, da mesma forma que qualquer outra mensagem, e a sessão retorna ao estado ocioso assim que o turno termina.

Sessões locais carregam seus skills pessoais de ~/.claude/skills/. Uma sessão SSH lê ~/.claude/skills/ do diretório home do host remoto, não de sua máquina.

Sessões locais e cloud também carregam os skills habilitados para sua conta claude.ai, exceto sessões locais quando sua organização define disableSideloadFlags. Sessões cloud os carregam em vez de ~/.claude/skills/, como Skills em sessões Cowork e cloud descreve.

Instalar plugins

Plugins 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.

Para sessões locais e SSH, 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 configurados incluindo o marketplace oficial da Anthropic. Selecione Manage plugins para ativar, desativar ou desinstalar plugins.

Você 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.

O navegador de plugins não está disponível em sessões cloud, e plugins que você instala do aplicativo desktop não estão disponíveis para sessões cloud. Uma sessão cloud também não instala plugins que o .claude/settings.json do repositório declara, como O que é transferido de sua configuração explica. Plugins não estão disponíveis em sessões WSL. Para a referência completa de plugins incluindo criar seus próprios plugins, veja plugins.

Configurar servidores de visualização

Claude detecta automaticamente sua configuração de servidor de desenvolvimento e armazena a configuração em .claude/launch.json na raiz da pasta que você selecionou ao iniciar a sessão. Preview usa essa pasta como seu diretório de trabalho, então se você selecionou uma pasta pai, subpastas com seus próprios servidores de desenvolvimento não serão detectadas automaticamente. Para trabalhar com o servidor de uma subpasta, inicie uma sessão nessa pasta diretamente ou adicione uma configuração manualmente.

Para personalizar como seu servidor inicia, por exemplo para usar yarn dev em vez de npm run dev ou para alterar a porta, edite .claude/launch.json. O arquivo suporta JSON com comentários.

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Você pode definir múltiplas configurações para executar diferentes servidores do mesmo projeto, como um frontend e uma API. Veja os exemplos abaixo.

Auto-verify changes

Quando autoVerify está ativado, Claude verifica automaticamente alterações de código após editar arquivos. Ele tira capturas de tela, verifica erros e confirma que as alterações funcionam antes de completar sua resposta.

Auto-verify está ativado por padrão. Desative-o por projeto adicionando "autoVerify": false a .claude/launch.json, ou desative Auto-verify changes no menu ⋮ do painel Browser.

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Quando desativado, ferramentas de visualização ainda estão disponíveis e você pode pedir a Claude para verificar a qualquer momento. Auto-verify torna isso automático após cada edição.

Configuration fields

Cada entrada no array configurations aceita os seguintes campos:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 8443,
      "url": "https://localhost:8443"
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "url": "https://app.localhost:3000"
    }
  ]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "frontend",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"cwd": "apps/web",
"port": 3000,
"autoPort": true
},
{
"name": "api",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "start"],
"cwd": "server",
"port": 8080,
"env": { "NODE_ENV": "development" },
"autoPort": false
}
]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "server",
"program": "server.js",
"args": ["--verbose"],
"port": 4000
}
]
}

O ambiente que você escolhe ao iniciar uma sessão determina onde Claude é executado e como você se conecta:

• Local: é executado na sua máquina com acesso direto aos seus arquivos
• Nuvem: é executado por padrão em infraestrutura gerenciada pela Anthropic. As sessões continuam mesmo que você feche o aplicativo.
• 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, mas com uma conta Claude ela pode parar quando o login dela expirar.
• WSL (Windows): é executado dentro de uma distribuição WSL 2 na sua máquina, usando o conjunto de ferramentas Linux dela e caminhos nativos

Sessões locais

O 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.

Para 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 para a lista completa de variáveis suportadas.

O pensamento estendido é 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, como o Opus 5.

Em modelos com raciocínio adaptativo, 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.

Sessões locais em dispositivos gerenciados

Seu administrador pode desativar as sessões locais com a configuração gerenciada disableDesktopLocalSessions. 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, cuja disponibilidade em dispositivos gerenciados é controlada separadamente, 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 ou na nuvem em vez disso, ou entre em contato com sua equipe de TI.

Sessões na nuvem

As 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, sem cobranças de computação separadas.

Você 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:

• Adicionar um ambiente: selecione Add cloud environment
• Editar ou arquivar um dos seus próprios ambientes: passe o mouse sobre ele e clique no ícone de engrenagem

Consulte Configurar ambientes de nuvem para detalhes sobre como configurar o acesso à rede e as variáveis de ambiente.

Sessões SSH

As sessões SSH permitem que você execute o 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 ficam em VMs na nuvem, dev containers ou servidores com hardware ou dependências específicos.

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

• Name: um rótulo amigável para esta conexão
• SSH host: user@hostname ou um host definido em ~/.ssh/config
• SSH port: usa 22 por padrão se deixado vazio, ou usa a porta da sua configuração SSH
• SSH key (optional): caminho para sua chave privada, como ~/.ssh/id_ed25519. Deixe vazio para usar sua configuração SSH ou seu agente SSH.
• 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.

Depois 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.

A máquina remota pode executar Linux, macOS ou Windows. 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.

Requisitos da máquina remota para sessões SSH

Uma máquina remota Linux ou macOS precisa de um processador suportado, 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:

• Sistema: um processador x86_64 ou arm64. A máquina também precisa atender aos requisitos de sistema do Claude Code. No Linux, o Claude Code precisa de glibc 2.17 ou posterior, ou musl. Para ver qual a máquina tem, execute ldd --version nela. Em uma distribuição baseada em musl, como o Alpine Linux, instale também os pacotes de que o Claude Code precisa.
• SFTP: o servidor SSH precisa oferecer o subsistema SFTP, que uma linha Subsystem sftp no sshd_config dele ativa. Para verificar, conecte-se ao mesmo host e porta com sftp em um terminal no seu computador. Um servidor funcionando mostra o prompt sftp>.
• 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.
• 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, portanto 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. Para saber o que essa pasta contém, consulte Arquivos e processos na máquina remota.
• Shell: o shell definido para sua conta na máquina remota precisa executar comandos enviados via SSH, como fazem o Bash, o Zsh e o sh
• Rede: o Claude Code é executado na máquina remota e faz suas requisições de rede a partir dali, portanto a máquina precisa do acesso à rede que o Claude Code exige. 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 ainda saem da máquina remota. Em uma máquina remota Linux, se essas requisições precisarem de um proxy, defina-o para sessões SSH.

Definir um proxy ou um certificado de CA para sessões SSH

Se uma máquina remota Linux acessa a internet por meio de um proxy ou precisa de um certificado de CA, adicione as variáveis de proxy e de CA em env no ~/.claude/settings.json dessa máquina. Adicione-as mesmo que você já as exporte em ~/.profile, ~/.bash_profile, ~/.zprofile ou ~/.zshrc nessa máquina.

Uma sessão SSH não as obtém desses arquivos, mesmo quando o claude em um terminal nessa máquina as obtém. A sessão pode então travar, ou mostrar The connection from … to the API failed ou Authentication failed, e fazer login novamente não ajuda.

{
"env": {
"HTTPS_PROXY": "http://proxy.example.com:8080",
"NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"
}
}

Encontrar uma variável de proxy ou de CA definida em outro lugar na máquina remota

Verifique se a máquina remota Linux define a variável de proxy ou de CA em outro lugar, porque as sessões usam esse valor e ignoram o de qualquer arquivo de configurações:

Usar sua configuração SSH no macOS e no Linux

No macOS e no Linux, o Desktop se conecta executando o cliente OpenSSH no seu computador, portanto ele usa seu ~/.ssh/config. Conectar-se por meio do cliente OpenSSH requer o 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.

Antes de adicionar a conexão, verifique o cliente e a entrada em um terminal no seu computador:

• Versão do cliente: execute ssh -V. O cliente precisa ser o OpenSSH 7.6 ou posterior.
• Entrada: execute ssh com o nome do Host, como ssh devbox. Se isso falhar, corrija a entrada primeiro.

Você pode deixar os campos SSH port e SSH key (optional) vazios. Se você preencher um deles, o Desktop o usa junto com a entrada:

• SSH port: um valor aqui sobrescreve o Port da entrada
• 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

Acessar uma máquina atrás de um jump host

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

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com

Insira devbox no campo SSH host.

Acessar um contêiner em uma máquina remota

Para executar uma sessão dentro de um contêiner que não publica nenhuma porta SSH, acesse-o com um ProxyCommand, porque o Desktop não executa o RemoteCommand da entrada à qual você se conecta. Se sua entrada usa RemoteCommand para entrar no contêiner, a sessão é executada na máquina em que a entrada faz login, não no contêiner.

Host devbox-container
User dev
ProxyCommand ssh build.example.com docker exec -i devbox /usr/sbin/sshd -i

Usar variáveis do seu shell em um `ProxyCommand`

Para usar uma variável de ambiente sua em um comando ProxyCommand ou Match exec, exporte-a em um arquivo de inicialização do shell, como ~/.zshrc, depois saia do Desktop e abra-o novamente. Quando o Desktop é iniciado, ele lê o que seu shell de login exporta e mantém esses valores até você sair.

Isso requer o Claude Desktop v2.37337.0 ou posterior e um comando env que aceite -0, o que você pode verificar executando env -0 em um terminal no seu computador.

[profile corp]
region = us-east-1
credential_process = /full/path/to/your-credential-helper

Host i-*
ProxyCommand sh -c "aws ssm start-session --profile corp --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"

Aumentar o timeout da conexão SSH

Se sua configuração SSH não define 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:

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com
  ConnectTimeout 120

O ssh usa o primeiro valor que encontra para um host, portanto 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, saia do Desktop e abra-o novamente.

Se a própria máquina remota aguarda uma aprovação no seu telefone, aprove em até 45 segundos, qualquer que seja o ConnectTimeout que você definir. Você não pode aumentar esse limite, porque o próprio Desktop define ServerAliveInterval e ServerAliveCountMax, e o ssh então encerra um login em que a máquina remota não envia nada por esse tempo. Se, em vez disso, um jump host ou um ProxyCommand aguardar por você, aumente o ConnectTimeout na entrada da máquina remota para cobrir esse tempo.

Corrigir um bloco `Match host` que apenas o Desktop aplica

Se o Desktop usa uma configuração que ssh devbox em um terminal não usa, procure um bloco Match host acima da linha HostName da entrada. Em um terminal, o ssh lê um bloco ali antes da linha HostName, portanto compara o bloco com devbox. O Desktop fornece ao ssh o valor de HostName na linha de comando, portanto o ssh compara o bloco com esse valor.

Para verificar, execute ssh -G em um terminal no seu computador com os valores de HostName e User da entrada na linha de comando, como o Desktop faz:

ssh -G -o HostName=devbox.internal.example.com -l alice devbox

Compare a saída com a de ssh -G devbox. Se as configurações do bloco, como proxycommand, aparecerem apenas na primeira saída, o bloco só tem efeito no Desktop. Para que o Desktop também o ignore, adicione !originalhost devbox à linha Match dele:

Match host *.internal.example.com !originalhost devbox

Para confirmar, execute o primeiro comando novamente. As configurações do bloco não aparecem mais na saída.

Configurações de encaminhamento que o Desktop deixa desativadas

Na conexão com a máquina remota, o Desktop deixa ForwardAgent, ForwardX11, LocalForward, RemoteForward, DynamicForward e Tunnel desativados, mesmo quando sua configuração SSH os ativa. No terminal ou em um comando !, espere que suas configurações de encaminhamento se apliquem apenas às vezes, porque o Desktop pode iniciar ali um ssh separado que as segue.

• Para acessar uma porta na máquina remota: encaminhe-a você mesmo
• Para usar suas próprias chaves a partir da máquina remota: configure uma credencial na própria máquina remota, por exemplo para git push

Para impedir que o Desktop encaminhe seu agente SSH ou uma porta, execute ssh -G devbox em um terminal no seu computador. Em seguida, execute-o novamente como o Desktop pode executá-lo, com os valores de hostname e user que ele imprime, como em ssh -G -o HostName=devbox.internal.example.com -l alice devbox. A segunda saída pode mostrar configurações de um bloco Match que a primeira ignora.

Procure em ambas as saídas uma linha forwardagent que diga qualquer coisa diferente de no, e linhas que comecem com localforward, remoteforward ou dynamicforward. Se encontrar alguma, remova essa configuração da sua configuração SSH. Faça o mesmo para um host que seu ProxyCommand acessa com ssh.

Acessar uma porta na máquina remota

Para abrir um servidor que é executado na máquina remota, como um servidor de desenvolvimento na porta 3000, encaminhe a porta você mesmo. Em um terminal no seu computador, execute ssh com -L e o host ao qual você se conecta, como devbox:

ssh -N -L 3000:localhost:3000 devbox

Se você preencheu SSH port ou SSH key (optional) na conexão, adicione -p ou -i com o mesmo valor. Deixe esse comando em execução e abra http://localhost:3000 em um navegador no seu computador para acessar a porta 3000 da máquina remota. Se o ssh imprimir open failed: administratively prohibited, peça ao administrador da máquina que permita o encaminhamento TCP, que é controlado por AllowTcpForwarding no sshd_config do servidor SSH.

Máquinas remotas Windows

Uma máquina remota Windows requer o Claude Desktop v2.31226.0 ou posterior.

Use 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.

Máquinas remotas Windows são menos testadas do que as Linux. Experimente seu próprio trabalho ali antes de depender dele.

Espere estes limites, entre outros, em uma máquina remota Windows:

• Terminal: o terminal não abre em uma sessão cuja pasta é um caminho do Windows, como C:/projects/app
• Sandbox: o Claude Code é executado ali no Windows nativo, onde executa comandos sem sandbox. Consulte onde o sandbox é executado.
• 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.
• Servidores MCP: em algumas máquinas remotas Windows, as chamadas de Claude para servidores MCP de claude_desktop_config.json passam pelo Desktop, portanto Claude não consegue chamar as ferramentas deles enquanto o Desktop está desconectado. Antes do Claude Desktop v2.37337.0, isso vale para todas as máquinas remotas Windows.
• Worktrees: os worktrees ficam em <project-root>/.claude/worktrees/. Se você escolher outra pasta, o Desktop a ignora.
• 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
• 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
• Execução enquanto desconectado: uma tarefa continua em execução enquanto o Desktop está desconectado somente se o servidor SSH permitir que um programa sobreviva à conexão que o iniciou. Para descobrir, teste a máquina remota.
• Processos remanescentes: depois que uma sessão termina, verifique na máquina se há programas que o Claude Code iniciou, porque eles podem continuar em execução. O auxiliar em segundo plano que o Desktop instala não para sozinho ali.

Manter uma tarefa em execução enquanto o Desktop está desconectado

Se seu computador entrar em suspensão, você perder a rede ou sair do Desktop, a tarefa continua até terminar, precisar de você ou atingir um dos limites. Fechar a tampa conta como suspensão. Uma reinicialização do Desktop ou do seu computador, inclusive para uma atualização, conta como saída.

O Claude Code é executado como um processo na máquina remota, sob um auxiliar em segundo plano que o Desktop instala ali, portanto não precisa da sua conexão SSH para continuar em execução. O comportamento descrito nesta seção requer o Claude Desktop v2.31226.0 ou posterior.

• Após suspensão ou perda de rede: você recupera a tarefa em execução se o processo ainda estiver em execução e o Desktop puder fazer login sem prompt. Se não puder, envie uma mensagem.
• Após sair: a tarefa continua em execução, mas você a perde quando a sessão é aberta novamente, a menos que o Desktop consiga se reconectar ao processo dela. Verifique quando o Desktop consegue se reconectar antes de sair. Se você perdeu a tarefa, envie uma mensagem para continuar.

Quando você voltar e a tarefa não estiver concluída, verifique se há um aviso de que o Desktop não consegue se reconectar, um erro de autenticação ou uma solicitação pendente:

• O Desktop não consegue se reconectar: a sessão informa o motivo, e uma notificação também pode informá-lo. O Desktop pode precisar que você faça login.
• Erro de autenticação: o token de login ou a credencial pode ter expirado. Com uma conta Claude, envie uma mensagem para continuar. Com um provedor terceirizado, consulte SSH remote sessions in Claude Desktop on 3P.
• Solicitação pendente: responda a ela
• Nenhum desses casos: envie uma mensagem para continuar

• 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 aguarda 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 aguardado 72 horas.
• Não saia no Windows, ou antes da v2.42304.0 com um provedor terceirizado: nesses casos, ao sair você perde a tarefa em execução, então deixe o Desktop aberto durante a tarefa. Em qualquer outro caso, veja o que você recupera antes de sair.
• Reduza as solicitações: escolha um modo de permissão, regras ou hooks que façam a tarefa aguardar por você com menos frequência
• Verifique o jump host: se seu jump host pede um login, por exemplo um push para um telefone, mude para um login que funcione sem prompt. Caso contrário, o Desktop pode enviar outro push cada vez que tentar se reconectar.
• Teste a máquina remota: inicie uma tarefa curta, saia do Desktop enquanto a tarefa ainda está em execução e abra a sessão novamente bem depois de a tarefa 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.
• Mantenha comandos fora do terminal do Desktop: se a máquina remota desconecta terminais ociosos, execute seus próprios comandos a partir de um login SSH fora do Desktop

• 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 terceirizado, o mesmo vale para uma credencial que expira, como uma de single sign-on ou de um auxiliar de credenciais. Consulte SSH remote sessions in Claude Desktop on 3P. Com uma conta Claude, mantenha o Desktop em execução e conectado para que ele possa renovar o login.
• 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.
• Terminais ociosos: algumas máquinas remotas Linux desconectam um terminal em que ninguém digita por um tempo definido (StopIdleSessionSec do systemd-logind). Com o Desktop no macOS ou no Linux, o terminal de uma sessão e os comandos ! compartilham por padrão a conexão SSH do Desktop. Essa desconexão 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, portanto mantenha comandos fora desse terminal.
• Atualizações do Desktop: se uma atualização trouxer um novo auxiliar, o Desktop substitui o auxiliar na máquina remota em uma conexão posterior, o que pode encerrar uma tarefa que ainda está em execução
• Ausências longas: em uma máquina remota Linux ou macOS, se o Desktop não se conectar por 30 dias, o auxiliar para e encerra todos os processos do Claude Code executados sob ele. Conecte-se antes disso.

Edições de arquivos e algumas ferramentas podem falhar enquanto o Desktop está desconectado. Se a tarefa precisar delas, mantenha o Desktop conectado:

• Worktrees: em uma sessão que usa um worktree, 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. Se não tiver certeza, inicie a sessão sem um worktree.
• 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.
• Conectores: conectores e outras ferramentas que o Desktop fornece passam pelo Desktop, portanto, enquanto ele está desconectado, cada chamada falha após cerca de 30 segundos
• Fluxos de trabalho: o Desktop verifica cada novo fluxo de trabalho antes que ele comece, portanto, enquanto o Desktop está desconectado, um novo aguarda até 10 minutos e depois falha
• Servidores MCP: servidores MCP que o Claude Code inicia na máquina remota não passam pelo Desktop, portanto Claude ainda pode chamar as ferramentas deles. Servidores de claude_desktop_config.json estão entre eles apenas se o Desktop não usar seu cliente SSH integrado. Caso contrário, e em algumas máquinas remotas Windows, Claude não consegue chamar as ferramentas deles enquanto o Desktop está desconectado.

drop connection #0 from [203.0.113.7]:51234 on [192.0.2.10]:22 penalty: connections without attempting authentication

fail2ban-regex -o ip lines.log "sshd[mode=aggressive]"

claude://code/new?ssh_host=dev%40build.example.com&ssh_port=2222&ssh_folder=/srv/payments&q=Investigate%20the%20failed%20deploy

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519"
    }
  ]
}

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

{
  "disableDesktopLocalSessions": true,
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "dev.example.com"
    }
  ],
  "sshHostAllowlist": ["dev.example.com"]
}

anthropic.com
*.anthropic.com
claude.ai
*.claude.ai
claude.com
*.claude.com
claude.app
*.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

anthropic.com
api.anthropic.com
a-api.anthropic.com
a-cdn.anthropic.com
s-cdn.anthropic.com
assets-proxy.anthropic.com
claude.ai
a.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

claude --desktop --resume <session-id>

git fetch origin <branch-name>
git checkout <branch-name>