desktop.md +32 −5
120 120
121> [!NOTE]121> [!NOTE]
122>122>
123123> Em uma [sessão SSH](#ssh-sessions), Claude não consegue abrir seu aplicativo no painel de navegador, porque não tem as ferramentas do painel lá. Para ver o aplicativo você mesmo, [encaminhe a porta dele para o seu computador](#reach-a-port-on-the-remote-machine).> Em uma [sessão SSH](#ssh-sessions), Claude não tem as ferramentas do painel de navegador, então não consegue abrir seu aplicativo no painel nem [verificar automaticamente](#auto-verify-changes) suas alterações. O menu **Dev servers** do painel e seus [servidores de visualização configurados](#configure-preview-servers) também não estão disponíveis. Para ver o aplicativo você mesmo, inicie o servidor dele na máquina remota e, em seguida, [encaminhe a porta dele para o seu computador](#reach-a-port-on-the-remote-machine).
124 124
125Se o painel de navegador não estiver aberto depois que Claude iniciar um servidor em uma sessão local, clique em **Open** no cartão do servidor no chat.125Se o painel de navegador não estiver aberto depois que Claude iniciar um servidor em uma sessão local, clique em **Open** no cartão do servidor no chat.
126 126
1002* **Códigos de uso único com `MaxSessions 1`**: se cada login solicitar algo, como códigos de uso único, os comandos `!` falham. Execute esses comandos em uma aba do terminal, que solicita no próprio painel.1002* **Códigos de uso único com `MaxSessions 1`**: se cada login solicitar algo, como códigos de uso único, os comandos `!` falham. Execute esses comandos em uma aba do terminal, que solicita no próprio painel.
1003* **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](#files-and-processes-on-the-remote-machine).1003* **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](#files-and-processes-on-the-remote-machine).
1004* **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`1004* **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`
10051005* **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](https://code.claude.com/docs/pt/network-config.md#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 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](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).* **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 exige](https://code.claude.com/docs/pt/network-config.md#network-access-requirements). Se a máquina não consegue baixar o Claude Code, o Desktop o baixa no seu computador e faz o upload. As demais requisições do Claude Code ainda saem da máquina remota. Se uma máquina remota Linux precisa de um proxy ou de um certificado de CA, [defina-os para sessões SSH](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).
1006 1006
1007#### Verificar a chave de host de uma máquina remota1007#### Verificar a chave de host de uma máquina remota
1008 1008
1030 1030
1031Se 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](https://code.claude.com/docs/pt/network-config.md) 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.1031Se 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](https://code.claude.com/docs/pt/network-config.md) 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.
1032 1032
10331033Em uma sessão SSH, o Claude Code não recebe as variáveis desses arquivos, mesmo quando `claude` em um terminal nessa máquina recebe. 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.Em uma sessão SSH, o Claude Code não recebe as variáveis desses arquivos, mesmo quando o `claude` em um terminal nessa máquina as recebe. A sessão pode então travar, ou mostrar **The connection from … to the API failed**, **Authentication failed** ou **Claude Code on … couldn’t verify the API connection’s certificate**. Fazer login novamente não ajuda.
1034 1034
1035**1. Adicione as variáveis**1035**1. Adicione as variáveis**
1036 1036
1948 1948
1949Para as chaves de permissão, plugin e entrega que apenas uma fonte gerenciada pode definir, veja [Chaves que apenas configurações gerenciadas podem definir](https://code.claude.com/docs/pt/managed-settings.md#managed-only-settings).1949Para as chaves de permissão, plugin e entrega que apenas uma fonte gerenciada pode definir, veja [Chaves que apenas configurações gerenciadas podem definir](https://code.claude.com/docs/pt/managed-settings.md#managed-only-settings).
1950 1950
1951#### Configurações de Claude Code que se comportam de forma diferente na aba Code
1952
1953Em uma sessão local, estas chaves, entre outras, têm um efeito diferente ou nenhum efeito visível, porque a aba Code substitui a interface do terminal. Elas ainda se aplicam no terminal, então você pode deixá-las definidas.
1954
1955| Chave | Em uma sessão local |
1956| - | - |
1957| `askUserQuestionTimeout` | o timeout não se aplica, então uma pergunta de Claude permanece aberta até que um usuário a responda |
1958| `awaySummaryEnabled` | a chave não tem efeito |
1959| `bashEditDiffEnabled` | a aba Code não mostra a lista de arquivos que um comando Bash alterou |
1960| `companyAnnouncements` | a aba Code não mostra anúncios |
1961| `defaultShell` | comandos que os usuários digitam após `!` são executados em um shell escolhido pelo aplicativo: o shell de login deles no macOS e Linux, PowerShell no Windows |
1962| `fileSuggestion` | o seletor de arquivos `@` cria sua própria lista de arquivos e não executa o comando que você definiu |
1963| `modelPicker` | o seletor de modelos lista os modelos disponíveis para a conta de cada usuário. Para limitá-los, defina [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection). |
1964| `pluginTrustMessage` | o aviso que os usuários veem ao instalar um plugin não inclui a mensagem que você definiu |
1965| `prUrlTemplate` | links de pull request usam a própria URL do pull request, não o template |
1966| `respectGitignore` | o seletor de arquivos `@` cria sua própria lista de arquivos e não lê esta chave |
1967| `respondToBashCommands` | Claude responde à saída de comandos que os usuários executam com `!`, qualquer que seja o valor |
1968| `showClearContextOnPlanAccept` | os usuários não recebem a opção de limpar o contexto ao aprovar um plano |
1969| `skipDangerousModePermissionPrompt` | a aba Code tem sua própria confirmação para o [modo Bypass permissions](#choose-a-permission-mode), e esta chave não a ignora |
1970| `verbose`, `viewMode` | cada usuário escolhe a visualização em [**Transcript view** no menu da sessão](#switch-view-modes) |
1971| `worktree.baseRef`, `worktree.sparsePaths`, `worktree.symlinkDirectories` | não são usadas para o worktree que a aba Code cria para uma sessão |
1972
1951### Políticas de gerenciamento de dispositivos1973### Políticas de gerenciamento de dispositivos
1952 1974
1953Equipes de TI podem gerenciar o aplicativo desktop através de MDM em macOS, group policy no Windows ou um arquivo de política no Linux. As políticas disponíveis incluem ativar ou desativar o recurso Claude Code, controlar atualizações automáticas no macOS e no Windows e definir uma URL de implantação personalizada.1975Equipes de TI podem gerenciar o aplicativo desktop através de MDM em macOS, group policy no Windows ou um arquivo de política no Linux. As políticas disponíveis incluem ativar ou desativar o recurso Claude Code, controlar atualizações automáticas no macOS e no Windows e definir uma URL de implantação personalizada.
2100* Arquivos **[CLAUDE.md](https://code.claude.com/docs/pt/memory.md)** e `CLAUDE.local.md` em seu projeto são usados por ambos2122* Arquivos **[CLAUDE.md](https://code.claude.com/docs/pt/memory.md)** e `CLAUDE.local.md` em seu projeto são usados por ambos
2101* **[MCP servers](https://code.claude.com/docs/pt/mcp.md)** configurados em `~/.claude.json` ou `.mcp.json` funcionam em ambos2123* **[MCP servers](https://code.claude.com/docs/pt/mcp.md)** configurados em `~/.claude.json` ou `.mcp.json` funcionam em ambos
2102* **[Hooks](https://code.claude.com/docs/pt/hooks.md)** e **[skills](https://code.claude.com/docs/pt/skills.md)** definidos em configurações se aplicam a ambos2124* **[Hooks](https://code.claude.com/docs/pt/hooks.md)** e **[skills](https://code.claude.com/docs/pt/skills.md)** definidos em configurações se aplicam a ambos
21032125* **[Configurações](https://code.claude.com/docs/pt/settings.md)** em `~/.claude.json` e `~/.claude/settings.json` são compartilhadas. Regras de permissão, ferramentas permitidas e outras configurações em `settings.json` se aplicam a sessões Desktop.* **[Configurações](https://code.claude.com/docs/pt/settings.md)** em `~/.claude.json` e `~/.claude/settings.json` são compartilhadas. Regras de permissão, ferramentas permitidas e outras configurações em `settings.json` se aplicam a sessões Desktop. Algumas chaves [se comportam de forma diferente na aba Code](#claude-code-settings-that-behave-differently-in-the-code-tab).
2104* **Modelos**: os mesmos [modelos](https://code.claude.com/docs/pt/model-config.md#available-models) estão disponíveis em ambos. Em Desktop, selecione o modelo no seletor de modelo na linha abaixo da caixa de prompt. Você pode alterar o modelo durante a sessão a partir do mesmo seletor.2126* **Modelos**: os mesmos [modelos](https://code.claude.com/docs/pt/model-config.md#available-models) estão disponíveis em ambos. Em Desktop, selecione o modelo no seletor de modelo na linha abaixo da caixa de prompt. Você pode alterar o modelo durante a sessão a partir do mesmo seletor.
2105 2127
2106#### MCP servers from the Claude Desktop chat app2128#### MCP servers from the Claude Desktop chat app
2281 2303
2282Examine os arquivos antes de enviá-los, pois eles podem incluir nomes e outros detalhes do seu ambiente. `<host>` e `<user>` representam nomes que o Desktop substituiu. O Desktop não substitui todos os nomes, e um nome de host ou de usuário SSH ainda pode aparecer como foi escrito. Se você enviar o arquivo zip para alguém, informe qual host falhou e quando, pois os logs podem não mencioná-lo.2304Examine os arquivos antes de enviá-los, pois eles podem incluir nomes e outros detalhes do seu ambiente. `<host>` e `<user>` representam nomes que o Desktop substituiu. O Desktop não substitui todos os nomes, e um nome de host ou de usuário SSH ainda pode aparecer como foi escrito. Se você enviar o arquivo zip para alguém, informe qual host falhou e quando, pois os logs podem não mencioná-lo.
2283 2305
22842306O arquivo zip não contém o log do programa auxiliar que o Desktop instala na máquina remota. Para obter esse log também, copie o `remote-server.log` da pasta do programa auxiliar em [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) no diretório pessoal do usuário que se conectou. Examine esse arquivo também antes de enviá-lo.O arquivo zip não contém o log do programa auxiliar que o Desktop instala na máquina remota. Para obter esse log também, copie estes arquivos da pasta do programa auxiliar em [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) no diretório pessoal do usuário que se conectou:
2307
2308* **`remote-server.log`**: o log da execução mais recente do programa auxiliar.
2309* **`remote-server.log.old`**, se existir: o log da execução anterior a essa. Copie-o o quanto antes, pois você o perde na próxima vez que o Desktop se conectar e precisar iniciar o programa auxiliar novamente.
2310
2311Examine esses arquivos também antes de enviá-los.
2285 2312
2286### Aplicativo não quer sair2313### Aplicativo não quer sair
2287 2314