10 10 

11저장소가 배포판의 파일 시스템 내에 있을 때 WSL 세션을 사용합니다. Windows에서 해당 파일을 작업하면 네트워크 파일 시스템을 통해 진행되므로 속도가 느리고 파일 감시가 중단됩니다. 배포판 내에서 세션을 실행하면 둘 다 피할 수 있습니다.11저장소가 배포판의 파일 시스템 내에 있을 때 WSL 세션을 사용합니다. Windows에서 해당 파일을 작업하면 네트워크 파일 시스템을 통해 진행되므로 속도가 느리고 파일 감시가 중단됩니다. 배포판 내에서 세션을 실행하면 둘 다 피할 수 있습니다.

12 12 

13<h2 id="requirements">13## 요구 사항

14 요구 사항

15</h2>

16 14 

17* [WSL 2](https://learn.microsoft.com/windows/wsl/install)가 설치된 Windows 10 또는 11. WSL 1은 지원되지 않습니다.15* [WSL 2](https://learn.microsoft.com/windows/wsl/install)가 설치된 Windows 10 또는 11. WSL 1은 지원되지 않습니다.

18* 설치된 배포판이 최소 하나 이상 필요합니다(예: Ubuntu).16* 설치된 배포판이 최소 하나 이상 필요합니다(예: Ubuntu).

19* 배포판 내에 `git`이 설치되어 있어야 합니다.17* 배포판 내에 `git`이 설치되어 있어야 합니다.

20 18 

21<h2 id="start-a-wsl-session">19## WSL 세션 시작

22 WSL 세션 시작

23</h2>

24 20 

25<Steps>21**1. 배포판 선택**

26 <Step title="배포판 선택">

27 Code 탭에서 새 세션을 시작하고 프롬프트 상자 아래, 또는 [이전 레이아웃](/docs/ko/desktop#check-which-layout-you-have)에서는 프롬프트 상자 위에 있는 [환경 선택기](/docs/ko/desktop#start-a-session)를 엽니다. 설치된 WSL 2 배포판이 **WSL** 섹션에 나타납니다. 하나를 선택합니다.

28 </Step>

29 22 

30 <Step title="폴더 선택">23Code 탭에서 새 세션을 시작하고 프롬프트 상자 아래, 또는 [이전 레이아웃](/docs/ko/desktop#check-which-layout-you-have)에서는 프롬프트 상자 위에 있는 [환경 선택기](/docs/ko/desktop#start-a-session)를 엽니다. 설치된 WSL 2 배포판이 **WSL** 섹션에 나타납니다. 하나를 선택합니다.

31 세션은 배포판의 홈 디렉터리에서 시작됩니다. 폴더 선택기를 사용하여 프로젝트 폴더를 선택합니다. 검색은 배포판 내에서 진행되며 `/home/you/project`와 같은 Linux 경로를 사용합니다.

32 </Step>

33 24 

34 <Step title="폴더 신뢰">25**2. 폴더 선택**

35 폴더의 첫 번째 세션에는 워크스페이스 신뢰 대화 상자가 표시됩니다. 신뢰는 배포판 및 폴더별로 부여됩니다. 한 배포판의 폴더를 신뢰하는 것이 다른 배포판이나 Windows의 동일한 경로에 적용되지는 않습니다.26 

36 </Step>27세션은 배포판의 홈 디렉터리에서 시작됩니다. 폴더 선택기를 사용하여 프로젝트 폴더를 선택합니다. 검색은 배포판 내에서 진행되며 `/home/you/project`와 같은 Linux 경로를 사용합니다.

37</Steps>28 

29**3. 폴더 신뢰**

30 

31폴더의 첫 번째 세션에는 워크스페이스 신뢰 대화 상자가 표시됩니다. 신뢰는 배포판 및 폴더별로 부여됩니다. 한 배포판의 폴더를 신뢰하는 것이 다른 배포판이나 Windows의 동일한 경로에 적용되지는 않습니다.

38 32 

39배포판의 첫 번째 세션은 Claude가 내부에 설정되는 동안 약간 더 오래 걸립니다. 일반 폴더 선택기에서 `\\wsl.localhost\...` 폴더를 열 수도 있으며, 해당 배포판 내에서 다시 열립니다.33배포판의 첫 번째 세션은 Claude가 내부에 설정되는 동안 약간 더 오래 걸립니다. 일반 폴더 선택기에서 `\\wsl.localhost\...` 폴더를 열 수도 있으며, 해당 배포판 내에서 다시 열립니다.

40 34 

41<h2 id="what-works-in-a-wsl-session">35## WSL 세션에서 작동하는 기능

42 WSL 세션에서 작동하는 기능

43</h2>

44 36 

45병렬 세션, 측면 채팅, 시각적 diff 검토, 브랜치 및 풀 리퀘스트 상태, worktree는 모두 배포판 내의 git 및 도구 체인으로 지원됩니다. "편집기에서 열기"는 [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl)을 통해 배포판에 연결된 VS Code를 엽니다.37병렬 세션, 측면 채팅, 시각적 diff 검토, 브랜치 및 풀 리퀘스트 상태, worktree는 모두 배포판 내의 git 및 도구 체인으로 지원됩니다. "편집기에서 열기"는 [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl)을 통해 배포판에 연결된 VS Code를 엽니다.

46 38 

51* **파일 편집**: [파일 창](/docs/ko/desktop#open-and-edit-files)에서 파일을 볼 수는 있지만 편집할 수는 없으므로 Claude에게 변경을 요청합니다43* **파일 편집**: [파일 창](/docs/ko/desktop#open-and-edit-files)에서 파일을 볼 수는 있지만 편집할 수는 없으므로 Claude에게 변경을 요청합니다

52* **첨부 파일**: **+** 메뉴에 **파일 또는 사진 추가** 대신 **이미지 추가**가 표시되면 이미지만 첨부할 수 있습니다. [프롬프트에 파일 및 컨텍스트 추가](/docs/ko/desktop#add-files-and-context-to-prompts)를 참조하세요.44* **첨부 파일**: **+** 메뉴에 **파일 또는 사진 추가** 대신 **이미지 추가**가 표시되면 이미지만 첨부할 수 있습니다. [프롬프트에 파일 및 컨텍스트 추가](/docs/ko/desktop#add-files-and-context-to-prompts)를 참조하세요.

53 45 

54<a id="check-for-the-terminal-and-connectors" />46### 터미널 또는 커넥터를 사용할 수 없는 경우

55 

56<h3 id="if-the-terminal-or-connectors-are-unavailable">

57 터미널 또는 커넥터를 사용할 수 없는 경우

58</h3>

59 47 

60WSL 세션의 통합 터미널이나 커넥터는 사용자가 직접 켤 수 없습니다.48WSL 세션의 통합 터미널이나 커넥터는 사용자가 직접 켤 수 없습니다.

61 49 

62* **Claude 계정**: 두 기능은 별도로 출시되고 있습니다. \*\*Help > Check for Updates…\*\*를 선택하고, 업데이트한 후에도 기능이 여전히 없다면 따로 조치할 것은 없습니다.50* **Claude 계정**: 두 기능은 별도로 출시되고 있습니다. \*\*Help > Check for Updates…\*\*를 선택하고, 업데이트한 후에도 기능이 여전히 없다면 따로 조치할 것은 없습니다.

63* **[서드파티 제공업체](/docs/ko/third-party-integrations)**: WSL 세션에서는 터미널이나 커넥터가 제공되지 않으며, Desktop을 업데이트해도 달라지지 않습니다51* **[서드파티 제공업체](/docs/ko/third-party-integrations)**: WSL 세션에서는 터미널이나 커넥터가 제공되지 않으며, Desktop을 업데이트해도 달라지지 않습니다

64 52 

65<h2 id="managed-devices">53## 관리되는 디바이스

66 관리되는 디바이스

67</h2>

68 54 

69조직에서 관리하는 디바이스에서는 WSL 세션을 사용할 수 없을 수 있습니다. 세션 시작이 디바이스가 관리된다는 메시지와 함께 실패하면 이는 관리자가 제어합니다. 관리자: 배포 가이드의 [설정이 디바이스에 도달하는 방식 결정](/docs/ko/admin-setup#decide-how-settings-reach-devices)을 참조하세요.55조직에서 관리하는 디바이스에서는 WSL 세션을 사용할 수 없을 수 있습니다. 세션 시작이 디바이스가 관리된다는 메시지와 함께 실패하면 이는 관리자가 제어합니다. 관리자: 배포 가이드의 [설정이 디바이스에 도달하는 방식 결정](/docs/ko/admin-setup#decide-how-settings-reach-devices)을 참조하세요.