desktop.md +30 −3
116 116
117Claude pode iniciar um servidor de desenvolvimento e abri-lo no painel de navegador para verificar suas alterações. Isso funciona para aplicativos web frontend e também para servidores backend: Claude pode testar endpoints de API, visualizar logs do servidor e iterar em problemas que encontra. Na maioria dos casos, Claude inicia o servidor automaticamente após editar arquivos de projeto. Você também pode pedir a Claude para visualizar a qualquer momento. Por padrão, Claude [verifica automaticamente](#auto-verify-changes) alterações após cada edição.117Claude pode iniciar um servidor de desenvolvimento e abri-lo no painel de navegador para verificar suas alterações. Isso funciona para aplicativos web frontend e também para servidores backend: Claude pode testar endpoints de API, visualizar logs do servidor e iterar em problemas que encontra. Na maioria dos casos, Claude inicia o servidor automaticamente após editar arquivos de projeto. Você também pode pedir a Claude para visualizar a qualquer momento. Por padrão, Claude [verifica automaticamente](#auto-verify-changes) alterações após cada edição.
118 118
119119Em uma sessão local, clique em um caminho HTML, PDF ou de vídeo no chat para abri-lo no painel de navegador.Em uma sessão local, clique em um caminho HTML, PDF ou de vídeo no chat para abri-lo no painel de navegador. Em uma sessão SSH ou WSL, você pode [visualizar um arquivo HTML](#preview-html-files-in-ssh-and-wsl-sessions).
120 120
121> [!NOTE]121> [!NOTE]
122>122>
137 137
138Para 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 > Code** ou **Settings > Claude Code**.138Para 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 > Code** ou **Settings > Claude Code**.
139 139
140#### Visualizar arquivos HTML em sessões SSH e WSL
141
142Em uma sessão [SSH](#ssh-sessions) ou [WSL](https://code.claude.com/docs/pt/desktop-wsl.md), clique no caminho de um arquivo HTML no chat para visualizar o arquivo no painel de navegador. Se gráficos ou tabelas na visualização permanecerem vazios, o aviso acima dela informa o motivo:
143
144* **`This preview doesn't load anything from the web`**: os scripts escritos no arquivo são executados, mas um gráfico que carrega sua biblioteca da web permanece vazio. Se o aviso tiver um botão **Export**, selecione-o e abra o arquivo salvo no seu navegador, onde o conteúdo da web é carregado.
145* **`This preview doesn't run scripts or load anything from the web`**: antes do Claude Desktop v4.23118.0, essas visualizações não executavam scripts, então atualize o Desktop e abra o arquivo novamente. Se o Desktop estiver atualizado e o aviso permanecer, reinicie o Desktop. Se ainda assim ele permanecer, os scripts podem estar [desativados para sua organização](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization), então pergunte ao seu administrador.
146
147Se você fechou o aviso, abra o arquivo novamente para trazê-lo de volta.
148
149#### Desativar scripts nas visualizações SSH e WSL para sua organização
150
151Para impedir que as [visualizações HTML em sessões SSH e WSL](#preview-html-files-in-ssh-and-wsl-sessions) executem scripts, defina a [configuração gerenciada `disableBrowserExternalNavigation`](#managed-settings) como `true`. Com essa configuração, os usuários também não podem [navegar em sites externos](#restrict-external-browsing-for-your-organization) no painel de navegador.
152
153Defina-a nas suas [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md), ou em uma [política MDM do Claude Code ou arquivo de configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md#where-each-mechanism-stores-the-policy) no computador que executa o Desktop. O Desktop não a lê da máquina remota nem da distribuição WSL. Com um [provedor terceirizado](https://code.claude.com/docs/pt/third-party-integrations.md), use a política MDM ou o arquivo.
154
155> [!WARNING]
156>
157> Se o computador que executa o Desktop ainda não recebe configurações gerenciadas do Claude Code, defina também [`parentSettingsBehavior`](https://code.claude.com/docs/pt/settings-reference#parentsettingsbehavior) como `"merge"` nas configurações gerenciadas que você criar. O Desktop passa sua própria política ao Claude Code e, sem `"merge"`, o Claude Code [ignora essa política](https://code.claude.com/docs/pt/managed-settings.md#let-an-embedding-host-add-policy) assim que o computador tiver configurações gerenciadas. No Windows, se você criar um arquivo de configurações gerenciadas, os usuários também perdem as sessões WSL até que você [as permita](https://code.claude.com/docs/pt/admin-setup.md#wsl-sessions-in-claude-code-desktop).
158>
159> Se o computador já recebe configurações gerenciadas do Claude Code, adicione a configuração a elas e deixe `parentSettingsBehavior` como está lá. Em um computador com mais de uma política MDM ou arquivo de configurações gerenciadas, use o [de maior prioridade](https://code.claude.com/docs/pt/managed-settings.md#how-claude-code-combines-managed-sources).
160
161Em seguida, peça aos usuários que reiniciem o Desktop para garantir que a configuração seja aplicada e informe-os sobre o que esperar:
162
163* **Arquivos que eles abrem**: a visualização não executa scripts, então gráficos e tabelas desenhados por scripts permanecem vazios
164* **Visualizações que estão executando scripts**: se o Desktop aplicar a configuração antes da reinicialização, elas são fechadas. Os usuários veem `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`
165* **Arquivos que eles exportam**: se um usuário [exportar um arquivo](#preview-html-files-in-ssh-and-wsl-sessions) e abri-lo em um navegador, os scripts dele são executados lá, com ou sem essa configuração
166
140### Navegar em sites externos167### Navegar em sites externos
141 168
142O 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.169O 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.
162 189
163O painel de navegador segue os mesmos [controles de allowlist e blocklist de sites](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) 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`](#managed-settings). Com ferramentas desativadas, os usuários ainda podem navegar para sites externos; as ferramentas de Claude não podem ler ou agir sobre eles.190O painel de navegador segue os mesmos [controles de allowlist e blocklist de sites](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) 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`](#managed-settings). Com ferramentas desativadas, os usuários ainda podem navegar para sites externos; as ferramentas de Claude não podem ler ou agir sobre eles.
164 191
165192Para desativar a navegação externa completamente, defina a configuração gerenciada [`disableBrowserExternalNavigation`](#managed-settings) 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.Para desativar a navegação externa completamente, defina a configuração gerenciada [`disableBrowserExternalNavigation`](#managed-settings) 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, mas as [visualizações HTML em sessões SSH e WSL](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) não executam scripts. 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.
166 193
167### Revisar alterações com visualização de diff194### Revisar alterações com visualização de diff
168 195
2009| `autoMode` | customize o que o classificador de modo auto confia e bloqueia em sua organização. Veja [Configurar o modo auto](https://code.claude.com/docs/pt/auto-mode-config.md). |2036| `autoMode` | customize o que o classificador de modo auto confia e bloqueia em sua organização. Veja [Configurar o modo auto](https://code.claude.com/docs/pt/auto-mode-config.md). |
2010| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |2037| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |
2011| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](https://code.claude.com/docs/pt/desktop-ios-simulator.md#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |2038| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](https://code.claude.com/docs/pt/desktop-ios-simulator.md#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |
20122039| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. || `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. As visualizações HTML em sessões SSH e WSL [não executam scripts](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |
2013| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no seletor de ambiente. Usuários não podem excluir conexões gerenciadas nem editar nada além de sua própria **Worktree folder**. |2040| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no seletor de ambiente. Usuários não podem excluir conexões gerenciadas nem editar nada além de sua própria **Worktree folder**. |
2014| `sshHostCommands` | ofereça aos usuários [conexões SSH cujo host vem de um comando](#distribute-commands-to-your-team), junto com as suas próprias. O Desktop a lê do arquivo de configurações gerenciadas ou da política MDM no computador, e a ignora em [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Requer Claude Desktop v3.6556.0 ou posterior no macOS ou Linux, ou v4.16336.0 ou posterior no Windows, conectado com uma conta Claude. No Windows, o Desktop também precisa [conectar-se através do cliente OpenSSH](#use-your-ssh-configuration). |2041| `sshHostCommands` | ofereça aos usuários [conexões SSH cujo host vem de um comando](#distribute-commands-to-your-team), junto com as suas próprias. O Desktop a lê do arquivo de configurações gerenciadas ou da política MDM no computador, e a ignora em [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Requer Claude Desktop v3.6556.0 ou posterior no macOS ou Linux, ou v4.16336.0 ou posterior no Windows, conectado com uma conta Claude. No Windows, o Desktop também precisa [conectar-se através do cliente OpenSSH](#use-your-ssh-configuration). |
2015| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Lido apenas de configurações gerenciadas. |2042| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Lido apenas de configurações gerenciadas. |