Documentation 2026-11-06 23:01 UTC to 2026-11-07 23:58 UTC

549로컬 세션은 사용자가 해당 세션에 Remote Control을 켜거나, 세션이 시작될 때 자동으로 연결됩니다.549로컬 세션은 사용자가 해당 세션에 Remote Control을 켜거나, 세션이 시작될 때 자동으로 연결됩니다.

550 550 

551* **해당 세션에 직접 켜기**: 세션의 **Remote Control** 스위치를 사용하거나 프롬프트 상자에 `/remote-control`을 입력합니다.551* **해당 세션에 직접 켜기**: 세션의 **Remote Control** 스위치를 사용하거나 프롬프트 상자에 `/remote-control`을 입력합니다.

552* **시작 시 연결**: **Settings > Code** 또는 **Settings > Claude Code**에서 **Connect new sessions to Remote Control**이 켜져 있으면 새 세션이 자동으로 연결됩니다. 이 설정을 변경한 적이 없다면 Desktop은 사용자 설정 또는 관리형 설정의 [`remoteControlAtStartup`](https://code.claude.com/docs/ko/settings-reference#remotecontrolatstartup)을 따르고, 그다음 조직의 기본값을 따릅니다.552* **시작 시 연결**: **Settings > Code** 또는 **Settings > Claude Code**에서 **Connect new sessions to Remote Control**이 켜져 있으면 새 세션이 자동으로 연결됩니다. 단, 관리형 설정에서 [`remoteControlAtStartup`](https://code.claude.com/docs/ko/settings-reference#remotecontrolatstartup)이 `false`이면 연결되지 않습니다. **Connect new sessions to Remote Control**을 변경한 적이 없다면 Desktop은 사용자 설정 또는 관리형 설정의 `remoteControlAtStartup`을 사용합니다. 둘 다 이를 설정하지 않은 경우 Desktop은 조직의 기본값을 사용하며, 조직 기본값이 없으면 Desktop 자체 기본값을 사용합니다.

553 553 

554세션이 연결되어 있는지 확인하려면 [세션 세부 정보 패널](#see-session-details)의 **Environment** 카드에서 **Remote Control** 스위치를 확인합니다.554세션이 연결되어 있는지 확인하려면 [세션 세부 정보 패널](#see-session-details)의 **Environment** 카드에서 **Remote Control** 스위치를 확인합니다.

555 555 

556세션이 다른 기기에 표시되지 않도록 하려면 필요한 수준에서 Remote Control을 끕니다.556#### 다른 기기에 세션이 표시되지 않도록 하기

557 

558세션 하나, 이 컴퓨터의 세션 또는 관리하는 컴퓨터에 대해 Remote Control을 끕니다.

557 559 

558* **세션 하나**: 해당 세션의 **Remote Control** 스위치를 끕니다. 시작 시 연결된 세션에서 `/remote-control`을 입력하면 Remote Control이 켜진 상태로 유지되며 `Remote Control is already on. This session connected automatically when it started.`가 표시됩니다. 연결을 끊으려면 해당 줄에서 **Turn off**를 클릭합니다.560* **세션 하나**: 해당 세션의 **Remote Control** 스위치를 끕니다. 시작 시 연결된 세션에서 `/remote-control`을 입력하면 Remote Control이 켜진 상태로 유지되며 `Remote Control is already on. This session connected automatically when it started.`가 표시됩니다. 연결을 끊으려면 해당 줄에서 **Turn off**를 클릭합니다.

559* **이 컴퓨터의 새 Desktop 세션**: **Settings > Code** 또는 **Settings > Claude Code**에서 **Connect new sessions to Remote Control**을 끕니다. 이미 꺼져 있는 것으로 표시되면 켰다가 다시 꺼서 Desktop이 선택을 저장하도록 합니다. 저장된 설정은 `remoteControlAtStartup`과 기본값보다 우선합니다.561* **이 컴퓨터의 새 Desktop 세션**: **Settings > Code** 또는 **Settings > Claude Code**에서 **Connect new sessions to Remote Control**을 끕니다. 이미 꺼져 있는 것으로 표시되면 켰다가 다시 꺼서 Desktop이 선택을 저장하도록 합니다. 저장된 후에는 `remoteControlAtStartup`이나 기본값이 연결하도록 지정하더라도 새 세션이 자동으로 연결되지 않습니다.

560* **CLI를 포함한 이 컴퓨터의 모든 세션**: `~/.claude/settings.json`에서 [`disableRemoteControl`](https://code.claude.com/docs/ko/settings-reference#disableremotecontrol)을 `true`로 설정하여 세션이 연결되지 않도록 합니다. 파일을 저장할 때 이미 연결되어 있던 세션은 해당 세션의 Remote Control을 끌 때까지 연결된 상태로 유지됩니다.562* **CLI를 포함한 이 컴퓨터의 모든 세션**: `~/.claude/settings.json`에서 [`disableRemoteControl`](https://code.claude.com/docs/ko/settings-reference#disableremotecontrol)을 `true`로 설정하여 세션이 연결되지 않도록 합니다. 파일을 저장할 때 이미 연결되어 있던 세션은 해당 세션의 Remote Control을 끌 때까지 연결된 상태로 유지됩니다.

563* **관리하는 컴퓨터의 Desktop 세션**: 컴퓨터의 [최우선 MDM 정책 또는 관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#how-claude-code-combines-managed-sources)에서 `remoteControlAtStartup`을 `false`로 설정하면, [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서 이 키가 `true`이더라도 해당 컴퓨터의 세션이 자동으로 연결되지 않습니다. 이 용도로 사용자 수준의 `HKCU` 레지스트리 값을 사용하지 마세요. 사용자는 여전히 세션에 대해 직접 Remote Control을 켤 수 있으며, 이를 막으려면 [관리자 콘솔](#admin-console-controls)을 사용하세요. Claude Desktop v4.4212.0 이상이 필요합니다.

561 564 

562이미 다른 기기에 표시된 세션을 숨기려면 Desktop에서 해당 세션을 보관합니다. Desktop은 세션의 Remote Control 사본도 보관하므로 해당 기기의 기본 세션 목록에서 사라집니다. 해당 기기에서 세션을 보거나 삭제하려면 [세션 보관하기](https://code.claude.com/docs/ko/claude-code-on-the-web.md#archive-sessions)를 참조하세요.565이미 다른 기기에 표시된 세션을 숨기려면 Desktop에서 해당 세션을 보관합니다. Desktop은 세션의 Remote Control 사본도 보관하므로 해당 기기의 기본 세션 목록에서 사라집니다. 해당 기기에서 세션을 보거나 삭제하려면 [세션 보관하기](https://code.claude.com/docs/ko/claude-code-on-the-web.md#archive-sessions)를 참조하세요.

563 566 

2014| `disableSshSavedPasswords` | `true`로 설정하면 Desktop이 SSH 비밀번호 저장을 제안하지 않으며, 이전에 저장한 비밀번호를 사용하거나 표시하지도 않습니다. 이 설정을 켜도 저장된 비밀번호가 삭제되지는 않습니다. 관리형 설정에서만 읽습니다. Claude Desktop v1.49585.0 이상이 필요합니다. |2017| `disableSshSavedPasswords` | `true`로 설정하면 Desktop이 SSH 비밀번호 저장을 제안하지 않으며, 이전에 저장한 비밀번호를 사용하거나 표시하지도 않습니다. 이 설정을 켜도 저장된 비밀번호가 삭제되지는 않습니다. 관리형 설정에서만 읽습니다. Claude Desktop v1.49585.0 이상이 필요합니다. |

2015| `managedMcpServers` | 모든 사용자에게 MCP 서버 구성을 푸시합니다. 서드파티(3P) Desktop 배포에서만 사용할 수 있습니다. 각 항목에서 `"http"`, `"sse"`, `"stdio"` 중 하나의 전송 방식과 연결 세부 정보를 설정하고, 선택적으로 `toolPolicy` 맵을 설정하여 사용자가 호출할 수 있는 해당 서버의 도구를 제한합니다. 3P 배포는 관리자 콘솔 설정을 받지 않으므로 관리형 설정 파일, MDM 또는 Claude apps 게이트웨이 정책의 [`desktop` 블록](https://code.claude.com/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)을 통해 전달하십시오. 게이트웨이를 통해 전달하려면 게이트웨이 서버에 Claude Code v2.1.232 이상이 필요합니다. 이 키는 데스크톱 앱 고유의 키이며, Claude Code는 항목 형식이 다른 [동일한 이름의 자체 관리형 설정](https://code.claude.com/docs/ko/managed-mcp.md#provide-servers-through-managed-settings)을 읽습니다. |2018| `managedMcpServers` | 모든 사용자에게 MCP 서버 구성을 푸시합니다. 서드파티(3P) Desktop 배포에서만 사용할 수 있습니다. 각 항목에서 `"http"`, `"sse"`, `"stdio"` 중 하나의 전송 방식과 연결 세부 정보를 설정하고, 선택적으로 `toolPolicy` 맵을 설정하여 사용자가 호출할 수 있는 해당 서버의 도구를 제한합니다. 3P 배포는 관리자 콘솔 설정을 받지 않으므로 관리형 설정 파일, MDM 또는 Claude apps 게이트웨이 정책의 [`desktop` 블록](https://code.claude.com/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)을 통해 전달하십시오. 게이트웨이를 통해 전달하려면 게이트웨이 서버에 Claude Code v2.1.232 이상이 필요합니다. 이 키는 데스크톱 앱 고유의 키이며, Claude Code는 항목 형식이 다른 [동일한 이름의 자체 관리형 설정](https://code.claude.com/docs/ko/managed-mcp.md#provide-servers-through-managed-settings)을 읽습니다. |

2016 2019 

2020컴퓨터의 [우선순위가 가장 높은 MDM 정책 또는 관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#how-claude-code-combines-managed-sources)에서 `browserExternalPageTools`, `disableMobileSimulatorTools` 또는 `disableBrowserExternalNavigation`으로 기능을 끄면, 해당 컴퓨터에서는 그 기능이 꺼진 상태로 유지됩니다. [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서 해당 키를 설정하지 않거나 기능을 허용하더라도 꺼진 상태로 유지됩니다. 이 용도로 사용자 수준의 `HKCU` 레지스트리 값을 사용하지 마십시오. 기능을 다시 켜려면 값을 설정한 모든 위치에서 해당 값을 제거하십시오. Claude Desktop v4.4212.0 이상이 필요합니다.

2021 

2017Desktop 세션에 어떤 관리형 설정이 적용되는지는 해당 세션이 실행되는 위치에 따라 달라집니다. [`availableModels`](https://code.claude.com/docs/ko/model-config#restrict-model-selection)와 같은 모델 제한은 터미널 CLI와 동일한 방식으로 Desktop의 Claude Code 세션에 적용됩니다. [사용 환경별 적용 범위](https://code.claude.com/docs/ko/model-config.md#surface-coverage)를 참조하십시오.2022Desktop 세션에 어떤 관리형 설정이 적용되는지는 해당 세션이 실행되는 위치에 따라 달라집니다. [`availableModels`](https://code.claude.com/docs/ko/model-config#restrict-model-selection)와 같은 모델 제한은 터미널 CLI와 동일한 방식으로 Desktop의 Claude Code 세션에 적용됩니다. [사용 환경별 적용 범위](https://code.claude.com/docs/ko/model-config.md#surface-coverage)를 참조하십시오.

2018 2023 

2019* **이 머신의 로컬 세션**: 디스크에 배포된 관리형 설정 파일이 적용됩니다. 세션이 [적격 로그인](https://code.claude.com/docs/ko/server-managed-settings.md#platform-availability)으로 인증하는 경우, 관리자 콘솔을 통해 원격으로 푸시된 관리형 설정도 Anthropic API를 사용하는 이러한 세션에 적용되며, 터미널 CLI와 동일한 [설정 우선순위](https://code.claude.com/docs/ko/settings.md#settings-precedence)를 따릅니다.2024* **이 머신의 로컬 세션**: 디스크에 배포된 관리형 설정 파일이 적용됩니다. 세션이 [적격 로그인](https://code.claude.com/docs/ko/server-managed-settings.md#platform-availability)으로 인증하는 경우, 관리자 콘솔을 통해 원격으로 푸시된 관리형 설정도 Anthropic API를 사용하는 이러한 세션에 적용되며, 터미널 CLI와 동일한 [설정 우선순위](https://code.claude.com/docs/ko/settings.md#settings-precedence)를 따릅니다.

2166| 필드 | 설명 |2166| 필드 | 설명 |

2167| :- | :- |2167| :- | :- |

2168| `behavior` | `"allow"`는 권한을 부여하고 `"deny"`는 거부합니다. [거부 및 확인 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)은 계속 평가되므로, `"allow"`를 반환하는 훅이 일치하는 거부 규칙을 재정의하지는 않습니다 |2168| `behavior` | `"allow"`는 권한을 부여하고 `"deny"`는 거부합니다. [거부 및 확인 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)은 계속 평가되므로, `"allow"`를 반환하는 훅이 일치하는 거부 규칙을 재정의하지는 않습니다 |

2169| `updatedInput` | `"allow"` 전용: 실행 전에 도구의 입력 매개변수를 수정합니다. 전체 입력 객체를 대체하므로 수정된 필드와 함께 변경되지 않은 필드도 포함해야 합니다. 수정된 입력은 거부 및 확인 규칙에 대해 다시 평가됩니다 |2169| `updatedInput` | `"allow"` 전용: 실행 전에 도구의 입력 매개변수를 수정합니다. 전체 입력 객체를 대체하므로 수정된 필드와 함께 변경되지 않은 필드도 포함하십시오. 수정된 입력은 거부 및 확인 규칙에 대해 다시 평가됩니다. `AskUserQuestion`과 `ExitPlanMode`에는 [이 필드가 필요합니다](#allow-with-updatedinput) |

2170| `updatedPermissions` | `"allow"` 전용: 허용 규칙 추가나 세션 권한 모드 변경 등 적용할 [권한 업데이트 항목](#permission-update-entries)의 배열입니다 |2170| `updatedPermissions` | `"allow"` 전용: 허용 규칙 추가나 세션 권한 모드 변경 등 적용할 [권한 업데이트 항목](#permission-update-entries)의 배열입니다 |

2171| `message` | `"deny"` 전용: 권한이 거부된 이유를 Claude에게 알립니다 |2171| `message` | `"deny"` 전용: 권한이 거부된 이유를 Claude에게 알립니다 |

2172| `interrupt` | `"deny"` 전용: `true`이면 Claude를 중지합니다 |2172| `interrupt` | `"deny"` 전용: `true`이면 Claude를 중지합니다 |

421 421 

422항상 허용하는 도구 호출에 대해서는 승인 대화 상자를 건너뜁니다. 이 예시는 Claude가 플랜 제시를 마치고 진행을 요청할 때 호출하는 도구인 `ExitPlanMode`를 자동 승인하므로, 플랜이 준비될 때마다 확인을 요청받지 않습니다.422항상 허용하는 도구 호출에 대해서는 승인 대화 상자를 건너뜁니다. 이 예시는 Claude가 플랜 제시를 마치고 진행을 요청할 때 호출하는 도구인 `ExitPlanMode`를 자동 승인하므로, 플랜이 준비될 때마다 확인을 요청받지 않습니다.

423 423 

424위의 종료 코드 예시와 달리, 자동 승인을 하려면 훅이 JSON 결정을 stdout에 출력해야 합니다. Claude Code는 사용자에게 권한을 요청하려고 할 때 `PermissionRequest` 훅을 실행하며, 훅이 `"behavior": "allow"`를 반환하면 Claude Code가 사용자를 대신하여 요청에 응답합니다.424위의 종료 코드 예시와 달리, 자동 승인을 하려면 훅이 JSON 결정을 stdout에 출력해야 합니다. Claude Code는 사용자에게 권한을 요청하려고 할 때 `PermissionRequest` 훅을 실행하며, 훅이 `"behavior": "allow"`를 반환하면 Claude Code가 사용자를 대신하여 요청에 응답합니다. `ExitPlanMode`처럼 [사용자 상호 작용이 필요한](https://code.claude.com/docs/ko/hooks.md#allow-with-updatedinput) 도구의 경우 허용 결정에 `updatedInput`도 포함해야 합니다. 그렇지 않으면 Claude Code는 이를 무시하고 여전히 프롬프트를 표시합니다.

425 425 

426matcher는 훅의 범위를 `ExitPlanMode`로만 한정하므로 다른 프롬프트에는 영향을 주지 않습니다. 다음을 `~/.claude/settings.json`에 추가하십시오.426matcher는 훅의 범위를 `ExitPlanMode`로만 한정하므로 다른 프롬프트에는 영향을 주지 않습니다. 다음을 `~/.claude/settings.json`에 추가하십시오.

427 427 

434 "hooks": [434 "hooks": [

435 {435 {

436 "type": "command",436 "type": "command",

437 "command": "echo '{\"hookSpecificOutput\": {\"hookEventName\": \"PermissionRequest\", \"decision\": {\"behavior\": \"allow\"}}}'"437 "command": "jq -c '{hookSpecificOutput: {hookEventName: \"PermissionRequest\", decision: {behavior: \"allow\", updatedInput: .tool_input}}}'"

438 }438 }

439 ]439 ]

440 }440 }

453>453>

454> Claude Code는 이를 `defaultMode`로 저장하지 않습니다.454> Claude Code는 이를 `defaultMode`로 저장하지 않습니다.

455 455 

456세션을 `acceptEdits`로 전환하려면 훅이 다음 JSON을 stdout에 출력합니다.456세션을 `acceptEdits`로 전환하려면 해당 훅의 `command` 줄을 다음 줄로 바꾸십시오.

457 457 

458```json theme={null}458```json theme={null}

459{459"command": "jq -c '{hookSpecificOutput: {hookEventName: \"PermissionRequest\", decision: {behavior: \"allow\", updatedInput: .tool_input, updatedPermissions: [{type: \"setMode\", mode: \"acceptEdits\", destination: \"session\"}]}}}'"

460 "hookSpecificOutput": {

461 "hookEventName": "PermissionRequest",

462 "decision": {

463 "behavior": "allow",

464 "updatedPermissions": [

465 { "type": "setMode", "mode": "acceptEdits", "destination": "session" }

466 ]

467 }

468 }

469}

470```460```

471 461 

472matcher는 가능한 한 좁게 유지하십시오. `.*`로 매칭하거나 matcher를 비워 두면 파일 쓰기와 셸 명령을 포함한 모든 도구 권한 프롬프트가 자동 승인됩니다. 전체 결정 필드는 [PermissionRequest 레퍼런스](https://code.claude.com/docs/ko/hooks.md#permissionrequest-decision-control)를 참조하십시오.462matcher는 가능한 한 좁게 유지하십시오. `.*`로 매칭하거나 matcher를 비워 두면 파일 쓰기와 셸 명령을 포함한 모든 도구 권한 프롬프트가 자동 승인됩니다. 전체 결정 필드는 [PermissionRequest 레퍼런스](https://code.claude.com/docs/ko/hooks.md#permissionrequest-decision-control)를 참조하십시오.

252 252 

253이 목록의 상태는 연결 시도가 아닌 구성 결정을 보고하므로 Claude Code는 서버에 연결하지 않고 인쇄합니다:253이 목록의 상태는 연결 시도가 아닌 구성 결정을 보고하므로 Claude Code는 서버에 연결하지 않고 인쇄합니다:

254 254 

255* ``⏸ Pending approval (run `claude` to approve)``: 아직 승인하지 않은 `.mcp.json`의 프로젝트 범위 서버입니다. Claude Code는 `claude mcp list`와 `claude mcp get <name>` 모두에 이 상태를 표시합니다. `claude`를 대화형으로 실행하여 검토하고 승인하십시오.255* ``⏸ Pending approval (run `claude` to approve)``: 아직 승인하지 않은 `.mcp.json`의 프로젝트 범위 서버입니다. Claude Code는 `claude mcp list`와 `claude mcp get <name>` 모두에 이를 표시합니다. `claude`를 대화형으로 실행하여 검토하고 승인하십시오.

256* `✘ Rejected (see disabledMcpjsonServers in settings)`: [`disabledMcpjsonServers`](https://code.claude.com/docs/ko/settings-reference#disabledmcpjsonservers) 항목이 거부하는 `.mcp.json` 서버입니다. Claude Code는 `claude mcp get <name>`에만 표시합니다.256* `✘ Rejected (see disabledMcpjsonServers in settings)`: [`disabledMcpjsonServers`](https://code.claude.com/docs/ko/settings-reference#disabledmcpjsonservers) 항목이 거부하는 `.mcp.json` 서버입니다. Claude Code는 `claude mcp get <name>`에만 표시합니다.

257* `⊘ Disabled for this project (re-enable via /mcp)`: 프로젝트의 [`disabledMcpServers`](#disable-a-server-without-removing-it) 목록이 이름을 지정하는 서버입니다. Claude Code는 `claude mcp list` 및 `claude mcp get <name>` 모두에 표시합니다. `/mcp` 패널에서 서버를 다시 켜세요.257* `⊘ Disabled for this project (re-enable via /mcp)`: 프로젝트의 [`disabledMcpServers`](#disable-a-server-without-removing-it) 목록이 이름을 지정하는 서버입니다. Claude Code는 `claude mcp list` 및 `claude mcp get <name>` 모두에 표시합니다. `/mcp` 패널에서 서버를 다시 켜세요.

258* `✘ Blocked by enterprise managed policy`: 조직의 정책 중 하나가 거부한 서버입니다. Claude Code는 이 상태를 `claude mcp list`와 `claude mcp get <name>` 모두에 표시합니다. [관리형 MCP 구성](https://code.claude.com/docs/ko/managed-mcp.md#how-restrictions-appear-to-users)의 허용 목록, 거부 목록 또는 기타 제한으로 차단된 서버는 이 상태로 표시되지 않고 두 명령 모두에서 숨겨집니다. 어떤 정책이 서버를 차단하는지 관리자에게 문의하십시오.258* `✘ Blocked by enterprise managed policy`: 조직의 정책 중 하나가 거부한 서버입니다. Claude Code는 이 상태를 `claude mcp list`와 `claude mcp get <name>` 모두에 표시합니다. [관리형 MCP 구성](https://code.claude.com/docs/ko/managed-mcp.md#how-restrictions-appear-to-users)의 허용 목록, 거부 목록 또는 기타 제한으로 차단된 서버는 이 상태로 표시되지 않고 두 명령 모두에서 숨겨집니다. 어떤 정책이 서버를 차단하는지 관리자에게 문의하십시오.

596 596 

597#### 작업으로 호출에 응답597#### 작업으로 호출에 응답

598 598 

599요청에 확장이 포함된 경우에만 작업으로 응답하세요. 그렇지 않으면 Claude는 `Unsupported result type 'task' for tools/call` 도구 오류를 받습니다. `taskId`, `status`, `createdAt`, `lastUpdatedAt` 또는 `ttlMs`가 누락된 경우에도 Claude는 같은 오류를 받습니다. 작업 객체는 `tools/call` 응답의 JSON-RPC `result`이며, `content` 배열이 필요하지 않습니다. 다음 예시에는 선택 사항인 `statusMessage`와 `pollIntervalMs`가 포함되어 있습니다.599요청에 확장이 포함된 경우에만 작업으로 응답하십시오. 그렇지 않으면 호출이 `Unsupported result type 'task' for tools/call` 도구 오류와 함께 실패합니다. 응답에 `taskId`가 없거나 유효한 `status`가 없어도 호출은 같은 방식으로 실패합니다. 작업 객체는 `tools/call` 응답의 JSON-RPC `result`이며, `content` 배열이 필요하지 않고, 여기서는 선택 사항인 `statusMessage`와 `pollIntervalMs`를 포함합니다.

600 600 

601```json theme={null}601```json theme={null}

602{602{

616| `resultType` | 응답을 작업으로 표시하려면 `"task"`로 설정합니다. 없으면 Claude Code는 응답을 일반 결과로 읽습니다 |616| `resultType` | 응답을 작업으로 표시하려면 `"task"`로 설정합니다. 없으면 Claude Code는 응답을 일반 결과로 읽습니다 |

617| `taskId` | 필수입니다. 공백 없는 출력 가능한 ASCII 문자 최대 128자여야 하며, 그렇지 않으면 Claude는 `MCP server "<name>" returned a malformed task handle for tool "<tool>"`로 시작하는 도구 오류를 받습니다. 재개 후 Claude Code는 새 연결에서 ID를 조회하므로, 연결이 바뀌어도 ID에 응답할 수 있도록 유지하세요 |617| `taskId` | 필수입니다. 공백 없는 출력 가능한 ASCII 문자 최대 128자여야 하며, 그렇지 않으면 Claude는 `MCP server "<name>" returned a malformed task handle for tool "<tool>"`로 시작하는 도구 오류를 받습니다. 재개 후 Claude Code는 새 연결에서 ID를 조회하므로, 연결이 바뀌어도 ID에 응답할 수 있도록 유지하세요 |

618| `status` | 필수입니다. `working`, `input_required`, `completed`, `failed`, `cancelled` 중 하나입니다. 다른 값은 `Unsupported result type` 오류를 발생시킵니다 |618| `status` | 필수입니다. `working`, `input_required`, `completed`, `failed`, `cancelled` 중 하나입니다. 다른 값은 `Unsupported result type` 오류를 발생시킵니다 |

619| `createdAt`, `lastUpdatedAt`, `ttlMs` | 필수이며, `ttlMs`는 `null`일 수 있습니다. Claude Code는 `ttlMs`가 지났다는 이유로 작업을 버리지 않습니다 |619| `createdAt`, `lastUpdatedAt`, `ttlMs` | tasks extension에서 필수이며, `ttlMs`는 `null`일 수 있습니다. Claude Code는 `ttlMs`가 지났다는 이유로 작업을 폐기하지 않습니다 |

620| `pollIntervalMs` | 선택 사항이지만 `null`일 수는 없습니다. `tasks/get` 요청 사이의 밀리초이며, 250에서 30000 사이로 제한됩니다. 필드가 없으면 Claude Code는 2000을 사용하며, 각 `tasks/get` 응답에서 값을 다시 읽습니다 |620| `pollIntervalMs` | 선택 사항입니다. `tasks/get` 요청 간 밀리초 간격이며, 250에서 30000 사이로 제한됩니다. 필드가 없거나 `null`이면 Claude Code는 2000을 사용하며, 각 `tasks/get` 응답에서 값을 다시 읽습니다 |

621| `statusMessage` | 선택 사항입니다. `/tasks`는 이 첫 응답이 아니라 최신 `tasks/get` 응답의 값을 표시하며, 필드를 생략한 응답은 값을 지웁니다. [Claude Code의 상태 메시지](#status-messages-on-an-mcp-task)가 대신 표시될 수 있습니다 |621| `statusMessage` | 선택 사항입니다. `/tasks`는 이 첫 응답이 아니라 최신 `tasks/get` 응답의 값을 표시하며, 필드를 생략한 응답은 값을 지웁니다. [Claude Code의 상태 메시지](#status-messages-on-an-mcp-task)가 대신 표시될 수 있습니다 |

622 622 

623Claude Code는 `createdAt`, `lastUpdatedAt` 또는 `ttlMs`를 생략하거나 `pollIntervalMs`를 `null`로 설정한 작업 응답을 받아들입니다. v2.1.317 이전에는 대신 `Unsupported result type` 오류와 함께 호출이 실패했습니다. 해당 버전에서도 작동하게 하려면 tasks extension이 요구하는 세 필드를 보내고, `pollIntervalMs`는 숫자로 보내거나 아예 보내지 마십시오.

624 

623HTTP 또는 claude.ai 커넥터 서버에서는 작업 응답이 [요청별 타이머](#time-limits-on-mcp-tool-calls) 안에 시작되어야 하므로, 작업을 수락하고 먼저 응답한 다음 작업을 수행하세요.625HTTP 또는 claude.ai 커넥터 서버에서는 작업 응답이 [요청별 타이머](#time-limits-on-mcp-tool-calls) 안에 시작되어야 하므로, 작업을 수락하고 먼저 응답한 다음 작업을 수행하세요.

624 626 

625#### 상태, 결과, 질문 보고627#### 상태, 결과, 질문 보고

41 41 

42* **기본 제공 파일 및 웹 도구**: Read, Edit, Write, WebFetch, WebSearch 같은 도구는 대신 [권한 규칙](https://code.claude.com/docs/ko/permissions.md)을 따릅니다. `denyRead` 항목은 Read 도구를 막지 않으며, `allowedDomains`는 WebFetch를 제한하지 않습니다42* **기본 제공 파일 및 웹 도구**: Read, Edit, Write, WebFetch, WebSearch 같은 도구는 대신 [권한 규칙](https://code.claude.com/docs/ko/permissions.md)을 따릅니다. `denyRead` 항목은 Read 도구를 막지 않으며, `allowedDomains`는 WebFetch를 제한하지 않습니다

43* **Claude Code가 시작하는 기타 프로세스**: 명령 [훅](https://code.claude.com/docs/ko/hooks.md), 로컬 [MCP 서버](https://code.claude.com/docs/ko/mcp.md), [플러그인 모니터](https://code.claude.com/docs/ko/plugins/components.md#monitors), [LSP 서버](https://code.claude.com/docs/ko/tools-reference.md#lsp-tool-behavior), 그리고 [상태줄](https://code.claude.com/docs/ko/statusline.md) 명령 및 `apiKeyHelper` 같은 헬퍼 명령은 사용자의 전체 접근 권한으로 실행됩니다43* **Claude Code가 시작하는 기타 프로세스**: 명령 [훅](https://code.claude.com/docs/ko/hooks.md), 로컬 [MCP 서버](https://code.claude.com/docs/ko/mcp.md), [플러그인 모니터](https://code.claude.com/docs/ko/plugins/components.md#monitors), [LSP 서버](https://code.claude.com/docs/ko/tools-reference.md#lsp-tool-behavior), 그리고 [상태줄](https://code.claude.com/docs/ko/statusline.md) 명령 및 `apiKeyHelper` 같은 헬퍼 명령은 사용자의 전체 접근 권한으로 실행됩니다

44* **Mod**: [mod](https://code.claude.com/docs/ko/plugins/mods/overview.md)는 Claude Code 내부에서 자체 코드를 실행하므로, mod의 파일 접근, 네트워크 요청, [`$.process`](https://code.claude.com/docs/ko/plugins/mods/api#reach-files-processes-and-the-network)로 시작한 프로그램은 샌드박스 처리되지 않습니다. [mod가 접근할 수 있는 항목](https://code.claude.com/docs/ko/plugins/mods/overview.md#what-a-mod-can-reach)을 참조하세요

44 45 

45설정에 따라 일부 셸 명령도 샌드박스 외부에서 실행됩니다.46설정에 따라 일부 셸 명령도 샌드박스 외부에서 실행됩니다.

46 47