41* [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 켜져 있는 동안 작업 디렉토리 외부의 읽기: 인식된 파일 읽기 Bash 명령어는 자동 모드 및 `bypassPermissions` 모드에서도 프롬프트하며, 샌드박스 외부에서 실행하기 위해 승인이 필요한 모든 [샌드박스 해제 재시도](https://code.claude.com/docs/ko/sandboxing.md#the-unsandboxed-retry-escape-hatch)도 마찬가지입니다. Claude Code v2.1.257 이상이 필요합니다.41* [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 켜져 있는 동안 작업 디렉토리 외부의 읽기: 인식된 파일 읽기 Bash 명령어는 자동 모드 및 `bypassPermissions` 모드에서도 프롬프트하며, 샌드박스 외부에서 실행하기 위해 승인이 필요한 모든 [샌드박스 해제 재시도](https://code.claude.com/docs/ko/sandboxing.md#the-unsandboxed-retry-escape-hatch)도 마찬가지입니다. Claude Code v2.1.257 이상이 필요합니다.
42 42
43 셸 파서가 추적할 수 없는 명령어(예: 두 번 이상 디렉토리를 변경하거나 서브셸을 실행하는 명령어)는 외부 경로를 명명하지 않더라도 동일한 방식으로 프롬프트합니다. 이 프롬프트는 명령어가 [샌드박스](https://code.claude.com/docs/ko/sandboxing.md)에서 실행되고 샌드박스가 블록을 적용할 때는 적용되지 않습니다.43 셸 파서가 추적할 수 없는 명령어(예: 두 번 이상 디렉토리를 변경하거나 서브셸을 실행하는 명령어)는 외부 경로를 명명하지 않더라도 동일한 방식으로 프롬프트합니다. 이 프롬프트는 명령어가 [샌드박스](https://code.claude.com/docs/ko/sandboxing.md)에서 실행되고 샌드박스가 블록을 적용할 때는 적용되지 않습니다.
44* [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockwritesoutsideworkingdirectories)가 켜져 있는 동안 작업 디렉터리 외부의 쓰기: Claude Code는 [자체 파일 일부](https://code.claude.com/docs/ko/settings-reference.md#what-the-write-block-refuses-and-what-stays-writable)를 제외하고 해당 위치에 대한 `Write`, `Edit`, `NotebookEdit` 호출을 거부합니다. 이 키는 셸 명령, MCP 도구 또는 훅이 실행하는 프로그램을 제한하지 않으므로, 셸 명령이 쓰는 위치를 제한하려면 [샌드박싱](https://code.claude.com/docs/ko/sandboxing.md)을 사용하십시오. Claude Code v2.1.314 이상이 필요합니다.
44 45
45## 일반적인 설정46## 일반적인 설정
46 47
327 328
328## 자동 모드로 권한 프롬프트 없애기329## 자동 모드로 권한 프롬프트 없애기
329 330
330자동 모드를 사용하면 Claude가 일상적인 권한 프롬프트 없이 작업을 실행합니다. 별도의 분류기 모델이 작업 실행 전에 이를 검토하여, 사용자의 요청 범위를 넘어서는 작업, 인식되지 않은 인프라를 대상으로 하는 작업, 또는 Claude가 읽은 악의적인 콘텐츠에 의해 유도된 것으로 보이는 작업을 차단합니다. 명시적인 [ask 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)은 여전히 프롬프트를 강제합니다.331자동 모드를 사용하면 Claude가 일상적인 권한 프롬프트 없이 실행할 수 있습니다. 별도의 분류기 모델이 작업을 실행 전에 검토하여, 요청 범위를 넘어서는 작업, 인식되지 않은 인프라를 대상으로 하는 작업, 또는 Claude가 읽은 악의적인 콘텐츠에 의해 유도된 것으로 보이는 작업을 차단합니다. 명시적인 [ask 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)은 여전히 프롬프트를 강제합니다.
331 332
332Claude Code v2.1.283 이상에서는 모든 플랜과 제공업체에서 대화형 터미널 및 VS Code 세션의 [기본 제공 시작 권한 모드](#which-mode-a-session-starts-in)가 자동 모드입니다. 이전 버전에서는 Pro, Max, Ultra, Team 플랜에서만 기본 제공 시작 권한 모드입니다.333Claude Code v2.1.283 이상에서는 모든 플랜과 제공자에서 자동 모드가 대화형 터미널 및 VS Code 세션의 [기본 제공 시작 권한 모드](#which-mode-a-session-starts-in)입니다. 이전 버전에서는 Pro, Max, Ultra, Team 플랜에서만 기본 제공 시작 권한 모드입니다.
333 334
334분류기는 Claude가 [`SendMessage`](https://code.claude.com/docs/ko/tools-reference)로 다른 에이전트에 보내는 각 메시지도, 일반 텍스트이든 구조화된 [에이전트 팀](https://code.claude.com/docs/ko/agent-teams.md) 메시지이든, Claude Code가 전달하기 전에 검토합니다. 이는 자동 모드와 [분류기가 명령을 검토하는 동안의 플랜 모드](#analyze-before-you-edit-with-plan-mode) 모두에서 적용되며, 전송 검토에는 Claude Code v2.1.222 이상이 필요합니다.335분류기는 Claude가 [`SendMessage`](https://code.claude.com/docs/ko/tools-reference)로 다른 에이전트에 보내는 각 메시지도 Claude Code가 전달하기 전에 검토합니다. 일반 텍스트든 구조화된 [에이전트 팀](https://code.claude.com/docs/ko/agent-teams.md) 메시지든 마찬가지이며, 자동 모드와 [분류기가 명령을 검토하는 동안의 플랜 모드](#analyze-before-you-edit-with-plan-mode) 모두에서 적용됩니다. 전송 검토에는 Claude Code v2.1.222 이상이 필요합니다.
335 336
336기본적으로 분류기는 `rm -rf /` 또는 `rm -rf ~`와 같이 인식된 `rm` 및 `rmdir` 중요 경로 삭제를 검토하지 않습니다. 각 권한 모드에서 이러한 삭제가 어떻게 처리되는지는 [중요 경로](#critical-paths)에서 다룹니다.337기본적으로 분류기는 `rm -rf /` 또는 `rm -rf ~`와 같이 인식된 `rm` 및 `rmdir` 핵심 경로 삭제를 검토하지 않습니다. [핵심 경로](#critical-paths)에서 각 권한 모드에서 이러한 삭제가 어떻게 처리되는지 설명합니다.
337 338
338자동 모드는 또한 Claude가 명확히 하기 위한 질문으로 멈추지 않고 작업을 계속하도록 유도하지만, 사용자의 프롬프트나 스킬이 명시적으로 질문에 의존하는 경우에는 여전히 질문합니다. 여전히 확인을 요청하는 모드에서 더 강한 자율적 동작을 원한다면 대신 [Proactive 출력 스타일](https://code.claude.com/docs/ko/output-styles.md)을 설정하십시오.339자동 모드는 또한 Claude가 명확화 질문을 위해 멈추지 않고 계속 작업하도록 유도하지만, 프롬프트나 스킬이 명시적으로 질문에 의존하는 경우에는 Claude가 여전히 질문합니다. 여전히 확인을 요청하는 모드에서 더 강한 자율적 동작을 원한다면 대신 [Proactive 출력 스타일](https://code.claude.com/docs/ko/output-styles.md)을 설정하십시오.
339 340
340> [!WARNING]341> [!WARNING]
341>342>
342> 자동 모드는 권한 프롬프트를 줄여 주지만 안전을 보장하지는 않습니다. 전반적인 방향을 신뢰할 수 있는 작업에 사용하고, 민감한 작업에 대한 검토를 대체하는 용도로 사용하지 마십시오.343> 자동 모드는 권한 프롬프트를 줄여 주지만 안전을 보장하지는 않습니다. 전반적인 방향을 신뢰할 수 있는 작업에 사용하고, 민감한 작업에 대한 검토를 대체하는 수단으로 사용하지 마십시오.
343 344
344자동 모드는 계정이 다음 요구 사항을 모두 충족하는 경우에만 사용할 수 있습니다.345자동 모드는 계정이 다음 요구 사항을 모두 충족하는 경우에만 사용할 수 있습니다.
345 346
346* **플랜**: 모든 플랜.347* **플랜**: 모든 플랜.
347* **조직**: Team 및 Enterprise에서는 자동 모드를 기본적으로 사용할 수 있습니다. 관리자는 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에서 `permissions.disableAutoMode`를 `"disable"`로 설정하여 조직 전체에서 이 기능을 끌 수 있습니다.348* **조직**: Team 및 Enterprise에서는 자동 모드를 기본적으로 사용할 수 있습니다. 관리자는 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에서 `permissions.disableAutoMode`를 `"disable"`로 설정하여 조직 전체에서 끌 수 있습니다.
348* **모델**: Anthropic API와 [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md)에서는 Claude Opus 4.6 이상, Sonnet 4.6 이상, Haiku 5.5 또는 [Fable 모델](https://code.claude.com/docs/ko/model-config.md#work-with-fable). Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 및 로그인된 [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 세션에서는 Claude Sonnet 5 이상, Opus 4.7 이상, Haiku 5.5 및 Fable 모델만 지원됩니다. Sonnet 4.5, Opus 4.5, Haiku 4.5 및 claude-3 모델을 포함한 이전 모델은 어떤 제공업체에서도 지원되지 않습니다.349* **모델**: Anthropic API 및 [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md)에서는 Claude Opus 4.6 이상, Sonnet 4.6 이상, Haiku 5.5 또는 [Fable 모델](https://code.claude.com/docs/ko/model-config.md#work-with-fable). Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry 및 로그인된 [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 세션에서는 Claude Sonnet 5 이상, Opus 4.7 이상, Haiku 5.5 및 Fable 모델만 지원됩니다. Sonnet 4.5, Opus 4.5, Haiku 4.5 및 claude-3 모델을 포함한 이전 모델은 어떤 제공자에서도 지원되지 않습니다.
349* **제공업체**: Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 및 로그인된 Claude apps gateway 세션에서 기본적으로 사용할 수 있습니다.350* **제공자**: Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry 및 로그인된 Claude apps gateway 세션에서 기본적으로 사용할 수 있습니다.
350 351
351Claude Code에서 자동 모드를 사용할 수 없다고 보고하면, 먼저 이러한 요구 사항과 설정 파일에서 [`disableAutoMode`](https://code.claude.com/docs/ko/settings-reference#disableautomode)를 설정하고 있는지 확인하십시오. Anthropic이 서버 측에서 자동 모드를 꺼 두었거나, 서버가 해당 계정에 대해 자동 모드를 거부했을 수도 있습니다. 이러한 응답 중 하나를 받은 세션은 세션이 끝날 때까지 자동 모드가 꺼진 상태로 유지되므로, 나중에 새 세션을 시작하십시오.352Claude Code가 자동 모드를 사용할 수 없다고 보고하면, 먼저 이 요구 사항과 설정 파일 중 [`disableAutoMode`](https://code.claude.com/docs/ko/settings-reference#disableautomode)를 설정한 파일이 있는지 확인하십시오. Anthropic이 서버 측에서 자동 모드를 껐거나, 서버가 해당 계정에 대해 자동 모드를 거부했을 수도 있습니다. 이 중 하나의 응답을 받은 세션은 세션이 끝날 때까지 자동 모드를 끈 상태로 유지하므로, 나중에 새 세션을 시작하십시오.
352 353
353모델 이름을 언급하며 자동 모드가 작업의 "안전성을 판단할 수 없다"고 알리는 별도의 메시지는 분류기 요청이 실패했음을 의미합니다. 이러한 실패는 대개 일시적이지만, Amazon Bedrock에서는 계정이 해당 모델을 호출할 수 있을 때까지 반복될 수 있습니다. 원인과 해결 방법은 [오류 참조](https://code.claude.com/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)를 참조하십시오.354모델 이름을 언급하며 자동 모드가 작업의 "안전성을 판단할 수 없다(cannot determine the safety)"고 알리는 별도의 메시지는 분류기 요청이 실패했다는 의미입니다. 이 실패는 대개 일시적이지만, Amazon Bedrock에서는 계정이 해당 모델을 호출할 수 있게 될 때까지 반복될 수 있습니다. 원인과 조치 방법은 [오류 참조](https://code.claude.com/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)를 참조하십시오.
354 355
355[설정](https://code.claude.com/docs/ko/settings-reference.md#all-settings)에서 `defaultMode: "auto"`를 설정했는데 터미널 세션이 오류 없이 Manual 모드로 시작된다면, 해당 설정이 `.claude/settings.json` 또는 `.claude/settings.local.json`에 있을 가능성이 높습니다. `auto`는 이러한 파일에서는 적용되지 않습니다. `~/.claude/settings.json`으로 옮기십시오. VS Code 확장 프로그램이 시작한 대화의 경우에는 대신 [권한 모드 전환](#switch-permission-modes)에 있는 확장 프로그램 자체 목록을 확인하십시오.356[설정](https://code.claude.com/docs/ko/settings-reference.md#all-settings)에서 `defaultMode: "auto"`를 설정했는데 터미널 세션이 오류 없이 Manual 모드로 시작된다면, 해당 설정이 `.claude/settings.json` 또는 `.claude/settings.local.json`에 있을 가능성이 높습니다. `auto`는 이 파일들에서는 적용되지 않습니다. `~/.claude/settings.json`으로 옮기십시오. VS Code 확장 프로그램이 시작한 대화의 경우에는 대신 [권한 모드 전환](#switch-permission-modes)에 있는 확장 프로그램 자체의 목록을 확인하십시오.
356 357
357### Bedrock, Agent Platform 또는 Foundry에서의 자동 모드358### Bedrock, Agent Platform 또는 Foundry에서의 자동 모드
358 359
359[Amazon Bedrock](https://code.claude.com/docs/ko/amazon-bedrock.md), [Google Cloud의 Agent Platform](https://code.claude.com/docs/ko/google-vertex-ai.md), [Microsoft Foundry](https://code.claude.com/docs/ko/microsoft-foundry.md) 및 로그인된 [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 세션에서는 자동 모드를 기본적으로 사용할 수 있습니다. 이러한 환경에서 권한 모드를 설정하지 않으면 대화형 세션은 자동 모드로 시작되고, `claude -p` 또는 Agent SDK 실행은 구성 값이 `default`인 Manual 모드로 시작됩니다.360[Amazon Bedrock](https://code.claude.com/docs/ko/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/ko/google-vertex-ai.md), [Microsoft Foundry](https://code.claude.com/docs/ko/microsoft-foundry.md) 및 로그인된 [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 세션에서는 자동 모드를 기본적으로 사용할 수 있습니다. 권한 모드를 설정하지 않으면 대화형 세션은 자동 모드로 시작되고, `claude -p` 또는 Agent SDK 실행은 구성 값이 `default`인 Manual 모드로 시작됩니다.
360 361
361* **대화형 터미널 및 VS Code 세션**: 자동 이외의 권한 모드로 시작하려면 [다른 권한 모드로 시작하기](#start-in-a-different-mode)에 설명된 대로 `permissions.defaultMode`를 설정하거나, VS Code 확장 프로그램의 [모드 표시기](#switch-permission-modes)에서 모드를 선택하십시오. 이러한 세션을 자동 모드로 시작하는 Claude Code 버전은 [세션이 시작되는 모드](#which-mode-a-session-starts-in)에 나와 있습니다.362* **대화형 터미널 및 VS Code 세션**: 자동 모드가 아닌 다른 권한 모드로 시작하려면 [다른 권한 모드로 시작하기](#start-in-a-different-mode)에 설명된 대로 `permissions.defaultMode`를 설정하거나, VS Code 확장 프로그램의 [모드 표시기](#switch-permission-modes)에서 선택하십시오. [세션이 시작되는 모드](#which-mode-a-session-starts-in)에 이러한 세션을 자동 모드로 시작하는 Claude Code 버전이 나와 있습니다.
362* **`claude -p` 및 Agent SDK 실행**: 자동 모드로 시작하려면 `claude -p`에 `--permission-mode auto`를 전달하거나, TypeScript에서는 `permissionMode: "auto"`를, Python에서는 `permission_mode="auto"`를 전달하십시오. 권한 모드를 전달하지 않는 경우에는 [`claude -p` 및 Agent SDK 실행에서 거부되는 도구 호출](#which-mode-a-non-interactive-run-starts-in)을 참조하십시오. 이 섹션은 이전 Claude Code 버전도 다룹니다.363* **`claude -p` 및 Agent SDK 실행**: 자동 모드로 시작하려면 `claude -p`에 `--permission-mode auto`를 전달하거나, TypeScript에서는 `permissionMode: "auto"`, Python에서는 `permission_mode="auto"`를 전달하십시오. 권한 모드를 전달하지 않는 경우에는 [`claude -p` 및 Agent SDK 실행에서 거부되는 도구 호출](#which-mode-a-non-interactive-run-starts-in)을 참조하십시오. 이 섹션은 이전 Claude Code 버전도 다룹니다.
363 364
364이러한 제공업체에서는 Claude Sonnet 5 이상, Opus 4.7 이상, Haiku 5.5 및 Fable 모델만 지원됩니다. 다른 모델에서는 세션이 대신 Manual로 시작됩니다. 이러한 제공업체에서 Haiku 5.5로 자동 모드를 사용하려면 Claude Code v2.1.293 이상이 필요합니다.365이 제공자들에서는 Claude Sonnet 5 이상, Opus 4.7 이상, Haiku 5.5 및 Fable 모델만 지원됩니다. 그 외의 모델에서는 세션이 대신 Manual로 시작됩니다. 이 제공자들에서 Haiku 5.5로 자동 모드를 사용하려면 Claude Code v2.1.293 이상이 필요합니다.
365 366
366개발자가 자동 모드를 사용하지 못하도록 하려면 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에서 `disableAutoMode`를 `"disable"`로 설정하십시오. 이렇게 하면 `Shift+Tab` 순환에서 `auto`가 제거되고, `--permission-mode auto`로 시작한 세션은 대신 Manual로 시작됩니다. 이미 자동 모드로 실행 중인 세션은 이 설정이 [관리자가 배포한 소스](https://code.claude.com/docs/ko/managed-settings.md#which-managed-source-claude-code-uses)에서 해당 세션에 도달하면 자동 모드를 벗어나고 `auto mode disabled by settings`를 표시합니다. v2.1.251 이전에는 실행 중인 세션이 종료될 때까지 자동 모드를 유지했습니다.367개발자가 자동 모드를 사용하지 못하게 하려면 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에서 `disableAutoMode`를 `"disable"`로 설정하십시오. 그러면 `Shift+Tab` 순환에서 `auto`가 제거되고, `--permission-mode auto`로 시작한 세션은 대신 Manual로 시작됩니다. 이미 자동 모드로 실행 중인 세션은 [관리자가 배포한 소스](https://code.claude.com/docs/ko/managed-settings.md#which-managed-source-claude-code-uses)에서 이 설정이 해당 세션에 도달하면 자동 모드를 종료하고 `auto mode disabled by settings`를 표시합니다. v2.1.251 이전에는 실행 중인 세션이 종료될 때까지 자동 모드를 유지했습니다.
367 368
368### 서버 측 분류기 검토369### 서버 측 분류기 검토
369 370
370자동 모드에서 Claude Code는 자체 분류기 요청을 보내는 대신, 세션의 모델 요청의 일부로 [결정 순서](#how-the-classifier-evaluates-actions)가 검토 대상으로 보내는 작업을 확인하도록 서버에 요청할 수 있습니다. 다음 세션이 서버에 요청합니다.371자동 모드에서 Claude Code는 자체 분류기 요청을 보내는 대신, 세션의 모델 요청의 일부로 [결정 순서](#how-the-classifier-evaluates-actions)가 검토 대상으로 보내는 작업을 확인하도록 서버에 요청할 수 있습니다. 다음 세션이 서버에 요청합니다.
371 372
372* **Anthropic API에 대한 직접 연결**: 플랜이나 계정 유형에 관계없이 대화형 터미널 세션과 `-p`, Agent SDK, [VS Code 확장 프로그램](https://code.claude.com/docs/ko/vs-code.md), [데스크톱 앱](https://code.claude.com/docs/ko/desktop.md) 세션에서, Anthropic이 순차적으로 배포함에 따라 적용됩니다. 세션 유형에 해당하는 최소 Claude Code 버전을 확인하십시오.373* **Anthropic API에 대한 직접 연결**: 대화형 터미널 세션과 `-p`, Agent SDK, [VS Code 확장 프로그램](https://code.claude.com/docs/ko/vs-code.md), [데스크톱 앱](https://code.claude.com/docs/ko/desktop.md) 세션에서, 플랜이나 계정 유형에 관계없이 Anthropic이 순차적으로 배포함에 따라 적용됩니다. 세션 유형에 따라 다음 최소 Claude Code 버전을 확인하십시오.
373 * 대화형 터미널 세션에서 서버에 요청하려면 Pro, Max, Ultra, Team 플랜의 경우 Claude Code v2.1.271 이상이 필요합니다. Enterprise 플랜과 Claude API 계정에서는 이러한 세션에 v2.1.278 이상이 필요합니다.374 * 대화형 터미널 세션에서 서버에 요청하려면 Pro, Max, Ultra, Team 플랜에서 Claude Code v2.1.271 이상이 필요합니다. Enterprise 플랜 및 Claude API 계정에서는 해당 세션에 v2.1.278 이상이 필요합니다.
374 * `-p`, Agent SDK, VS Code 확장 프로그램 및 데스크톱 앱 세션에서 서버에 요청하려면 Claude Code v2.1.281 이상이 필요합니다375 * `-p`, Agent SDK, VS Code 확장 프로그램 및 데스크톱 앱 세션에서 서버에 요청하려면 Claude Code v2.1.281 이상이 필요합니다
375 * v2.1.282부터는 예를 들어 텔레메트리를 꺼서 [기능 플래그를 가져오지 않는](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) 세션은 어떤 종류의 세션에서든 기본적으로 서버에 요청합니다376 * v2.1.282부터는 텔레메트리를 끈 경우 등 [기능 플래그를 가져오지 않는](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) 세션이 모든 종류의 세션에서 기본적으로 서버에 요청합니다
376* **클라우드 제공업체 또는 LLM 게이트웨이나 프록시**: [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry에서, 그리고 `ANTHROPIC_BASE_URL`을 [LLM 게이트웨이 또는 프록시](https://code.claude.com/docs/ko/llm-gateway)로 지정할 때마다, 플랜에 관계없이 적용됩니다. 기본적으로 요청하려면 Claude Code v2.1.278 이상이 필요합니다.377* **클라우드 제공자 또는 LLM 게이트웨이나 프록시**: [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry에서, 그리고 `ANTHROPIC_BASE_URL`을 [LLM 게이트웨이 또는 프록시](https://code.claude.com/docs/ko/llm-gateway)로 지정할 때마다, 플랜에 관계없이 적용됩니다. 기본적으로 요청하려면 Claude Code v2.1.278 이상이 필요합니다.
377* **로그인된 [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 세션**: Claude Code v2.1.280 이상이 필요합니다378* **로그인된 [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 세션**: Claude Code v2.1.280 이상이 필요합니다
378* **Anthropic 호스팅 환경의 [클라우드 세션](https://code.claude.com/docs/ko/claude-code-on-the-web.md)**: 플랜에 관계없이, 웹, 모바일 앱 또는 **Cloud**를 선택한 데스크톱 앱에서 시작할 때 적용됩니다. [클라우드 예약 작업](https://code.claude.com/docs/ko/routines.md)으로 시작된 세션은 Anthropic이 순차적으로 배포함에 따라 서버에 요청합니다.379* **Anthropic 호스팅 환경의 [클라우드 세션](https://code.claude.com/docs/ko/claude-code-on-the-web.md)**: 웹, 모바일 앱 또는 **Cloud**를 선택한 데스크톱 앱에서 시작하는 경우 플랜에 관계없이 적용됩니다. [클라우드 예약 작업](https://code.claude.com/docs/ko/routines.md)으로 시작된 세션은 Anthropic이 순차적으로 배포함에 따라 서버에 요청합니다.
379 380
380서버가 작업을 검토하는 경우 서버의 판정이 작업을 결정합니다. 그 밖에 두 가지 결과가 가능합니다.381서버가 작업을 검토하는 경우 서버의 판정이 작업을 결정합니다. 그 밖에 두 가지 결과가 있을 수 있습니다.
381 382
382* **서버가 세션을 검토하지 않는 경우**: 응답이 검토 결과 없이 완료되거나, 서버가 이 세션을 검토하지 않는다고 응답합니다. 가장 흔한 원인은 검토 요청이나 결과를 누락시키는 LLM 게이트웨이나 프록시, 그리고 아직 서버 측 확인을 지원하지 않는 플랫폼, 리전 또는 자격 증명입니다. Claude Code는 자체 분류기 요청으로 폴백합니다. 이 폴백이 세션의 나머지 기간 동안 유지되면, 해당 요청이 과금되는 계정에서는 [분류기 요청 요금에 대한 알림](https://code.claude.com/docs/ko/auto-mode-classifier-billing.md)을 표시합니다.383* **서버가 세션을 검토하지 않음**: 응답이 검토 결과 없이 완료되거나, 서버가 이 세션을 검토하지 않는다고 응답합니다. 가장 흔한 원인은 검토 요청이나 결과를 누락시키는 LLM 게이트웨이 또는 프록시, 그리고 아직 서버 측 검사를 지원하지 않는 플랫폼, 리전 또는 자격 증명입니다. Claude Code는 자체 분류기 요청으로 폴백합니다. 이 폴백이 세션의 나머지 기간 동안 유지되면, 해당 요청이 과금되는 계정에서 [분류기 요청 요금에 대한 알림](https://code.claude.com/docs/ko/auto-mode-classifier-billing.md)을 표시합니다.
383* **서버가 작업에 대한 판정을 내리지 않는 경우**: Claude Code는 검토되지 않은 작업을 실행하지 않고 거부합니다. 어떤 연결에서든 검토 결과가 도착하기 전에 응답이 끝나거나, Claude Code가 읽을 수 없는 형식으로 결과가 도착하면 이런 일이 발생합니다. 응답을 중간에 잘라내거나 결과를 다시 쓰는 LLM 게이트웨이나 프록시가 둘 다의 원인이 될 수 있습니다. Anthropic API에 직접 연결된 경우, 예를 들어 시간 초과로 인해 서버의 확인이 해당 작업에 대해 실패할 때도 이런 일이 발생합니다. 거부 메시지, 거부가 반복될 때 일어나는 일, 해결 방법은 [The server returned no safety verdict](https://code.claude.com/docs/ko/errors.md#the-server-returned-no-safety-verdict)에서 다룹니다.384* **서버가 작업에 대한 판정을 내리지 않음**: Claude Code는 검토되지 않은 상태로 실행하는 대신 작업을 거부합니다. 모든 연결에서 이는 검토 결과가 도착하기 전에 응답이 끝나거나, Claude Code가 읽을 수 없는 형식으로 결과가 도착할 때 발생합니다. 응답을 중간에 자르거나 결과를 다시 쓰는 LLM 게이트웨이 또는 프록시가 두 가지 모두의 원인이 될 수 있습니다. Anthropic API에 직접 연결된 경우에는 시간 초과 등으로 해당 작업에 대한 서버 검사가 실패할 때도 발생합니다. [서버가 안전 판정을 반환하지 않음](https://code.claude.com/docs/ko/errors.md#the-server-returned-no-safety-verdict)에서 거부 메시지, 거부가 반복될 때의 동작, 조치 방법을 설명합니다.
384 385
385서버에 요청하지 않고 항상 Claude Code의 자체 분류기 요청을 사용하려면 [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/ko/env-vars)을 설정하십시오. Anthropic API에 직접 연결된 경우 이 변수에는 Claude Code v2.1.281 이상이 필요합니다. 여기서 이 변수를 `1`로 설정하면, `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`도 함께 설정하지 않은 한, 아직 서버 검토가 적용되지 않은 세션에서 서버 검토가 켜집니다. `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`을 설정하고 `CLAUDE_CODE_AUTO_MODE_SERVER`를 설정하지 않으면, [사전 출시 기능 비활성화](https://code.claude.com/docs/ko/llm-gateway-protocol.md#disable-pre-release-capabilities)에 설명된 경우를 제외하고 Claude Code는 서버에 요청하는 것도 중단합니다.386서버 요청을 건너뛰고 항상 Claude Code 자체 분류기 요청을 사용하려면 [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/ko/env-vars)을 설정하십시오. Anthropic API에 직접 연결된 경우 이 변수에는 Claude Code v2.1.281 이상이 필요합니다. 이 환경에서 값을 `1`로 설정하면, `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`도 함께 설정하지 않은 한 아직 서버 검토가 적용되지 않은 세션에서 서버 검토가 켜집니다. `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`을 설정하고 `CLAUDE_CODE_AUTO_MODE_SERVER`를 설정하지 않으면, [사전 출시 기능 비활성화](https://code.claude.com/docs/ko/llm-gateway-protocol.md#disable-pre-release-capabilities)에 설명된 경우를 제외하고 Claude Code도 서버 요청을 중단합니다.
386 387
387### 기본 분류기 모델388### 기본 분류기 모델
388 389
389기본적으로 분류기 요청은 Claude Sonnet 5로 전송됩니다. `/status`에 `Auto mode server`가 `Enabled`로 표시되면, 분류기 요청은 [서버의 검토](#server-side-classifier-review) 대상이 아닌 호출에 대해서만 전송됩니다.390기본적으로 분류기 요청은 Claude Sonnet 5로 전송됩니다. `/status`에 `Auto mode server`가 `Enabled`로 표시되면, [서버의 검토](#server-side-classifier-review) 범위 밖의 호출에 대해서만 요청이 전송됩니다.
390 391
391이 표에서 세션과 일치하는 첫 번째 행을 찾으십시오. Sonnet 5 대신 해당 행의 모델이 사용됩니다.392이 표에서 세션에 해당하는 첫 번째 행을 찾으십시오. Sonnet 5 대신 해당 행의 모델이 사용됩니다.
392 393
393| 세션 | 분류기 모델 |394| 세션 | 분류기 모델 |
394| - | - |395| - | - |
395| Anthropic이 구성한 분류기 모델이 있음 | 구성된 모델. 어떤 모델인지는 [디버그 로그를 확인](#classifier-model-check)하십시오 |396| Anthropic이 구성한 분류기 모델이 있음 | 구성된 모델. 어떤 모델인지 확인하려면 [디버그 로그를 확인](#classifier-model-check)하십시오 |
396| Claude Sonnet 4.6에서 실행됨 | Sonnet 4.6 |397| Claude Sonnet 4.6에서 실행 | Sonnet 4.6 |
397| [`ANTHROPIC_DEFAULT_SONNET_MODEL`](https://code.claude.com/docs/ko/model-config#environment-variables)이 설정됨 | 해당 값. 값이 Claude Sonnet 5.5 또는 Claude Opus 5.5이면 Sonnet 5 |398| [`ANTHROPIC_DEFAULT_SONNET_MODEL`](https://code.claude.com/docs/ko/model-config#environment-variables)이 설정됨 | 해당 값. 값이 Claude Sonnet 5.5 또는 Claude Opus 5.5이면 Sonnet 5 |
398 399
399Sonnet 5 또는 `ANTHROPIC_DEFAULT_SONNET_MODEL`의 모델을 제공업체에서 사용할 수 없거나 조직의 [모델 정책](https://code.claude.com/docs/ko/model-config.md#restrict-model-selection)에서 제외한 경우, Claude Code는 대체 모델을 사용합니다. 이는 세션의 모델이며, [Fable 세션](https://code.claude.com/docs/ko/model-config.md#work-with-fable)에서는 Opus 모델입니다.400Sonnet 5 또는 `ANTHROPIC_DEFAULT_SONNET_MODEL`의 모델을 제공자에서 사용할 수 없거나 조직의 [모델 정책](https://code.claude.com/docs/ko/model-config.md#restrict-model-selection)에서 제외된 경우, Claude Code는 대체 모델을 사용합니다. 대체 모델은 세션의 모델이거나, [Fable 세션](https://code.claude.com/docs/ko/model-config.md#work-with-fable)에서는 Opus 모델입니다.
400 401
401### 분류기 모델 선택402### 분류기 모델 선택
402 403
403Claude Code v2.1.302 이상에서는 [`CLAUDE_CODE_AUTO_MODE_MODEL`](https://code.claude.com/docs/ko/env-vars)을 전체 모델 ID로 설정하여 [기본값](#default-classifier-model)이 아닌 모델에서 분류기를 실행할 수 있습니다. 클라우드 제공업체 자체의 전체 모델 ID도 사용할 수 있습니다. 다음 `~/.claude/settings.json` 예시는 Claude Sonnet 4.6을 설정합니다.404Claude Code v2.1.302 이상에서는 [`CLAUDE_CODE_AUTO_MODE_MODEL`](https://code.claude.com/docs/ko/env-vars)을 전체 모델 ID로 설정하여 [기본값](#default-classifier-model)이 아닌 모델에서 분류기를 실행할 수 있습니다. 클라우드 제공자 자체의 전체 모델 ID도 사용할 수 있습니다. 다음 `~/.claude/settings.json` 예시는 Claude Sonnet 4.6을 설정합니다.
404 405
405```json theme={null}406```json theme={null}
406{407{
410}411}
411```412```
412 413
413#### 설정한 모델이 검토하지 않는 경우414#### 지정한 모델이 검토하지 않는 경우
414 415
415| 상황 | 결과 | 조치 |416| 상황 | 결과 | 조치 방법 |
416| - | - | - |417| - | - | - |
417| [디버그 로그](#classifier-model-check)에 Anthropic이 구성한 분류기 모델이 보고됨 | 해당 모델이 검토함 | 조치 필요 없음 |418| [디버그 로그](#classifier-model-check)에 Anthropic이 구성한 분류기 모델이 보고됨 | 해당 모델이 검토합니다 | 조치 필요 없음 |
418| Claude Opus 5, Sonnet 5.5, Opus 5.5 또는 조직의 [모델 정책](https://code.claude.com/docs/ko/model-config.md#restrict-model-selection)에서 제외한 모델을 설정함 | [기본 분류기 모델](#default-classifier-model)이 검토함 | 다른 모델 설정 |419| Claude Opus 5, Sonnet 5.5, Opus 5.5 또는 조직의 [모델 정책](https://code.claude.com/docs/ko/model-config.md#restrict-model-selection)에서 제외된 모델을 설정함 | [기본 분류기 모델](#default-classifier-model)이 검토합니다 | 다른 모델을 설정하십시오 |
419| 제공업체가 해당 모델을 제공할 수 없음 | 분류기 확인이 실패하므로 Claude Code가 [확인하는 각 작업을 거부함](https://code.claude.com/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) | 제공업체가 제공하는 모델을 설정하거나 변수 제거 |420| 제공자가 해당 모델을 제공할 수 없음 | 분류기 검사가 실패하므로 Claude Code가 [검사하는 각 작업을 거부](https://code.claude.com/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)합니다 | 제공자가 제공하는 모델을 설정하거나 변수를 제거하십시오 |
420| 세션에서 `/status`에 [`Auto mode server`](#server-side-classifier-review)가 `Enabled`로 표시됨 | 설정한 모델 없이 서버가 검토함 | 조치 필요 없음 |421| 세션에서 `/status`에 [`Auto mode server`](#server-side-classifier-review)가 `Enabled`로 표시됨 | 지정한 모델 없이 서버가 검토합니다 | 조치 필요 없음 |
421 422
422여러 상황이 해당하면 목록에서 먼저 나오는 상황을 따릅니다.423여러 상황에 해당하면 먼저 나열된 상황을 따릅니다.
423 424
424#### 분류기가 사용한 모델 확인425#### 분류기가 사용한 모델 확인
425 426
429claude --permission-mode auto --debug-file classifier-debug.log430claude --permission-mode auto --debug-file classifier-debug.log
430```431```
431 432
432Claude가 읽기 전용이 아닌 셸 명령을 실행하도록 한 다음, 로그에서 `classifier_request_started`를 검색합니다.433Claude에게 읽기 전용이 아닌 셸 명령을 실행하게 한 다음, 로그에서 `classifier_request_started`를 검색하십시오.
433 434
434* **`model=` 뒤에 설정한 모델이 있음**: 변수가 적용되었습니다435* **`model=` 뒤에 지정한 모델이 있음**: 변수가 적용되었습니다
435* **`model=` 뒤에 다른 모델이 있음**: 로그에서 `ignoring CLAUDE_CODE_AUTO_MODE_MODEL`을 검색하십시오. 이 줄에 이유와 필요한 조치가 나와 있습니다436* **`model=` 뒤에 다른 모델이 있음**: 로그에서 `ignoring CLAUDE_CODE_AUTO_MODE_MODEL`을 검색하면 이유와 필요한 조치를 확인할 수 있습니다
436* **해당 줄이 없음**: Claude Code 프롬프트에서 `/status`의 `Auto mode server`를 확인하십시오.437* **해당 줄이 없음**: Claude Code 프롬프트에서 `/status`의 `Auto mode server`를 확인하십시오.
437 * **`Enabled`**: [서버](#server-side-classifier-review)가 이 세션의 호출을 검토하도록 설정되어 있습니다.438 * **`Enabled`**: 이 세션의 호출을 [서버](#server-side-classifier-review)가 검토하도록 설정되어 있습니다.
438 * **`Disabled`**: [권한 모드](#switch-permission-modes)가 auto인지 확인한 다음, Claude가 읽기 전용이 아닌 다른 명령을 실행하도록 하십시오.439 * **`Disabled`**: [권한 모드](#switch-permission-modes)가 auto인지 확인한 다음, Claude에게 읽기 전용이 아닌 다른 명령을 실행하게 하십시오.
439 440
440### 분류기가 기본적으로 차단하는 항목441### 분류기가 기본적으로 차단하는 항목
441 442
442분류기는 작업 디렉터리와 세션 시작 시점에 해당 디렉터리에 구성되어 있던 원격 저장소를 신뢰합니다. 세션 중에 `git remote add` 또는 `git remote set-url`로 추가되거나 대상이 변경된 원격 저장소는 신뢰되지 않으며, [신뢰할 수 있는 인프라를 구성](https://code.claude.com/docs/ko/auto-mode-config.md)하기 전까지 그 밖의 모든 것은 외부로 취급됩니다.443분류기는 작업 디렉터리와 세션이 시작될 때 해당 디렉터리에 구성되어 있던 원격 저장소를 신뢰합니다. 세션 중에 `git remote add` 또는 `git remote set-url`로 추가되거나 다른 곳을 가리키도록 변경된 원격 저장소는 신뢰되지 않으며, 그 밖의 모든 것은 [신뢰할 수 있는 인프라를 구성](https://code.claude.com/docs/ko/auto-mode-config.md)할 때까지 외부로 취급됩니다.
443 444
444**기본적으로 차단됨**:445**기본적으로 차단됨**:
445 446
446* `curl | bash`처럼 코드를 다운로드하여 실행하는 작업447* `curl | bash`와 같이 코드를 다운로드하여 실행
447* 민감한 데이터를 외부 엔드포인트로 전송하는 작업448* 민감한 데이터를 외부 엔드포인트로 전송
448* 프로덕션 배포 및 마이그레이션449* 프로덕션 배포 및 마이그레이션
449* 클라우드 스토리지의 대량 삭제450* 클라우드 스토리지의 대량 삭제
450* IAM 또는 저장소 권한 부여451* IAM 또는 저장소 권한 부여
451* 공유 인프라 수정452* 공유 인프라 수정
452* 세션 이전부터 존재하던 파일을 되돌릴 수 없게 삭제하는 작업453* 세션 이전부터 존재하던 파일을 되돌릴 수 없게 파괴
453* 강제 푸시454* 강제 푸시
454* 실행 시 시크릿이나 민감한 데이터를 저장소 외부로 보내거나, 배포가 노출하는 범위를 넓히는 변경을 커밋하거나 푸시하는 작업. 여기에는 시크릿을 아직 받지 않는 대상으로 전달하는 CI 워크플로나 배포 구성, 시크릿 저장소를 읽어 데이터를 외부로 보내는 스크립트나 설정 단계, 레지스트리, 공개 범위, 아티팩트 또는 소스맵 설정처럼 배포가 게시하는 범위를 넓히는 구성 변경이 포함됩니다. 이 확인은 모든 브랜치에 적용되고, 저장소가 공개 저장소인 경우에도 적용되며, 해당 커밋이나 푸시가 파이프라인을 트리거하는지 여부와 관계없이 변경이 커밋되거나 푸시될 때 발동합니다. 이를 해제하려면 커밋이나 푸시만이 아니라 실행 효과를 명시해야 합니다455* 실행될 때 시크릿이나 민감한 데이터를 저장소 밖으로 보내거나, 배포가 노출하는 범위를 넓히는 변경 사항의 커밋 또는 푸시. 여기에는 아직 시크릿을 받지 않는 대상에 시크릿을 전달하는 CI 워크플로나 배포 구성, 시크릿 저장소를 읽어 데이터를 외부로 보내는 스크립트나 설정 단계, 레지스트리, 공개 범위, 아티팩트 또는 소스맵 설정처럼 배포가 게시하는 범위를 넓히는 구성 변경이 포함됩니다. 이 검사는 모든 브랜치에 적용되고, 저장소가 공개된 경우에도 적용되며, 해당 커밋이나 푸시가 파이프라인을 트리거하는지 여부와 관계없이 변경 사항이 커밋되거나 푸시될 때 발동합니다. 이를 해제하려면 커밋이나 푸시만이 아니라 실행 효과를 명시해야 합니다
455* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` 또는 `git stash clear`. 분류기는 이러한 명령이 커밋되지 않은 변경 사항을 버린다고 가정합니다456* 분류기가 커밋되지 않은 변경 사항을 버릴 것으로 간주하는 `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` 또는 `git stash clear`
456* HEAD의 커밋이 이 세션에서 생성되지 않은 경우의 `git commit --amend`457* HEAD의 커밋이 이 세션에서 생성되지 않은 경우의 `git commit --amend`
457* v2.1.198부터, HEAD의 커밋이 이미 푸시된 경우의 `git commit --amend`. 메시지만 바꾸는 경우는 차단되지 않습니다. 즉, 이 세션에서 Claude가 만든 커밋에 대해 새로 스테이징된 항목 없이 `--amend -m`을 사용하는 경우입니다458* v2.1.198부터는 HEAD의 커밋이 이미 푸시된 경우의 `git commit --amend`. 메시지만 바꾸는 경우, 즉 새로 스테이징된 내용 없이 이 세션에서 Claude가 생성한 커밋에 대해 `--amend -m`을 실행하는 경우는 차단되지 않습니다
458* `terraform destroy`, `pulumi destroy`, `cdk destroy` 또는 `terragrunt destroy`, 그리고 리소스를 삭제하는 플랜 적용459* `terraform destroy`, `pulumi destroy`, `cdk destroy` 또는 `terragrunt destroy`, 그리고 리소스를 파괴하는 플랜 적용
459* 시크릿 매니저에 쓰기, 또는 DNS 레코드나 TLS 인증서 변경460* 시크릿 관리자에 쓰기, 또는 DNS 레코드나 TLS 인증서 변경
460* 사람이 승인하지 않은 풀 리퀘스트 병합, Claude 자신의 풀 리퀘스트 승인, 또는 CI 검사 비활성화461* 사람이 승인하지 않은 풀 리퀘스트 병합, Claude 자신의 풀 리퀘스트 승인, 또는 CI 검사 비활성화
461* `atlantis apply`나 봇의 `/deploy` 또는 `/merge`처럼 그 자체가 자동화에 대한 명령인 댓글 게시462* `atlantis apply`나 봇의 `/deploy` 또는 `/merge`처럼 그 자체가 자동화에 대한 명령인 댓글 게시
462* 프로덕션 기능 플래그의 전환, 점진적 확대 또는 삭제463* 프로덕션 기능 플래그의 전환, 점진적 확대 또는 삭제
463* 보호된 IaC 범위에 인프라 변경 적용, 또는 클러스터 노드 드레인 및 제거464* 보호된 IaC 범위에 인프라 변경 적용, 또는 클러스터 노드 드레인 및 제거
464* 레이블 선택기나 다른 사용자의 작업까지 포함하는 `--all`처럼, 지정한 리소스를 넘어서는 공유 컴퓨팅 클러스터에 대한 쓰기465* 다른 사용자의 작업까지 포함하는 레이블 셀렉터나 `--all`처럼, 지정한 리소스를 넘어서는 공유 컴퓨팅 클러스터 쓰기
465* DaemonSet 및 admission webhook처럼 모든 노드에서 실행되거나 클러스터 트래픽을 가로채는 Kubernetes 리소스 생성466* DaemonSet 및 admission webhook처럼 모든 노드에서 실행되거나 클러스터 트래픽을 가로채는 Kubernetes 리소스 생성
466* 민감한 원격 대상에 대한 대화형 셸 또는 포트 포워딩467* 민감한 원격 대상에 대한 대화형 셸 또는 포트 포워딩
467* 로컬 서비스를 공용 인터넷에서 접근 가능하게 만드는 터널 또는 리버스 셸 열기468* 로컬 서비스를 공용 인터넷에서 접근할 수 있게 만드는 터널 또는 리버스 셸 열기
468* 실제 자격 증명이나 토큰을 트랜스크립트나 파일에 출력하는 작업469* 실제 사용 중인 자격 증명이나 토큰을 트랜스크립트 또는 파일에 출력
469* [환경](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure)에 민감한 데이터 위치로 나열된 위치에 접근하거나, 그곳에서 데이터를 복사하거나, 해당 항목이 제외하는 대상에게 그곳의 데이터를 보내는 작업470* [환경](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure)에 민감한 데이터 위치로 나열된 위치에 접근하거나, 그곳에서 데이터를 복사하거나, 그곳의 데이터를 해당 항목이 제외하는 대상에게 전송
470* 패키지 설치를 내부 패키지 레지스트리를 우회하여 공개 레지스트리로 라우팅하는 작업. 이는 내부 레지스트리나 미러가 환경에 나열되어 있거나 대화에서 Claude에게 내부 레지스트리가 있다고 알린 경우에 적용됩니다471* 내부 패키지 레지스트리를 우회하여 공개 레지스트리로 패키지 설치 경로를 변경. 이는 환경에 내부 레지스트리나 미러가 나열되어 있거나, 대화에서 Claude에게 그러한 레지스트리가 있다고 알린 경우에 적용됩니다
471* `--insecure`처럼 안전 장치를 해제하는 플래그를 사용하여 명령을 실행하는 작업472* `--insecure`처럼 안전 장치를 해제하는 플래그로 명령 실행
472* `--dangerously-skip-permissions` 또는 `--no-sandbox`로 시작한 것처럼, 사람의 승인이나 샌드박스 없이 실행되는 자율 에이전트 루프 실행. 여기에는 `--yes-always`로 시작한 실행기처럼 격리와 작업별 승인이 비활성화된 서드파티 에이전트나 평가 하네스 실행도 포함됩니다473* `--dangerously-skip-permissions` 또는 `--no-sandbox`로 시작한 경우처럼, 사람의 승인이나 샌드박스 없이 실행되는 자율 에이전트 루프 실행. 여기에는 `--yes-always`로 시작한 러너처럼 격리와 작업별 승인이 비활성화된 타사 에이전트나 평가 하네스 실행이 포함됩니다
473* 페이지 콘텐츠, 쿠키 또는 자격 증명을 다른 출처로 보낼 수 있는 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 브라우저 작업474* 페이지 콘텐츠, 쿠키 또는 자격 증명을 다른 출처로 보낼 수 있는 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 브라우저 작업
474* 특정 이름의 경로가 아닌 와일드카드, glob 또는 기간 필터로 `/tmp`, `$TMPDIR` 또는 기타 공유 임시 디렉터리나 캐시 디렉터리의 파일을 삭제하는 작업475* 특정 경로를 지정하지 않고 와일드카드, glob 또는 기간 필터로 `/tmp`, `$TMPDIR` 또는 기타 공유 스크래치나 캐시 디렉터리의 파일 삭제
475* 사용자 본인의 메시지가 해당 수신자에게 허용하지 않은 민감한 세부 정보를, 다른 사람이나 공유 시스템으로 전송, 업로드, 게시 또는 작성되는 콘텐츠에 포함하는 작업. 저장소가 신뢰 경계 밖에 있거나 공개 저장소인 경우(조직 자체의 공개 저장소 포함) PR 및 이슈 본문, 커밋 메시지, 댓글이 이러한 외부 전송 콘텐츠에 해당합니다. 내부 파일 경로, 코드 이름, 이메일이나 계정 식별자 같은 실시간 API 응답 데이터, 인프라 식별자가 민감한 세부 정보에 해당합니다. PR 또는 이슈 본문에 이메일 주소, 계정이나 조직 식별자, 사용량 지표 같은 API 응답의 실시간 개인 데이터를 포함하려면, 저장소의 공개 범위나 신뢰 경계와 관계없이 해당 세부 정보와 수신자를 사용자가 직접 명시해야 합니다476* 다른 사람이나 공유 시스템에 전송, 업로드, 게시 또는 작성되는 콘텐츠에, 사용자 자신의 메시지가 해당 수신자에게 허용하지 않은 민감한 세부 정보를 포함. 저장소가 신뢰 경계 밖에 있거나 공개된 경우(조직 자체의 공개 저장소 포함) PR 및 이슈 본문, 커밋 메시지, 댓글은 이러한 외부 전송 콘텐츠로 간주됩니다. 내부 파일 경로, 코드명, 이메일이나 계정 식별자 같은 실제 API 응답 데이터, 인프라 식별자는 민감한 세부 정보로 간주됩니다. PR 또는 이슈 본문에 이메일 주소, 계정 또는 조직 식별자, 사용량 지표 같은 API 응답의 실제 개인 데이터를 포함하려면, 저장소의 공개 범위나 신뢰 경계와 관계없이 해당 세부 정보와 수신자를 명시해야 합니다
476* Claude Code 자체의 tmux 창에 키 입력을 보내 자신의 인터페이스를 조작하는 작업. 분류기는 이를 Claude가 자신의 권한이나 감독을 변경하는 것으로 취급합니다477* Claude Code 자체의 인터페이스를 조작하기 위해 Claude Code 자신의 tmux 창에 키 입력 전송. 분류기는 이를 Claude가 자신의 권한이나 감독을 변경하는 것으로 취급합니다
477* 인증, 접근 제어, 입력 검증 또는 샌드박싱 같은 보안 동작을 보호하는 테스트나 어설션을 주석 처리, 삭제 또는 강제 통과시키는 작업478* 인증, 접근 제어, 입력 검증, 샌드박싱 같은 보안 동작을 보호하는 테스트나 어서션을 주석 처리, 삭제 또는 강제 통과
478* 더 구체적인 삭제 규칙이 적용되지 않고 사용자가 해당 리소스를 지정하지 않은 경우, Claude가 세션에서 생성하지 않은 상태 저장 리소스를 삭제하거나 해체하는 작업479* 더 구체적인 삭제 규칙이 적용되지 않고 사용자가 해당 리소스를 지정하지 않은 경우, Claude가 세션에서 생성하지 않은 상태 저장 리소스의 삭제 또는 해체
479* API 기본 URL, 프록시 엔드포인트, 웹훅 수신기 또는 레지스트리 미러를 작업에 맞지 않는 서드파티 호스트로 변경하는 작업. `.env.example` 같은 예시 파일에서의 변경도 포함됩니다480* `.env.example` 같은 예제 파일을 포함하여, API 기본 URL, 프록시 엔드포인트, 웹훅 수신기 또는 레지스트리 미러를 작업에 맞지 않는 타사 호스트로 변경
480* 새 원격 저장소를 사용자가 지정하지 않은 경우, `git remote set-url` 또는 `git remote add`로 푸시 대상을 변경하는 작업481* 새 원격 저장소를 사용자가 지정하지 않은 경우, `git remote set-url` 또는 `git remote add`로 푸시 대상 변경
481* 공개된 것으로 알려진 저장소에 시크릿이나 개인 데이터 또는 위탁받은 데이터를 푸시하거나, 해당 저장소 자체의 작업에 속하지 않는 기밀 자료를 푸시하는 작업. 개인 데이터나 위탁받은 데이터의 경우 dotfiles 저장소 자체의 주제가 유일한 예외이며, 비공개 저장소의 콘텐츠가 공개된 곳에 도달하는 것도 같은 방식으로 차단됩니다. 저장소의 공개 범위가 확인되지 않은 경우 분류기는 그것만으로 차단하지 않고, 대신 다른 규칙에 따라 콘텐츠를 판단합니다482* 공개된 것으로 알려진 저장소에 시크릿이나 개인 데이터 또는 위탁받은 데이터를 푸시하거나, 해당 저장소 자체의 작업에 속하지 않는 기밀 자료를 푸시. 개인 데이터나 위탁받은 데이터의 경우 dotfiles 저장소 자체의 주제가 유일한 예외이며, 비공개 저장소의 콘텐츠가 공개된 곳에 도달하는 것도 같은 방식으로 차단됩니다. 저장소의 공개 범위가 확인되지 않은 경우 분류기는 그것만으로 차단하지 않고, 대신 다른 규칙에 따라 콘텐츠를 판단합니다
482* 외부 대상을 사용자가 지정하지 않은 경우, 다른 저장소나 조직을 대상으로 풀 리퀘스트를 열거나, `gh repo fork`로 포크하거나, 서드파티 저장소에 푸시하는 작업483* 사용자가 해당 외부 대상을 지정하지 않은 경우, 다른 저장소나 조직을 대상으로 풀 리퀘스트 열기, `gh repo fork`로 포크, 또는 타사 저장소에 푸시
483* 출처와 대상을 모두 사용자가 지정하지 않은 경우, 민감한 로컬 저장 위치의 콘텐츠 또는 이름, 경로나 유형으로 민감함이 드러나는 파일의 콘텐츠가 커밋, 푸시, PR 또는 이슈 텍스트, gist나 paste, 패키지 게시에 포함되는 작업. 세션 트랜스크립트와 대화 로그, SSH 키, 클라우드 자격 증명, 브라우저 프로필, 셸 기록 같은 자격 증명 및 구성 점 폴더, 사용자 데이터 내보내기가 모두 해당하며, 저장소가 비공개라고 해서 허용되지 않습니다484* 사용자가 출처와 대상을 모두 지정하지 않은 경우, 민감한 로컬 저장소의 콘텐츠나 이름, 경로 또는 유형으로 민감함이 드러나는 파일의 콘텐츠가 커밋, 푸시, PR 또는 이슈 텍스트, gist 또는 paste, 패키지 게시에 포함되는 것. 세션 트랜스크립트와 대화 로그, SSH 키, 클라우드 자격 증명, 브라우저 프로필, 셸 기록 같은 자격 증명 및 구성 dot 폴더, 사용자 데이터 내보내기가 모두 해당되며, 저장소가 비공개라고 해서 해제되지 않습니다
484* 직접 또는 셸 명령을 통해 Claude Code 세션 트랜스크립트, 즉 `~/.claude/projects/` 또는 구성된 설정 디렉터리 아래의 `.jsonl` 기록 파일에 쓰는 작업. 이 규칙은 Claude Code가 자체 확인을 위해 각 트랜스크립트 항목에 덧붙이는 메타데이터 줄도 다룹니다. 트랜스크립트를 읽는 것은 차단되지 않습니다485* 직접 또는 셸 명령을 통해 Claude Code 세션 트랜스크립트, 즉 `~/.claude/projects/` 또는 구성된 config 디렉터리 아래의 `.jsonl` 기록 파일에 쓰기. 이 규칙은 Claude Code가 자체 검사를 위해 각 트랜스크립트 항목에 추가하는 메타데이터 줄도 포함합니다. 트랜스크립트 읽기는 차단되지 않습니다
485* 대상이 분류기가 보는 대화 어디에서도 할당되지 않은 셸 변수이거나 그러한 변수를 기준으로 하는 glob인 `rm -rf "$VAR"` 또는 `Remove-Item -Recurse -Force $dir` 같은 재귀적 강제 삭제. 해당 값은 분류기가 받지 못하는 이전 명령 출력에서만 나왔으므로, 분류기는 삭제 대상을 다른 삭제 규칙에 비추어 확인할 수 없습니다. 삭제되는 정확한 경로를 사용자가 지정하거나, Claude가 확인된 리터럴 경로를 명령에 직접 써서 삭제를 다시 실행하면 차단이 해제됩니다. 분류기가 대상을 확인할 수 있는 삭제는 영향을 받지 않습니다.486* 대상이 분류기가 보는 대화 어디에서도 할당되지 않은 셸 변수이거나 그러한 변수를 기준으로 하는 glob인 `rm -rf "$VAR"` 또는 `Remove-Item -Recurse -Force $dir` 같은 재귀적 강제 삭제. 값이 분류기가 전혀 받지 않는 이전 명령 출력에서만 나왔으므로, 분류기는 삭제 대상을 다른 삭제 규칙에 비추어 확인할 수 없습니다. 삭제되는 정확한 경로를 사용자가 지정하거나, Claude가 확인된 리터럴 경로를 명령에 직접 작성하여 삭제를 다시 실행하면 차단이 해제됩니다. 분류기가 대상을 확인할 수 있는 삭제는 영향을 받지 않습니다.
486 487
487 `rm -rf "$VAR"/*`처럼 변수 바로 아래의 glob은 대신 [중요 경로](#critical-paths)에 해당합니다. 대상이 단독 `*`이거나 `/*` 또는 `\*`로 끝나는 `Remove-Item`은 분류기에 도달하지 않습니다. Claude Code가 [즉시 거부합니다](#remove-item-in-powershell).488 `rm -rf "$VAR"/*`처럼 변수 바로 아래의 glob은 대신 [핵심 경로](#critical-paths)에 해당합니다. 단독 `*`이거나 `/*` 또는 `\*`로 끝나는 `Remove-Item` 대상은 분류기에 도달하지 않으며, Claude Code가 [즉시 거부](#remove-item-in-powershell)합니다.
488 489
489이러한 범주 중 일부는 민감한 원격 대상이나 보호된 IaC 범위처럼 구체적인 이름으로 좁힐 수 있는 [환경](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure) 항목에 따라 달라집니다.490이 범주 중 일부는 민감한 원격 대상이나 보호된 IaC 범위처럼 구체적인 이름으로 좁힐 수 있는 [환경](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure) 항목에 따라 달라집니다.
490 491
491Claude Code v2.1.257 이상에서는 다음 항목도 기본적으로 차단합니다.492Claude Code v2.1.257 이상에서는 다음도 기본적으로 차단합니다.
492 493
493* `169.254.169.254` 같은 클라우드 인스턴스 메타데이터 엔드포인트에 자격 증명을 요청하거나, 머신 자체의 서비스 계정 또는 노드 ID로 클라우드, 클러스터 또는 레지스트리 호출을 명시적으로 인증하는 작업494* `169.254.169.254` 같은 클라우드 인스턴스 메타데이터 엔드포인트에서 자격 증명을 요청하거나, 머신 자체의 서비스 계정 또는 노드 ID로 클라우드, 클러스터 또는 레지스트리 호출을 명시적으로 인증
494* 터널, 리버스 셸, 또는 외부를 가리키도록 다시 작성된 리졸버나 프록시 구성처럼 직접 요청이 아닌 경로로 공개 호스트에 접근하는 작업495* 터널, 리버스 셸, 외부를 가리키도록 다시 작성된 리졸버 또는 프록시 구성처럼 직접 요청이 아닌 경로로 공개 호스트에 접근
495* 노드 인증서나 노드의 컨테이너 레지스트리 인증 정보처럼 작업이 아닌 호스트에 속한 자격 증명을 읽는 작업496* 노드 인증서나 노드의 컨테이너 레지스트리 인증 정보처럼 작업이 아닌 호스트에 속한 자격 증명 읽기
496* Claude가 시작하지 않은 형제 컨테이너, 파드 또는 VM이나 컨테이너 아래의 노드에 연결하거나 스캔하는 작업497* Claude가 시작하지 않은 형제 컨테이너, 파드 또는 VM, 또는 컨테이너 아래의 노드에 연결하거나 스캔
497 498
498Claude Code가 이 중 하나를 허용하도록 의도된 환경에서 실행되는 경우, `autoMode.environment`의 [Host containment 항목](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure)에 해당 구성을 설명하십시오.499이 중 하나를 허용해야 하는 곳에서 Claude Code를 실행한다면, `autoMode.environment`의 [Host containment 항목](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure)에 해당 구성을 설명하십시오.
499 500
500Claude Code v2.1.261 이상에서는 다음 항목도 기본적으로 차단합니다.501Claude Code v2.1.261 이상에서는 다음도 기본적으로 차단합니다.
501 502
502* URL 자체에 공유되는 콘텐츠가 담겨 있는 경우, 메시지, PR 또는 이슈 텍스트, 문서 또는 링크가 열리거나 가져와지는 기타 위치에 공개 paste, 다이어그램 또는 데이터 공유 서비스 링크를 게시하거나 작성하는 작업. 사용자가 해당 서비스를 지정한 경우는 예외입니다503* URL 자체가 공유되는 콘텐츠를 담고 있는 경우, 사용자가 해당 서비스를 지정하지 않았다면 메시지, PR 또는 이슈 텍스트, 문서 또는 링크가 열리거나 가져와지는 기타 위치에 공개 paste, 다이어그램 또는 데이터 공유 서비스 링크를 게시하거나 작성
503 504
504**기본적으로 허용됨**:505**기본적으로 허용됨**:
505 506
506* 작업 디렉터리 내의 로컬 파일 작업507* 작업 디렉터리 내의 로컬 파일 작업
507* 잠금 파일이나 매니페스트에 선언된 의존성 설치508* 잠금 파일이나 매니페스트에 선언된 의존성 설치
508* `.env`를 읽고 자격 증명을 해당 API로 전송하는 작업509* `.env`를 읽고 일치하는 API로 자격 증명 전송
509* 읽기 전용 HTTP 요청510* 읽기 전용 HTTP 요청
510* 기본 브랜치를 포함하여 작업 중인 저장소의 모든 브랜치로 푸시하는 작업. `production`이나 `gh-pages`처럼 이름으로 배포 또는 게시 대상임을 나타내는 기본이 아닌 브랜치는 여기에 포함되지 않으며, 분류기는 해당 브랜치로의 푸시를 별도로 판단합니다.511* 기본 브랜치를 포함하여, 작업 중인 저장소의 모든 브랜치에 푸시. 단, `production`이나 `gh-pages`처럼 이름으로 배포 또는 게시 대상임이 드러나는 기본 브랜치가 아닌 브랜치는 포함되지 않으며, 분류기는 그러한 브랜치로의 푸시를 별도의 기준으로 판단합니다.
511 512
512 푸시의 콘텐츠는 여전히 분류기의 다른 규칙에 따라 확인되며, [`permissions.deny` 규칙](https://code.claude.com/docs/ko/permissions#manage-permissions)은 모든 모드에서 푸시 명령을 [작성된 그대로](https://code.claude.com/docs/ko/permissions.md#bash-rule-limits) 여전히 차단할 수 있습니다. 원격 저장소 자체의 브랜치 보호도 여전히 적용됩니다.513 푸시의 콘텐츠는 여전히 분류기의 다른 규칙에 따라 검사되며, [`permissions.deny` 규칙](https://code.claude.com/docs/ko/permissions#manage-permissions)은 모든 모드에서 여전히 [작성된 그대로](https://code.claude.com/docs/ko/permissions.md#bash-rule-limits)의 푸시 명령을 차단할 수 있습니다. 원격 저장소 자체의 브랜치 보호도 여전히 적용됩니다.
513* 같은 세션에서 Claude가 앞서 생성한 바로 그 작업 삭제514* 같은 세션에서 앞서 Claude가 생성한 바로 그 작업의 삭제
514* 작업의 일부로 보안 관련 코드, 구성 및 위협 모델을 읽고, 검토하고, 작성하는 작업515* 작업의 일환으로 보안 관련 코드, 구성 및 위협 모델을 읽기, 검토 또는 작성
515* 같은 멀티 에이전트 세션에서 함께 작업하는 에이전트 간의 메시지516* 같은 멀티 에이전트 세션에서 함께 작업하는 에이전트 간 메시지
516* [`environment`](https://code.claude.com/docs/ko/auto-mode-config#define-trusted-infrastructure)에 나열한 신뢰할 수 있는 도메인, 버킷 및 서비스로 데이터를 보내는 작업. 이는 데이터 흐름만 다루며, 같은 인프라에 대한 파괴적 작업이나 자격 증명 작업은 포함하지 않습니다517* [`environment`](https://code.claude.com/docs/ko/auto-mode-config#define-trusted-infrastructure)에 나열한 신뢰할 수 있는 도메인, 버킷 및 서비스로 데이터 전송. 이는 데이터 흐름만 포함하며, 같은 인프라에 대한 파괴적 작업이나 자격 증명 작업은 포함하지 않습니다
517* 신뢰할 수 있는 내부 도메인, localhost 또는 사용자가 지정한 URL로의 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 탐색518* 신뢰할 수 있는 내부 도메인, localhost 또는 사용자가 지정한 URL로의 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 탐색
518 519
519샌드박스 처리된 명령은 기본적으로 네트워크 접근 권한을 받지 않습니다. Claude는 명령에 필요한 호스트를 명령 자체에 명시하고, 분류기는 명령과 함께 이를 검토하며, 승인된 목록은 해당 명령 하나에 대해서만 그 호스트를 엽니다. 목록으로 열 수 있는 것과 열 수 없는 것, 그리고 명령이 목록에 없는 호스트에 접근하려 할 때 일어나는 일은 [명령별 허용 도메인](https://code.claude.com/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)에서 다룹니다.520샌드박스된 명령은 기본적으로 네트워크 접근 권한을 받지 않습니다. Claude가 명령 자체에 해당 명령에 필요한 호스트를 명시하면, 분류기가 명령과 함께 이를 검토하고, 승인된 목록은 해당 명령 하나에 대해서만 그 호스트들을 엽니다. [명령별 허용 도메인](https://code.claude.com/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)에서 목록으로 열 수 있는 것과 열 수 없는 것, 그리고 명령이 목록에 없는 호스트에 접근하려 할 때의 동작을 설명합니다.
520 521
521`claude auto-mode defaults`를 실행하면 전체 규칙 목록을 JSON으로 출력합니다. 일상적인 작업이 차단되는 경우 관리자는 `autoMode.environment` 설정을 통해 신뢰할 수 있는 저장소, 버킷 및 서비스를 추가할 수 있습니다. [자동 모드 구성](https://code.claude.com/docs/ko/auto-mode-config.md)을 참조하십시오.522`claude auto-mode defaults`를 실행하면 전체 규칙 목록을 JSON으로 출력합니다. 일상적인 작업이 차단된다면 관리자가 `autoMode.environment` 설정을 통해 신뢰할 수 있는 저장소, 버킷 및 서비스를 추가할 수 있습니다. [자동 모드 구성](https://code.claude.com/docs/ko/auto-mode-config.md)을 참조하십시오.
522 523
523작업 중인 저장소의 모든 브랜치로 푸시하는 작업과 요청에 부합하는 풀 리퀘스트를 생성하는 작업은, 시크릿이나 민감한 데이터가 저장소 밖으로 나가거나 풀 리퀘스트가 다른 저장소나 조직을 대상으로 하는 경우처럼 푸시나 풀 리퀘스트가 [차단 목록](#what-the-classifier-blocks-by-default)에 해당하지 않는 한 프롬프트 없이 실행됩니다. 자동 모드를 유지하면서 이러한 명령 전에 사람의 확인 단계를 요구하려면, 명령을 [작성된 그대로](https://code.claude.com/docs/ko/permissions.md#bash-rule-limits) 매칭하는 `permissions.ask` 규칙을 추가하십시오. [일반적인 경계](https://code.claude.com/docs/ko/auto-mode-config.md#common-boundaries)를 참조하십시오.524작업 중인 저장소의 모든 브랜치에 푸시하는 것과 요청에 부합하는 풀 리퀘스트를 생성하는 것은 프롬프트 없이 실행됩니다. 단, 시크릿이나 민감한 데이터가 저장소 밖으로 나가는 경우나 다른 저장소 또는 조직을 대상으로 하는 풀 리퀘스트처럼 해당 푸시나 풀 리퀘스트가 [차단 목록](#what-the-classifier-blocks-by-default)에 해당하는 경우에는 예외입니다. 자동 모드를 유지하면서 이러한 명령 전에 사람의 확인 단계를 요구하려면, 명령을 [작성된 그대로](https://code.claude.com/docs/ko/permissions.md#bash-rule-limits) 일치시키는 `permissions.ask` 규칙을 추가하십시오. [일반적인 경계](https://code.claude.com/docs/ko/auto-mode-config.md#common-boundaries)를 참조하십시오.
524 525
525### 작업 디렉터리 밖의 첫 번째 읽기526### 작업 디렉터리 밖의 첫 번째 읽기
526 527
527[`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 꺼져 있는 동안, 자동 모드에서는 [네트워크 경로에서의 읽기](https://code.claude.com/docs/ko/permissions.md#network-paths)를 제외한 파일 읽기가 [작업 디렉터리](https://code.claude.com/docs/ko/permissions.md#working-directories) 밖의 읽기를 포함하여 프롬프트 없이 실행됩니다. Claude가 작업 디렉터리 밖의 경로에 처음으로 Read, Grep 또는 Glob 도구를 사용하면, Claude Code는 해당 읽기를 허용할지 묻습니다.528[`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 꺼져 있는 동안, 자동 모드에서는 [네트워크 경로에서의 읽기](https://code.claude.com/docs/ko/permissions.md#network-paths)를 제외한 파일 읽기가 [작업 디렉터리](https://code.claude.com/docs/ko/permissions.md#working-directories) 밖의 읽기를 포함하여 프롬프트 없이 실행됩니다. Claude가 작업 디렉터리 밖의 경로에 처음으로 Read, Grep 또는 Glob 도구를 사용하면, Claude Code가 해당 읽기를 허용할지 묻습니다.
528 529
529이 프롬프트는 비대화형 `-p` 실행이나 백그라운드 세션에서는 나타나지 않으며, 그곳에서는 읽기가 이전과 같이 실행됩니다.530이 프롬프트는 비대화형 `-p` 실행이나 백그라운드 세션에서는 나타나지 않으며, 그곳에서의 읽기는 이전과 같이 실행됩니다.
530 531
531어떻게 답하든 Claude는 작업을 계속합니다.532어떻게 답하든 Claude는 계속 작업합니다.
532 533
533* **Yes, and keep allowing any reads outside the working directories**: 읽기가 실행되고, 이후 작업 디렉터리 밖의 읽기도 이전과 같이 실행되며, Claude Code는 프롬프트가 다시 나타나지 않도록 답변을 기록합니다534* **Yes, and keep allowing any reads outside the working directories**: 읽기가 실행되고, 이후 작업 디렉터리 밖의 읽기도 이전과 같이 실행되며, Claude Code가 답변을 기록하여 프롬프트가 다시 나타나지 않습니다
534* **No, and block reads outside the working directories from now on**: 읽기가 거부되고, Claude Code는 사용자 설정에서 [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)를 `true`로 설정합니다. 이렇게 하면 이후의 모든 세션과 모든 권한 모드에서 파일 도구가 이러한 읽기를 거부합니다. 나중에 Claude가 그러한 경로를 읽을 수 있게 하려면 `/add-dir`로 해당 디렉터리를 추가하거나 설정을 제거하십시오.535* **No, and block reads outside the working directories from now on**: 읽기가 거부되고, Claude Code가 사용자 설정에서 [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)를 `true`로 설정합니다. 그러면 이 세션과 이후의 모든 세션, 모든 권한 모드에서 파일 도구가 이러한 읽기를 거부합니다. 차단을 해제하려면 이 설정을 지정한 모든 [설정 파일](https://code.claude.com/docs/ko/settings.md#settings-files-and-who-they-affect)에서 설정을 제거한 다음, 실행 중인 각 세션을 다시 시작하십시오. 이 세션에서 하나의 디렉터리만 허용하려면 `/add-dir`을 사용하십시오.
535* **No, and ask again next time**: 읽기가 거부되고, 다음에 작업 디렉터리 밖을 읽을 때 다시 프롬프트가 표시됩니다536* **No, and ask again next time**: 읽기가 거부되고, 다음에 작업 디렉터리 밖을 읽을 때 다시 묻습니다
536* **Yes, but ask again next time**: 읽기가 실행되고, 아무것도 저장되지 않으며, 다음에 작업 디렉터리 밖을 읽을 때 다시 프롬프트가 표시됩니다537* **Yes, but ask again next time**: 읽기가 실행되고, 아무것도 저장되지 않으며, 다음에 작업 디렉터리 밖을 읽을 때 다시 묻습니다
537 538
538### 대화에서 명시한 경계539### 대화에서 명시한 경계
539 540
540분류기는 대화에서 사용자가 명시한 경계를 차단 신호로 취급합니다. Claude에게 "푸시하지 마" 또는 "배포 전에 내가 검토할 때까지 기다려"라고 말하면, 기본 규칙이 허용하는 경우에도 분류기는 해당하는 작업을 차단합니다. 경계는 이후 메시지에서 사용자가 해제할 때까지 유효합니다. 조건이 충족되었다는 Claude 자신의 판단으로는 해제되지 않습니다.541분류기는 대화에서 명시한 경계를 차단 신호로 취급합니다. Claude에게 "푸시하지 마" 또는 "배포하기 전에 내가 검토할 때까지 기다려"라고 말하면, 기본 규칙이 허용하는 경우에도 분류기가 일치하는 작업을 차단합니다. 경계는 이후 메시지에서 해제할 때까지 유효합니다. 조건이 충족되었다는 Claude 자신의 판단으로는 해제되지 않습니다.
541 542
542경계는 규칙으로 저장되지 않습니다. 분류기는 확인할 때마다 트랜스크립트에서 경계를 다시 읽으므로, [컨텍스트 압축](https://code.claude.com/docs/ko/costs.md#reduce-token-usage)으로 경계를 명시한 메시지가 제거되면 경계가 사라질 수 있습니다. 확실한 보장이 필요하다면 대신 [deny 규칙](https://code.claude.com/docs/ko/permissions.md#permission-rule-syntax)을 추가하십시오.543경계는 규칙으로 저장되지 않습니다. 분류기는 검사할 때마다 트랜스크립트에서 경계를 다시 읽으므로, [컨텍스트 압축](https://code.claude.com/docs/ko/costs.md#reduce-token-usage)이 경계를 명시한 메시지를 제거하면 경계가 사라질 수 있습니다. 확실한 보장이 필요하다면 대신 [deny 규칙](https://code.claude.com/docs/ko/permissions.md#permission-rule-syntax)을 추가하십시오.
543 544
544### 대화에서 명시한 승인545### 대화에서 명시한 승인
545 546
546차단된 작업이 허용된다고 Claude에게 말하면, 분류기는 이를 사용자의 승인으로 읽고 차단을 해제할 수 있습니다. 어떻게 표현했는지에 따라 작업의 실행 여부와 승인의 적용 범위가 결정됩니다.547차단된 작업이 허용된다고 Claude에게 말하면, 분류기는 이를 사용자의 승인으로 읽고 차단을 해제할 수 있습니다. 어떻게 표현했는지에 따라 작업의 실행 여부와 승인이 미치는 범위가 결정됩니다.
547 548
548* **작업과 그 세부 사항을 명시하십시오**: 메시지에서 작업과 그 작업을 위험하게 만드는 구체적인 대상, 예를 들어 강제 푸시의 브랜치를 명시해야 합니다. 동사만 언급해서는 아무것도 해제되지 않으므로, "강제 푸시해도 돼"라고 하면 차단이 그대로 유지됩니다.549* **작업과 그 세부 사항을 명시하십시오**: 메시지에 작업과 함께, 강제 푸시의 브랜치처럼 그 작업을 위험하게 만드는 구체적인 대상을 명시해야 합니다. 동사만 명시하면 아무것도 해제되지 않으므로, "강제 푸시해도 돼"라고 하면 차단이 그대로 유지됩니다.
549* **하나의 작업에만 적용된다고 생각하십시오**: 승인은 사용자가 명시한 파괴적 작업에만 적용되므로, 승인을 지속적인 것으로 부여하지 않은 한 이후 작업은 다시 차단됩니다. 일상적인 패턴을 작업마다 하나씩 승인하지 않으려면 [`autoMode.allow`](https://code.claude.com/docs/ko/auto-mode-config#override-the-block-and-allow-rules)에 추가하십시오.550* **하나의 작업에만 적용된다고 생각하십시오**: 승인은 명시한 파괴적 작업에 적용되므로, 승인을 지속적인 것으로 부여하지 않았다면 이후의 작업은 다시 차단됩니다. 반복적인 패턴을 작업마다 하나씩 승인하지 않으려면 [`autoMode.allow`](https://code.claude.com/docs/ko/auto-mode-config#override-the-block-and-allow-rules)에 추가하십시오.
550* **일부 차단은 유지됩니다**: 승인으로 해제할 수 있는 차단은 [분류기의 우선순위](https://code.claude.com/docs/ko/auto-mode-config.md#override-the-block-and-allow-rules)에 정해져 있습니다. 승인으로 해제되지 않는 단계를 실행하려면 [자동 모드를 벗어나](#switch-permission-modes) 권한 프롬프트에 답하십시오.551* **일부 차단은 유지됩니다**: [분류기의 우선순위](https://code.claude.com/docs/ko/auto-mode-config.md#override-the-block-and-allow-rules)에 승인으로 해제할 수 있는 차단이 정리되어 있습니다. 승인으로 해제되지 않는 단계를 실행하려면 [자동 모드를 종료](#switch-permission-modes)하고 권한 프롬프트에 답하십시오.
551 552
552### 자동 모드가 폴백하는 경우553### 자동 모드가 폴백하는 경우
553 554
554자동 모드가 세션의 작업을 승인할 수 없을 때 일어나는 일은 경우에 따라 다릅니다.555자동 모드가 세션의 작업을 승인할 수 없을 때의 동작은 경우에 따라 다릅니다.
555 556
556* **차단된 작업**: Claude Code는 알림을 표시하고 `/permissions`의 **Recently denied** 탭에 해당 작업을 나열합니다. 여기서 `r`을 눌러 수동 승인으로 재시도할 수 있습니다.557* **차단된 작업**: Claude Code가 알림을 표시하고 `/permissions`의 **Recently blocked** 탭에 작업을 나열하며, 그곳에서 [작업을 승인하여 Claude가 재시도하도록](https://code.claude.com/docs/ko/auto-mode-config.md#review-denials) 할 수 있습니다.
557* **반복된 차단**: 분류기가 작업을 연속 3회 또는 총 20회 차단하면 자동 모드가 일시 중지되고 Claude Code가 다시 확인을 요청합니다. 확인 요청된 작업을 승인하면 자동 모드가 재개됩니다. 차단 횟수를 세는 방법은 [반복 차단 임계값](#repeated-block-thresholds)을 참조하십시오.558* **반복된 차단**: 분류기가 작업을 연속 3회 또는 총 20회 차단하면 자동 모드가 일시 중지되고 Claude Code가 다시 확인을 요청합니다. 요청된 작업을 승인하면 자동 모드가 재개됩니다. 차단 횟수를 세는 방식은 [반복 차단 임계값](#repeated-block-thresholds)을 참조하십시오.
558* **분류기의 판정 없음**: 자동 모드와는 별개인 안전 확인이 분류기 자체의 요청을 거부하거나 분류기의 응답을 파싱할 수 없으면, Claude Code는 알림이나 **Recently denied** 항목 없이 작업을 거부합니다. 각 경우에 표시되는 메시지와 해결 방법은 [Auto mode cannot determine the safety of an action](https://code.claude.com/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)을 참조하십시오.559* **분류기의 판정 없음**: 자동 모드와 별개의 안전 검사가 분류기 자체의 요청을 거부하거나, 분류기의 응답을 파싱할 수 없는 경우, Claude Code는 알림이나 **Recently blocked** 항목 없이 작업을 차단합니다. 각 경우에 표시되는 메시지와 조치 방법은 [Auto mode cannot determine the safety of an action](https://code.claude.com/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)을 참조하십시오.
559* **서버의 판정 없음**: [서버 측 분류기 검토](#server-side-classifier-review)에서 Claude Code는 서버가 판정을 내리지 않은 작업을 거부하고, 판정 없는 응답이 연속 10회 이어지면 턴을 중단합니다. [The server returned no safety verdict](https://code.claude.com/docs/ko/errors.md#the-server-returned-no-safety-verdict)를 참조하십시오.560* **서버의 판정 없음**: [서버 측 분류기 검토](#server-side-classifier-review)에서 Claude Code는 서버가 판정을 내리지 않은 작업을 거부하며, 판정 없는 응답이 연속 10회 이어지면 턴을 중단합니다. [서버가 안전 판정을 반환하지 않음](https://code.claude.com/docs/ko/errors.md#the-server-returned-no-safety-verdict)을 참조하십시오.
560* **확인 중 모드 전환**: 분류기 확인이 대기 중일 때 권한 모드를 전환하면, Claude Code는 새 모드에서는 요청하지 않았을 판정을 폐기합니다. 대신 승인 요청을 받거나, [`dontAsk` 모드](#allow-only-pre-approved-tools-with-dontask-mode)에서는 작업이 자동으로 거부됩니다.561* **검사 중 모드 전환**: 분류기 검사가 진행 중일 때 권한 모드를 전환하면, Claude Code는 새 모드에서라면 요청하지 않았을 판정을 폐기합니다. 대신 승인을 요청받거나, [`dontAsk` 모드](#allow-only-pre-approved-tools-with-dontask-mode)에서는 작업이 자동으로 거부됩니다.
561 562
562#### 반복 차단 임계값563#### 반복 차단 임계값
563 564
564연속 3회 차단과 총 20회 차단이라는 임계값은 구성할 수 없습니다. 총 카운터는 세션 동안 유지되며, 자체 한도로 인해 폴백이 발생할 때만 초기화됩니다. 자동 모드와는 별개인 안전 확인이 분류기 자체의 요청을 거부한 경우, Claude Code는 해당 거부를 어느 임계값에도 포함하지 않습니다.565연속 3회 차단 및 총 20회 차단이라는 임계값은 구성할 수 없습니다. 총 횟수 카운터는 세션 동안 유지되며, 자체 한도로 폴백이 발생할 때만 초기화됩니다. 자동 모드와 별개의 안전 검사가 분류기 자체의 요청을 거부한 경우, Claude Code는 해당 거부를 어느 임계값에도 포함하지 않습니다.
565 566
566[`--permission-prompt-tool`](https://code.claude.com/docs/ko/cli-reference#cli-flags) 없는 [비대화형](https://code.claude.com/docs/ko/headless.md) `-p` 실행에는 폴백할 프롬프트가 없습니다. 반복된 차단이 임계값에 도달하면 해당 작업은 실행되지 않고 Claude는 작업을 계속합니다. Claude Code는 실행을 중단하지 않습니다.567[`--permission-prompt-tool`](https://code.claude.com/docs/ko/cli-reference#cli-flags)이 없는 [비대화형](https://code.claude.com/docs/ko/headless.md) `-p` 실행에는 폴백할 프롬프트가 없습니다. 반복된 차단이 임계값에 도달하면 작업은 실행되지 않고 Claude는 계속 작업합니다. Claude Code는 실행을 중단하지 않습니다.
567 568
568반복된 차단은 대개 분류기에 인프라에 대한 컨텍스트가 부족하다는 의미입니다. `/feedback`을 사용하여 오탐을 보고하거나, 관리자에게 [신뢰할 수 있는 인프라를 구성](https://code.claude.com/docs/ko/auto-mode-config.md)하도록 요청하십시오.569반복된 차단은 대개 분류기에 인프라에 대한 컨텍스트가 부족하다는 의미입니다. `/feedback`을 사용하여 오탐을 보고하거나, 관리자에게 [신뢰할 수 있는 인프라 구성](https://code.claude.com/docs/ko/auto-mode-config.md)을 요청하십시오.
569 570
570### 자동 모드가 작업을 평가하는 방식571### 자동 모드가 작업을 평가하는 방식
571 572
572다음 섹션에서는 Claude Code가 작업을 평가하는 순서, 분류기가 서브에이전트 작업을 검토하는 방식, 분류기 호출로 추가되는 비용과 지연 시간을 다룹니다.573다음 섹션에서는 Claude Code가 작업을 평가하는 순서, 분류기가 서브에이전트 작업을 검토하는 방식, 그리고 분류기 호출로 추가되는 비용과 지연 시간을 설명합니다.
573 574
574> [accordion] 분류기가 작업을 평가하는 방식575> [accordion] 분류기가 작업을 평가하는 방식
575>576>
576> 각 작업은 고정된 결정 순서를 거칩니다. 처음으로 일치하는 단계가 적용됩니다.577> 각 작업은 고정된 결정 순서를 거칩니다. 처음으로 일치하는 단계가 적용됩니다.
577>578>
578> 1. [allow, ask 또는 deny 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)과 일치하는 작업은 즉시 처리되며, 다음과 같은 예외가 있습니다.579> 1. [allow, ask 또는 deny 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)과 일치하는 작업은 즉시 처리되며, 다음과 같은 예외가 있습니다.
579> * [보호된 경로](#protected-paths)에 대한 쓰기는 allow 규칙과 일치하더라도 분류기로 전달됩니다. 보호된 경로가 심볼릭 링크된 설정 파일이 가리키는 파일인 경우, [보호된 경로](#protected-paths) 목록에 설명된 대로 대신 확인을 요청할 수 있습니다580> * [보호된 경로](#protected-paths)에 대한 쓰기는 allow 규칙이 일치하더라도 분류기로 전달됩니다. 보호된 경로가 심볼릭 링크된 설정 파일이 가리키는 파일인 경우, [보호된 경로](#protected-paths) 목록에 설명된 대로 쓰기 시 대신 확인을 요청할 수 있습니다
580> * 어떤 allow 규칙도 인식된 `rm` 및 `rmdir` [중요 경로 삭제](#critical-paths)를 승인하지 않습니다581> * 어떤 allow 규칙도 인식된 `rm` 및 `rmdir` [핵심 경로 삭제](#critical-paths)를 승인하지 않습니다
581> * [`requiresUserInteraction`](https://code.claude.com/docs/ko/mcp#require-approval-for-a-specific-tool)으로 표시된 MCP 도구는 allow 규칙과 일치하더라도 직접 확인을 요청하며, 해당 설정이 Claude Code에 적용되는 세션에서 [조직이 `ask`로 설정한](https://code.claude.com/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구도 마찬가지입니다582> * [`requiresUserInteraction`](https://code.claude.com/docs/ko/mcp#require-approval-for-a-specific-tool)으로 표시된 MCP 도구는 allow 규칙이 일치하더라도 직접 확인을 요청하며, 해당 설정이 Claude Code에 도달하는 세션에서 [조직이 `ask`로 설정한](https://code.claude.com/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구도 마찬가지입니다
582> * [명령별 허용 도메인](https://code.claude.com/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)을 포함하는 셸 명령도 allow 규칙과 일치하더라도 분류기로 전달됩니다. 규칙은 명령을 승인할 뿐 그 호스트를 승인하지 않기 때문입니다583> * [명령별 허용 도메인](https://code.claude.com/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)을 포함하는 셸 명령도 allow 규칙이 일치하더라도 분류기로 전달됩니다. 규칙은 명령을 승인할 뿐 해당 호스트를 승인하지는 않기 때문입니다
583> * `Bash(git push *)`처럼 명령의 내용과 매칭되는 ask 규칙은 권한 프롬프트로 폴백합니다584> * `Bash(git push *)`처럼 명령의 내용과 일치하는 ask 규칙은 권한 프롬프트로 폴백합니다
584> * [심볼릭 링크 확인](https://code.claude.com/docs/ko/permissions.md#symlinks)에서 보호된 경로로 확인되는 쓰기는, Claude가 요청한 경로 자체가 보호되지 않은 경우 확인을 요청합니다585> * [심볼릭 링크 검사](https://code.claude.com/docs/ko/permissions.md#symlinks)가 보호된 경로로 확인한 쓰기는, Claude가 요청한 경로 자체가 보호되지 않은 경우 확인을 요청합니다
585> * [네트워크 경로](https://code.claude.com/docs/ko/permissions.md#network-paths)에서의 읽기는 allow 규칙과 일치하더라도 확인을 요청합니다586> * [네트워크 경로](https://code.claude.com/docs/ko/permissions.md#network-paths)에서의 읽기는 allow 규칙이 일치하더라도 확인을 요청합니다
586> 2. 작업 디렉터리 내의 읽기 전용 작업과 파일 편집은 자동 승인됩니다. 단, [보호된 경로](#protected-paths)에 대한 쓰기와 확인을 요청하는 [작업 디렉터리 밖의 첫 번째 읽기](#first-read-outside-the-working-directories)는 예외입니다587> 2. 작업 디렉터리 내의 읽기 전용 작업과 파일 편집은 자동으로 승인됩니다. 단, [보호된 경로](#protected-paths)에 대한 쓰기와 확인을 요청하는 [작업 디렉터리 밖의 첫 번째 읽기](#first-read-outside-the-working-directories)는 예외입니다
587> * [서버 측 분류기 검토](#server-side-classifier-review)가 적용되는 세션에서는 읽기 전용 셸 명령과 [샌드박스 처리된](https://code.claude.com/docs/ko/sandboxing.md#sandbox-modes) 셸 명령이 해당 검토를 기다리며, 검토에서 문제가 지적되면 차단됩니다588> * [서버 측 분류기 검토](#server-side-classifier-review)가 적용되는 세션에서는 읽기 전용 셸 명령과 [샌드박스된](https://code.claude.com/docs/ko/sandboxing.md#sandbox-modes) 셸 명령이 해당 검토를 기다리며, 검토에서 문제가 지적되면 차단됩니다
588> * [심볼릭 링크 확인](https://code.claude.com/docs/ko/permissions.md#symlinks)에서 작업 디렉터리 밖의 위치로 확인되는 작업 디렉터리 내 쓰기는 확인을 요청합니다589> * [심볼릭 링크 검사](https://code.claude.com/docs/ko/permissions.md#symlinks)가 작업 디렉터리 밖의 위치로 확인한 작업 디렉터리 내의 쓰기는 확인을 요청합니다
589> * Claude가 [다른 사람이 만든 아티팩트](https://code.claude.com/docs/ko/artifacts.md#read-an-artifact-shared-with-you)를 읽는 경우, 해당 섹션에 나열된 승인 사례가 적용됩니다590> * Claude가 [다른 사람이 만든 아티팩트](https://code.claude.com/docs/ko/artifacts.md#read-an-artifact-shared-with-you)를 읽을 때는 해당 섹션에 나열된 승인 사례가 적용됩니다
590> * [네트워크 경로](https://code.claude.com/docs/ko/permissions.md#network-paths)에서의 읽기는 확인을 요청합니다591> * [네트워크 경로](https://code.claude.com/docs/ko/permissions.md#network-paths)에서의 읽기는 확인을 요청합니다
591> 3. 기본 처리 방식이 적용되는 [중요 경로 삭제](#critical-paths)를 제외한 나머지는 모두 분류기로 전달됩니다. 1단계에서 직접 확인을 요청하는 커넥터 도구와 `requiresUserInteraction` MCP 도구도 분류기에 도달하지 않으므로, 조직이 요구한 승인이나 동의 단계는 자동 승인되지 않습니다592> 3. 기본 처리 방식이 적용되는 [핵심 경로 삭제](#critical-paths)를 제외한 나머지는 모두 분류기로 전달됩니다. 1단계에서 직접 확인을 요청하는 커넥터 도구와 `requiresUserInteraction` MCP 도구도 분류기에 도달하지 않으므로, 조직이 요구하는 승인이나 동의 단계가 자동으로 승인되는 일은 없습니다
592> 4. 분류기가 차단하면 Claude는 그 이유를 받습니다. 대부분의 세션에서 이유는 서술된 설명 대신 `[Data Exfiltration]`처럼 분류기가 매칭한 규칙의 이름입니다. [거부 검토](https://code.claude.com/docs/ko/auto-mode-config.md#review-denials)를 참조하십시오593> 4. 분류기가 차단하면 Claude가 그 이유를 받습니다. 대부분의 세션에서 이유는 서술형 설명이 아니라 `[Data Exfiltration]`처럼 분류기가 일치시킨 규칙의 이름으로 제공됩니다. [거부 검토](https://code.claude.com/docs/ko/auto-mode-config.md#review-denials)를 참조하십시오
593>594>
594> `tool.check`를 처리하는 설치된 [mod](https://code.claude.com/docs/ko/plugins/mods/overview.md)도 작업을 승인할 수 있습니다. 해당 승인이 규칙과 훅을 통과하지 못하는 경우는 [훅으로 권한 확장](https://code.claude.com/docs/ko/permissions.md#precedence-among-rules-hooks-and-mods)을 참조하십시오.595> 설치한 [mod](https://code.claude.com/docs/ko/plugins/mods/overview.md)가 `tool.check`를 처리하는 경우 해당 mod도 작업을 승인할 수 있습니다. mod의 승인이 규칙과 훅을 통과하지 못하는 경우는 [훅으로 권한 확장](https://code.claude.com/docs/ko/permissions.md#precedence-among-rules-hooks-and-mods)을 참조하십시오.
595>596>
596> VS Code 확장 프로그램에서 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 브라우저 작업이 승인되는 방식은 [VS Code 세션의 권한 프롬프트](https://code.claude.com/docs/ko/chrome.md#permission-prompts-in-vs-code-sessions)를 참조하십시오.597> VS Code 확장 프로그램에서 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 브라우저 작업이 승인되는 방식은 [VS Code 세션의 권한 프롬프트](https://code.claude.com/docs/ko/chrome.md#permission-prompts-in-vs-code-sessions)를 참조하십시오.
597>598>
598> 자동 모드에 진입하면 임의의 코드 실행을 허용하는 광범위한 allow 규칙이 제외됩니다.599> 자동 모드에 진입하면 임의의 코드 실행을 허용하는 광범위한 allow 규칙이 제외됩니다.
599>600>
600> * 전면적인 `Bash(*)` 또는 `PowerShell(*)`601> * 포괄적인 `Bash(*)` 또는 `PowerShell(*)`
601> * `Bash(python*)` 같은 와일드카드 인터프리터602> * `Bash(python*)` 같은 와일드카드 인터프리터
602> * 패키지 매니저 실행 명령603> * 패키지 관리자 실행 명령
603> * `Agent` allow 규칙604> * `Agent` allow 규칙
604> * [`Monitor`](https://code.claude.com/docs/ko/tools-reference#monitor-tool) allow 규칙. Claude Code는 Monitor 명령을 셸을 통해 실행하기 때문입니다605> * [`Monitor`](https://code.claude.com/docs/ko/tools-reference#monitor-tool) allow 규칙. Claude Code가 Monitor 명령을 셸을 통해 실행하기 때문입니다
605>606>
606> `Bash(npm test)` 같은 좁은 규칙은 그대로 유효합니다. 자동 모드를 벗어나면 Claude Code가 제외된 규칙을 복원합니다. v2.1.236 이전에는 Claude Code가 자동 모드에서 `Monitor` allow 규칙을 유효하게 유지했으므로, 도구 전체와 일치하는 규칙이 분류기 검토 없이 Monitor 명령을 승인했습니다.607> `Bash(npm test)` 같은 좁은 규칙은 그대로 유지됩니다. 자동 모드를 종료하면 Claude Code가 제외된 규칙을 복원합니다. v2.1.236 이전에는 Claude Code가 자동 모드에서 `Monitor` allow 규칙을 유지했기 때문에, 도구 전체와 일치하는 규칙이 분류기 검토 없이 Monitor 명령을 승인했습니다.
607>608>
608> Claude Code는 또한 `git reset --hard`나 `rm -rf`처럼 커밋되지 않은 작업을 버릴 수 있는 명령 전에 직접 `git status`를 실행하여, 스테이징된 작업, 수정된 작업 또는 추적되지 않은 작업이 있는지를 분류기에 보여 줍니다. Claude Code는 저장소의 git 구성에서 `status.showUntrackedFiles=no`를 설정한 경우에도 해당 확인에서 추적되지 않은 파일을 보고합니다.609> Claude Code는 또한 `git reset --hard`나 `rm -rf`처럼 커밋되지 않은 작업을 버릴 수 있는 명령 전에 직접 `git status`를 실행하고, 스테이징되었거나 수정되었거나 추적되지 않은 작업이 있는지 분류기에 보여 줍니다. 저장소의 git 구성이 `status.showUntrackedFiles=no`로 설정되어 있어도 Claude Code는 이 검사에서 추적되지 않은 파일을 보고합니다.
609>610>
610> Claude Code 자체가 보내는 분류기 요청에서 분류기는 사용자 메시지, 파일 읽기 및 검색 같은 읽기 전용 조회를 제외한 도구 호출, 그리고 CLAUDE.md 내용을 봅니다. 이러한 요청에서는 도구 결과가 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 분류기를 직접 조작할 수 없습니다.611> Claude Code 자체가 보내는 분류기 요청에서 분류기는 사용자 메시지, 파일 읽기 및 검색 같은 읽기 전용 조회를 제외한 도구 호출, 그리고 CLAUDE.md 내용을 봅니다. 이러한 요청에서는 도구 결과가 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 분류기를 직접 조작할 수 없습니다.
611>612>
612> [PostToolUse 훅의 `classifierContext` 필드](https://code.claude.com/docs/ko/hooks#annotate-a-result-for-the-auto-mode-classifier)로 호출 결과에 주석을 달 수 있으며, 분류기는 이를 애플리케이션이 제공한 컨텍스트로 읽습니다. 이 필드에는 Claude Code v2.1.236 이상이 필요합니다.613> [PostToolUse 훅의 `classifierContext` 필드](https://code.claude.com/docs/ko/hooks#annotate-a-result-for-the-auto-mode-classifier)로 호출 결과에 주석을 달 수 있으며, 분류기는 이를 애플리케이션이 제공한 컨텍스트로 읽습니다. 이 필드에는 Claude Code v2.1.236 이상이 필요합니다.
613>614>
614> 별도의 서버 측 프로브가 들어오는 도구 결과를 검사하여 Claude가 읽기 전에 의심스러운 콘텐츠를 표시합니다. 이러한 계층이 함께 작동하는 방식에 대한 자세한 내용은 [자동 모드 발표](https://claude.com/blog/auto-mode)와 [엔지니어링 심층 분석](https://www.anthropic.com/engineering/claude-code-auto-mode)을 참조하십시오.615> 별도의 서버 측 프로브가 들어오는 도구 결과를 스캔하여 Claude가 읽기 전에 의심스러운 콘텐츠를 표시합니다. 이러한 계층이 함께 작동하는 방식에 대한 자세한 내용은 [자동 모드 발표](https://claude.com/blog/auto-mode)와 [엔지니어링 심층 분석](https://www.anthropic.com/engineering/claude-code-auto-mode)을 참조하십시오.
615 616
616> [accordion] 자동 모드가 서브에이전트를 처리하는 방식617> [accordion] 자동 모드가 서브에이전트를 처리하는 방식
617>618>
618> 분류기는 세 시점에서 [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md) 작업을 확인합니다.619> 분류기는 [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md) 작업을 세 시점에서 검사합니다.
619>620>
620> 1. 서브에이전트가 시작되기 전에 위임된 작업 설명이 평가되므로, 위험해 보이는 작업은 생성 시점에 차단됩니다.621> 1. 서브에이전트가 시작되기 전에 위임된 작업 설명이 평가되므로, 위험해 보이는 작업은 생성 시점에 차단됩니다.
621> 2. 서브에이전트가 실행되는 동안 각 작업은 부모 세션과 동일한 [결정 순서](#how-the-classifier-evaluates-actions)를 동일한 차단 및 허용 규칙으로 거칩니다. 서브에이전트의 frontmatter에 있는 `permissionMode`는 무시됩니다.622> 2. 서브에이전트가 실행되는 동안 각 작업은 상위 세션과 동일한 [결정 순서](#how-the-classifier-evaluates-actions)를 거치며, 동일한 차단 및 허용 규칙이 적용됩니다. 서브에이전트의 frontmatter에 있는 `permissionMode`는 무시됩니다.
622> 3. 서브에이전트가 완료되면, 부모가 보고서를 읽기 전에 분류기가 서브에이전트의 작업과 최종 보고서를 검토합니다. 분류기가 서브에이전트의 작업이나 보고서에서 문제를 지적하거나 별도의 API 안전 확인이 검토를 거부하는 경우에도 보고서는 전달되지만, 앞부분에 보안 경고가 추가됩니다. 검토에 분류기를 사용할 수 없는 경우, 보고서에는 이를 바탕으로 조치하기 전에 서브에이전트의 작업을 확인하라는 메모가 함께 전달됩니다.623> 3. 서브에이전트가 완료되면, 상위 세션이 보고서를 읽기 전에 분류기가 서브에이전트의 작업과 최종 보고서를 검토합니다. 분류기가 서브에이전트의 작업이나 보고서에 문제를 지적하거나, 별도의 API 안전 검사가 검토를 거부하는 경우에도 보고서는 보안 경고가 앞에 추가된 채로 전달됩니다. 검토 시 분류기를 사용할 수 없는 경우, 보고서는 이를 기반으로 행동하기 전에 서브에이전트의 작업을 확인하라는 메모와 함께 전달됩니다.
623 624
624> [accordion] 비용 및 지연 시간625> [accordion] 비용 및 지연 시간
625>626>
626> Claude Code의 분류기 요청은 `/model`에서 선택한 모델이 아닌 다른 모델에서 실행될 수 있습니다. [어떤 모델에서 실행되는지](#default-classifier-model)를 참조하십시오.627> Claude Code의 분류기 요청은 `/model`에서 선택한 모델과 다른 모델에서 실행될 수 있습니다. [어떤 모델에서 실행되는지](#default-classifier-model)를 참조하십시오.
627>628>
628> Enterprise 플랜과 Claude API, [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 사용하는 계정에서는 분류기 호출이 토큰 사용량에 포함됩니다. 각 확인은 트랜스크립트의 일부와 대기 중인 작업을 전송하므로 실행 전에 왕복 과정이 추가됩니다. 보호된 경로 밖의 읽기와 작업 디렉터리 편집은 분류기를 건너뛰므로, 오버헤드는 주로 셸 명령과 네트워크 작업에서 발생합니다. 서버가 세션의 모델 요청의 일부로 작업을 검토하는 경우에는 집계할 별도의 분류기 호출이 없습니다. [서버 측 분류기 검토](#server-side-classifier-review)를 참조하십시오.629> Enterprise 플랜과 Claude API, [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud's Agent Platform 또는 Microsoft Foundry를 사용하는 계정에서는 분류기 호출이 토큰 사용량에 포함됩니다. 각 검사는 트랜스크립트의 일부와 대기 중인 작업을 전송하므로, 실행 전에 왕복 시간이 추가됩니다. 보호된 경로 밖의 읽기와 작업 디렉터리 편집은 분류기를 건너뛰므로, 오버헤드는 주로 셸 명령과 네트워크 작업에서 발생합니다. 서버가 세션의 모델 요청의 일부로 작업을 검토하는 경우에는 별도로 집계되는 분류기 호출이 없습니다. [서버 측 분류기 검토](#server-side-classifier-review)를 참조하십시오.
629>630>
630> 샌드박스 처리된 네트워크 접근은 연결마다 분류기 요청을 추가하지 않습니다. 분류기는 [명령이 명시한 호스트](https://code.claude.com/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)를 명령과 함께 한 번의 검토로 판단하며, Claude Code는 분류기를 다시 호출하지 않고 승인된 목록에 따라 각 연결을 확인합니다.631> 샌드박스된 네트워크 접근은 연결별 분류기 요청을 추가하지 않습니다. 분류기는 [명령이 명시한 호스트](https://code.claude.com/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)를 한 번의 검토에서 명령과 함께 판단하며, Claude Code는 분류기를 다시 호출하지 않고 승인된 목록과 대조하여 각 연결을 확인합니다.
631 632
632## dontAsk 모드로 사전 승인된 도구만 허용633## dontAsk 모드로 사전 승인된 도구만 허용
633 634
738 739
739[`--restricted`](https://code.claude.com/docs/ko/cli-reference#cli-flags)로 시작된 세션에서(Claude Code v2.1.248 이상 필요) 분류기는 보호된 경로 쓰기를 승인할 수 없습니다.740[`--restricted`](https://code.claude.com/docs/ko/cli-reference#cli-flags)로 시작된 세션에서(Claude Code v2.1.248 이상 필요) 분류기는 보호된 경로 쓰기를 승인할 수 없습니다.
740 741
742[`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ko/settings-reference#permissions-blockwritesoutsideworkingdirectories)가 켜져 있는 동안 Claude Code는 모든 권한 모드에서 설정 파일에 대한 `Write`, `Edit`, `NotebookEdit` 쓰기를 거부합니다.
743
741보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 [symlink check](https://code.claude.com/docs/ko/permissions.md#symlinks)가 보호된 경로로 확인하는 쓰기가 Claude가 요청한 경로 자체가 보호되지 않을 때 대신 프롬프트를 표시합니다.744보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 [symlink check](https://code.claude.com/docs/ko/permissions.md#symlinks)가 보호된 경로로 확인하는 쓰기가 Claude가 요청한 경로 자체가 보호되지 않을 때 대신 프롬프트를 표시합니다.
742 745
743설정 파일의 [`permissions.allow`](https://code.claude.com/docs/ko/permissions#manage-permissions) 규칙은 보호된 경로 쓰기를 사전에 승인하지 않습니다. 안전 확인은 Claude Code가 설정에서 allow 규칙을 평가하기 전에 실행되므로, `~/.claude/settings.json` 또는 `.claude/settings.json`의 `Edit(.claude/**)` 같은 항목은 위 표의 모드별 결과를 변경하지 않습니다. 프롬프트를 표시하는 모드에서는 프로젝트의 `.claude/` 폴더 또는 `~/.claude/`에 대한 쓰기 프롬프트가 다음 세션 범위 옵션 중 하나를 제공할 수 있습니다:746설정 파일의 [`permissions.allow`](https://code.claude.com/docs/ko/permissions#manage-permissions) 규칙은 보호된 경로 쓰기를 사전에 승인하지 않습니다. 안전 확인은 Claude Code가 설정에서 allow 규칙을 평가하기 전에 실행되므로, `~/.claude/settings.json` 또는 `.claude/settings.json`의 `Edit(.claude/**)` 같은 항목은 위 표의 모드별 결과를 변경하지 않습니다. 프롬프트를 표시하는 모드에서는 프로젝트의 `.claude/` 폴더 또는 `~/.claude/`에 대한 쓰기 프롬프트가 다음 세션 범위 옵션 중 하나를 제공할 수 있습니다:
776* `.devcontainer.json`779* `.devcontainer.json`
777* `.ripgreprc`, `pyrightconfig.json`780* `.ripgreprc`, `pyrightconfig.json`
778* `.mcp.json`, `.claude.json`781* `.mcp.json`, `.claude.json`
782* `~/.claude` 또는 [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ko/env-vars)이 가리키는 디렉토리에 있는 `remote-settings.json`(조직의 [서버 관리 설정](https://code.claude.com/docs/ko/server-managed-settings.md)의 저장된 사본)과 Claude Code가 이와 함께 보관하는 서명, 동기화, 동의 파일
779* 세션을 시작할 때 [`--settings`](https://code.claude.com/docs/ko/cli-reference#cli-flags), `--mcp-config` 또는 `--agents`에 전달한 파일783* 세션을 시작할 때 [`--settings`](https://code.claude.com/docs/ko/cli-reference#cli-flags), `--mcp-config` 또는 `--agents`에 전달한 파일
780* 사용자, 프로젝트 또는 로컬 [설정 파일](https://code.claude.com/docs/ko/settings.md#settings-files-and-who-they-affect) 자체가 심볼릭 링크일 때(예: dotfiles 저장소로 연결되는 경우) 해당 설정 파일이 가리키는 파일. 보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 allow 규칙이 일치하더라도 이 파일에 대한 쓰기는 대신 확인을 요청합니다. 파일 자체의 경로가 다른 폴더의 `.claude/settings.json`처럼 설정 파일의 경로이기도 한 경우, 해당 쓰기는 다른 보호된 경로 쓰기와 마찬가지로 분류기로 전달됩니다784* 사용자, 프로젝트 또는 로컬 [설정 파일](https://code.claude.com/docs/ko/settings.md#settings-files-and-who-they-affect) 자체가 심볼릭 링크일 때(예: dotfiles 저장소로 연결되는 경우) 해당 설정 파일이 가리키는 파일. 보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 allow 규칙이 일치하더라도 이 파일에 대한 쓰기는 대신 확인을 요청합니다. 파일 자체의 경로가 다른 폴더의 `.claude/settings.json`처럼 설정 파일의 경로이기도 한 경우, 해당 쓰기는 다른 보호된 경로 쓰기와 마찬가지로 분류기로 전달됩니다
781 785
