desktop.md +30 −3
116 116
117Claude는 개발 서버를 시작하고 Browser 패널에서 열어 변경 사항을 확인할 수 있습니다. 이는 프론트엔드 웹 앱뿐만 아니라 백엔드 서버에도 작동합니다: Claude는 API 엔드포인트를 테스트하고, 서버 로그를 보고, 발견한 문제를 반복할 수 있습니다. 대부분의 경우 Claude는 프로젝트 파일을 편집한 후 자동으로 서버를 시작합니다. 언제든지 Claude에게 미리보기를 요청할 수도 있습니다. 기본적으로 Claude는 모든 편집 후 [자동으로 변경 사항을 확인](#auto-verify-changes)합니다.117Claude는 개발 서버를 시작하고 Browser 패널에서 열어 변경 사항을 확인할 수 있습니다. 이는 프론트엔드 웹 앱뿐만 아니라 백엔드 서버에도 작동합니다: Claude는 API 엔드포인트를 테스트하고, 서버 로그를 보고, 발견한 문제를 반복할 수 있습니다. 대부분의 경우 Claude는 프로젝트 파일을 편집한 후 자동으로 서버를 시작합니다. 언제든지 Claude에게 미리보기를 요청할 수도 있습니다. 기본적으로 Claude는 모든 편집 후 [자동으로 변경 사항을 확인](#auto-verify-changes)합니다.
118 118
119119로컬 세션에서는 채팅에서 HTML, PDF 또는 비디오 경로를 클릭하여 Browser 패널에서 엽니다.로컬 세션에서는 채팅에서 HTML, PDF 또는 비디오 경로를 클릭하여 Browser 패널에서 엽니다. SSH 또는 WSL 세션에서는 [HTML 파일을 미리 볼](#preview-html-files-in-ssh-and-wsl-sessions) 수 있습니다.
120 120
121> [!NOTE]121> [!NOTE]
122>122>
137 137
138Browser에 저장된 데이터를 지우려면 Browser 패널의 **⋮** 메뉴에서 **Clear browsing data**를 선택합니다. Browser를 완전히 끄려면 **Settings > Code** 또는 **Settings > Claude Code**에서 **Browser tools**를 끕니다.138Browser에 저장된 데이터를 지우려면 Browser 패널의 **⋮** 메뉴에서 **Clear browsing data**를 선택합니다. Browser를 완전히 끄려면 **Settings > Code** 또는 **Settings > Claude Code**에서 **Browser tools**를 끕니다.
139 139
140#### SSH 및 WSL 세션에서 HTML 파일 미리보기
141
142[SSH](#ssh-sessions) 또는 [WSL](https://code.claude.com/docs/ko/desktop-wsl.md) 세션에서는 채팅에 있는 HTML 파일 경로를 클릭하여 Browser 패널에서 파일을 미리 봅니다. 미리보기의 차트나 표가 비어 있으면 그 위에 표시되는 알림에서 이유를 알려 줍니다:
143
144* **`This preview doesn't load anything from the web`**: 파일에 작성된 스크립트는 실행되지만, 웹에서 라이브러리를 불러오는 차트는 비어 있습니다. 알림에 **Export** 버튼이 있으면 이를 선택하고 저장된 파일을 브라우저에서 엽니다. 브라우저에서는 웹의 콘텐츠가 로드됩니다.
145* **`This preview doesn't run scripts or load anything from the web`**: Claude Desktop v4.23118.0 이전에는 이러한 미리보기에서 스크립트가 실행되지 않았으므로 Desktop을 업데이트하고 파일을 다시 엽니다. Desktop이 최신 상태인데도 알림이 계속 표시되면 Desktop을 다시 시작합니다. 그래도 계속 표시되면 [조직에서 스크립트가 꺼져](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) 있을 수 있으므로 관리자에게 문의합니다.
146
147알림을 닫은 경우 파일을 다시 열면 알림이 다시 표시됩니다.
148
149#### 조직의 SSH 및 WSL 미리보기에서 스크립트 끄기
150
151[SSH 및 WSL 세션의 HTML 미리보기](#preview-html-files-in-ssh-and-wsl-sessions)에서 스크립트가 실행되지 않도록 하려면 [`disableBrowserExternalNavigation` 관리형 설정](#managed-settings)을 `true`로 설정합니다. 이 설정을 사용하면 사용자는 Browser 패널에서 [외부 사이트를 탐색](#restrict-external-browsing-for-your-organization)할 수도 없습니다.
152
153이 설정은 [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서 지정하거나, Desktop을 실행하는 컴퓨터의 [Claude Code MDM 정책 또는 관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#where-each-mechanism-stores-the-policy)에서 지정합니다. Desktop은 원격 머신이나 WSL 배포판에서 이 설정을 읽지 않습니다. [타사 공급자](https://code.claude.com/docs/ko/third-party-integrations.md)를 사용하는 경우 MDM 정책 또는 파일을 사용합니다.
154
155> [!WARNING]
156>
157> Desktop을 실행하는 컴퓨터가 아직 Claude Code 관리형 설정을 받지 않는 경우, 새로 만드는 관리형 설정에서 [`parentSettingsBehavior`](https://code.claude.com/docs/ko/settings-reference#parentsettingsbehavior)도 `"merge"`로 설정합니다. Desktop은 자체 정책을 Claude Code에 전달하는데, `"merge"`가 없으면 컴퓨터에 관리형 설정이 생긴 후 Claude Code가 [해당 정책을 무시](https://code.claude.com/docs/ko/managed-settings.md#let-an-embedding-host-add-policy)합니다. Windows에서 관리형 설정 파일을 만들면 [허용](https://code.claude.com/docs/ko/admin-setup.md#wsl-sessions-in-claude-code-desktop)하기 전까지 사용자는 WSL 세션도 사용할 수 없게 됩니다.
158>
159> 컴퓨터가 이미 Claude Code 관리형 설정을 받고 있다면 해당 설정에 이 설정을 추가하고, 그곳의 `parentSettingsBehavior`는 그대로 둡니다. MDM 정책 또는 관리형 설정 파일이 두 개 이상 있는 컴퓨터에서는 [우선순위가 가장 높은 것](https://code.claude.com/docs/ko/managed-settings.md#how-claude-code-combines-managed-sources)을 사용합니다.
160
161그런 다음 설정이 확실히 적용되도록 사용자에게 Desktop을 다시 시작하게 하고, 예상되는 동작을 알려 줍니다:
162
163* **사용자가 여는 파일**: 미리보기에서 스크립트가 실행되지 않으므로 스크립트가 그리는 차트와 표는 비어 있습니다
164* **스크립트를 실행 중인 미리보기**: 다시 시작하기 전에 Desktop이 설정을 반영하면 해당 미리보기가 닫힙니다. 사용자에게 `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`가 표시됩니다
165* **사용자가 내보내는 파일**: 사용자가 [파일을 내보내](#preview-html-files-in-ssh-and-wsl-sessions) 브라우저에서 열면, 이 설정과 관계없이 스크립트가 브라우저에서 실행됩니다
166
140### 외부 사이트 탐색하기167### 외부 사이트 탐색하기
141 168
142Browser 패널은 탭 브라우저이므로 실행 중인 앱 옆에 문서, 이슈 추적기 또는 다른 사이트를 열 수 있습니다. Browser를 열려면 macOS에서 **Cmd+Shift+B**를 누르거나 Windows에서 **Ctrl+Shift+B**를 누르거나, 세션 제목 표시줄에서 **Browser**를 클릭합니다. Google OAuth와 같은 팝업 로그인 흐름을 포함하여 패널의 사이트에 로그인할 수 있습니다.169Browser 패널은 탭 브라우저이므로 실행 중인 앱 옆에 문서, 이슈 추적기 또는 다른 사이트를 열 수 있습니다. Browser를 열려면 macOS에서 **Cmd+Shift+B**를 누르거나 Windows에서 **Ctrl+Shift+B**를 누르거나, 세션 제목 표시줄에서 **Browser**를 클릭합니다. Google OAuth와 같은 팝업 로그인 흐름을 포함하여 패널의 사이트에 로그인할 수 있습니다.
162 189
163Browser는 Claude in Chrome 확장 프로그램과 동일한 [site allowlist and blocklist controls](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls)를 따릅니다. 조직이 이미 확장 프로그램에 대해 해당 목록을 구성한 경우 Browser는 자동으로 이를 준수합니다. 관리자는 [`browserExternalPageTools` 관리형 설정](#managed-settings)으로 외부 페이지에서 Claude의 도구를 끌 수도 있습니다. 도구가 비활성화되면 사용자는 여전히 외부 사이트로 이동할 수 있습니다; Claude의 도구는 이를 읽거나 작동할 수 없습니다.190Browser는 Claude in Chrome 확장 프로그램과 동일한 [site allowlist and blocklist controls](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls)를 따릅니다. 조직이 이미 확장 프로그램에 대해 해당 목록을 구성한 경우 Browser는 자동으로 이를 준수합니다. 관리자는 [`browserExternalPageTools` 관리형 설정](#managed-settings)으로 외부 페이지에서 Claude의 도구를 끌 수도 있습니다. 도구가 비활성화되면 사용자는 여전히 외부 사이트로 이동할 수 있습니다; Claude의 도구는 이를 읽거나 작동할 수 없습니다.
164 191
165192외부 탐색을 완전히 끄려면 [`disableBrowserExternalNavigation` 관리형 설정](#managed-settings)을 `true`로 설정합니다. 이는 조직의 허용 목록에 있는 사이트를 포함하여 Browser의 모든 외부 탐색을 차단합니다; localhost 개발 서버 및 파일 미리보기는 계속 작동합니다. `browserExternalPageTools`를 사용하여 사용자가 Claude의 도구 없이 외부 사이트를 계속 탐색하도록 하고, `disableBrowserExternalNavigation`을 사용하여 사용자와 Claude 모두에 대해 외부 사이트를 차단합니다.외부 탐색을 완전히 끄려면 [`disableBrowserExternalNavigation` 관리형 설정](#managed-settings)을 `true`로 설정합니다. 이는 조직의 허용 목록에 있는 사이트를 포함하여 Browser의 모든 외부 탐색을 차단합니다. localhost 개발 서버 및 파일 미리보기는 계속 작동하지만, [SSH 및 WSL 세션의 HTML 미리보기](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)에서는 스크립트가 실행되지 않습니다. `browserExternalPageTools`를 사용하여 사용자가 Claude의 도구 없이 외부 사이트를 계속 탐색하도록 하고, `disableBrowserExternalNavigation`을 사용하여 사용자와 Claude 모두에 대해 외부 사이트를 차단합니다.
166 193
167### diff 보기로 변경 사항 검토하기194### diff 보기로 변경 사항 검토하기
168 195
2009| `autoMode` | 조직 전체에서 자동 모드 분류기가 신뢰하고 차단하는 항목을 사용자 지정합니다. [자동 모드 구성](https://code.claude.com/docs/ko/auto-mode-config.md)을 참조하십시오. |2036| `autoMode` | 조직 전체에서 자동 모드 분류기가 신뢰하고 차단하는 항목을 사용자 지정합니다. [자동 모드 구성](https://code.claude.com/docs/ko/auto-mode-config.md)을 참조하십시오. |
2010| `browserExternalPageTools` | `"disabled"`로 설정하면 Claude가 [Browser 창](#browse-external-sites)에서 외부 페이지를 읽거나 조작하는 도구를 사용할 수 없습니다. 사용자는 여전히 직접 외부 사이트로 이동할 수 있으며, 로컬 개발 서버 미리보기는 영향을 받지 않습니다. |2037| `browserExternalPageTools` | `"disabled"`로 설정하면 Claude가 [Browser 창](#browse-external-sites)에서 외부 페이지를 읽거나 조작하는 도구를 사용할 수 없습니다. 사용자는 여전히 직접 외부 사이트로 이동할 수 있으며, 로컬 개발 서버 미리보기는 영향을 받지 않습니다. |
2011| `disableMobileSimulatorTools` | `true`로 설정하면 [iOS Simulator 창](https://code.claude.com/docs/ko/desktop-ios-simulator.md#turn-off-simulator-access)에서 기기를 제어하고 캡처하는 Claude의 도구가 차단됩니다. 사용자가 직접 탭하는 용도로는 창을 계속 사용할 수 있으며, Claude의 액세스만 제거됩니다. 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. |2038| `disableMobileSimulatorTools` | `true`로 설정하면 [iOS Simulator 창](https://code.claude.com/docs/ko/desktop-ios-simulator.md#turn-off-simulator-access)에서 기기를 제어하고 캡처하는 Claude의 도구가 차단됩니다. 사용자가 직접 탭하는 용도로는 창을 계속 사용할 수 있으며, Claude의 액세스만 제거됩니다. 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. |
20122039| `disableBrowserExternalNavigation` | `true`로 설정하면 [Browser 창](#browse-external-sites)에서 외부 탐색이 완전히 꺼집니다. 사용자와 Claude 모두 외부 사이트로 이동할 수 없으며, localhost 개발 서버 미리보기는 영향을 받지 않습니다. 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. || `disableBrowserExternalNavigation` | `true`로 설정하면 [Browser 창](#browse-external-sites)에서 외부 탐색이 완전히 꺼집니다. 사용자와 Claude 모두 외부 사이트로 이동할 수 없으며, localhost 개발 서버 미리보기는 영향을 받지 않습니다. SSH 및 WSL 세션의 HTML 미리보기는 [스크립트를 실행하지 않습니다](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. |
2013| `sshConfigs` | 환경 선택기에 표시되는 [SSH 연결](#pre-configure-ssh-connections-for-your-team)을 미리 구성합니다. 사용자는 관리되는 연결을 삭제할 수 없으며, 자신의 **Worktree folder** 외에는 아무것도 편집할 수 없습니다. |2040| `sshConfigs` | 환경 선택기에 표시되는 [SSH 연결](#pre-configure-ssh-connections-for-your-team)을 미리 구성합니다. 사용자는 관리되는 연결을 삭제할 수 없으며, 자신의 **Worktree folder** 외에는 아무것도 편집할 수 없습니다. |
2014| `sshHostCommands` | 사용자 자신의 연결과 함께 [명령에서 호스트를 가져오는 SSH 연결](#distribute-commands-to-your-team)을 제공합니다. Desktop은 컴퓨터의 관리형 설정 파일 또는 MDM 정책에서 이 키를 읽으며, [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서는 무시합니다. macOS 또는 Linux에서는 Claude Desktop v3.6556.0 이상, Windows에서는 v4.16336.0 이상이 필요하며, Claude 계정으로 로그인해야 합니다. Windows에서는 Desktop이 [OpenSSH 클라이언트를 통해 연결](#use-your-ssh-configuration)하도록 설정되어 있어야 합니다. |2041| `sshHostCommands` | 사용자 자신의 연결과 함께 [명령에서 호스트를 가져오는 SSH 연결](#distribute-commands-to-your-team)을 제공합니다. Desktop은 컴퓨터의 관리형 설정 파일 또는 MDM 정책에서 이 키를 읽으며, [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서는 무시합니다. macOS 또는 Linux에서는 Claude Desktop v3.6556.0 이상, Windows에서는 v4.16336.0 이상이 필요하며, Claude 계정으로 로그인해야 합니다. Windows에서는 Desktop이 [OpenSSH 클라이언트를 통해 연결](#use-your-ssh-configuration)하도록 설정되어 있어야 합니다. |
2015| `sshHostAllowlist` | [SSH 세션](#restrict-which-ssh-hosts-users-can-connect-to)을 확인된 호스트 이름이 이 패턴 중 하나와 일치하는 호스트로 제한합니다. 관리형 설정에서만 읽습니다. |2042| `sshHostAllowlist` | [SSH 세션](#restrict-which-ssh-hosts-users-can-connect-to)을 확인된 호스트 이름이 이 패턴 중 하나와 일치하는 호스트로 제한합니다. 관리형 설정에서만 읽습니다. |