desktop.md +32 −5
120 120
121> [!NOTE]121> [!NOTE]
122>122>
123123> [SSH 세션](#ssh-sessions)에서는 Claude가 Browser 패널의 도구를 사용할 수 없으므로 Browser 패널에서 앱을 열 수 없습니다. 앱을 직접 확인하려면 [앱의 포트를 컴퓨터로 포워딩](#reach-a-port-on-the-remote-machine)합니다.> [SSH 세션](#ssh-sessions)에서는 Claude가 Browser 패널의 도구를 사용할 수 없으므로 패널에서 앱을 열거나 변경 사항을 [자동으로 확인](#auto-verify-changes)할 수 없습니다. 패널의 **Dev servers** 메뉴와 [구성된 미리보기 서버](#configure-preview-servers)도 사용할 수 없습니다. 앱을 직접 확인하려면 원격 머신에서 앱의 서버를 시작한 다음 [해당 포트를 컴퓨터로 포워딩](#reach-a-port-on-the-remote-machine)합니다.
124 124
125로컬 세션에서 Claude가 서버를 시작한 후 Browser 패널이 열려 있지 않으면 채팅에서 서버 카드의 **Open**을 클릭합니다.125로컬 세션에서 Claude가 서버를 시작한 후 Browser 패널이 열려 있지 않으면 채팅에서 서버 카드의 **Open**을 클릭합니다.
126 126
1002* **`MaxSessions 1`에서의 일회용 코드**: 일회용 코드처럼 로그인할 때마다 확인을 요청하는 경우 `!` 명령이 실패합니다. 대신 자체 창에서 확인을 요청하는 터미널 탭에서 해당 명령을 실행하세요.1002* **`MaxSessions 1`에서의 일회용 코드**: 일회용 코드처럼 로그인할 때마다 확인을 요청하는 경우 `!` 명령이 실패합니다. 대신 자체 창에서 확인을 요청하는 터미널 탭에서 해당 명령을 실행하세요.
1003* **설치 폴더**: Desktop은 홈 디렉터리의 `~/.claude/remote/` 아래에 도우미 프로그램과 Claude Code를 설치합니다. 해당 위치에서 이를 실행하므로 이 폴더는 `noexec`로 마운트된 파일 시스템에 있으면 안 됩니다. 연결하는 각 사용자의 홈 디렉터리에 약 1 GB의 디스크 공간을 확보하세요. 이 폴더에 담긴 내용은 [원격 머신의 파일 및 프로세스](#files-and-processes-on-the-remote-machine)를 참조하세요.1003* **설치 폴더**: Desktop은 홈 디렉터리의 `~/.claude/remote/` 아래에 도우미 프로그램과 Claude Code를 설치합니다. 해당 위치에서 이를 실행하므로 이 폴더는 `noexec`로 마운트된 파일 시스템에 있으면 안 됩니다. 연결하는 각 사용자의 홈 디렉터리에 약 1 GB의 디스크 공간을 확보하세요. 이 폴더에 담긴 내용은 [원격 머신의 파일 및 프로세스](#files-and-processes-on-the-remote-machine)를 참조하세요.
1004* **셸**: 원격 머신에서 계정에 설정된 셸은 Bash, Zsh, `sh`처럼 SSH를 통해 전송된 명령을 실행할 수 있어야 합니다1004* **셸**: 원격 머신에서 계정에 설정된 셸은 Bash, Zsh, `sh`처럼 SSH를 통해 전송된 명령을 실행할 수 있어야 합니다
10051005* **네트워크**: Claude Code는 원격 머신에서 실행되며 네트워크 요청도 그곳에서 보내므로, 머신에는 [Claude Code에 필요한 네트워크 액세스](https://code.claude.com/docs/ko/network-config.md#network-access-requirements)가 있어야 합니다. 머신이 Claude Code를 다운로드할 수 없는 경우 Desktop이 컴퓨터에서 다운로드하여 업로드합니다. Claude Code의 다른 요청은 여전히 원격 머신에서 전송됩니다. Linux 원격 머신에서 이러한 요청에 프록시가 필요하다면 [SSH 세션에 프록시를 설정](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions)하세요.* **네트워크**: Claude Code는 원격 머신에서 실행되고 그곳에서 네트워크 요청을 보내므로, 머신에는 [Claude Code에 필요한 네트워크 액세스](https://code.claude.com/docs/ko/network-config.md#network-access-requirements)가 있어야 합니다. 머신이 Claude Code를 다운로드할 수 없으면 Desktop이 사용자 컴퓨터에서 다운로드하여 업로드합니다. Claude Code의 다른 요청은 여전히 원격 머신에서 나갑니다. Linux 원격 머신에 프록시나 CA 인증서가 필요하다면 [SSH 세션용으로 설정](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions)하세요.
1006 1006
1007#### 원격 머신의 호스트 키 확인1007#### 원격 머신의 호스트 키 확인
1008 1008
1030 1030
1031Linux 원격 머신이 프록시를 통해 인터넷에 연결하거나 CA 인증서가 필요한 경우, 해당 머신의 `~/.claude/settings.json`에 있는 `env` 아래에 [프록시 및 CA 변수](https://code.claude.com/docs/ko/network-config.md)를 추가합니다. 해당 머신의 `~/.profile`, `~/.bash_profile`, `~/.zprofile` 또는 `~/.zshrc`에서 이미 내보내고 있더라도 추가하세요.1031Linux 원격 머신이 프록시를 통해 인터넷에 연결하거나 CA 인증서가 필요한 경우, 해당 머신의 `~/.claude/settings.json`에 있는 `env` 아래에 [프록시 및 CA 변수](https://code.claude.com/docs/ko/network-config.md)를 추가합니다. 해당 머신의 `~/.profile`, `~/.bash_profile`, `~/.zprofile` 또는 `~/.zshrc`에서 이미 내보내고 있더라도 추가하세요.
1032 1032
10331033SSH 세션에서 Claude Code는 해당 머신의 터미널에서 실행한 `claude`가 이러한 파일의 변수를 받는 경우에도 그 변수를 받지 않습니다. 그러면 세션이 멈추거나 **The connection from … to the API failed** 또는 **Authentication failed**가 표시될 수 있으며, 다시 로그인해도 도움이 되지 않습니다.SSH 세션에서 Claude Code는 해당 머신의 터미널에서 실행한 `claude`가 이 파일들의 변수를 받는 경우에도 이를 받지 못합니다. 그러면 세션이 멈추거나 **The connection from … to the API failed**, **Authentication failed**, 또는 **Claude Code on … couldn’t verify the API connection’s certificate**가 표시될 수 있습니다. 다시 로그인해도 해결되지 않습니다.
1034 1034
1035**1. 변수 추가**1035**1. 변수 추가**
1036 1036
1948 1948
1949관리형 소스에서만 설정할 수 있는 권한, 플러그인, 전달 관련 키는 [관리형 설정에서만 설정할 수 있는 키](https://code.claude.com/docs/ko/managed-settings.md#managed-only-settings)를 참조하십시오.1949관리형 소스에서만 설정할 수 있는 권한, 플러그인, 전달 관련 키는 [관리형 설정에서만 설정할 수 있는 키](https://code.claude.com/docs/ko/managed-settings.md#managed-only-settings)를 참조하십시오.
1950 1950
1951#### Code 탭에서 다르게 작동하는 Claude Code 설정
1952
1953Code 탭이 터미널 인터페이스를 대체하므로, 로컬 세션에서는 다음 키를 비롯한 일부 키가 다르게 작동하거나 눈에 보이는 효과가 없습니다. 이러한 키는 터미널에서는 여전히 적용되므로 설정된 상태로 두어도 됩니다.
1954
1955| 키 | 로컬 세션에서의 동작 |
1956| - | - |
1957| `askUserQuestionTimeout` | 타임아웃이 적용되지 않으므로 Claude의 질문은 사용자가 답변할 때까지 열린 상태로 유지됩니다 |
1958| `awaySummaryEnabled` | 이 키는 효과가 없습니다 |
1959| `bashEditDiffEnabled` | Code 탭은 Bash 명령이 변경한 파일 목록을 표시하지 않습니다 |
1960| `companyAnnouncements` | Code 탭은 공지를 표시하지 않습니다 |
1961| `defaultShell` | 사용자가 `!` 뒤에 입력하는 명령은 앱이 선택하는 셸에서 실행됩니다. macOS와 Linux에서는 사용자의 로그인 셸, Windows에서는 PowerShell입니다 |
1962| `fileSuggestion` | `@` 파일 선택기는 자체 파일 목록을 만들며 설정한 명령을 실행하지 않습니다 |
1963| `modelPicker` | 모델 선택기에는 각 사용자 계정에서 사용할 수 있는 모델이 나열됩니다. 이를 제한하려면 [`availableModels`](https://code.claude.com/docs/ko/model-config#restrict-model-selection)를 설정하십시오. |
1964| `pluginTrustMessage` | 사용자가 플러그인을 설치할 때 표시되는 경고에 설정한 메시지가 포함되지 않습니다 |
1965| `prUrlTemplate` | 풀 리퀘스트 링크는 템플릿이 아닌 풀 리퀘스트 자체의 URL을 사용합니다 |
1966| `respectGitignore` | `@` 파일 선택기는 자체 파일 목록을 만들며 이 키를 읽지 않습니다 |
1967| `respondToBashCommands` | 값과 관계없이 Claude는 사용자가 `!`로 실행한 명령의 출력에 응답합니다 |
1968| `showClearContextOnPlanAccept` | 사용자가 계획을 승인할 때 컨텍스트 지우기 옵션이 제공되지 않습니다 |
1969| `skipDangerousModePermissionPrompt` | Code 탭에는 [Bypass permissions 모드](#choose-a-permission-mode)에 대한 자체 확인 절차가 있으며, 이 키로 이를 건너뛸 수 없습니다 |
1970| `verbose`, `viewMode` | 각 사용자가 [세션 메뉴의 **Transcript view**](#switch-view-modes)에서 보기를 선택합니다 |
1971| `worktree.baseRef`, `worktree.sparsePaths`, `worktree.symlinkDirectories` | Code 탭이 세션용으로 만드는 워크트리에는 사용되지 않습니다 |
1972
1951### 기기 관리 정책1973### 기기 관리 정책
1952 1974
1953IT 팀은 macOS에서는 MDM, Windows에서는 그룹 정책, Linux에서는 정책 파일을 통해 데스크톱 앱을 관리할 수 있습니다. 사용 가능한 정책에는 Claude Code 기능 활성화 또는 비활성화, macOS 및 Windows의 자동 업데이트 제어, 사용자 지정 배포 URL 설정이 포함됩니다.1975IT 팀은 macOS에서는 MDM, Windows에서는 그룹 정책, Linux에서는 정책 파일을 통해 데스크톱 앱을 관리할 수 있습니다. 사용 가능한 정책에는 Claude Code 기능 활성화 또는 비활성화, macOS 및 Windows의 자동 업데이트 제어, 사용자 지정 배포 URL 설정이 포함됩니다.
2100* 프로젝트의 **[CLAUDE.md](https://code.claude.com/docs/ko/memory.md)** 및 `CLAUDE.local.md` 파일은 둘 다에서 사용됩니다2122* 프로젝트의 **[CLAUDE.md](https://code.claude.com/docs/ko/memory.md)** 및 `CLAUDE.local.md` 파일은 둘 다에서 사용됩니다
2101* `~/.claude.json` 또는 `.mcp.json`에 구성된 \*\*[MCP 서버](https://code.claude.com/docs/ko/mcp.md)\*\*는 둘 다에서 작동합니다2123* `~/.claude.json` 또는 `.mcp.json`에 구성된 \*\*[MCP 서버](https://code.claude.com/docs/ko/mcp.md)\*\*는 둘 다에서 작동합니다
2102* 설정에 정의된 **[훅](https://code.claude.com/docs/ko/hooks.md)** 및 \*\*[스킬](https://code.claude.com/docs/ko/skills.md)\*\*은 둘 다에 적용됩니다2124* 설정에 정의된 **[훅](https://code.claude.com/docs/ko/hooks.md)** 및 \*\*[스킬](https://code.claude.com/docs/ko/skills.md)\*\*은 둘 다에 적용됩니다
21032125* `~/.claude.json` 및 `~/.claude/settings.json`의 \*\*[설정](https://code.claude.com/docs/ko/settings.md)\*\*은 공유됩니다. `settings.json`의 권한 규칙, 허용된 도구 및 기타 설정은 Desktop 세션에 적용됩니다.* `~/.claude.json` 및 `~/.claude/settings.json`의 \*\*[설정](https://code.claude.com/docs/ko/settings.md)\*\*은 공유됩니다. `settings.json`의 권한 규칙, 허용된 도구 및 기타 설정은 Desktop 세션에 적용됩니다. 일부 키는 [Code 탭에서 다르게 작동합니다](#claude-code-settings-that-behave-differently-in-the-code-tab).
2104* **모델**: 동일한 [모델](https://code.claude.com/docs/ko/model-config.md#available-models)을 둘 다에서 사용할 수 있습니다. Desktop에서는 프롬프트 상자 아래 행의 모델 선택기에서 모델을 선택합니다. 동일한 선택기에서 세션 중간에 모델을 변경할 수 있습니다.2126* **모델**: 동일한 [모델](https://code.claude.com/docs/ko/model-config.md#available-models)을 둘 다에서 사용할 수 있습니다. Desktop에서는 프롬프트 상자 아래 행의 모델 선택기에서 모델을 선택합니다. 동일한 선택기에서 세션 중간에 모델을 변경할 수 있습니다.
2105 2127
2106#### Claude Desktop 채팅 앱의 MCP 서버2128#### Claude Desktop 채팅 앱의 MCP 서버
2281 2303
2282파일을 보내기 전에 내용을 살펴보세요. 환경의 이름과 기타 세부 정보가 포함될 수 있습니다. `<host>`와 `<user>`는 Desktop이 대체한 이름을 나타냅니다. Desktop이 모든 이름을 대체하지는 않으므로 SSH 호스트 또는 사용자 이름이 작성된 그대로 나타날 수 있습니다. zip 파일을 다른 사람에게 보내는 경우 로그에 해당 호스트 이름이 없을 수 있으므로 어떤 호스트가 언제 실패했는지 알려 주세요.2304파일을 보내기 전에 내용을 살펴보세요. 환경의 이름과 기타 세부 정보가 포함될 수 있습니다. `<host>`와 `<user>`는 Desktop이 대체한 이름을 나타냅니다. Desktop이 모든 이름을 대체하지는 않으므로 SSH 호스트 또는 사용자 이름이 작성된 그대로 나타날 수 있습니다. zip 파일을 다른 사람에게 보내는 경우 로그에 해당 호스트 이름이 없을 수 있으므로 어떤 호스트가 언제 실패했는지 알려 주세요.
2283 2305
22842306zip 파일에는 Desktop이 원격 머신에 설치하는 도우미 프로그램의 로그가 포함되어 있지 않습니다. 해당 로그도 가져오려면 연결한 사용자의 홈 디렉터리에 있는 [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) 아래 도우미 폴더에서 `remote-server.log`를 복사합니다. 이 파일도 보내기 전에 내용을 살펴보세요.zip 파일에는 Desktop이 원격 머신에 설치하는 도우미 프로그램의 로그가 포함되어 있지 않습니다. 해당 로그도 가져오려면 연결한 사용자의 홈 디렉터리에 있는 [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) 아래 도우미 폴더에서 다음 파일을 복사합니다:
2307
2308* **`remote-server.log`**: 도우미의 가장 최근 실행 로그입니다.
2309* **`remote-server.log.old`**(있는 경우): 그 이전 실행의 로그입니다. 다음에 Desktop이 연결하면서 도우미를 다시 시작해야 하면 이 파일이 사라지므로 가능한 한 빨리 복사하세요.
2310
2311이 파일들도 보내기 전에 내용을 살펴보세요.
2285 2312
2286### 앱이 종료되지 않음2313### 앱이 종료되지 않음
2287 2314