권한 모드 선택

Claude가 작업하기 전에 묻는지 여부를 제어합니다. CLI에서 Shift+Tab, VS Code의 모드 표시기 또는 Desktop의 모드 선택기로 권한 모드를 전환합니다.

권한 모드는 Claude가 먼저 묻지 않고 세션에서 수행할 수 있는 작업을 설정합니다. Manual 모드에서는 Claude Code가 파일을 편집하거나 셸 명령을 실행하거나 네트워크에 접근하는 대부분의 작업 전에 멈추고 사용자에게 묻습니다. auto 모드에서는 두 번째 모델인 분류기가 사용자 대신 작업을 검토합니다. 분류기가 작업을 평가하는 방식에서는 분류기가 검토하는 작업과 건너뛰는 작업을 나열합니다.

Claude Code v2.1.283 이상에서는 auto 모드가 대화형 터미널 및 VS Code 세션의 기본 제공 시작 권한 모드입니다. 이전 버전에서는 Pro, Max, Team 플랜에서만 기본 제공되는 시작 권한 모드입니다. 세션이 시작되는 모드에서는 시작 권한 모드를 변경하는 표면과 설정을 다룹니다. 실행 중인 세션의 권한 모드는 언제든지 변경할 수 있습니다.

사용 가능한 모드

각 모드는 편의성과 감시 사이에서 서로 다른 트레이드오프를 만듭니다. 아래 표는 각 모드에서 Claude가 권한 프롬프트 없이 수행할 수 있는 작업을 보여줍니다. 수동 모드는 구성 값인 default 아래에 나타납니다.

모드	요청 없이 실행되는 작업	최적 사용 사례
`default`	읽기만	모든 작업을 직접 검토, 민감한 작업
`acceptEdits`	읽기, 파일 편집, 일반적인 파일시스템 명령어 (`mkdir`, `touch`, `mv`, `cp` 등)	검토 중인 코드 반복 작업
`plan`	읽기, 그리고 자동 모드를 사용할 수 있을 때 분류기 승인 명령어	변경 전 코드베이스 탐색
`auto`	백그라운드 안전 검사를 포함한 모든 작업	장시간 작업, 프롬프트 피로 감소
`dontAsk`	작업 디렉터리 내부의 파일 읽기 및 사전 승인된 도구; 프롬프트를 표시할 모든 작업은 거부됨. 단, 설치한 mod는 이러한 호출 중 일부를 여전히 승인할 수 있음	잠금된 CI 및 스크립트
`bypassPermissions`	모든 작업	격리된 컨테이너 및 VM만 해당

모든 작업을 검토하는 모드는 CLI에서 Manual이라고 명명되며, claude --help에서, VS Code 및 JetBrains 확장 프로그램에서, 그리고 데스크톱 앱에서도 Manual이라고 명명됩니다. 구성 값은 default이며, 이는 훅 및 SDK 통합이 사용하는 값입니다. CLI는 값을 입력하는 모든 곳에서 manual을 별칭으로 허용합니다. 예를 들어 claude --permission-mode manual 또는 "defaultMode": "manual"입니다.

보호된 경로에 대한 쓰기는 bypassPermissions 모드에서와 bypass 권한을 사용할 수 있는 plan-mode 세션에서를 제외하고는 자동 승인되지 않습니다. 이는 모드 사이클에 bypassPermissions를 배치하는 방식으로 시작된 대화형 터미널 세션을 의미합니다.

모드는 기준선을 설정합니다. 특정 도구를 사전 승인하거나 차단하기 위해 권한 규칙을 위에 계층화합니다. 거부 규칙은 bypassPermissions를 포함한 모든 모드에서 차단합니다. 거부 및 요청 규칙은 Claude가 호출할 수 있는 다른 도구가 최소 하나 이상 있는 한 EndConversation에 적용되지 않습니다. 허용 규칙은 bypassPermissions에서 효과가 없습니다.

어떤 모드도 자동 승인하지 않는 작업

Claude Code는 bypassPermissions를 포함한 어떤 모드에서도 다음을 자동 승인하지 않습니다. 각 항목은 각 모드에서 대신 어떤 일이 발생하는지를 설명하는 섹션으로 연결됩니다:

명시적 요청 규칙과 일치하는 도구
조직이 ask로 설정한 커넥터 도구, 해당 설정이 Claude Code에 도달하는 세션에서
사용자 상호작용이 필요한 도구: 기본 제공 AskUserQuestion 도구 및 requiresUserInteraction으로 표시된 MCP 도구
인식된 rm 및 rmdir 중요 경로 제거, 어떤 허용 규칙이나 PreToolUse 훅 "allow"도 승인하지 않음
세션 간 메시징 보안 조치
permissions.blockReadsOutsideWorkingDirectories가 켜져 있는 동안 작업 디렉토리 외부의 읽기: 인식된 파일 읽기 Bash 명령어는 자동 모드 및 bypassPermissions 모드에서도 프롬프트하며, 샌드박스 외부에서 실행하기 위해 승인이 필요한 모든 샌드박스 해제 재시도도 마찬가지입니다. Claude Code v2.1.257 이상이 필요합니다.

셸 파서가 추적할 수 없는 명령어(예: 두 번 이상 디렉토리를 변경하거나 서브셸을 실행하는 명령어)는 외부 경로를 명명하지 않더라도 동일한 방식으로 프롬프트합니다. 이 프롬프트는 명령어가 샌드박스에서 실행되고 샌드박스가 블록을 적용할 때는 적용되지 않습니다.

일반적인 설정

권한 모드는 Claude가 작업 전에 물어보는지 여부를 결정하고, Bash sandbox 및 외부 isolation boundaries는 작업이 실행되면 도달할 수 있는 것을 결정합니다. 아래의 각 행은 목표를 시작점으로 그곳에 도달하는 플래그 또는 설정 및 필요한 격리와 쌍을 이룹니다. 사용 가능한 모드는 각 모드에서 프롬프트 없이 실행되는 것을 나열합니다.

원하는 것	시작	필요한 격리	참고
모든 작업을 직접 검토	Manual 모드: `claude --permission-mode default`	없음	민감한 작업, 낯선 코드
분류기 없이 더 적은 프롬프트로 로컬에서 반복	Manual 모드 + auto-allow mode의 Bash sandbox: `claude --permission-mode default`, 그 다음 `/sandbox` 실행 및 auto-allow 선택	기본 제공 Bash sandbox, macOS, Linux, WSL2	Deny 규칙은 여전히 적용되고, `Bash(git push *)`와 같이 명령을 지정하는 ask 규칙은 여전히 프롬프트합니다. 확인을 요청할 수 있는 그 밖의 명령은 Auto-allow mode에서 다룹니다. 설정 파일에서 대신 sandbox를 켜려면 `sandbox.enabled`를 `true`로 설정합니다.
변경 전에 탐색	`claude --permission-mode plan`	없음	Claude Code는 계획을 승인할 때까지 편집을 차단합니다.
auto mode에서 자동 실행	`claude --permission-mode auto`, 기본 제공 시작 권한 모드 v2.1.283 이상	없음; sandbox 또는 컨테이너는 심층 방어를 추가합니다.	지원되는 모델이 필요하고, 조직이 auto mode를 끌 수 있습니다.
정확한 allowlist로 CI에서 실행	`claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"`	CI 러너가 제공하는 것 이상 없음	Cloud sessions는 설정 파일의 `dontAsk`를 무시합니다.
컨테이너 내에서 완전히 자동 실행	`claude -p "<prompt>" --dangerously-skip-permissions`	필수: 컨테이너, VM, 또는 sandbox runtime; Linux 및 macOS에서 non-root user로 실행	Cloud sessions는 설정 파일의 이 모드를 무시합니다. 이 `-p` 실행에서 여전히 프롬프트할 몇 가지 호출은 대신 거부됩니다.

Bash sandbox와 auto mode는 독립적으로 작동하고 결합합니다. Sandbox modes에 나열된 예외가 있습니다. 전체 상호작용은 How sandboxing relates to permissions and permission modes 및 How isolation relates to permission modes를 참조하세요.

세션이 시작되는 모드

터미널에서 새 세션을 시작할 때 Claude Code는 다음 중 적용되는 첫 번째 항목에서 권한 모드를 가져옵니다.

--permission-mode 플래그 또는 --dangerously-skip-permissions
설정 파일의 permissions.defaultMode

.claude/settings.json 또는 .claude/settings.local.json에서 "auto"를 설정하면 해당 값이 적용되지 않으며, Claude Code는 ~/.claude/settings.json의 defaultMode 대신 기본 제공 기본값을 사용합니다. 이 두 파일에서 "bypassPermissions"를 설정하면 역시 적용되지 않으며, 세션은 수동 모드에서 시작됩니다. 다른 값들은 모든 설정 파일에서 적용됩니다.
기본 제공 기본값

VS Code 확장 프로그램이 시작하는 대화는 권한 모드 전환의 확장 프로그램 자체 목록을 따릅니다. Claude Code가 재개된 세션을 시작하는 권한 모드에 대해서는 재개 시 권한 모드를 참조하세요.

기본 제공 auto 기본값은 macOS, Linux 및 WSL에서 Claude Code v2.1.228 이상이 필요하며, 기본 Windows에서는 v2.1.233 이상이 필요합니다. 이전 버전에서는 기본 제공 기본값이 수동입니다.

기본 제공 기본값은 Claude Code를 실행하는 방식에 따라 달라집니다. 세션과 일치하는 첫 번째 행이 적용됩니다. 이 표는 터미널이나 VS Code 확장 프로그램을 통해 시작하는 세션을 다룹니다. 데스크톱 앱 및 claude.ai의 경우 권한 모드 전환의 데스크톱 및 웹 탭을 참조하세요.

Claude Code를 실행하는 방식	기본 제공 시작 권한 모드
모든 설정 파일이 `disableAutoMode`를 `"disable"`로 설정	`default`
`claude -p` 또는 Agent SDK	`default`
조직에 HIPAA 구성이 적용되어 있고 세션이 적용 대상인 경우	Claude Code v2.1.285 이상에서 `default`. 자동 모드로 전환하는 것은 계속 가능합니다
터미널 또는 VS Code 확장 프로그램을 통해	Claude Code v2.1.283 이상에서 `auto`; 이전 버전에서는 기능 플래그를 가져오는 세션에서 Pro, Max 또는 Team 플랜의 `auto`, 그 외에는 `default`

플래그, 설정 파일 또는 기본 제공 기본값이 auto를 선택하지만 자동 모드를 세션에서 사용할 수 없는 경우, Claude Code는 대신 수동 모드에서 세션을 시작합니다. 자동 모드는 세션이 가용성 요구 사항을 충족하지 않을 때(예: 설정 파일이 자동 모드를 비활성화하거나 지원하지 않는 모델) 또는 Anthropic이 서버 측에서 임시로 자동 모드를 비활성화했을 때 사용할 수 없습니다.

기본 제공 기본값이 처음으로 세션 중 하나를 자동 모드에서 시작할 때, Claude Code는 이 페이지로 연결되는 알림을 표시합니다.

터미널에서 세션 맨 위에 한 번
VS Code 확장 프로그램에서 새 대화 화면의 카드로 표시되며, 이를 닫을 때까지 유지됩니다.

~/.claude/settings.json이 auto 이외의 defaultMode를 설정하고 다른 설정 파일이 설정하지 않으면, 세션은 계속해서 해당 모드에서 시작됩니다. Pro, Max 및 Team 플랜에서, 그리고 기능 플래그를 가져오지 않는 세션에서 Claude Code는 터미널 또는 VS Code 확장 프로그램에서 한 번 설정을 자동 모드로 변경할지 여부를 묻습니다. 거절하면 설정은 그대로 유지됩니다.

`claude -p` 및 Agent SDK 실행에서 거부되는 도구 호출

Claude Code v2.1.302 이상에서는 권한 모드가 설정되지 않은 claude -p 및 Agent SDK 실행이 수동 모드에서 시작됩니다. 이 모드는 SDK 옵션과 설정에서 default로 표시됩니다. 승인이 필요한 호출은 허용 규칙, 훅, canUseTool 콜백 또는 --permission-prompt-tool로 승인하지 않는 한 거부됩니다.

이러한 호출이 승인되도록 하려면 허용 규칙을 추가하거나 자동 모드에서 시작합니다.

허용 규칙 추가: Claude는 나열된 호출을 실행합니다. claude -p에 --allowedTools "Bash(npm test)"를 전달하거나 SDK의 허용 도구 옵션을 설정합니다.
자동 모드에서 시작: 분류기 모델이 호출을 검토하므로 미리 나열할 필요가 없습니다. claude -p에 --permission-mode auto를 전달하거나 SDK의 권한 모드 옵션을 설정합니다.

다음 예제는 CLI와 각 SDK에서 자동 모드를 사용하는 형태를 보여 줍니다.

CLI

claude -p "Run the test suite and fix any failures" --permission-mode auto

TypeScript

const options = {
  permissionMode: "auto"
};

Python

from claude_agent_sdk import ClaudeAgentOptions

options = ClaudeAgentOptions(permission_mode="auto")

v2.1.302 이전에는 이러한 실행이 기능 플래그를 가져오지 않는 경우(예: 타사 공급자 사용 시 또는 DISABLE_TELEMETRY 설정 시) 자동 모드에서 시작될 수 있었습니다.

다른 권한 모드에서 시작

한 세션에 대해 또는 머신, 프로젝트 또는 조직의 모든 세션에 대한 기본값으로 시작 권한 모드를 설정할 수 있습니다. 둘 이상의 설정 파일이 permissions.defaultMode를 설정할 때 설정 우선순위가 결정하므로, 프로젝트 또는 관리형 값이 ~/.claude/settings.json을 능가합니다. 이미 실행 중인 세션의 권한 모드를 변경하려면 권한 모드 전환을 참조하세요.

시작 권한 모드를 설정하는 대상	수행할 작업
시작하려는 한 세션	권한 모드를 플래그로 전달합니다. 예: `claude --permission-mode default`
이 머신에서 시작하는 모든 터미널 세션	`~/.claude/settings.json`에서 `permissions.defaultMode`를 설정합니다. VS Code 확장 프로그램이 읽는 내용은 권한 모드 전환을 참조하세요.
한 프로젝트에서 시작하는 모든 터미널 세션	프로젝트의 `.claude/settings.json`에서 `permissions.defaultMode`를 설정합니다. 터미널에서 시작하는 세션은 `auto` 및 `bypassPermissions`을 제외한 모든 값을 준수합니다. VS Code 확장 프로그램이 시작하는 세션은 시작 권한 모드에 대한 프로젝트 설정을 읽지 않습니다.
조직의 모든 터미널 세션	관리형 설정에서 `permissions.defaultMode`를 설정합니다. 터미널 세션은 해당 모드에서 시작되며 사용자는 여전히 자동 모드로 전환할 수 있습니다. VS Code 확장 프로그램이 읽는 내용은 권한 모드 전환을 참조하세요. 자동 모드를 제거하여 아무도 선택할 수 없도록 하려면 대신 `permissions.disableAutoMode`를 `"disable"`로 설정합니다.

이 예제는 머신의 모든 터미널 세션이 수동 모드(구성 값은 default)에서 시작되도록 합니다. ~/.claude/settings.json에 저장합니다.

{
  "permissions": {
    "defaultMode": "default"
  }
}

다음 세션을 시작하면 상태 표시줄에 ⏸ manual mode on이 표시됩니다.

HIPAA 구성에서의 권한 모드

HIPAA 구성이 적용된 조직에서는 기본 제공 auto 기본값이 적용되지 않습니다. 시작 권한 모드를 선택하는 다른 항목이 없으면 터미널 또는 VS Code 세션은 수동 모드에서 시작됩니다. 터미널 세션에는 Auto mode isn't the default for your organization · Shift+Tab to switch도 표시되며, VS Code 확장 프로그램에는 알림이 표시되지 않습니다. 이 내용이 적용되는 세션은 개발자의 로그인 및 연결 방식 확인에 나와 있습니다.

자동 모드와 bypassPermissions는 계속 사용할 수 있습니다.

자동 모드로 전환: Shift+Tab을 누르거나 사용 중인 인터페이스의 컨트롤을 사용합니다
자동 모드에서 시작: --permission-mode auto를 전달하거나, 사용자 설정에서 또는 조직 전체의 경우 관리형 설정에서 permissions.defaultMode를 auto로 설정합니다. 다른 권한 모드에서 시작을 참조하세요
자동 모드 제거: 관리형 설정에서 permissions.disableAutoMode를 "disable"로 설정합니다
bypassPermissions 차단: 관리형 설정에서 permissions.disableBypassPermissionsMode를 "disable"로 설정합니다

HIPAA 구성의 최소 버전인 Claude Code v2.1.285 이상이 필요합니다.

권한 모드 전환

각 인터페이스는 세션 중에 권한 모드를 전환하기 위한 자체 컨트롤과 새 세션이 시작되는 권한 모드를 선택하는 자체 방법을 가집니다. 인터페이스를 선택하여 컨트롤을 확인하세요.

CLI

세션 중: Shift+Tab을 눌러 권한 모드를 순환합니다. auto에서 처음 누르면 default로 전환되고, 이후 순환은 default → acceptEdits → plan 순으로 진행됩니다. 선택적 모드는 plan 뒤에 들어갑니다. 상태 표시줄은 활성 모드를 default의 경우 회색 ⏸ manual mode on으로, 또는 ⏵⏵ accept edits on, ⏸ plan mode on, ⏵⏵ auto mode on, ⏵⏵ don't ask on, 또는 ⏵⏵ bypass permissions on으로 표시합니다.

자동 모드에서 시작한 세션을 담은 이 클립에서 상태 표시줄을 확인하세요. Shift+Tab을 누를 때마다 상태 표시줄이 auto mode on에서 manual mode on, accept edits on, plan mode on으로 바뀌었다가 다시 auto mode on으로 돌아옵니다.

UI 레이블	모드
Manual	`default`
Edit automatically	`acceptEdits`
Plan	`plan`
Auto	`auto`
Bypass permissions	`bypassPermissions`

세션	분류기 모델
Anthropic이 구성한 분류기 모델이 있음	구성된 모델. 어떤 모델인지 디버그 로그를 확인하세요
Claude Sonnet 4.6에서 실행됨	Sonnet 4.6
`ANTHROPIC_DEFAULT_SONNET_MODEL`이 설정됨	해당 값, 또는 값이 Claude Sonnet 5.5 또는 Claude Opus 5.5이면 Sonnet 5

상황	발생하는 일	수행할 작업
디버그 로그에 Anthropic이 구성한 분류기 모델이 보고됨	해당 모델이 검토합니다	필요 없음
Claude Opus 5, Sonnet 5.5, Opus 5.5 또는 조직의 모델 정책에서 제외하는 모델을 설정함	기본 분류기 모델이 검토합니다	다른 모델을 설정하세요
제공자가 해당 모델을 제공할 수 없음	분류기 검사가 실패하므로 Claude Code가 검사하는 각 작업을 거부합니다	제공자가 제공하는 모델을 설정하거나 변수를 제거하세요
세션에서 `/status`에 `Auto mode server`가 `Enabled`로 표시됨	지정한 모델 없이 서버가 검토합니다	필요 없음

모드	보호된 경로 쓰기
`default`, `acceptEdits`	프롬프트됨
`plan`	bypass permissions를 사용할 수 있는 대화형 터미널 세션에서 허용됨. 그렇지 않으면 계획 중에 auto mode를 사용할 수 있을 때 분류기로 라우팅되고, 그렇지 않으면 프롬프트됨
`auto`	분류기로 라우팅됨
`dontAsk`	거부됨
`bypassPermissions`	허용됨

Target	Example	Why it counts
셸 변수 직접 아래의 glob 또는 후행 슬래시	`rm -rf "$DIR"/*`	변수가 비어 있으면 명령이 파일시스템 루트에서 제거가 됩니다
`$1` 또는 `$@`와 같은 위치 매개변수 아래의 동일한 형식, 명령에서 값을 제공하는 것이 없을 때	`rm -rf "$1"/*`	명령이 루트에서 제거로 확장됩니다
셸 변수 다음에 하나의 일반적인 최상위 디렉토리 이름(예: `mnt`, `tmp`, `usr`, `Users`)	`rm -rf "$TMPDIR/mnt"`	변수가 비어 있으면 명령이 `/mnt`를 제거합니다
같은 명령이 디렉토리 출력 치환(예: `$(pwd)` 또는 `$(git rev-parse --show-toplevel)`)에서 할당하는 변수	`D=$(pwd); rm -rf "$D"`	값은 작업 디렉토리 또는 저장소 루트의 이름을 지정할 수 있습니다
명령 치환의 출력만인 대상, `rm`이 recursive일 때	`rm -rf "$(pwd)"`	Claude Code는 명령이 실행되기 전에 대상을 확인할 수 없습니다
critical path 다음의 후행 명령 치환	`rm -rf ~/$(cmd)`	Claude Code는 치환이 비어 있으면 남아 있을 경로(여기서는 홈 디렉토리)를 확인합니다
백슬래시만 있는 대상	`rm -rf "\\"`	Windows의 Git Bash는 단일 백슬래시를 현재 드라이브의 루트로 읽으므로 확인이 모든 플랫폼에 적용됩니다
드라이브 문자 대신 GUID로 볼륨을 지정하는 Windows 경로	`rm -rf '\\?\Volume{GUID}\work\build'`	경로가 어느 드라이브에 있는지 나타내지 않으므로 critical path일 수 있습니다. Claude Code v2.1.292 이상이 필요합니다
`/` 또는 `//`로 끝나는 일부 대상	`rm -rf logs//`, `rm -rf logs//`, `cd logs && rm -rf a/`	Claude Code는 명령이 실행되기 전에 이러한 대상이 어떤 디렉터리에 도달하는지 알 수 없습니다

Under	Path shapes that get the prompt	Examples
`/Volumes`	`/Volumes/<drive>`, `/Volumes/<drive>/<name>`	`/Volumes/USB`, `/Volumes/USB/build`
`/System/Volumes`	`/System/Volumes`, `/System/Volumes/<volume>`, `/System/Volumes/<volume>/<name>`	`/System/Volumes/Data`
`/media`	`/media/<user>`, `/media/<user>/<drive>`, `/media/<user>/<drive>/<name>`	`/media/alex`
`/run/media`	`/run/media`, `/run/media/<user>`, `/run/media/<user>/<drive>`, `/run/media/<user>/<drive>/<name>`	`/run/media/alex/USB/build`
`/mnt`	`/mnt/<name>`, 그리고 WSL의 `/mnt/c`와 같은 한 글자 마운트 아래의 `/mnt/<letter>/<name>`	`/mnt/data`, `/mnt/c/Users`

Mode	Outcome
`default`, `acceptEdits`	승인을 요청합니다
`plan`	승인을 요청합니다. 계획 중에 분류기가 명령을 검토할 때 bypass permissions를 사용할 수 없으면 `auto` mode처럼 처리합니다
`auto`	터미널에서 시간 제한과 함께 승인을 요청합니다. 다른 곳에서는 거부합니다
`dontAsk`	거부합니다
`bypassPermissions`	터미널에서 시간 제한과 함께 승인을 요청합니다

permission-modes.md +146 −126

23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | 작업 디렉터리 내부의 파일 읽기 및 사전 승인된 도구; 프롬프트를 표시할 모든 작업은 거부됨. 단, 설치한 [mod](/docs/ko/plugins/mods/overview)는 이러한 호출 중 일부를 여전히 승인할 수 있음 | 잠금된 CI 및 스크립트 |23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | 작업 디렉터리 내부의 파일 읽기 및 사전 승인된 도구; 프롬프트를 표시할 모든 작업은 거부됨. 단, 설치한 [mod](/docs/ko/plugins/mods/overview.md)는 이러한 호출 중 일부를 여전히 승인할 수 있음 | 잠금된 CI 및 스크립트 |

25 25

26모든 작업을 검토하는 모드는 CLI에서 **Manual**이라고 명명되며, `claude --help`에서, VS Code 및 JetBrains 확장 프로그램에서, 그리고 데스크톱 앱에서도 **Manual**이라고 명명됩니다. 구성 값은 `default`이며, 이는 훅 및 SDK 통합이 사용하는 값입니다. CLI는 값을 입력하는 모든 곳에서 `manual`을 별칭으로 허용합니다. 예를 들어 `claude --permission-mode manual` 또는 `"defaultMode": "manual"`입니다.26모든 작업을 검토하는 모드는 CLI에서 **Manual**이라고 명명되며, `claude --help`에서, VS Code 및 JetBrains 확장 프로그램에서, 그리고 데스크톱 앱에서도 **Manual**이라고 명명됩니다. 구성 값은 `default`이며, 이는 훅 및 SDK 통합이 사용하는 값입니다. CLI는 값을 입력하는 모든 곳에서 `manual`을 별칭으로 허용합니다. 예를 들어 `claude --permission-mode manual` 또는 `"defaultMode": "manual"`입니다.

27 27

28[보호된 경로](#protected-paths)에 대한 쓰기는 `bypassPermissions` 모드에서와 bypass 권한을 사용할 수 있는 plan-mode 세션에서를 제외하고는 자동 승인되지 않습니다. 이는 [모드 사이클에 `bypassPermissions`를 배치하는 방식으로 시작된](#switch-permission-modes) 대화형 터미널 세션을 의미합니다.28[보호된 경로](#protected-paths)에 대한 쓰기는 `bypassPermissions` 모드에서와 bypass 권한을 사용할 수 있는 plan-mode 세션에서를 제외하고는 자동 승인되지 않습니다. 이는 [모드 사이클에 `bypassPermissions`를 배치하는 방식으로 시작된](#switch-permission-modes) 대화형 터미널 세션을 의미합니다.

29 29

30모드는 기준선을 설정합니다. 특정 도구를 사전 승인하거나 차단하기 위해 [권한 규칙](/docs/ko/permissions#manage-permissions)을 위에 계층화합니다. 거부 규칙은 `bypassPermissions`를 포함한 모든 모드에서 차단합니다. 거부 및 요청 규칙은 Claude가 호출할 수 있는 다른 도구가 최소 하나 이상 있는 한 [`EndConversation`](/docs/ko/tools-reference#endconversation-tool-behavior)에 적용되지 않습니다. 허용 규칙은 `bypassPermissions`에서 효과가 없습니다.30모드는 기준선을 설정합니다. 특정 도구를 사전 승인하거나 차단하기 위해 [권한 규칙](/docs/ko/permissions.md#manage-permissions)을 위에 계층화합니다. 거부 규칙은 `bypassPermissions`를 포함한 모든 모드에서 차단합니다. 거부 및 요청 규칙은 Claude가 호출할 수 있는 다른 도구가 최소 하나 이상 있는 한 [`EndConversation`](/docs/ko/tools-reference#endconversation-tool-behavior)에 적용되지 않습니다. 허용 규칙은 `bypassPermissions`에서 효과가 없습니다.

31 31

32### 어떤 모드도 자동 승인하지 않는 작업32### 어떤 모드도 자동 승인하지 않는 작업

33 33

34Claude Code는 `bypassPermissions`를 포함한 어떤 모드에서도 다음을 자동 승인하지 않습니다. 각 항목은 각 모드에서 대신 어떤 일이 발생하는지를 설명하는 섹션으로 연결됩니다:34Claude Code는 `bypassPermissions`를 포함한 어떤 모드에서도 다음을 자동 승인하지 않습니다. 각 항목은 각 모드에서 대신 어떤 일이 발생하는지를 설명하는 섹션으로 연결됩니다:

35 35

~~36* 명시적 [요청 규칙](/docs/ko/permissions#manage-permissions)과 일치하는 도구~~36* 명시적 [요청 규칙](/docs/ko/permissions.md#manage-permissions)과 일치하는 도구

37* 조직이 [`ask`로 설정한](/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구, 해당 설정이 Claude Code에 도달하는 세션에서37* 조직이 [`ask`로 설정한](/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구, 해당 설정이 Claude Code에 도달하는 세션에서

38* 사용자 상호작용이 필요한 도구: 기본 제공 `AskUserQuestion` 도구 및 [`requiresUserInteraction`](/docs/ko/mcp#require-approval-for-a-specific-tool)으로 표시된 MCP 도구38* 사용자 상호작용이 필요한 도구: 기본 제공 `AskUserQuestion` 도구 및 [`requiresUserInteraction`](/docs/ko/mcp#require-approval-for-a-specific-tool)으로 표시된 MCP 도구

~~39* [중요 경로](#critical-paths)를 대상으로 하는 `rm` 및 `rmdir` 제거, 어떤 허용 규칙이나 `PreToolUse` hook `"allow"`도 승인하지 않음~~39* 인식된 `rm` 및 `rmdir` [중요 경로 제거](#critical-paths), 어떤 허용 규칙이나 `PreToolUse` 훅 `"allow"`도 승인하지 않음

40* [세션 간 메시징 보안 조치](#skip-all-checks-with-bypasspermissions-mode)40* [세션 간 메시징 보안 조치](#skip-all-checks-with-bypasspermissions-mode)

41* [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 켜져 있는 동안 작업 디렉토리 외부의 읽기: 인식된 파일 읽기 Bash 명령어는 자동 모드 및 `bypassPermissions` 모드에서도 프롬프트하며, 샌드박스 외부에서 실행하기 위해 승인이 필요한 모든 [샌드박스 해제 재시도](/docs/ko/sandboxing#the-unsandboxed-retry-escape-hatch)도 마찬가지입니다. Claude Code v2.1.257 이상이 필요합니다.41* [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 켜져 있는 동안 작업 디렉토리 외부의 읽기: 인식된 파일 읽기 Bash 명령어는 자동 모드 및 `bypassPermissions` 모드에서도 프롬프트하며, 샌드박스 외부에서 실행하기 위해 승인이 필요한 모든 [샌드박스 해제 재시도](/docs/ko/sandboxing.md#the-unsandboxed-retry-escape-hatch)도 마찬가지입니다. Claude Code v2.1.257 이상이 필요합니다.

42 42

43 셸 파서가 추적할 수 없는 명령어(예: 두 번 이상 디렉토리를 변경하거나 서브셸을 실행하는 명령어)는 외부 경로를 명명하지 않더라도 동일한 방식으로 프롬프트합니다. 이 프롬프트는 명령어가 [샌드박스](/docs/ko/sandboxing)에서 실행되고 샌드박스가 블록을 적용할 때는 적용되지 않습니다.43 셸 파서가 추적할 수 없는 명령어(예: 두 번 이상 디렉토리를 변경하거나 서브셸을 실행하는 명령어)는 외부 경로를 명명하지 않더라도 동일한 방식으로 프롬프트합니다. 이 프롬프트는 명령어가 [샌드박스](/docs/ko/sandboxing.md)에서 실행되고 샌드박스가 블록을 적용할 때는 적용되지 않습니다.

44 44

45## 일반적인 설정45## 일반적인 설정

46 46

47권한 모드는 Claude가 작업 전에 물어보는지 여부를 결정하고, [Bash sandbox](/docs/ko/sandboxing) 및 외부 [isolation boundaries](/docs/ko/sandbox-environments)는 작업이 실행되면 도달할 수 있는 것을 결정합니다. 아래의 각 행은 목표를 시작점으로 그곳에 도달하는 플래그 또는 설정 및 필요한 격리와 쌍을 이룹니다. [사용 가능한 모드](#available-modes)는 각 모드에서 프롬프트 없이 실행되는 것을 나열합니다.47권한 모드는 Claude가 작업 전에 물어보는지 여부를 결정하고, [Bash sandbox](/docs/ko/sandboxing.md) 및 외부 [isolation boundaries](/docs/ko/sandbox-environments.md)는 작업이 실행되면 도달할 수 있는 것을 결정합니다. 아래의 각 행은 목표를 시작점으로 그곳에 도달하는 플래그 또는 설정 및 필요한 격리와 쌍을 이룹니다. [사용 가능한 모드](#available-modes)는 각 모드에서 프롬프트 없이 실행되는 것을 나열합니다.

48 48

49| 원하는 것 | 시작 | 필요한 격리 | 참고 |49| 원하는 것 | 시작 | 필요한 격리 | 참고 |

50| :- | :- | :- | :- |50| :- | :- | :- | :- |

51| 모든 작업을 직접 검토 | Manual 모드: `claude --permission-mode default` | 없음 | 민감한 작업, 낯선 코드 |51| 모든 작업을 직접 검토 | Manual 모드: `claude --permission-mode default` | 없음 | 민감한 작업, 낯선 코드 |

52| 분류기 없이 더 적은 프롬프트로 로컬에서 반복 | Manual 모드 + [auto-allow mode](/docs/ko/sandboxing#sandbox-modes)의 Bash sandbox: `claude --permission-mode default`, 그 다음 `/sandbox` 실행 및 auto-allow 선택 | 기본 제공 Bash sandbox, macOS, Linux, WSL2 | Deny 규칙은 여전히 적용되고, `Bash(git push *)`와 같이 명령을 지정하는 ask 규칙은 여전히 프롬프트합니다. 확인을 요청할 수 있는 그 밖의 명령은 [Auto-allow mode](/docs/ko/sandboxing#auto-allow-mode)에서 다룹니다. 설정 파일에서 대신 sandbox를 켜려면 [`sandbox.enabled`](/docs/ko/settings-reference#sandbox-enabled)를 `true`로 설정합니다. |52| 분류기 없이 더 적은 프롬프트로 로컬에서 반복 | Manual 모드 + [auto-allow mode](/docs/ko/sandboxing.md#sandbox-modes)의 Bash sandbox: `claude --permission-mode default`, 그 다음 `/sandbox` 실행 및 auto-allow 선택 | 기본 제공 Bash sandbox, macOS, Linux, WSL2 | Deny 규칙은 여전히 적용되고, `Bash(git push *)`와 같이 명령을 지정하는 ask 규칙은 여전히 프롬프트합니다. 확인을 요청할 수 있는 그 밖의 명령은 [Auto-allow mode](/docs/ko/sandboxing.md#auto-allow-mode)에서 다룹니다. 설정 파일에서 대신 sandbox를 켜려면 [`sandbox.enabled`](/docs/ko/settings-reference#sandbox-enabled)를 `true`로 설정합니다. |

53| 변경 전에 탐색 | `claude --permission-mode plan` | 없음 | Claude Code는 [계획을 승인](#review-and-approve-a-plan)할 때까지 편집을 차단합니다. |53| 변경 전에 탐색 | `claude --permission-mode plan` | 없음 | Claude Code는 [계획을 승인](#review-and-approve-a-plan)할 때까지 편집을 차단합니다. |

54| auto mode에서 자동 실행 | `claude --permission-mode auto`, [기본 제공 시작 권한 모드](#which-mode-a-session-starts-in) v2.1.283 이상 | 없음; sandbox 또는 컨테이너는 심층 방어를 추가합니다. | [지원되는 모델](#eliminate-prompts-with-auto-mode)이 필요하고, 조직이 [auto mode를 끌 수 있습니다](#eliminate-prompts-with-auto-mode). |54| auto mode에서 자동 실행 | `claude --permission-mode auto`, [기본 제공 시작 권한 모드](#which-mode-a-session-starts-in) v2.1.283 이상 | 없음; sandbox 또는 컨테이너는 심층 방어를 추가합니다. | [지원되는 모델](#eliminate-prompts-with-auto-mode)이 필요하고, 조직이 [auto mode를 끌 수 있습니다](#eliminate-prompts-with-auto-mode). |

55| 정확한 allowlist로 CI에서 실행 | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | CI 러너가 제공하는 것 이상 없음 | [Cloud sessions](/docs/ko/claude-code-on-the-web)는 설정 파일의 `dontAsk`를 무시합니다. |55| 정확한 allowlist로 CI에서 실행 | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | CI 러너가 제공하는 것 이상 없음 | [Cloud sessions](/docs/ko/claude-code-on-the-web.md)는 설정 파일의 `dontAsk`를 무시합니다. |

56| 컨테이너 내에서 완전히 자동 실행 | `claude -p "<prompt>" --dangerously-skip-permissions` | 필수: 컨테이너, VM, 또는 [sandbox runtime](/docs/ko/sandbox-environments#sandbox-runtime); Linux 및 macOS에서 [non-root user](#skip-all-checks-with-bypasspermissions-mode)로 실행 | Cloud sessions는 설정 파일의 이 모드를 무시합니다. 이 `-p` 실행에서 [여전히 프롬프트할 몇 가지 호출](#skip-all-checks-with-bypasspermissions-mode)은 대신 거부됩니다. |56| 컨테이너 내에서 완전히 자동 실행 | `claude -p "<prompt>" --dangerously-skip-permissions` | 필수: 컨테이너, VM, 또는 [sandbox runtime](/docs/ko/sandbox-environments.md#sandbox-runtime); Linux 및 macOS에서 [non-root user](#skip-all-checks-with-bypasspermissions-mode)로 실행 | Cloud sessions는 설정 파일의 이 모드를 무시합니다. 이 `-p` 실행에서 [여전히 프롬프트할 몇 가지 호출](#skip-all-checks-with-bypasspermissions-mode)은 대신 거부됩니다. |

57 57

58Bash sandbox와 auto mode는 독립적으로 작동하고 결합합니다. [Sandbox modes](/docs/ko/sandboxing#sandbox-modes)에 나열된 예외가 있습니다. 전체 상호작용은 [How sandboxing relates to permissions and permission modes](/docs/ko/sandboxing#how-sandboxing-relates-to-permissions-and-permission-modes) 및 [How isolation relates to permission modes](/docs/ko/sandbox-environments#how-isolation-relates-to-permission-modes)를 참조하세요.58Bash sandbox와 auto mode는 독립적으로 작동하고 결합합니다. [Sandbox modes](/docs/ko/sandboxing.md#sandbox-modes)에 나열된 예외가 있습니다. 전체 상호작용은 [How sandboxing relates to permissions and permission modes](/docs/ko/sandboxing.md#how-sandboxing-relates-to-permissions-and-permission-modes) 및 [How isolation relates to permission modes](/docs/ko/sandbox-environments.md#how-isolation-relates-to-permission-modes)를 참조하세요.

59 59

60## 세션이 시작되는 모드60## 세션이 시작되는 모드

61 61

63 63

641. `--permission-mode` 플래그 또는 `--dangerously-skip-permissions`641. `--permission-mode` 플래그 또는 `--dangerously-skip-permissions`

65 65

~~662. [설정 파일](/docs/ko/settings#where-settings-live)의 `permissions.defaultMode`~~662. [설정 파일](/docs/ko/settings.md#where-settings-live)의 `permissions.defaultMode`

67 67

68 `.claude/settings.json` 또는 `.claude/settings.local.json`에서 `"auto"`를 설정하면 해당 값이 적용되지 않으며, Claude Code는 `~/.claude/settings.json`의 `defaultMode` 대신 기본 제공 기본값을 사용합니다. 이 두 파일에서 `"bypassPermissions"`를 설정하면 역시 적용되지 않으며, 세션은 수동 모드에서 시작됩니다. 다른 값들은 모든 설정 파일에서 적용됩니다.68 `.claude/settings.json` 또는 `.claude/settings.local.json`에서 `"auto"`를 설정하면 해당 값이 적용되지 않으며, Claude Code는 `~/.claude/settings.json`의 `defaultMode` 대신 기본 제공 기본값을 사용합니다. 이 두 파일에서 `"bypassPermissions"`를 설정하면 역시 적용되지 않으며, 세션은 수동 모드에서 시작됩니다. 다른 값들은 모든 설정 파일에서 적용됩니다.

69 69

703. 기본 제공 기본값703. 기본 제공 기본값

71 71

72VS Code 확장 프로그램이 시작하는 대화는 [권한 모드 전환](#switch-permission-modes)의 확장 프로그램 자체 목록을 따릅니다. Claude Code가 재개된 세션을 시작하는 권한 모드에 대해서는 [재개 시 권한 모드](/docs/ko/sessions#permission-mode-on-resume)를 참조하세요.72VS Code 확장 프로그램이 시작하는 대화는 [권한 모드 전환](#switch-permission-modes)의 확장 프로그램 자체 목록을 따릅니다. Claude Code가 재개된 세션을 시작하는 권한 모드에 대해서는 [재개 시 권한 모드](/docs/ko/sessions.md#permission-mode-on-resume)를 참조하세요.

73 73

74기본 제공 `auto` 기본값은 macOS, Linux 및 WSL에서 Claude Code v2.1.228 이상이 필요하며, 기본 Windows에서는 v2.1.233 이상이 필요합니다. 이전 버전에서는 기본 제공 기본값이 수동입니다.74기본 제공 `auto` 기본값은 macOS, Linux 및 WSL에서 Claude Code v2.1.228 이상이 필요하며, 기본 Windows에서는 v2.1.233 이상이 필요합니다. 이전 버전에서는 기본 제공 기본값이 수동입니다.

75 75

78| Claude Code를 실행하는 방식 | 기본 제공 시작 권한 모드 |78| Claude Code를 실행하는 방식 | 기본 제공 시작 권한 모드 |

79| :- | :- |79| :- | :- |

80| 모든 설정 파일이 `disableAutoMode`를 `"disable"`로 설정 | `default` |80| 모든 설정 파일이 `disableAutoMode`를 `"disable"`로 설정 | `default` |

82| 조직에 [HIPAA 구성](#hipaa-configuration)이 적용되어 있고 세션이 [적용 대상](/docs/ko/hipaa-setup#check-how-developers-sign-in-and-connect)인 경우 | Claude Code v2.1.285 이상에서 `default`. 자동 모드로 전환하는 것은 계속 가능합니다 |82| 조직에 [HIPAA 구성](#hipaa-configuration)이 적용되어 있고 세션이 [적용 대상](/docs/ko/hipaa-setup.md#check-how-developers-sign-in-and-connect)인 경우 | Claude Code v2.1.285 이상에서 `default`. 자동 모드로 전환하는 것은 계속 가능합니다 |

83| 터미널 또는 [VS Code 확장 프로그램](/docs/ko/vs-code)을 통해 | Claude Code v2.1.283 이상에서 `auto`; 이전 버전에서는 [기능 플래그를 가져오는](/docs/ko/env-vars#features-that-need-feature-flag-fetching) 세션에서 Pro, Max 또는 Team 플랜의 `auto`, 그 외에는 `default` |83| 터미널 또는 [VS Code 확장 프로그램](/docs/ko/vs-code.md)을 통해 | Claude Code v2.1.283 이상에서 `auto`; 이전 버전에서는 [기능 플래그를 가져오는](/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) 세션에서 Pro, Max 또는 Team 플랜의 `auto`, 그 외에는 `default` |

84 84

85플래그, 설정 파일 또는 기본 제공 기본값이 `auto`를 선택하지만 자동 모드를 세션에서 사용할 수 없는 경우, Claude Code는 대신 수동 모드에서 세션을 시작합니다. 자동 모드는 세션이 [가용성 요구 사항](#eliminate-prompts-with-auto-mode)을 충족하지 않을 때(예: 설정 파일이 자동 모드를 비활성화하거나 지원하지 않는 모델) 또는 Anthropic이 서버 측에서 임시로 자동 모드를 비활성화했을 때 사용할 수 없습니다.85플래그, 설정 파일 또는 기본 제공 기본값이 `auto`를 선택하지만 자동 모드를 세션에서 사용할 수 없는 경우, Claude Code는 대신 수동 모드에서 세션을 시작합니다. 자동 모드는 세션이 [가용성 요구 사항](#eliminate-prompts-with-auto-mode)을 충족하지 않을 때(예: 설정 파일이 자동 모드를 비활성화하거나 지원하지 않는 모델) 또는 Anthropic이 서버 측에서 임시로 자동 모드를 비활성화했을 때 사용할 수 없습니다.

86 86

89* 터미널에서 세션 맨 위에 한 번89* 터미널에서 세션 맨 위에 한 번

90* VS Code 확장 프로그램에서 새 대화 화면의 카드로 표시되며, 이를 닫을 때까지 유지됩니다.90* VS Code 확장 프로그램에서 새 대화 화면의 카드로 표시되며, 이를 닫을 때까지 유지됩니다.

91 91

92`~/.claude/settings.json`이 `auto` 이외의 `defaultMode`를 설정하고 다른 설정 파일이 설정하지 않으면, 세션은 계속해서 해당 모드에서 시작됩니다. Pro, Max 및 Team 플랜에서, 그리고 [기능 플래그를 가져오지 않는](/docs/ko/env-vars#features-that-need-feature-flag-fetching) 세션에서 Claude Code는 터미널 또는 VS Code 확장 프로그램에서 한 번 설정을 자동 모드로 변경할지 여부를 묻습니다. 거절하면 설정은 그대로 유지됩니다.92`~/.claude/settings.json`이 `auto` 이외의 `defaultMode`를 설정하고 다른 설정 파일이 설정하지 않으면, 세션은 계속해서 해당 모드에서 시작됩니다. Pro, Max 및 Team 플랜에서, 그리고 [기능 플래그를 가져오지 않는](/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) 세션에서 Claude Code는 터미널 또는 VS Code 확장 프로그램에서 한 번 설정을 자동 모드로 변경할지 여부를 묻습니다. 거절하면 설정은 그대로 유지됩니다.

93 93

94### `claude -p` 및 Agent SDK 실행에서 거부되는 도구 호출94### `claude -p` 및 Agent SDK 실행에서 거부되는 도구 호출

95 95

96Claude Code v2.1.302 이상에서는 [권한 모드가 설정되지 않은](#which-mode-a-session-starts-in) `claude -p` 및 [Agent SDK](/docs/ko/agent-sdk/permissions#permission-modes) 실행이 수동 모드에서 시작됩니다. 이 모드는 SDK 옵션과 설정에서 `default`로 표시됩니다. 승인이 필요한 호출은 허용 규칙, 훅, `canUseTool` 콜백 또는 `--permission-prompt-tool`로 승인하지 않는 한 거부됩니다.96Claude Code v2.1.302 이상에서는 [권한 모드가 설정되지 않은](#which-mode-a-session-starts-in) `claude -p` 및 [Agent SDK](/docs/ko/agent-sdk/permissions.md#permission-modes) 실행이 수동 모드에서 시작됩니다. 이 모드는 SDK 옵션과 설정에서 `default`로 표시됩니다. 승인이 필요한 호출은 허용 규칙, 훅, `canUseTool` 콜백 또는 `--permission-prompt-tool`로 승인하지 않는 한 거부됩니다.

97 97

98이러한 호출이 승인되도록 하려면 허용 규칙을 추가하거나 자동 모드에서 시작합니다.98이러한 호출이 승인되도록 하려면 허용 규칙을 추가하거나 자동 모드에서 시작합니다.

99 99

100* **[허용 규칙 추가](/docs/ko/permissions#manage-permissions)**: Claude는 나열된 호출을 실행합니다. `claude -p`에 [`--allowedTools "Bash(npm test)"`](/docs/ko/headless#auto-approve-tools)를 전달하거나 SDK의 [허용 도구 옵션](/docs/ko/agent-sdk/permissions#allow-and-deny-rules)을 설정합니다.100* **[허용 규칙 추가](/docs/ko/permissions.md#manage-permissions)**: Claude는 나열된 호출을 실행합니다. `claude -p`에 [`--allowedTools "Bash(npm test)"`](/docs/ko/headless#auto-approve-tools)를 전달하거나 SDK의 [허용 도구 옵션](/docs/ko/agent-sdk/permissions.md#allow-and-deny-rules)을 설정합니다.

101* **[자동 모드](#eliminate-prompts-with-auto-mode)에서 시작**: 분류기 모델이 호출을 검토하므로 미리 나열할 필요가 없습니다. `claude -p`에 `--permission-mode auto`를 전달하거나 SDK의 [권한 모드 옵션](/docs/ko/agent-sdk/permissions#set-permission-mode)을 설정합니다.101* **[자동 모드](#eliminate-prompts-with-auto-mode)에서 시작**: 분류기 모델이 호출을 검토하므로 미리 나열할 필요가 없습니다. `claude -p`에 `--permission-mode auto`를 전달하거나 SDK의 [권한 모드 옵션](/docs/ko/agent-sdk/permissions.md#set-permission-mode)을 설정합니다.

102 102

103다음 예제는 CLI와 각 SDK에서 자동 모드를 사용하는 형태를 보여 줍니다.103다음 예제는 CLI와 각 SDK에서 자동 모드를 사용하는 형태를 보여 줍니다.

104 104

124options = ClaudeAgentOptions(permission_mode="auto")124options = ClaudeAgentOptions(permission_mode="auto")

125```125```

126 126

127v2.1.302 이전에는 이러한 실행이 [기능 플래그를 가져오지](/docs/ko/env-vars#features-that-need-feature-flag-fetching) 않는 경우(예: [타사 공급자](/docs/ko/third-party-integrations) 사용 시 또는 `DISABLE_TELEMETRY` 설정 시) 자동 모드에서 시작될 수 있었습니다.127v2.1.302 이전에는 이러한 실행이 [기능 플래그를 가져오지](/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) 않는 경우(예: [타사 공급자](/docs/ko/third-party-integrations.md) 사용 시 또는 `DISABLE_TELEMETRY` 설정 시) 자동 모드에서 시작될 수 있었습니다.

128 128

129### 다른 권한 모드에서 시작129### 다른 권한 모드에서 시작

130 130

131한 세션에 대해 또는 머신, 프로젝트 또는 조직의 모든 세션에 대한 기본값으로 시작 권한 모드를 설정할 수 있습니다. 둘 이상의 설정 파일이 `permissions.defaultMode`를 설정할 때 [설정 우선순위](/docs/ko/settings#settings-precedence)가 결정하므로, 프로젝트 또는 관리형 값이 `~/.claude/settings.json`을 능가합니다. 이미 실행 중인 세션의 권한 모드를 변경하려면 [권한 모드 전환](#switch-permission-modes)을 참조하세요.131한 세션에 대해 또는 머신, 프로젝트 또는 조직의 모든 세션에 대한 기본값으로 시작 권한 모드를 설정할 수 있습니다. 둘 이상의 설정 파일이 `permissions.defaultMode`를 설정할 때 [설정 우선순위](/docs/ko/settings.md#settings-precedence)가 결정하므로, 프로젝트 또는 관리형 값이 `~/.claude/settings.json`을 능가합니다. 이미 실행 중인 세션의 권한 모드를 변경하려면 [권한 모드 전환](#switch-permission-modes)을 참조하세요.

132 132

133| 시작 권한 모드를 설정하는 대상 | 수행할 작업 |133| 시작 권한 모드를 설정하는 대상 | 수행할 작업 |

134| :- | :- |134| :- | :- |

136| 이 머신에서 시작하는 모든 터미널 세션 | `~/.claude/settings.json`에서 `permissions.defaultMode`를 설정합니다. VS Code 확장 프로그램이 읽는 내용은 [권한 모드 전환](#switch-permission-modes)을 참조하세요. |136| 이 머신에서 시작하는 모든 터미널 세션 | `~/.claude/settings.json`에서 `permissions.defaultMode`를 설정합니다. VS Code 확장 프로그램이 읽는 내용은 [권한 모드 전환](#switch-permission-modes)을 참조하세요. |

137| 한 프로젝트에서 시작하는 모든 터미널 세션 | 프로젝트의 `.claude/settings.json`에서 `permissions.defaultMode`를 설정합니다. 터미널에서 시작하는 세션은 `auto` 및 `bypassPermissions`을 제외한 모든 값을 준수합니다. VS Code 확장 프로그램이 시작하는 세션은 시작 권한 모드에 대한 프로젝트 설정을 읽지 않습니다. |137| 한 프로젝트에서 시작하는 모든 터미널 세션 | 프로젝트의 `.claude/settings.json`에서 `permissions.defaultMode`를 설정합니다. 터미널에서 시작하는 세션은 `auto` 및 `bypassPermissions`을 제외한 모든 값을 준수합니다. VS Code 확장 프로그램이 시작하는 세션은 시작 권한 모드에 대한 프로젝트 설정을 읽지 않습니다. |

138| 조직의 모든 터미널 세션 | [관리형 설정](/docs/ko/managed-settings)에서 `permissions.defaultMode`를 설정합니다. 터미널 세션은 해당 모드에서 시작되며 사용자는 여전히 자동 모드로 전환할 수 있습니다. VS Code 확장 프로그램이 읽는 내용은 [권한 모드 전환](#switch-permission-modes)을 참조하세요. 자동 모드를 제거하여 아무도 선택할 수 없도록 하려면 대신 `permissions.disableAutoMode`를 `"disable"`로 설정합니다. |138| 조직의 모든 터미널 세션 | [관리형 설정](/docs/ko/managed-settings.md)에서 `permissions.defaultMode`를 설정합니다. 터미널 세션은 해당 모드에서 시작되며 사용자는 여전히 자동 모드로 전환할 수 있습니다. VS Code 확장 프로그램이 읽는 내용은 [권한 모드 전환](#switch-permission-modes)을 참조하세요. 자동 모드를 제거하여 아무도 선택할 수 없도록 하려면 대신 `permissions.disableAutoMode`를 `"disable"`로 설정합니다. |

139 139

140이 예제는 머신의 모든 터미널 세션이 수동 모드(구성 값은 `default`)에서 시작되도록 합니다. `~/.claude/settings.json`에 저장합니다.140이 예제는 머신의 모든 터미널 세션이 수동 모드(구성 값은 `default`)에서 시작되도록 합니다. `~/.claude/settings.json`에 저장합니다.

141 141

151 151

152### HIPAA 구성에서의 권한 모드152### HIPAA 구성에서의 권한 모드

153 153

154[HIPAA 구성](/docs/ko/hipaa-setup)이 적용된 조직에서는 기본 제공 `auto` 기본값이 적용되지 않습니다. 시작 권한 모드를 선택하는 다른 항목이 없으면 터미널 또는 VS Code 세션은 수동 모드에서 시작됩니다. 터미널 세션에는 `Auto mode isn't the default for your organization · Shift+Tab to switch`도 표시되며, VS Code 확장 프로그램에는 알림이 표시되지 않습니다. 이 내용이 적용되는 세션은 [개발자의 로그인 및 연결 방식 확인](/docs/ko/hipaa-setup#check-how-developers-sign-in-and-connect)에 나와 있습니다.154[HIPAA 구성](/docs/ko/hipaa-setup.md)이 적용된 조직에서는 기본 제공 `auto` 기본값이 적용되지 않습니다. 시작 권한 모드를 선택하는 다른 항목이 없으면 터미널 또는 VS Code 세션은 수동 모드에서 시작됩니다. 터미널 세션에는 `Auto mode isn't the default for your organization · Shift+Tab to switch`도 표시되며, VS Code 확장 프로그램에는 알림이 표시되지 않습니다. 이 내용이 적용되는 세션은 [개발자의 로그인 및 연결 방식 확인](/docs/ko/hipaa-setup.md#check-how-developers-sign-in-and-connect)에 나와 있습니다.

155 155

156자동 모드와 `bypassPermissions`는 계속 사용할 수 있습니다.156자동 모드와 `bypassPermissions`는 계속 사용할 수 있습니다.

157 157

160* **자동 모드 제거**: 관리형 설정에서 [`permissions.disableAutoMode`](/docs/ko/settings-reference#disableautomode)를 `"disable"`로 설정합니다160* **자동 모드 제거**: 관리형 설정에서 [`permissions.disableAutoMode`](/docs/ko/settings-reference#disableautomode)를 `"disable"`로 설정합니다

161* **`bypassPermissions` 차단**: 관리형 설정에서 [`permissions.disableBypassPermissionsMode`](/docs/ko/settings-reference#permissions-disablebypasspermissionsmode)를 `"disable"`로 설정합니다161* **`bypassPermissions` 차단**: 관리형 설정에서 [`permissions.disableBypassPermissionsMode`](/docs/ko/settings-reference#permissions-disablebypasspermissionsmode)를 `"disable"`로 설정합니다

162 162

163[HIPAA 구성의 최소 버전](/docs/ko/hipaa-setup#update-claude-code-and-claude-desktop)인 Claude Code v2.1.285 이상이 필요합니다.163[HIPAA 구성의 최소 버전](/docs/ko/hipaa-setup.md#update-claude-code-and-claude-desktop)인 Claude Code v2.1.285 이상이 필요합니다.

164 164

165## 권한 모드 전환165## 권한 모드 전환

166 166

182 182

183활성화된 선택적 모드는 `plan` 후에 슬롯되며, `bypassPermissions`가 먼저이고 `auto`가 마지막입니다. 둘 다 활성화된 경우 `auto`로 가는 길에 `bypassPermissions`를 순환합니다.183활성화된 선택적 모드는 `plan` 후에 슬롯되며, `bypassPermissions`가 먼저이고 `auto`가 마지막입니다. 둘 다 활성화된 경우 `auto`로 가는 길에 `bypassPermissions`를 순환합니다.

184 184

185**Bash 권한 프롬프트에서**: Manual 및 `acceptEdits` 권한 모드에서 [auto mode](#eliminate-prompts-with-auto-mode)를 사용할 수 있을 때 Claude Code는 Bash 명령의 권한 프롬프트에 **Yes, and switch to auto mode**를 추가합니다. 이를 선택하여 명령을 승인하고 세션을 auto mode로 전환합니다. [PowerShell tool](/docs/ko/tools-reference#powershell-tool) 프롬프트는 옵션을 제공하지 않습니다. Claude Code v2.1.247 이상이 필요합니다.185**Bash 권한 프롬프트에서**: Manual 및 `acceptEdits` 권한 모드에서 [auto mode](#eliminate-prompts-with-auto-mode)를 사용할 수 있을 때 Claude Code는 Bash 명령의 권한 프롬프트에 **Yes, and switch to auto mode**를 추가합니다. 이를 선택하여 명령을 승인하고 세션을 auto mode로 전환합니다. [PowerShell tool](/docs/ko/tools-reference.md#powershell-tool) 프롬프트는 옵션을 제공하지 않습니다. Claude Code v2.1.247 이상이 필요합니다.

186 186

187Claude Code는 [`ask` 규칙](/docs/ko/permissions#manage-permissions) 중 하나 또는 [hook](/docs/ko/hooks#pretooluse-decision-control)에 의해 강제된 프롬프트에 옵션을 추가하지 않습니다. auto mode는 여전히 이러한 프롬프트를 표시하므로 전환해도 제거되지 않습니다.187Claude Code는 [`ask` 규칙](/docs/ko/permissions#manage-permissions) 중 하나 또는 [hook](/docs/ko/hooks.md#pretooluse-decision-control)에 의해 강제된 프롬프트에 옵션을 추가하지 않습니다. auto mode는 여전히 이러한 프롬프트를 표시하므로 전환해도 제거되지 않습니다.

188 188

189**시작 시**: 권한 모드를 플래그로 전달합니다.189**시작 시**: 권한 모드를 플래그로 전달합니다.

190 190

194 194

195**기본값으로**: [다른 권한 모드에서 시작](#start-in-a-different-mode)에 설명된 대로 원하는 범위에서 `permissions.defaultMode`를 설정합니다.195**기본값으로**: [다른 권한 모드에서 시작](#start-in-a-different-mode)에 설명된 대로 원하는 범위에서 `permissions.defaultMode`를 설정합니다.

196 196

197동일한 `--permission-mode` 플래그는 [비대화형 실행](/docs/ko/headless)을 위해 `-p`와 함께 작동합니다.197동일한 `--permission-mode` 플래그는 [비대화형 실행](/docs/ko/headless.md)을 위해 `-p`와 함께 작동합니다.

198 198

199**VS Code**199**VS Code**

200 200

212 212

2131. `claudeCode.initialPermissionMode`2131. `claudeCode.initialPermissionMode`

2142. 마지막으로 모드 표시기에서 선택한 모드(Manual, Edit automatically, 또는 Auto인 경우). Plan 또는 Bypass permissions를 선택하면 해당 대화에만 적용됩니다.2142. 마지막으로 모드 표시기에서 선택한 모드(Manual, Edit automatically, 또는 Auto인 경우). Plan 또는 Bypass permissions를 선택하면 해당 대화에만 적용됩니다.

2153. [관리형 설정](/docs/ko/managed-settings) 또는 `~/.claude/settings.json`의 `permissions.defaultMode`2153. [관리형 설정](/docs/ko/managed-settings.md) 또는 `~/.claude/settings.json`의 `permissions.defaultMode`

2164. 플랜, 제공자, 조직 설정에 대한 [기본 제공 기본값](#which-mode-a-session-starts-in)2164. 플랜, 제공자, 조직 설정에 대한 [기본 제공 기본값](#which-mode-a-session-starts-in)

217 217

218확장은 시작 권한 모드에 대해 프로젝트의 `.claude/settings.json` 또는 `.claude/settings.local.json`을 읽지 않습니다. `claudeCode.claudeProcessWrapper`가 설정되면 항목 3과 4도 적용되지 않습니다: 항목 1 또는 항목 2가 권한 모드를 설정하지 않으면 이러한 대화는 Manual에서 시작됩니다.218확장은 시작 권한 모드에 대해 프로젝트의 `.claude/settings.json` 또는 `.claude/settings.local.json`을 읽지 않습니다. `claudeCode.claudeProcessWrapper`가 설정되면 항목 3과 4도 적용되지 않습니다: 항목 1 또는 항목 2가 권한 모드를 설정하지 않으면 이러한 대화는 Manual에서 시작됩니다.

219 219

220v2.1.283 이전에는 항목 3이 [기능 플래그를 가져오는](/docs/ko/env-vars#features-that-need-feature-flag-fetching) Pro, Max, Team 플랜에서만 적용되었습니다.220v2.1.283 이전에는 항목 3이 [기능 플래그를 가져오는](/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) Pro, Max, Team 플랜에서만 적용되었습니다.

221 221

222Auto는 [auto mode를 사용할 수 있을 때](#eliminate-prompts-with-auto-mode) 모드 표시기에 나타납니다.222Auto는 [auto mode를 사용할 수 있을 때](#eliminate-prompts-with-auto-mode) 모드 표시기에 나타납니다.

223 223

224Bypass permissions는 확장 설정의 **Allow dangerously skip permissions** 토글이 필요합니다. 없으면 권한 모드가 표시기에 나타나지 않으며, 항목 1 또는 항목 3의 `bypassPermissions` 값은 대신 대화를 Manual에서 시작합니다. 항목의 Auto는 auto mode를 사용할 수 없을 때 마찬가지로 대화를 Manual에서 시작합니다.224Bypass permissions는 확장 설정의 **Allow dangerously skip permissions** 토글이 필요합니다. 없으면 권한 모드가 표시기에 나타나지 않으며, 항목 1 또는 항목 3의 `bypassPermissions` 값은 대신 대화를 Manual에서 시작합니다. 항목의 Auto는 auto mode를 사용할 수 없을 때 마찬가지로 대화를 Manual에서 시작합니다.

225 225

226[VS Code 가이드](/docs/ko/vs-code)에서 확장 관련 세부사항을 참조하세요.226[VS Code 가이드](/docs/ko/vs-code.md)에서 확장 관련 세부사항을 참조하세요.

227 227

228**JetBrains**228**JetBrains**

229 229

238 238

239Cowork는 이러한 모드를 사용하지 않습니다. Cowork는 별도로 활성화되는 자체 권한 모드를 가지며, 계정에 대해 기본값 이외의 모드가 활성화될 때까지 모드 선택기를 전혀 표시하지 않습니다. [Cowork 문서](https://claude.com/docs/cowork/overview)를 참조하세요.239Cowork는 이러한 모드를 사용하지 않습니다. Cowork는 별도로 활성화되는 자체 권한 모드를 가지며, 계정에 대해 기본값 이외의 모드가 활성화될 때까지 모드 선택기를 전혀 표시하지 않습니다. [Cowork 문서](https://claude.com/docs/cowork/overview)를 참조하세요.

240 240

241데스크톱 관련 세부사항은 Desktop 가이드의 [권한 모드 선택](/docs/ko/desktop#choose-a-permission-mode)을 참조하세요.241데스크톱 관련 세부사항은 Desktop 가이드의 [권한 모드 선택](/docs/ko/desktop.md#choose-a-permission-mode)을 참조하세요.

242 242

243**기본값으로**: [설정](/docs/ko/settings#where-settings-live)에서 `defaultMode`를 설정합니다. 데스크톱 앱은 CLI와 동일한 설정 파일을 읽고 새 로컬 세션에 권한 모드를 적용합니다.243**기본값으로**: [설정](/docs/ko/settings.md#where-settings-live)에서 `defaultMode`를 설정합니다. 데스크톱 앱은 CLI와 동일한 설정 파일을 읽고 새 로컬 세션에 권한 모드를 적용합니다.

244 244

245모드 선택기에서 선택한 모드는 폴더별로 기억되며 해당 폴더에 대해 `defaultMode`보다 우선합니다. Plan은 예외입니다: 선택하면 현재 세션에만 적용됩니다.245모드 선택기에서 선택한 모드는 폴더별로 기억되며 해당 폴더에 대해 `defaultMode`보다 우선합니다. Plan은 예외입니다: 선택하면 현재 세션에만 적용됩니다.

246 246

250 250

251[claude.ai/code](https://claude.ai/code)에서는 프롬프트 상자 옆의 모드 드롭다운을 사용합니다. 모바일 앱에서는 프롬프트 상자의 **+** 버튼을 탭한 다음 **Permission**을 탭합니다. 클라우드 세션과 Remote Control 세션은 서로 다른 권한 모드를 제공합니다:251[claude.ai/code](https://claude.ai/code)에서는 프롬프트 상자 옆의 모드 드롭다운을 사용합니다. 모바일 앱에서는 프롬프트 상자의 **+** 버튼을 탭한 다음 **Permission**을 탭합니다. 클라우드 세션과 Remote Control 세션은 서로 다른 권한 모드를 제공합니다:

252 252

253* **[클라우드 세션](/docs/ko/claude-code-on-the-web)**: Accept edits, Plan, Auto. Accept edits는 `default` 모드에 해당합니다: 클라우드 세션은 모드에 관계없이 파일 편집을 사전 승인하므로 드롭다운은 Manual 대신 Accept edits를 표시합니다. 클라우드 세션은 여전히 설정의 `defaultMode: "acceptEdits"`를 준수합니다. 자동 모드는 조직이 허용하고 선택한 모델이 지원할 때만 나타납니다. Bypass permissions는 사용할 수 없습니다.253* **[클라우드 세션](/docs/ko/claude-code-on-the-web.md)**: Accept edits, Plan, Auto. Accept edits는 `default` 모드에 해당합니다: 클라우드 세션은 모드에 관계없이 파일 편집을 사전 승인하므로 드롭다운은 Manual 대신 Accept edits를 표시합니다. 클라우드 세션은 여전히 설정의 `defaultMode: "acceptEdits"`를 준수합니다. 자동 모드는 조직이 허용하고 선택한 모델이 지원할 때만 나타납니다. Bypass permissions는 사용할 수 없습니다.

254* **로컬 머신의 [Remote Control](/docs/ko/remote-control) 세션**: 직접 시작한 세션의 경우 Manual, Accept edits, Plan, Auto이며, 앱에서 Bypass permissions를 선택할 수 없습니다. Auto를 사용하려면 세션이 자동 모드 [사용 가능 요건](#eliminate-prompts-with-auto-mode)을 충족해야 합니다. 컴퓨터에서 실행 중인 프로젝트 스레드의 경우 [자신의 컴퓨터에서 스레드 실행](/docs/ko/claude-projects#run-a-thread-on-your-own-computer)을 참조하세요.254* **로컬 머신의 [Remote Control](/docs/ko/remote-control.md) 세션**: 직접 시작한 세션의 경우 Manual, Accept edits, Plan, Auto이며, 앱에서 Bypass permissions를 선택할 수 없습니다. Auto를 사용하려면 세션이 자동 모드 [사용 가능 요건](#eliminate-prompts-with-auto-mode)을 충족해야 합니다. 컴퓨터에서 실행 중인 프로젝트 스레드의 경우 [자신의 컴퓨터에서 스레드 실행](/docs/ko/claude-projects.md#run-a-thread-on-your-own-computer)을 참조하세요.

255 * Bypass permissions를 제외하고, 드롭다운은 터미널에서 설정된 모드를 포함하여 로컬 세션이 있는 권한 모드를 표시합니다. 앱 또는 터미널에서 권한 모드가 변경될 때 업데이트됩니다.255 * Bypass permissions를 제외하고, 드롭다운은 터미널에서 설정된 모드를 포함하여 로컬 세션이 있는 권한 모드를 표시합니다. 앱 또는 터미널에서 권한 모드가 변경될 때 업데이트됩니다.

256 * [데스크톱 앱](/docs/ko/desktop) 또는 [VS Code 확장](/docs/ko/vs-code)이 호스팅하는 세션은 터미널에서 호스팅하는 세션과 동일하게 권한 모드 변경이 발생할 때 claude.ai에 보고합니다.256 * [데스크톱 앱](/docs/ko/desktop.md) 또는 [VS Code 확장](/docs/ko/vs-code.md)이 호스팅하는 세션은 터미널에서 호스팅하는 세션과 동일하게 권한 모드 변경이 발생할 때 claude.ai에 보고합니다.

257 257

258Remote Control의 경우 로컬 머신이 claude.ai 계정으로 로그인되어야 합니다. API 키는 지원되지 않습니다. 해당 로컬 세션을 시작할 때 시작 권한 모드를 설정할 수도 있습니다:258Remote Control의 경우 로컬 머신이 claude.ai 계정으로 로그인되어야 합니다. API 키는 지원되지 않습니다. 해당 로컬 세션을 시작할 때 시작 권한 모드를 설정할 수도 있습니다:

259 259

267 267

268파일 편집 외에도 `acceptEdits` 모드는 일반적인 파일시스템 Bash 명령어를 자동으로 승인합니다: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp`, `sed`. 이러한 명령어는 `LANG=C` 또는 `NO_COLOR=1`과 같은 안전한 환경 변수가 접두사로 붙거나 `timeout`, `nice`, `nohup`과 같은 프로세스 래퍼가 붙을 때도 자동으로 승인됩니다. 파일 편집과 마찬가지로 자동 승인은 작업 디렉토리 또는 `additionalDirectories` 내의 경로에만 적용됩니다.268파일 편집 외에도 `acceptEdits` 모드는 일반적인 파일시스템 Bash 명령어를 자동으로 승인합니다: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp`, `sed`. 이러한 명령어는 `LANG=C` 또는 `NO_COLOR=1`과 같은 안전한 환경 변수가 접두사로 붙거나 `timeout`, `nice`, `nohup`과 같은 프로세스 래퍼가 붙을 때도 자동으로 승인됩니다. 파일 편집과 마찬가지로 자동 승인은 작업 디렉토리 또는 `additionalDirectories` 내의 경로에만 적용됩니다.

269 269

270각 경로는 [symlink 확인](/docs/ko/permissions#symlinks)을 거치므로, 해당 범위 외으로 확인되는 쓰기는 자동으로 승인되지 않습니다. 해당 범위 외의 경로, [보호된 경로](#protected-paths)에 대한 쓰기, [critical path](#critical-paths)를 대상으로 하는 `rm` 및 `rmdir` 제거, 그리고 [읽기 전용 집합](/docs/ko/permissions#read-only-commands)을 제외한 다른 모든 Bash 명령어는 여전히 프롬프트를 표시합니다.270다음 항목은 여전히 확인을 요청합니다:

271 271

272[PowerShell tool](/docs/ko/tools-reference#powershell-tool)이 활성화되어 있으면 `acceptEdits` 모드는 범위 내 경로에서 `Set-Content`, `Add-Content`, `Clear-Content`, `Remove-Item`과 이들의 일반적인 별칭도 자동으로 승인합니다. 동일한 범위 및 보호된 경로 규칙이 적용되고, `Remove-Item`은 [자체 확인](#remove-item-in-powershell)을 받습니다. `Set-Content .\notes.txt "It's done"`의 아포스트로피와 같이 따옴표 문자를 포함하는 위치 인수는 Claude Code가 따옴표 및 따옴표 없는 읽기가 다른 인수를 정적으로 검증할 수 없기 때문에 범위 내 경로에서도 여전히 프롬프트를 표시합니다. 프롬프트를 피하려면 `-Value`와 같은 명명된 매개변수를 통해 콘텐츠를 전달합니다.272* 해당 범위 밖의 경로

273* [보호된 경로](#protected-paths)에 대한 쓰기

274* 인식된 `rm` 및 `rmdir` [중요 경로 제거](#critical-paths)

275* [기본 제공 읽기 전용 집합](/docs/ko/permissions.md#read-only-commands)을 제외한 다른 모든 Bash 명령

276

277각 경로는 [심볼릭 링크 확인](/docs/ko/permissions.md#symlinks)도 거치므로, 해당 범위 밖으로 확인되는 쓰기 역시 자동으로 승인되지 않습니다.

278

279[PowerShell tool](/docs/ko/tools-reference.md#powershell-tool)이 활성화되어 있으면 `acceptEdits` 모드는 범위 내 경로에서 `Set-Content`, `Add-Content`, `Clear-Content`, `Remove-Item`과 이들의 일반적인 별칭도 자동으로 승인합니다. 동일한 범위 및 보호된 경로 규칙이 적용되고, `Remove-Item`은 [자체 확인](#remove-item-in-powershell)을 받습니다. `Set-Content .\notes.txt "It's done"`의 아포스트로피와 같이 따옴표 문자를 포함하는 위치 인수는 Claude Code가 따옴표 및 따옴표 없는 읽기가 다른 인수를 정적으로 검증할 수 없기 때문에 범위 내 경로에서도 여전히 프롬프트를 표시합니다. 프롬프트를 피하려면 `-Value`와 같은 명명된 매개변수를 통해 콘텐츠를 전달합니다.

273 280

274편집을 인라인으로 승인하는 대신 편집기에서 또는 `git diff`를 통해 변경 사항을 검토하려는 경우 `acceptEdits`를 사용하세요.281편집을 인라인으로 승인하는 대신 편집기에서 또는 `git diff`를 통해 변경 사항을 검토하려는 경우 `acceptEdits`를 사용하세요.

275 282

286계획 중에 셸 명령이 어떻게 처리되는지는 세션에 따라 다르며, 다음 중 일치하는 첫 번째 경우가 적용됩니다:293계획 중에 셸 명령이 어떻게 처리되는지는 세션에 따라 다르며, 다음 중 일치하는 첫 번째 경우가 적용됩니다:

287 294

288* **bypassPermissions를 사용할 수 있는 대화형 터미널 세션**: 분류기나 프롬프트가 계획 명령에 적용되지 않습니다. [bypassPermissions 모드로 모든 검사 건너뛰기](#skip-all-checks-with-bypasspermissions-mode)는 여전히 프롬프트가 표시되는 몇 가지 항목을 다룹니다.295* **bypassPermissions를 사용할 수 있는 대화형 터미널 세션**: 분류기나 프롬프트가 계획 명령에 적용되지 않습니다. [bypassPermissions 모드로 모든 검사 건너뛰기](#skip-all-checks-with-bypasspermissions-mode)는 여전히 프롬프트가 표시되는 몇 가지 항목을 다룹니다.

289* **[자동 모드](/docs/ko/auto-mode-config)를 사용할 수 있고 기본적으로 켜져 있는 `useAutoModeDuringPlan` 설정이 활성화됨**: 분류기는 [중요 경로 제거](#critical-paths)를 제외한 셸 명령을 검토하며 사용자에게 프롬프트를 표시하지 않습니다. 승인된 명령은 실행되고 거부된 명령은 차단됩니다.296* **[자동 모드](/docs/ko/auto-mode-config.md)를 사용할 수 있고 기본적으로 켜져 있는 `useAutoModeDuringPlan` 설정이 활성화됨**: 분류기는 [중요 경로 제거](#critical-paths)를 제외한 셸 명령을 검토하며 사용자에게 프롬프트를 표시하지 않습니다. 승인된 명령은 실행되고 거부된 명령은 차단됩니다.

290* **자동 모드를 사용할 수 없거나 `useAutoModeDuringPlan`이 꺼짐**: [기본 제공 읽기 전용 집합](/docs/ko/permissions#read-only-commands) 외의 명령은 승인을 요청하며, 샌드박스의 [자동 허용 모드](/docs/ko/sandboxing#sandbox-modes)가 활성화된 경우에도 마찬가지입니다.297* **자동 모드를 사용할 수 없거나 `useAutoModeDuringPlan`이 꺼짐**: [기본 제공 읽기 전용 집합](/docs/ko/permissions.md#read-only-commands) 외의 명령은 승인을 요청하며, 샌드박스의 [자동 허용 모드](/docs/ko/sandboxing.md#sandbox-modes)가 활성화된 경우에도 마찬가지입니다.

291 298

292계획 모드에 들어가려면 `Shift+Tab`을 누르거나 단일 프롬프트 앞에 `/plan`을 붙입니다. CLI에서 계획 모드로 시작할 수도 있습니다:299계획 모드에 들어가려면 `Shift+Tab`을 누르거나 단일 프롬프트 앞에 `/plan`을 붙입니다. CLI에서 계획 모드로 시작할 수도 있습니다:

293 300

309 316

310`Ctrl+G`를 눌러 제안된 계획을 기본 텍스트 편집기에서 열고 Claude가 진행하기 전에 직접 편집합니다. [`showClearContextOnPlanAccept`](/docs/ko/settings-reference#showclearcontextonplanaccept)가 활성화되면 목록에 계획을 승인하고 계획 컨텍스트를 지우는 첫 번째 옵션이 추가됩니다.317`Ctrl+G`를 눌러 제안된 계획을 기본 텍스트 편집기에서 열고 Claude가 진행하기 전에 직접 편집합니다. [`showClearContextOnPlanAccept`](/docs/ko/settings-reference#showclearcontextonplanaccept)가 활성화되면 목록에 계획을 승인하고 계획 컨텍스트를 지우는 첫 번째 옵션이 추가됩니다.

311 318

312계획을 수락하면 세션에 계획을 기반으로 한 [생성된 제목](/docs/ko/sessions#name-your-sessions)이 지정되며, 이미 세션의 이름을 지정하지 않은 경우입니다.319계획을 수락하면 세션에 계획을 기반으로 한 [생성된 제목](/docs/ko/sessions.md#name-your-sessions)이 지정되며, 이미 세션의 이름을 지정하지 않은 경우입니다.

313 320

314### 계획 모드를 기본값으로 설정321### 계획 모드를 기본값으로 설정

315 322

316프로젝트의 터미널 세션에 대해 계획 모드를 기본값으로 설정하려면 `.claude/settings.json`에서 `defaultMode`를 `plan`으로 설정합니다. 이는 [다른 권한 모드에서 시작](#start-in-a-different-mode)의 예시에 표시된 대로 배치됩니다. [VS Code 확장](/docs/ko/vs-code)이 시작하는 대화는 시작 권한 모드에 대한 프로젝트 설정을 읽지 않습니다. 대신 VS Code 사용자 설정에서 `claudeCode.initialPermissionMode`를 `plan`으로 설정합니다.323프로젝트의 터미널 세션에 대해 계획 모드를 기본값으로 설정하려면 `.claude/settings.json`에서 `defaultMode`를 `plan`으로 설정합니다. 이는 [다른 권한 모드에서 시작](#start-in-a-different-mode)의 예시에 표시된 대로 배치됩니다. [VS Code 확장](/docs/ko/vs-code.md)이 시작하는 대화는 시작 권한 모드에 대한 프로젝트 설정을 읽지 않습니다. 대신 VS Code 사용자 설정에서 `claudeCode.initialPermissionMode`를 `plan`으로 설정합니다.

317 324

318## 자동 모드로 권한 프롬프트 제거325## 자동 모드로 권한 프롬프트 제거

319 326

320자동 모드를 사용하면 Claude가 일상적인 권한 프롬프트 없이 실행될 수 있습니다. 별도의 분류기 모델이 실행 전에 작업을 검토하여 요청을 초과하는 모든 것, 인식되지 않은 인프라를 대상으로 하는 것, 또는 Claude가 읽은 악의적인 콘텐츠로 인해 발생한 것으로 보이는 것을 차단합니다. 명시적 [요청 규칙](/docs/ko/permissions#manage-permissions)은 여전히 프롬프트를 강제합니다.327자동 모드를 사용하면 Claude가 일상적인 권한 프롬프트 없이 실행될 수 있습니다. 별도의 분류기 모델이 실행 전에 작업을 검토하여 요청을 초과하는 모든 것, 인식되지 않은 인프라를 대상으로 하는 것, 또는 Claude가 읽은 악의적인 콘텐츠로 인해 발생한 것으로 보이는 것을 차단합니다. 명시적 [요청 규칙](/docs/ko/permissions.md#manage-permissions)은 여전히 프롬프트를 강제합니다.

321 328

322Claude Code v2.1.283 이상에서는 자동 모드가 모든 플랜 및 제공자의 대화형 터미널 및 VS Code 세션에 대한 [기본 제공 시작 권한 모드](#which-mode-a-session-starts-in)입니다. 이전 버전에서는 Pro, Max 및 Team 플랜에서만 기본 제공 시작 권한 모드입니다.329Claude Code v2.1.283 이상에서는 자동 모드가 모든 플랜 및 제공자의 대화형 터미널 및 VS Code 세션에 대한 [기본 제공 시작 권한 모드](#which-mode-a-session-starts-in)입니다. 이전 버전에서는 Pro, Max 및 Team 플랜에서만 기본 제공 시작 권한 모드입니다.

323 330

324분류기는 또한 자동 모드와 [분류기가 명령을 검토하는 동안 플랜 모드](#analyze-before-you-edit-with-plan-mode)에서 Claude Code가 전달하기 전에 [`SendMessage`](/docs/ko/tools-reference)를 사용하여 다른 에이전트에 보내는 각 메시지(일반 텍스트 또는 구조화된 [에이전트 팀](/docs/ko/agent-teams) 메시지)를 검토합니다. 전송 검토에는 Claude Code v2.1.222 이상이 필요합니다.331분류기는 또한 자동 모드와 [분류기가 명령을 검토하는 동안 플랜 모드](#analyze-before-you-edit-with-plan-mode)에서 Claude Code가 전달하기 전에 [`SendMessage`](/docs/ko/tools-reference)를 사용하여 다른 에이전트에 보내는 각 메시지(일반 텍스트 또는 구조화된 [에이전트 팀](/docs/ko/agent-teams.md) 메시지)를 검토합니다. 전송 검토에는 Claude Code v2.1.222 이상이 필요합니다.

325 332

326기본적으로 분류기는 `rm -rf /` 또는 `rm -rf ~`와 같은 중요 경로를 대상으로 하는 `rm` 및 `rmdir` 제거를 검토하지 않습니다. [중요 경로](#critical-paths)는 각 권한 모드에서 이들에게 어떤 일이 발생하는지 다룹니다.333기본적으로 분류기는 `rm -rf /` 또는 `rm -rf ~`와 같이 중요 경로를 대상으로 하는 것으로 인식된 `rm` 및 `rmdir` 제거를 검토하지 않습니다. [중요 경로](#critical-paths)는 각 권한 모드에서 이들에게 어떤 일이 발생하는지 다룹니다.

327 334

328자동 모드는 또한 Claude가 명확히 하는 질문을 위해 멈추지 않고 계속 작업하도록 Claude를 유도하지만, Claude는 여전히 프롬프트나 스킬이 명시적으로 이를 요구할 때 질문합니다. 여전히 프롬프트를 표시하는 모드에서 더 강력한 자율 동작을 원하면 [적극적 출력 스타일](/docs/ko/output-styles)을 대신 설정하세요.335자동 모드는 또한 Claude가 명확히 하는 질문을 위해 멈추지 않고 계속 작업하도록 Claude를 유도하지만, Claude는 여전히 프롬프트나 스킬이 명시적으로 이를 요구할 때 질문합니다. 여전히 프롬프트를 표시하는 모드에서 더 강력한 자율 동작을 원하면 [적극적 출력 스타일](/docs/ko/output-styles.md)을 대신 설정하세요.

329 336

330> [!WARNING]337> [!WARNING]

331>338>

334자동 모드는 계정이 다음 요구 사항을 모두 충족할 때만 사용 가능합니다:341자동 모드는 계정이 다음 요구 사항을 모두 충족할 때만 사용 가능합니다:

335 342

336* **플랜**: 모든 플랜.343* **플랜**: 모든 플랜.

337* **조직**: Team 및 Enterprise에서는 자동 모드를 기본적으로 사용할 수 있습니다. 관리자는 [관리형 설정](/docs/ko/managed-settings)에서 `permissions.disableAutoMode`를 `"disable"`로 설정하여 조직에 대해 이를 끌 수 있습니다.344* **조직**: Team 및 Enterprise에서는 자동 모드를 기본적으로 사용할 수 있습니다. 관리자는 [관리형 설정](/docs/ko/managed-settings.md)에서 `permissions.disableAutoMode`를 `"disable"`로 설정하여 조직에 대해 이를 끌 수 있습니다.

338* **모델**: Anthropic API 및 [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws)에서는 Claude Opus 4.6 이상, Sonnet 4.6 이상, Haiku 5.5 또는 [Fable 모델](/docs/ko/model-config#work-with-fable). Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 및 로그인한 [Claude 앱 게이트웨이](/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 모델을 포함한 이전 모델은 어떤 제공자에서도 지원되지 않습니다.345* **모델**: Anthropic API 및 [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws.md)에서는 Claude Opus 4.6 이상, Sonnet 4.6 이상, Haiku 5.5 또는 [Fable 모델](/docs/ko/model-config.md#work-with-fable). Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 및 로그인한 [Claude 앱 게이트웨이](/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 모델을 포함한 이전 모델은 어떤 제공자에서도 지원되지 않습니다.

339* **제공자**: Anthropic API, AWS의 Claude Platform, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 및 로그인한 Claude 앱 게이트웨이 세션에서 기본적으로 사용 가능합니다.346* **제공자**: Anthropic API, AWS의 Claude Platform, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 및 로그인한 Claude 앱 게이트웨이 세션에서 기본적으로 사용 가능합니다.

340 347

341Claude Code가 자동 모드를 사용할 수 없다고 보고하면 먼저 이러한 요구 사항과 설정 파일이 [`disableAutoMode`](/docs/ko/settings-reference#disableautomode)를 설정하는지 확인하세요. Anthropic은 또한 서버 측에서 자동 모드를 끄거나 서버가 계정에 대해 자동 모드를 거부했을 수 있습니다. 어느 한 답변을 받은 세션은 세션이 끝날 때까지 자동 모드를 끈 상태로 유지하므로 나중에 새 세션을 시작하세요.348Claude Code가 자동 모드를 사용할 수 없다고 보고하면 먼저 이러한 요구 사항과 설정 파일이 [`disableAutoMode`](/docs/ko/settings-reference#disableautomode)를 설정하는지 확인하세요. Anthropic은 또한 서버 측에서 자동 모드를 끄거나 서버가 계정에 대해 자동 모드를 거부했을 수 있습니다. 어느 한 답변을 받은 세션은 세션이 끝날 때까지 자동 모드를 끈 상태로 유지하므로 나중에 새 세션을 시작하세요.

342 349

343모델을 이름 지정하고 자동 모드가 작업의 안전성을 "결정할 수 없다"고 말하는 별도의 메시지는 분류기 요청이 실패했음을 의미합니다. 이 실패는 일반적으로 일시적이지만 Amazon Bedrock에서는 계정이 명명된 모델을 호출할 수 있을 때까지 반복될 수 있습니다. 원인 및 수행할 작업은 [오류 참조](/docs/ko/errors#auto-mode-cannot-determine-the-safety-of-an-action)를 참조하세요.350모델을 이름 지정하고 자동 모드가 작업의 안전성을 "결정할 수 없다"고 말하는 별도의 메시지는 분류기 요청이 실패했음을 의미합니다. 이 실패는 일반적으로 일시적이지만 Amazon Bedrock에서는 계정이 명명된 모델을 호출할 수 있을 때까지 반복될 수 있습니다. 원인 및 수행할 작업은 [오류 참조](/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)를 참조하세요.

344 351

345[설정](/docs/ko/settings-reference#all-settings)에서 `defaultMode: "auto"`를 설정했는데 터미널 세션이 오류 없이 Manual 모드로 시작되면 설정이 `.claude/settings.json` 또는 `.claude/settings.local.json`에 있을 가능성이 높습니다. `auto`는 이러한 파일에서 적용되지 않습니다. `~/.claude/settings.json`으로 이동하세요. VS Code 확장이 시작한 대화의 경우 [권한 모드 전환](#switch-permission-modes) 대신 확장의 자체 목록을 확인하세요.352[설정](/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) 대신 확장의 자체 목록을 확인하세요.

346 353

347### Bedrock, Agent Platform 또는 Foundry의 자동 모드354### Bedrock, Agent Platform 또는 Foundry의 자동 모드

348 355

349[Amazon Bedrock](/docs/ko/amazon-bedrock), [Google Cloud의 Agent Platform](/docs/ko/google-vertex-ai), [Microsoft Foundry](/docs/ko/microsoft-foundry) 및 로그인한 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway) 세션에서는 자동 모드를 기본적으로 사용할 수 있습니다. 여기서 권한 모드를 설정하지 않으면 대화형 세션은 자동 모드로 시작하고, `claude -p` 또는 Agent SDK 실행은 구성 값이 `default`인 Manual 모드로 시작합니다:356[Amazon Bedrock](/docs/ko/amazon-bedrock.md), [Google Cloud의 Agent Platform](/docs/ko/google-vertex-ai.md), [Microsoft Foundry](/docs/ko/microsoft-foundry.md) 및 로그인한 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway) 세션에서는 자동 모드를 기본적으로 사용할 수 있습니다. 여기서 권한 모드를 설정하지 않으면 대화형 세션은 자동 모드로 시작하고, `claude -p` 또는 Agent SDK 실행은 구성 값이 `default`인 Manual 모드로 시작합니다:

350 357

351* **대화형 터미널 및 VS Code 세션**: 자동 이외의 권한 모드로 시작하려면 [다른 권한 모드에서 시작](#start-in-a-different-mode)이 설명하는 대로 `permissions.defaultMode`를 설정하거나 VS Code 확장의 [모드 표시기](#switch-permission-modes)에서 하나를 선택하세요. [세션이 시작되는 모드](#which-mode-a-session-starts-in)에는 이러한 세션을 자동 모드로 시작하는 Claude Code 버전이 나열되어 있습니다.358* **대화형 터미널 및 VS Code 세션**: 자동 이외의 권한 모드로 시작하려면 [다른 권한 모드에서 시작](#start-in-a-different-mode)이 설명하는 대로 `permissions.defaultMode`를 설정하거나 VS Code 확장의 [모드 표시기](#switch-permission-modes)에서 하나를 선택하세요. [세션이 시작되는 모드](#which-mode-a-session-starts-in)에는 이러한 세션을 자동 모드로 시작하는 Claude Code 버전이 나열되어 있습니다.

352* **`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 버전도 다룹니다.359* **`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 버전도 다룹니다.

353 360

354이러한 제공자에서는 Claude Sonnet 5 이상, Opus 4.7 이상, Haiku 5.5 및 Fable 모델만 지원됩니다. 다른 모델에서는 세션이 Manual로 시작됩니다. 이러한 제공자에서 Haiku 5.5로 자동 모드를 사용하려면 Claude Code v2.1.293 이상이 필요합니다.361이러한 제공자에서는 Claude Sonnet 5 이상, Opus 4.7 이상, Haiku 5.5 및 Fable 모델만 지원됩니다. 다른 모델에서는 세션이 Manual로 시작됩니다. 이러한 제공자에서 Haiku 5.5로 자동 모드를 사용하려면 Claude Code v2.1.293 이상이 필요합니다.

355 362

356개발자가 자동 모드를 사용하지 못하도록 하려면 [관리형 설정](/docs/ko/managed-settings)에서 `disableAutoMode`를 `"disable"`로 설정하세요. 이렇게 하면 `Shift+Tab` 사이클에서 `auto`가 제거되고, `--permission-mode auto`로 시작된 세션은 Manual로 시작됩니다. 이미 자동 모드로 실행 중인 세션은 설정이 [관리자 배포 소스](/docs/ko/managed-settings#which-managed-source-claude-code-uses)에서 해당 세션에 도달할 때 이를 떠나고 `auto mode disabled by settings`를 표시합니다. v2.1.251 이전에는 실행 중인 세션이 끝날 때까지 자동 모드를 유지했습니다.363개발자가 자동 모드를 사용하지 못하도록 하려면 [관리형 설정](/docs/ko/managed-settings.md)에서 `disableAutoMode`를 `"disable"`로 설정하세요. 이렇게 하면 `Shift+Tab` 사이클에서 `auto`가 제거되고, `--permission-mode auto`로 시작된 세션은 Manual로 시작됩니다. 이미 자동 모드로 실행 중인 세션은 설정이 [관리자 배포 소스](/docs/ko/managed-settings.md#which-managed-source-claude-code-uses)에서 해당 세션에 도달할 때 이를 떠나고 `auto mode disabled by settings`를 표시합니다. v2.1.251 이전에는 실행 중인 세션이 끝날 때까지 자동 모드를 유지했습니다.

357 364

358### 서버 측 분류기 검토365### 서버 측 분류기 검토

359 366

360자동 모드에서 Claude Code는 서버에 [결정 순서](#how-the-classifier-evaluates-actions)가 검토를 위해 보내는 작업을 확인하도록 요청할 수 있으며, 이는 자체 분류기 요청을 보내는 대신 세션의 모델 요청의 일부로 수행됩니다. 이러한 세션은 다음을 요청합니다:367자동 모드에서 Claude Code는 서버에 [결정 순서](#how-the-classifier-evaluates-actions)가 검토를 위해 보내는 작업을 확인하도록 요청할 수 있으며, 이는 자체 분류기 요청을 보내는 대신 세션의 모델 요청의 일부로 수행됩니다. 이러한 세션은 다음을 요청합니다:

361 368

362* **Anthropic API에 대한 직접 연결**: 대화형 터미널 세션과 `-p`, Agent SDK, [VS Code 확장](/docs/ko/vs-code) 및 [데스크톱 앱](/docs/ko/desktop) 세션에서, 플랜이나 계정 유형에 관계없이 Anthropic이 롤아웃할 때. 대화형 터미널 세션에서는 Pro, Max 및 Team 플랜에서 Claude Code v2.1.271 이상이 필요하고, Enterprise 플랜 및 Claude API 계정에서는 v2.1.278 이상이 필요합니다. `-p`, Agent SDK, VS Code 확장 및 데스크톱 앱 세션에서는 Claude Code v2.1.281 이상이 필요합니다. v2.1.282부터는 [기능 플래그를 가져오지 않는](/docs/ko/env-vars#features-that-need-feature-flag-fetching) 세션(예: 텔레메트리를 끈 경우)은 모든 종류의 세션에서 기본적으로 서버에 요청합니다.369* **Anthropic API에 대한 직접 연결**: 대화형 터미널 세션과 `-p`, Agent SDK, [VS Code 확장](/docs/ko/vs-code.md) 및 [데스크톱 앱](/docs/ko/desktop.md) 세션에서, 플랜이나 계정 유형에 관계없이 Anthropic이 롤아웃할 때. 대화형 터미널 세션에서는 Pro, Max 및 Team 플랜에서 Claude Code v2.1.271 이상이 필요하고, Enterprise 플랜 및 Claude API 계정에서는 v2.1.278 이상이 필요합니다. `-p`, Agent SDK, VS Code 확장 및 데스크톱 앱 세션에서는 Claude Code v2.1.281 이상이 필요합니다. v2.1.282부터는 [기능 플래그를 가져오지 않는](/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) 세션(예: 텔레메트리를 끈 경우)은 모든 종류의 세션에서 기본적으로 서버에 요청합니다.

363* **클라우드 제공자, LLM 게이트웨이 또는 프록시**: [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws), Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry에서, 그리고 `ANTHROPIC_BASE_URL`을 [LLM 게이트웨이 또는 프록시](/docs/ko/llm-gateway)로 가리킬 때마다 플랜에 관계없이. 기본적으로 요청하려면 Claude Code v2.1.278 이상이 필요합니다.370* **클라우드 제공자, LLM 게이트웨이 또는 프록시**: [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry에서, 그리고 `ANTHROPIC_BASE_URL`을 [LLM 게이트웨이 또는 프록시](/docs/ko/llm-gateway)로 가리킬 때마다 플랜에 관계없이. 기본적으로 요청하려면 Claude Code v2.1.278 이상이 필요합니다.

364* **로그인한 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway) 세션**: Claude Code v2.1.280 이상이 필요합니다371* **로그인한 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway) 세션**: Claude Code v2.1.280 이상이 필요합니다

365 372

366서버가 작업을 검토하는 경우 해당 판정이 이를 결정합니다. 다른 두 가지 결과가 가능합니다:373서버가 작업을 검토하는 경우 해당 판정이 이를 결정합니다. 다른 두 가지 결과가 가능합니다:

367 374

368* **서버가 세션을 검토하지 않음**: 응답이 검토 결과 없이 완료되거나 서버가 이 세션을 검토하지 않는다고 답합니다. 가장 일반적인 원인은 검토 요청이나 결과를 삭제하는 LLM 게이트웨이 또는 프록시이며, 아직 서버 측 검사가 없는 플랫폼, 지역 또는 자격 증명입니다. Claude Code는 자체 분류기 요청으로 폴백합니다. 이 폴백이 세션의 나머지 부분에 대해 유지되면 [분류기 요청 요금에 대한 공지](/docs/ko/auto-mode-classifier-billing)를 이러한 요청이 청구되는 계정에 표시합니다.375* **서버가 세션을 검토하지 않음**: 응답이 검토 결과 없이 완료되거나 서버가 이 세션을 검토하지 않는다고 답합니다. 가장 일반적인 원인은 검토 요청이나 결과를 삭제하는 LLM 게이트웨이 또는 프록시이며, 아직 서버 측 검사가 없는 플랫폼, 지역 또는 자격 증명입니다. Claude Code는 자체 분류기 요청으로 폴백합니다. 이 폴백이 세션의 나머지 부분에 대해 유지되면 [분류기 요청 요금에 대한 공지](/docs/ko/auto-mode-classifier-billing.md)를 이러한 요청이 청구되는 계정에 표시합니다.

369* **서버가 작업에 대한 판정을 제공하지 않음**: Claude Code는 검토되지 않은 상태로 실행하는 대신 작업을 거부합니다. 모든 연결에서 이는 응답이 검토 결과가 도착하기 전에 끝나거나 결과가 Claude Code가 읽을 수 없는 형식으로 도착할 때 발생합니다. 응답을 단축하거나 결과를 다시 작성하는 LLM 게이트웨이 또는 프록시가 둘 다 발생할 수 있습니다. Anthropic API에 대한 직접 연결에서는 서버의 검사가 작업에 대해 실패할 때도 발생합니다(예: 시간 초과). [서버가 안전 판정을 반환하지 않음](/docs/ko/errors#the-server-returned-no-safety-verdict)은 거부 메시지, 거부가 반복될 때 발생하는 일 및 수행할 작업을 다룹니다.376* **서버가 작업에 대한 판정을 제공하지 않음**: Claude Code는 검토되지 않은 상태로 실행하는 대신 작업을 거부합니다. 모든 연결에서 이는 응답이 검토 결과가 도착하기 전에 끝나거나 결과가 Claude Code가 읽을 수 없는 형식으로 도착할 때 발생합니다. 응답을 단축하거나 결과를 다시 작성하는 LLM 게이트웨이 또는 프록시가 둘 다 발생할 수 있습니다. Anthropic API에 대한 직접 연결에서는 서버의 검사가 작업에 대해 실패할 때도 발생합니다(예: 시간 초과). [서버가 안전 판정을 반환하지 않음](/docs/ko/errors.md#the-server-returned-no-safety-verdict)은 거부 메시지, 거부가 반복될 때 발생하는 일 및 수행할 작업을 다룹니다.

370 377

371서버에 요청하는 것을 건너뛰고 항상 Claude Code의 자체 분류기 요청을 사용하려면 [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/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`를 설정하지 않으면 Claude Code도 서버에 요청하는 것을 중지합니다. [사전 릴리스 기능 비활성화](/docs/ko/llm-gateway-protocol#disable-pre-release-capabilities)가 설명하는 경우는 제외합니다.378서버에 요청하는 것을 건너뛰고 항상 Claude Code의 자체 분류기 요청을 사용하려면 [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/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`를 설정하지 않으면 Claude Code도 서버에 요청하는 것을 중지합니다. [사전 릴리스 기능 비활성화](/docs/ko/llm-gateway-protocol.md#disable-pre-release-capabilities)가 설명하는 경우는 제외합니다.

372 379

373### 기본 분류기 모델380### 기본 분류기 모델

374 381

382| Claude Sonnet 4.6에서 실행됨 | Sonnet 4.6 |389| Claude Sonnet 4.6에서 실행됨 | Sonnet 4.6 |

383| [`ANTHROPIC_DEFAULT_SONNET_MODEL`](/docs/ko/model-config#environment-variables)이 설정됨 | 해당 값, 또는 값이 Claude Sonnet 5.5 또는 Claude Opus 5.5이면 Sonnet 5 |390| [`ANTHROPIC_DEFAULT_SONNET_MODEL`](/docs/ko/model-config#environment-variables)이 설정됨 | 해당 값, 또는 값이 Claude Sonnet 5.5 또는 Claude Opus 5.5이면 Sonnet 5 |

384 391

385Sonnet 5 또는 `ANTHROPIC_DEFAULT_SONNET_MODEL`의 모델을 제공자에서 사용할 수 없거나 조직의 [모델 정책](/docs/ko/model-config#restrict-model-selection)에서 제외한 경우 Claude Code는 대체 모델을 사용합니다. 이는 세션의 모델이며, [Fable 세션](/docs/ko/model-config#work-with-fable)에서는 Opus 모델입니다.392Sonnet 5 또는 `ANTHROPIC_DEFAULT_SONNET_MODEL`의 모델을 제공자에서 사용할 수 없거나 조직의 [모델 정책](/docs/ko/model-config.md#restrict-model-selection)에서 제외한 경우 Claude Code는 대체 모델을 사용합니다. 이는 세션의 모델이며, [Fable 세션](/docs/ko/model-config.md#work-with-fable)에서는 Opus 모델입니다.

386 393

387### 분류기 모델 선택394### 분류기 모델 선택

388 395

401| 상황 | 발생하는 일 | 수행할 작업 |408| 상황 | 발생하는 일 | 수행할 작업 |

402| - | - | - |409| - | - | - |

407 414

408여러 상황이 해당하면 먼저 나열된 상황을 따르세요.415여러 상황이 해당하면 먼저 나열된 상황을 따르세요.

425 432

426### 분류기가 기본적으로 차단하는 것433### 분류기가 기본적으로 차단하는 것

427 434

428분류기는 작업 디렉터리와 세션이 시작될 때 이에 대해 구성된 원격을 신뢰합니다. 세션 중에 `git remote add` 또는 `git remote set-url`로 추가되거나 다시 가리킨 원격은 신뢰되지 않으며, [신뢰할 수 있는 인프라를 구성](/docs/ko/auto-mode-config)할 때까지 다른 모든 것은 외부로 취급됩니다.435분류기는 작업 디렉터리와 세션이 시작될 때 이에 대해 구성된 원격을 신뢰합니다. 세션 중에 `git remote add` 또는 `git remote set-url`로 추가되거나 다시 가리킨 원격은 신뢰되지 않으며, [신뢰할 수 있는 인프라를 구성](/docs/ko/auto-mode-config.md)할 때까지 다른 모든 것은 외부로 취급됩니다.

429 436

430**기본적으로 차단됨**:437**기본적으로 차단됨**:

431 438

452* 민감한 원격 대상으로의 대화형 셸 또는 포트 포워드459* 민감한 원격 대상으로의 대화형 셸 또는 포트 포워드

453* 로컬 서비스를 공개 인터넷에서 도달 가능하게 하는 터널 또는 역셸 열기460* 로컬 서비스를 공개 인터넷에서 도달 가능하게 하는 터널 또는 역셸 열기

454* 라이브 자격 증명 또는 토큰을 트랜스크립트 또는 파일에 인쇄461* 라이브 자격 증명 또는 토큰을 트랜스크립트 또는 파일에 인쇄

455* [환경](/docs/ko/auto-mode-config#define-trusted-infrastructure)에서 민감한 데이터 위치로 나열된 위치에 액세스, 해당 위치에서 데이터 복사, 또는 항목이 제외하는 대상으로 해당 위치의 데이터 전송462* [환경](/docs/ko/auto-mode-config.md#define-trusted-infrastructure)에서 민감한 데이터 위치로 나열된 위치에 액세스, 해당 위치에서 데이터 복사, 또는 항목이 제외하는 대상으로 해당 위치의 데이터 전송

456* 내부 패키지 레지스트리를 우회하여 공개 레지스트리로 패키지 설치 라우팅. 이는 내부 레지스트리 또는 미러가 환경에 나열되어 있거나, 대화에서 Claude에 그러한 레지스트리가 존재한다고 말했을 때 적용됩니다463* 내부 패키지 레지스트리를 우회하여 공개 레지스트리로 패키지 설치 라우팅. 이는 내부 레지스트리 또는 미러가 환경에 나열되어 있거나, 대화에서 Claude에 그러한 레지스트리가 존재한다고 말했을 때 적용됩니다

457* `--insecure`와 같은 안전 가드를 해제하는 플래그로 명령 실행464* `--insecure`와 같은 안전 가드를 해제하는 플래그로 명령 실행

458* `--dangerously-skip-permissions` 또는 `--no-sandbox`로 시작된 것과 같이 인간 승인이나 샌드박스 없이 실행되는 자율 에이전트 루프 시작. 여기에는 `--yes-always`로 시작된 러너와 같이 격리 및 작업별 승인이 비활성화된 상태로 제3자 에이전트 또는 평가 하네스를 실행하는 것도 포함됩니다465* `--dangerously-skip-permissions` 또는 `--no-sandbox`로 시작된 것과 같이 인간 승인이나 샌드박스 없이 실행되는 자율 에이전트 루프 시작. 여기에는 `--yes-always`로 시작된 러너와 같이 격리 및 작업별 승인이 비활성화된 상태로 제3자 에이전트 또는 평가 하네스를 실행하는 것도 포함됩니다

459* [Chrome의 Claude](/docs/ko/chrome) 브라우저 작업으로 페이지 콘텐츠, 쿠키 또는 자격 증명을 원본 외부로 보낼 수 있음466* [Chrome의 Claude](/docs/ko/chrome.md) 브라우저 작업으로 페이지 콘텐츠, 쿠키 또는 자격 증명을 원본 외부로 보낼 수 있음

460* 특정 명명된 경로가 아닌 와일드카드, 글로브 또는 나이 필터로 `/tmp`, `$TMPDIR` 또는 다른 공유 스크래치 또는 캐시 디렉터리의 파일 삭제467* 특정 명명된 경로가 아닌 와일드카드, 글로브 또는 나이 필터로 `/tmp`, `$TMPDIR` 또는 다른 공유 스크래치 또는 캐시 디렉터리의 파일 삭제

461* 자신의 메시지가 해당 수신자에게 이러한 세부 정보를 승인하지 않았을 때 전송, 업로드, 게시 또는 다른 사람이나 공유 시스템에 작성된 콘텐츠에 민감한 세부 정보 포함. PR 및 이슈 본문, 커밋 메시지 및 댓글은 저장소가 신뢰 경계 외부이거나 공개일 때 이러한 종류의 아웃바운드 콘텐츠로 계산되며, 조직의 자체 공개 저장소도 포함됩니다. 내부 파일 경로, 코드명, 이메일 또는 계정 식별자와 같은 라이브 API 응답 데이터 및 인프라 식별자는 민감한 세부 정보로 계산됩니다. PR 또는 이슈 본문의 API 응답의 라이브 개인 데이터(예: 이메일 주소, 계정 또는 조직 식별자 또는 사용 메트릭)에는 저장소의 가시성이나 신뢰 경계에 관계없이 이러한 세부 정보와 수신자를 이름 지정해야 합니다468* 자신의 메시지가 해당 수신자에게 이러한 세부 정보를 승인하지 않았을 때 전송, 업로드, 게시 또는 다른 사람이나 공유 시스템에 작성된 콘텐츠에 민감한 세부 정보 포함. PR 및 이슈 본문, 커밋 메시지 및 댓글은 저장소가 신뢰 경계 외부이거나 공개일 때 이러한 종류의 아웃바운드 콘텐츠로 계산되며, 조직의 자체 공개 저장소도 포함됩니다. 내부 파일 경로, 코드명, 이메일 또는 계정 식별자와 같은 라이브 API 응답 데이터 및 인프라 식별자는 민감한 세부 정보로 계산됩니다. PR 또는 이슈 본문의 API 응답의 라이브 개인 데이터(예: 이메일 주소, 계정 또는 조직 식별자 또는 사용 메트릭)에는 저장소의 가시성이나 신뢰 경계에 관계없이 이러한 세부 정보와 수신자를 이름 지정해야 합니다

462* Claude Code의 자체 tmux 창으로 키스트로크를 보내 자체 인터페이스를 구동하는 것으로, 분류기는 Claude가 자체 권한이나 감시를 변경하는 것으로 취급합니다469* Claude Code의 자체 tmux 창으로 키스트로크를 보내 자체 인터페이스를 구동하는 것으로, 분류기는 Claude가 자체 권한이나 감시를 변경하는 것으로 취급합니다

472 479

473 `rm -rf "$VAR"/*`처럼 변수 바로 아래의 글로브는 대신 [중요 경로](#critical-paths)에 해당합니다. 맨 `*`이거나 `/*` 또는 `\*`로 끝나는 `Remove-Item` 대상은 분류기에 도달하지 않습니다: Claude Code가 [이를 즉시 거부합니다](#remove-item-in-powershell).480 `rm -rf "$VAR"/*`처럼 변수 바로 아래의 글로브는 대신 [중요 경로](#critical-paths)에 해당합니다. 맨 `*`이거나 `/*` 또는 `\*`로 끝나는 `Remove-Item` 대상은 분류기에 도달하지 않습니다: Claude Code가 [이를 즉시 거부합니다](#remove-item-in-powershell).

474 481

475이러한 범주 중 여러 개는 민감한 원격 대상 및 보호된 IaC 범위와 같이 구체적인 이름으로 좁힐 수 있는 [환경](/docs/ko/auto-mode-config#define-trusted-infrastructure) 항목에 따라 달라집니다.482이러한 범주 중 여러 개는 민감한 원격 대상 및 보호된 IaC 범위와 같이 구체적인 이름으로 좁힐 수 있는 [환경](/docs/ko/auto-mode-config.md#define-trusted-infrastructure) 항목에 따라 달라집니다.

476 483

477Claude Code v2.1.257 이상도 기본적으로 다음을 차단합니다:484Claude Code v2.1.257 이상도 기본적으로 다음을 차단합니다:

478 485

481* 작업이 아닌 호스트에 속하는 자격 증명 읽기(예: 노드 인증서 또는 노드의 컨테이너 레지스트리 인증)488* 작업이 아닌 호스트에 속하는 자격 증명 읽기(예: 노드 인증서 또는 노드의 컨테이너 레지스트리 인증)

482* Claude가 시작하지 않은 형제 컨테이너, 포드 또는 VM 또는 컨테이너 아래의 노드에 연결 또는 스캔489* Claude가 시작하지 않은 형제 컨테이너, 포드 또는 VM 또는 컨테이너 아래의 노드에 연결 또는 스캔

483 490

484Claude Code가 이 중 하나를 허용하도록 의도된 곳에서 실행되면 `autoMode.environment`의 [호스트 격리 항목](/docs/ko/auto-mode-config#define-trusted-infrastructure)에서 해당 설정을 설명하세요.491Claude Code가 이 중 하나를 허용하도록 의도된 곳에서 실행되면 `autoMode.environment`의 [호스트 격리 항목](/docs/ko/auto-mode-config.md#define-trusted-infrastructure)에서 해당 설정을 설명하세요.

485 492

486Claude Code v2.1.261 이상도 기본적으로 다음을 차단합니다:493Claude Code v2.1.261 이상도 기본적으로 다음을 차단합니다:

487 494

495* 읽기 전용 HTTP 요청502* 읽기 전용 HTTP 요청

496* 기본 브랜치를 포함하여 작업 중인 저장소의 모든 브랜치로 푸시. 이름이 배포 또는 게시 대상임을 나타내는 비기본 브랜치(예: `production` 또는 `gh-pages`)는 포함되지 않습니다: 분류기는 거기로의 푸시를 자체 조건에 따라 판단합니다.503* 기본 브랜치를 포함하여 작업 중인 저장소의 모든 브랜치로 푸시. 이름이 배포 또는 게시 대상임을 나타내는 비기본 브랜치(예: `production` 또는 `gh-pages`)는 포함되지 않습니다: 분류기는 거기로의 푸시를 자체 조건에 따라 판단합니다.

497 504

498 푸시의 콘텐츠는 여전히 분류기의 다른 규칙에 대해 검사되고, [`permissions.deny` 규칙](/docs/ko/permissions#manage-permissions)은 여전히 모든 모드에서 [작성된 대로](/docs/ko/permissions#bash-rule-limits) 푸시 명령을 차단할 수 있습니다. 원격의 자체 브랜치 보호는 여전히 적용됩니다. v2.1.203부터 v2.1.211 이전까지는 일상적인 기본 브랜치 푸시와 시작한 브랜치 또는 Claude가 생성한 브랜치로의 푸시만 기본적으로 허용되었습니다.505 푸시의 콘텐츠는 여전히 분류기의 다른 규칙에 대해 검사되고, [`permissions.deny` 규칙](/docs/ko/permissions#manage-permissions)은 여전히 모든 모드에서 [작성된 대로](/docs/ko/permissions.md#bash-rule-limits) 푸시 명령을 차단할 수 있습니다. 원격의 자체 브랜치 보호는 여전히 적용됩니다. v2.1.203부터 v2.1.211 이전까지는 일상적인 기본 브랜치 푸시와 시작한 브랜치 또는 Claude가 생성한 브랜치로의 푸시만 기본적으로 허용되었습니다.

499* 같은 세션에서 Claude가 생성한 정확한 작업 삭제506* 같은 세션에서 Claude가 생성한 정확한 작업 삭제

500* 작업의 일부로 보안 관련 코드, 구성 및 위협 모델 읽기, 검토 또는 작성507* 작업의 일부로 보안 관련 코드, 구성 및 위협 모델 읽기, 검토 또는 작성

501* 같은 다중 에이전트 세션에서 함께 작업하는 에이전트 간의 메시지508* 같은 다중 에이전트 세션에서 함께 작업하는 에이전트 간의 메시지

502* [`environment`](/docs/ko/auto-mode-config#define-trusted-infrastructure)에 나열한 신뢰할 수 있는 도메인, 버킷 및 서비스로 데이터 전송. 이는 동일한 인프라에 대한 파괴적이거나 자격 증명 작업이 아닌 데이터 흐름만 다룹니다509* [`environment`](/docs/ko/auto-mode-config#define-trusted-infrastructure)에 나열한 신뢰할 수 있는 도메인, 버킷 및 서비스로 데이터 전송. 이는 동일한 인프라에 대한 파괴적이거나 자격 증명 작업이 아닌 데이터 흐름만 다룹니다

503* [Chrome의 Claude](/docs/ko/chrome) 신뢰할 수 있는 내부 도메인, localhost 또는 이름 지정한 URL로의 탐색510* [Chrome의 Claude](/docs/ko/chrome.md) 신뢰할 수 있는 내부 도메인, localhost 또는 이름 지정한 URL로의 탐색

504 511

505샌드박스된 명령은 기본적으로 네트워크 액세스를 받지 않습니다. Claude는 명령이 필요한 호스트를 명령 자체에 이름 지정하고, 분류기는 명령과 함께 이를 검토하며, 승인된 목록은 해당 명령만을 위해 이러한 호스트를 엽니다. [명령별 허용 도메인](/docs/ko/sandboxing#per-command-allowed-domains-in-auto-mode)은 목록이 열 수 있는 것과 열 수 없는 것, 그리고 명령이 나열되지 않은 호스트에 도달할 때 발생하는 일을 다룹니다.512샌드박스된 명령은 기본적으로 네트워크 액세스를 받지 않습니다. Claude는 명령이 필요한 호스트를 명령 자체에 이름 지정하고, 분류기는 명령과 함께 이를 검토하며, 승인된 목록은 해당 명령만을 위해 이러한 호스트를 엽니다. [명령별 허용 도메인](/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)은 목록이 열 수 있는 것과 열 수 없는 것, 그리고 명령이 나열되지 않은 호스트에 도달할 때 발생하는 일을 다룹니다.

506 513

507`claude auto-mode defaults`를 실행하여 전체 규칙 목록을 JSON으로 인쇄하세요. 일상적인 작업이 차단되면 관리자는 `autoMode.environment` 설정을 통해 신뢰할 수 있는 저장소, 버킷 및 서비스를 추가할 수 있습니다: [자동 모드 구성](/docs/ko/auto-mode-config)을 참조하세요.514`claude auto-mode defaults`를 실행하여 전체 규칙 목록을 JSON으로 인쇄하세요. 일상적인 작업이 차단되면 관리자는 `autoMode.environment` 설정을 통해 신뢰할 수 있는 저장소, 버킷 및 서비스를 추가할 수 있습니다: [자동 모드 구성](/docs/ko/auto-mode-config.md)을 참조하세요.

508 515

509작업 중인 저장소의 모든 브랜치로 푸시하고 요청과 일치하는 풀 리퀘스트를 생성하는 것은 프롬프트 없이 실행됩니다. 푸시 또는 풀 리퀘스트가 [차단 목록](#what-the-classifier-blocks-by-default)에 해당하지 않는 한(예: 비밀이나 민감한 데이터가 저장소를 떠나거나 다른 저장소 또는 조직을 대상으로 하는 풀 리퀘스트). 자동 모드에 머물면서 이러한 명령 전에 인간 체크포인트를 요구하려면 `permissions.ask` 규칙을 추가하세요. 이는 명령과 [작성된 대로](/docs/ko/permissions#bash-rule-limits) 일치합니다: [일반적인 경계](/docs/ko/auto-mode-config#common-boundaries)를 참조하세요.516작업 중인 저장소의 모든 브랜치로 푸시하고 요청과 일치하는 풀 리퀘스트를 생성하는 것은 프롬프트 없이 실행됩니다. 푸시 또는 풀 리퀘스트가 [차단 목록](#what-the-classifier-blocks-by-default)에 해당하지 않는 한(예: 비밀이나 민감한 데이터가 저장소를 떠나거나 다른 저장소 또는 조직을 대상으로 하는 풀 리퀘스트). 자동 모드에 머물면서 이러한 명령 전에 인간 체크포인트를 요구하려면 `permissions.ask` 규칙을 추가하세요. 이는 명령과 [작성된 대로](/docs/ko/permissions.md#bash-rule-limits) 일치합니다: [일반적인 경계](/docs/ko/auto-mode-config.md#common-boundaries)를 참조하세요.

510 517

511### 작업 디렉터리 외부의 첫 번째 읽기518### 작업 디렉터리 외부의 첫 번째 읽기

512 519

513[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 꺼져 있는 동안 [네트워크 경로에서의 읽기](/docs/ko/permissions#network-paths)를 제외한 파일 읽기는 자동 모드에서 프롬프트 없이 실행되며, [작업 디렉터리](/docs/ko/permissions#working-directories) 외부의 읽기를 포함합니다. Claude가 처음으로 Read, Grep 또는 Glob 도구를 이들 외부의 경로에 사용할 때 Claude Code는 해당 읽기를 허용할지 묻습니다.520[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ko/settings-reference#permissions-blockreadsoutsideworkingdirectories)가 꺼져 있는 동안 [네트워크 경로에서의 읽기](/docs/ko/permissions.md#network-paths)를 제외한 파일 읽기는 자동 모드에서 프롬프트 없이 실행되며, [작업 디렉터리](/docs/ko/permissions.md#working-directories) 외부의 읽기를 포함합니다. Claude가 처음으로 Read, Grep 또는 Glob 도구를 이들 외부의 경로에 사용할 때 Claude Code는 해당 읽기를 허용할지 묻습니다.

514 521

515프롬프트는 비대화형 `-p` 실행이나 백그라운드 세션에 나타나지 않습니다. 거기서의 읽기는 이전과 같이 실행됩니다.522프롬프트는 비대화형 `-p` 실행이나 백그라운드 세션에 나타나지 않습니다. 거기서의 읽기는 이전과 같이 실행됩니다.

516 523

525 532

526분류기는 대화에서 명시한 경계를 차단 신호로 취급합니다. "푸시하지 마" 또는 "배포하기 전에 검토할 때까지 기다려"라고 Claude에 말하면 분류기는 기본 규칙이 허용하더라도 일치하는 작업을 차단합니다. 경계는 나중의 메시지에서 이를 해제할 때까지 유효합니다. 조건이 충족되었다는 Claude의 자체 판단으로는 이를 해제할 수 없습니다.533분류기는 대화에서 명시한 경계를 차단 신호로 취급합니다. "푸시하지 마" 또는 "배포하기 전에 검토할 때까지 기다려"라고 Claude에 말하면 분류기는 기본 규칙이 허용하더라도 일치하는 작업을 차단합니다. 경계는 나중의 메시지에서 이를 해제할 때까지 유효합니다. 조건이 충족되었다는 Claude의 자체 판단으로는 이를 해제할 수 없습니다.

527 534

528경계는 규칙으로 저장되지 않습니다. 분류기는 각 검사에서 트랜스크립트에서 이를 다시 읽으므로 [컨텍스트 압축](/docs/ko/costs#reduce-token-usage)이 경계를 명시한 메시지를 제거하면 경계가 손실될 수 있습니다. 하드 보장을 위해 [거부 규칙](/docs/ko/permissions#permission-rule-syntax)을 대신 추가하세요.535경계는 규칙으로 저장되지 않습니다. 분류기는 각 검사에서 트랜스크립트에서 이를 다시 읽으므로 [컨텍스트 압축](/docs/ko/costs.md#reduce-token-usage)이 경계를 명시한 메시지를 제거하면 경계가 손실될 수 있습니다. 하드 보장을 위해 [거부 규칙](/docs/ko/permissions.md#permission-rule-syntax)을 대신 추가하세요.

529 536

530### 대화에서 명시한 승인537### 대화에서 명시한 승인

531 538

533 540

534* **작업과 그 세부 정보를 이름 지정**: 메시지는 작업과 이를 위험하게 만드는 구체적인 것(예: 강제 푸시의 브랜치)을 이름 지정해야 합니다. 동사만 이름 지정하는 것은 아무것도 지우지 않으므로 "강제 푸시할 수 있습니다"는 블록을 그대로 둡니다.541* **작업과 그 세부 정보를 이름 지정**: 메시지는 작업과 이를 위험하게 만드는 구체적인 것(예: 강제 푸시의 브랜치)을 이름 지정해야 합니다. 동사만 이름 지정하는 것은 아무것도 지우지 않으므로 "강제 푸시할 수 있습니다"는 블록을 그대로 둡니다.

535* **한 작업을 다루도록 예상**: 승인은 이름 지정한 파괴적 작업을 다루므로, 승인을 지속적인 것으로 부여하지 않았다면 나중의 작업은 다시 차단됩니다. 일상적인 패턴을 한 번에 하나씩 승인하는 것을 중지하려면 [`autoMode.allow`](/docs/ko/auto-mode-config#override-the-block-and-allow-rules)에 추가하세요.542* **한 작업을 다루도록 예상**: 승인은 이름 지정한 파괴적 작업을 다루므로, 승인을 지속적인 것으로 부여하지 않았다면 나중의 작업은 다시 차단됩니다. 일상적인 패턴을 한 번에 하나씩 승인하는 것을 중지하려면 [`autoMode.allow`](/docs/ko/auto-mode-config#override-the-block-and-allow-rules)에 추가하세요.

536* **일부 블록은 그대로 남음**: [분류기의 우선순위 순서](/docs/ko/auto-mode-config#override-the-block-and-allow-rules)는 승인이 도달할 수 있는 블록을 설정합니다. 이를 지우지 않을 단계를 실행하려면 [자동 모드를 떠나](#switch-permission-modes) 권한 프롬프트에 답하세요.543* **일부 블록은 그대로 남음**: [분류기의 우선순위 순서](/docs/ko/auto-mode-config.md#override-the-block-and-allow-rules)는 승인이 도달할 수 있는 블록을 설정합니다. 이를 지우지 않을 단계를 실행하려면 [자동 모드를 떠나](#switch-permission-modes) 권한 프롬프트에 답하세요.

537 544

538### 자동 모드가 폴백할 때545### 자동 모드가 폴백할 때

539 546

541 548

542* **차단된 작업**: Claude Code는 알림을 표시하고 `/permissions` 아래의 **최근 거부됨** 탭에 작업을 나열하며, 여기서 `r`을 눌러 수동 승인으로 다시 시도할 수 있습니다.549* **차단된 작업**: Claude Code는 알림을 표시하고 `/permissions` 아래의 **최근 거부됨** 탭에 작업을 나열하며, 여기서 `r`을 눌러 수동 승인으로 다시 시도할 수 있습니다.

543* **반복된 블록**: 분류기가 작업을 연속 3회 또는 총 20회 차단하면 자동 모드가 일시 중지되고 Claude Code는 프롬프트를 다시 시작합니다. 프롬프트된 작업을 승인하면 자동 모드가 재개됩니다. [반복된 블록 임계값](#repeated-block-thresholds)을 참조하여 블록이 어떻게 계산되는지 확인하세요.550* **반복된 블록**: 분류기가 작업을 연속 3회 또는 총 20회 차단하면 자동 모드가 일시 중지되고 Claude Code는 프롬프트를 다시 시작합니다. 프롬프트된 작업을 승인하면 자동 모드가 재개됩니다. [반복된 블록 임계값](#repeated-block-thresholds)을 참조하여 블록이 어떻게 계산되는지 확인하세요.

544* **분류기의 판정 없음**: 자동 모드와 별개인 안전 검사가 분류기의 자체 요청을 거부하거나 분류기의 응답이 구문 분석되지 않을 때 Claude Code는 알림이나 **최근 거부됨** 항목 없이 작업을 거부합니다. [자동 모드가 작업의 안전성을 결정할 수 없음](/docs/ko/errors#auto-mode-cannot-determine-the-safety-of-an-action)을 참조하여 각 경우가 표시하는 메시지와 수행할 작업을 확인하세요.551* **분류기의 판정 없음**: 자동 모드와 별개인 안전 검사가 분류기의 자체 요청을 거부하거나 분류기의 응답이 구문 분석되지 않을 때 Claude Code는 알림이나 **최근 거부됨** 항목 없이 작업을 거부합니다. [자동 모드가 작업의 안전성을 결정할 수 없음](/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)을 참조하여 각 경우가 표시하는 메시지와 수행할 작업을 확인하세요.

545* **서버의 판정 없음**: [서버 측 분류기 검토](#server-side-classifier-review)에서 Claude Code는 서버가 판정을 제공하지 않는 작업을 거부하고, 연속 10개 응답 후 판정이 없으면 턴을 중지합니다. [서버가 안전 판정을 반환하지 않음](/docs/ko/errors#the-server-returned-no-safety-verdict)을 참조하세요.552* **서버의 판정 없음**: [서버 측 분류기 검토](#server-side-classifier-review)에서 Claude Code는 서버가 판정을 제공하지 않는 작업을 거부하고, 연속 10개 응답 후 판정이 없으면 턴을 중지합니다. [서버가 안전 판정을 반환하지 않음](/docs/ko/errors.md#the-server-returned-no-safety-verdict)을 참조하세요.

546* **검사 중 모드 전환**: 분류기 검사가 보류 중일 때 권한 모드를 전환하면 Claude Code는 새 모드가 요청하지 않을 판정을 삭제합니다. 대신 승인을 위해 프롬프트되거나 [`dontAsk` 모드](#allow-only-pre-approved-tools-with-dontask-mode)에서 작업이 자동 거부됩니다.553* **검사 중 모드 전환**: 분류기 검사가 보류 중일 때 권한 모드를 전환하면 Claude Code는 새 모드가 요청하지 않을 판정을 삭제합니다. 대신 승인을 위해 프롬프트되거나 [`dontAsk` 모드](#allow-only-pre-approved-tools-with-dontask-mode)에서 작업이 자동 거부됩니다.

547 554

548#### 반복된 블록 임계값555#### 반복된 블록 임계값

549 556

550연속 3개 블록 및 총 20개 블록의 임계값은 구성할 수 없습니다. 총 카운터는 세션에 대해 유지되고 자체 한계가 폴백을 트리거할 때만 재설정됩니다. Claude Code는 자동 모드와 별개인 안전 검사가 분류기의 자체 요청을 거부할 때 거부를 어느 임계값에도 계산하지 않습니다.557연속 3개 블록 및 총 20개 블록의 임계값은 구성할 수 없습니다. 총 카운터는 세션에 대해 유지되고 자체 한계가 폴백을 트리거할 때만 재설정됩니다. Claude Code는 자동 모드와 별개인 안전 검사가 분류기의 자체 요청을 거부할 때 거부를 어느 임계값에도 계산하지 않습니다.

551 558

552[비대화형](/docs/ko/headless) `-p` 실행이 [`--permission-prompt-tool`](/docs/ko/cli-reference#cli-flags)이 없으면 폴백할 프롬프트가 없습니다. 반복된 블록이 임계값에 도달하면 작업이 실행되지 않고 Claude는 계속 작업합니다. Claude Code는 실행을 중지하지 않습니다.559[비대화형](/docs/ko/headless.md) `-p` 실행이 [`--permission-prompt-tool`](/docs/ko/cli-reference#cli-flags)이 없으면 폴백할 프롬프트가 없습니다. 반복된 블록이 임계값에 도달하면 작업이 실행되지 않고 Claude는 계속 작업합니다. Claude Code는 실행을 중지하지 않습니다.

553 560

554반복된 블록은 일반적으로 분류기가 인프라에 대한 컨텍스트를 놓치고 있음을 의미합니다. `/feedback`을 사용하여 거짓 양성을 보고하거나 관리자가 [신뢰할 수 있는 인프라를 구성](/docs/ko/auto-mode-config)하도록 하세요.561반복된 블록은 일반적으로 분류기가 인프라에 대한 컨텍스트를 놓치고 있음을 의미합니다. `/feedback`을 사용하여 거짓 양성을 보고하거나 관리자가 [신뢰할 수 있는 인프라를 구성](/docs/ko/auto-mode-config.md)하도록 하세요.

555 562

556### 자동 모드가 작업을 평가하는 방법563### 자동 모드가 작업을 평가하는 방법

557 564

561>568>

562> 각 작업은 고정된 결정 순서를 거칩니다. 첫 번째 일치하는 단계가 승리합니다:569> 각 작업은 고정된 결정 순서를 거칩니다. 첫 번째 일치하는 단계가 승리합니다:

563>570>

564> 1. [allow, ask 또는 deny 규칙](/docs/ko/permissions#manage-permissions)과 일치하는 작업은 즉시 처리되며, 다음은 예외입니다:571> 1. [allow, ask 또는 deny 규칙](/docs/ko/permissions.md#manage-permissions)과 일치하는 작업은 즉시 처리되며, 다음은 예외입니다:

565> * [보호된 경로](#protected-paths)에 대한 쓰기는 allow 규칙이 일치하더라도 분류기로 전달됩니다. 보호된 경로가 심볼릭 링크된 설정 파일이 가리키는 파일인 경우, [보호된 경로](#protected-paths) 목록에서 설명하는 대로 쓰기가 대신 확인을 요청할 수 있습니다572> * [보호된 경로](#protected-paths)에 대한 쓰기는 allow 규칙이 일치하더라도 분류기로 전달됩니다. 보호된 경로가 심볼릭 링크된 설정 파일이 가리키는 파일인 경우, [보호된 경로](#protected-paths) 목록에서 설명하는 대로 쓰기가 대신 확인을 요청할 수 있습니다

566> * 어떤 allow 규칙도 [중요 경로](#critical-paths)를 대상으로 하는 `rm` 및 `rmdir` 제거를 승인하지 않습니다573> * 어떤 allow 규칙도 [중요 경로](#critical-paths)를 대상으로 하는 것으로 인식된 `rm` 및 `rmdir` 제거를 승인하지 않습니다

567> * [`requiresUserInteraction`](/docs/ko/mcp#require-approval-for-a-specific-tool)으로 표시된 MCP 도구는 allow 규칙이 일치하더라도 직접 확인을 요청하며, 해당 설정이 Claude Code에 도달하는 세션에서는 [조직이 `ask`로 설정한](/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구도 마찬가지입니다574> * [`requiresUserInteraction`](/docs/ko/mcp#require-approval-for-a-specific-tool)으로 표시된 MCP 도구는 allow 규칙이 일치하더라도 직접 확인을 요청하며, 해당 설정이 Claude Code에 도달하는 세션에서는 [조직이 `ask`로 설정한](/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구도 마찬가지입니다

568> * [명령별 허용 도메인](/docs/ko/sandboxing#per-command-allowed-domains-in-auto-mode)을 포함하는 셸 명령도 allow 규칙이 일치하더라도 분류기로 전달됩니다. 규칙은 명령을 승인할 뿐 호스트를 승인하지 않기 때문입니다575> * [명령별 허용 도메인](/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)을 포함하는 셸 명령도 allow 규칙이 일치하더라도 분류기로 전달됩니다. 규칙은 명령을 승인할 뿐 호스트를 승인하지 않기 때문입니다

569> * `Bash(git push *)`처럼 명령 내용과 일치하는 ask 규칙은 권한 프롬프트로 폴백합니다576> * `Bash(git push *)`처럼 명령 내용과 일치하는 ask 규칙은 권한 프롬프트로 폴백합니다

570> * [심볼릭 링크 검사](/docs/ko/permissions#symlinks)로 보호된 경로로 확인되는 쓰기는, Claude가 요청한 경로 자체가 보호되지 않은 경우 확인을 요청합니다577> * [심볼릭 링크 검사](/docs/ko/permissions.md#symlinks)로 보호된 경로로 확인되는 쓰기는, Claude가 요청한 경로 자체가 보호되지 않은 경우 확인을 요청합니다

571> * [네트워크 경로](/docs/ko/permissions#network-paths)에서의 읽기는 allow 규칙이 일치하더라도 확인을 요청합니다578> * [네트워크 경로](/docs/ko/permissions.md#network-paths)에서의 읽기는 allow 규칙이 일치하더라도 확인을 요청합니다

572> 2. 읽기 전용 작업과 작업 디렉터리의 파일 편집은 자동 승인됩니다. 단, [보호된 경로](#protected-paths)에 대한 쓰기와 확인을 요청하는 [작업 디렉터리 외부의 첫 번째 읽기](#first-read-outside-the-working-directories)는 예외입니다579> 2. 읽기 전용 작업과 작업 디렉터리의 파일 편집은 자동 승인됩니다. 단, [보호된 경로](#protected-paths)에 대한 쓰기와 확인을 요청하는 [작업 디렉터리 외부의 첫 번째 읽기](#first-read-outside-the-working-directories)는 예외입니다

573> * [서버 측 분류기 검토](#server-side-classifier-review)가 적용되는 세션에서는 읽기 전용 및 [샌드박스된](/docs/ko/sandboxing#sandbox-modes) 셸 명령이 해당 검토를 기다리며, 검토에서 문제가 지적되면 차단됩니다580> * [서버 측 분류기 검토](#server-side-classifier-review)가 적용되는 세션에서는 읽기 전용 및 [샌드박스된](/docs/ko/sandboxing.md#sandbox-modes) 셸 명령이 해당 검토를 기다리며, 검토에서 문제가 지적되면 차단됩니다

574> * 작업 디렉터리 내부의 쓰기가 [심볼릭 링크 검사](/docs/ko/permissions#symlinks)로 외부 위치로 확인되면 확인을 요청합니다581> * 작업 디렉터리 내부의 쓰기가 [심볼릭 링크 검사](/docs/ko/permissions.md#symlinks)로 외부 위치로 확인되면 확인을 요청합니다

575> * Claude가 [다른 사람이 만든 아티팩트](/docs/ko/artifacts#read-an-artifact-shared-with-you)를 읽을 때는 해당 섹션에 나열된 승인 사례가 적용됩니다582> * Claude가 [다른 사람이 만든 아티팩트](/docs/ko/artifacts.md#read-an-artifact-shared-with-you)를 읽을 때는 해당 섹션에 나열된 승인 사례가 적용됩니다

576> * [네트워크 경로](/docs/ko/permissions#network-paths)에서의 읽기는 확인을 요청합니다583> * [네트워크 경로](/docs/ko/permissions.md#network-paths)에서의 읽기는 확인을 요청합니다

577> 3. 기본 처리 방식이 적용되는 [중요 경로 제거](#critical-paths)를 제외한 그 밖의 모든 것은 분류기로 전달됩니다. 1단계에서 직접 확인을 요청하는 커넥터 도구와 `requiresUserInteraction` MCP 도구도 분류기에 도달하지 않으므로, 조직이 요구하는 승인이나 동의 단계는 자동 승인되지 않습니다584> 3. 기본 처리 방식이 적용되는 [중요 경로 제거](#critical-paths)를 제외한 그 밖의 모든 것은 분류기로 전달됩니다. 1단계에서 직접 확인을 요청하는 커넥터 도구와 `requiresUserInteraction` MCP 도구도 분류기에 도달하지 않으므로, 조직이 요구하는 승인이나 동의 단계는 자동 승인되지 않습니다

578> 4. 분류기가 차단하면 Claude는 그 이유를 받습니다. 대부분의 세션에서 이유는 서술형 설명이 아니라 `[Data Exfiltration]`처럼 분류기가 일치시킨 규칙의 이름으로 제공됩니다. [거부 검토](/docs/ko/auto-mode-config#review-denials)를 참조하세요585> 4. 분류기가 차단하면 Claude는 그 이유를 받습니다. 대부분의 세션에서 이유는 서술형 설명이 아니라 `[Data Exfiltration]`처럼 분류기가 일치시킨 규칙의 이름으로 제공됩니다. [거부 검토](/docs/ko/auto-mode-config.md#review-denials)를 참조하세요

579>586>

580> `tool.check`를 처리하는 설치된 [mod](/docs/ko/plugins/mods/overview)도 작업을 승인할 수 있습니다. mod의 승인이 규칙과 훅을 통과하지 못하는 경우는 [훅으로 권한 확장](/docs/ko/permissions#precedence-among-rules-hooks-and-mods)을 참조하세요.587> `tool.check`를 처리하는 설치된 [mod](/docs/ko/plugins/mods/overview.md)도 작업을 승인할 수 있습니다. mod의 승인이 규칙과 훅을 통과하지 못하는 경우는 [훅으로 권한 확장](/docs/ko/permissions.md#precedence-among-rules-hooks-and-mods)을 참조하세요.

581>588>

582> VS Code 확장에서 [Chrome의 Claude](/docs/ko/chrome) 브라우저 작업이 승인되는 방식은 [VS Code 세션의 권한 프롬프트](/docs/ko/chrome#permission-prompts-in-vs-code-sessions)를 참조하세요.589> VS Code 확장에서 [Chrome의 Claude](/docs/ko/chrome.md) 브라우저 작업이 승인되는 방식은 [VS Code 세션의 권한 프롬프트](/docs/ko/chrome.md#permission-prompts-in-vs-code-sessions)를 참조하세요.

583>590>

584> 자동 모드에 들어가면 임의의 코드 실행을 부여하는 광범위한 허용 규칙이 삭제됩니다:591> 자동 모드에 들어가면 임의의 코드 실행을 부여하는 광범위한 허용 규칙이 삭제됩니다:

585>592>

601 608

602> **자동 모드가 서브에이전트를 처리하는 방법**609> **자동 모드가 서브에이전트를 처리하는 방법**

603>610>

604> 분류기는 [서브에이전트](/docs/ko/sub-agents) 작업을 세 지점에서 검사합니다:611> 분류기는 [서브에이전트](/docs/ko/sub-agents.md) 작업을 세 지점에서 검사합니다:

605>612>

606> 1. 서브에이전트가 시작되기 전에 위임된 작업 설명이 평가되므로, 위험해 보이는 작업은 생성 시점에 차단됩니다.613> 1. 서브에이전트가 시작되기 전에 위임된 작업 설명이 평가되므로, 위험해 보이는 작업은 생성 시점에 차단됩니다.

607> 2. 서브에이전트가 실행되는 동안 각 작업은 상위 세션과 동일한 차단 및 허용 규칙으로 동일한 [결정 순서](#how-the-classifier-evaluates-actions)를 거칩니다. 서브에이전트 frontmatter의 `permissionMode`는 무시됩니다.614> 2. 서브에이전트가 실행되는 동안 각 작업은 상위 세션과 동일한 차단 및 허용 규칙으로 동일한 [결정 순서](#how-the-classifier-evaluates-actions)를 거칩니다. 서브에이전트 frontmatter의 `permissionMode`는 무시됩니다.

611>618>

612> Claude Code의 분류기 요청은 `/model` 선택과 다른 모델에서 실행될 수 있습니다. [어떤 모델에서 실행되는지](#default-classifier-model) 참조하세요.619> Claude Code의 분류기 요청은 `/model` 선택과 다른 모델에서 실행될 수 있습니다. [어떤 모델에서 실행되는지](#default-classifier-model) 참조하세요.

613>620>

614> Enterprise 플랜 및 Claude API를 사용하는 계정, [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws), Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서 분류기 호출은 토큰 사용량에 계산됩니다. 각 검사는 트랜스크립트의 일부와 보류 중인 작업을 보내며 실행 전에 왕복을 추가합니다. 읽기 및 보호된 경로 외부의 작업 디렉터리 편집은 분류기를 건너뛰므로 오버헤드는 주로 셸 명령 및 네트워크 작업에서 나옵니다. 서버가 세션의 모델 요청의 일부로 작업을 검토하는 경우 계산할 별도의 분류기 호출이 없습니다. [서버 측 분류기 검토](#server-side-classifier-review)를 참조하세요.621> Enterprise 플랜 및 Claude API를 사용하는 계정, [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서 분류기 호출은 토큰 사용량에 계산됩니다. 각 검사는 트랜스크립트의 일부와 보류 중인 작업을 보내며 실행 전에 왕복을 추가합니다. 읽기 및 보호된 경로 외부의 작업 디렉터리 편집은 분류기를 건너뛰므로 오버헤드는 주로 셸 명령 및 네트워크 작업에서 나옵니다. 서버가 세션의 모델 요청의 일부로 작업을 검토하는 경우 계산할 별도의 분류기 호출이 없습니다. [서버 측 분류기 검토](#server-side-classifier-review)를 참조하세요.

615>622>

616> 샌드박스된 네트워크 액세스는 연결별 분류기 요청을 추가하지 않습니다. 분류기는 [명령이 이름 지정하는 호스트](/docs/ko/sandboxing#per-command-allowed-domains-in-auto-mode)를 한 번의 검토에서 명령과 함께 판단하고, Claude Code는 분류기를 다시 호출하지 않고 승인된 목록에 대해 각 연결을 검사합니다.623> 샌드박스된 네트워크 액세스는 연결별 분류기 요청을 추가하지 않습니다. 분류기는 [명령이 이름 지정하는 호스트](/docs/ko/sandboxing.md#per-command-allowed-domains-in-auto-mode)를 한 번의 검토에서 명령과 함께 판단하고, Claude Code는 분류기를 다시 호출하지 않고 승인된 목록에 대해 각 연결을 검사합니다.

617 624

618## dontAsk 모드로 사전 승인된 도구만 허용625## dontAsk 모드로 사전 승인된 도구만 허용

619 626

620`dontAsk` 모드를 설정하면 Claude Code는 평소라면 확인을 요청했을 모든 도구 호출을 자동으로 거부합니다. 단, 설치한 [mod](/docs/ko/plugins/mods/overview)는 이러한 호출 중 일부를 여전히 승인할 수 있습니다. mod가 승인할 수 있는 호출을 확인하려면 [훅으로 권한 확장](/docs/ko/permissions#precedence-among-rules-hooks-and-mods)을 참조하세요.627`dontAsk` 모드를 설정하면 Claude Code는 평소라면 확인을 요청했을 모든 도구 호출을 자동으로 거부합니다. 단, 설치한 [mod](/docs/ko/plugins/mods/overview.md)는 이러한 호출 중 일부를 여전히 승인할 수 있습니다. mod가 승인할 수 있는 호출을 확인하려면 [훅으로 권한 확장](/docs/ko/permissions.md#precedence-among-rules-hooks-and-mods)을 참조하세요.

621 628

622Claude는 여전히 Manual 모드에서 승인이 필요 없는 작업을 실행합니다. 예를 들어 작업 디렉터리 내의 파일 읽기 및 [읽기 전용 Bash 명령](/docs/ko/permissions#read-only-commands)이 이에 해당합니다. `permissions.allow` 규칙과 일치하는 작업과 [PreToolUse 훅](/docs/ko/permissions#extend-permissions-with-hooks)으로 승인된 호출도 실행됩니다. 이 모드는 CI 파이프라인이나 Claude가 수행할 수 있는 작업을 사전에 정의하는 제한된 환경에서 사용합니다. 세션은 입력을 기다리지 않습니다. 이 모드에서는 상태 표시줄에 `⏵⏵ don't ask on`이 표시됩니다.629Claude는 여전히 Manual 모드에서 승인이 필요 없는 작업을 실행합니다. 예를 들어 작업 디렉터리 내의 파일 읽기 및 [읽기 전용 Bash 명령](/docs/ko/permissions.md#read-only-commands)이 이에 해당합니다. `permissions.allow` 규칙과 일치하는 작업과 [PreToolUse 훅](/docs/ko/permissions.md#extend-permissions-with-hooks)으로 승인된 호출도 실행됩니다. 이 모드는 CI 파이프라인이나 Claude가 수행할 수 있는 작업을 사전에 정의하는 제한된 환경에서 사용합니다. 세션은 입력을 기다리지 않습니다. 이 모드에서는 상태 표시줄에 `⏵⏵ don't ask on`이 표시됩니다.

623 630

624Claude Code는 프롬프트를 표시하는 대신 명시적인 [`ask` 규칙](/docs/ko/permissions#manage-permissions)과 일치하는 호출을 거부합니다. 또한 `allow` 규칙이 일치하더라도 기본 제공 `AskUserQuestion` 도구를 거부하며, 해당 설정이 Claude Code에 도달하는 세션에서 조직이 [`ask`로 설정한](/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구도 동일하게 거부합니다. [`_meta["anthropic/requiresUserInteraction"]`](/docs/ko/mcp#require-approval-for-a-specific-tool)로 표시된 MCP 도구도 동일한 방식으로 거부합니다. 이는 승인 카드가 이 모드에서 수집하지 않는 답변이 필요하기 때문입니다.631Claude Code는 프롬프트를 표시하는 대신 명시적인 [`ask` 규칙](/docs/ko/permissions#manage-permissions)과 일치하는 호출을 거부합니다. 또한 `allow` 규칙이 일치하더라도 기본 제공 `AskUserQuestion` 도구를 거부하며, 해당 설정이 Claude Code에 도달하는 세션에서 조직이 [`ask`로 설정한](/docs/ko/mcp#organization-controls-on-connector-tools) 커넥터 도구도 동일하게 거부합니다. [`_meta["anthropic/requiresUserInteraction"]`](/docs/ko/mcp#require-approval-for-a-specific-tool)로 표시된 MCP 도구도 동일한 방식으로 거부합니다. 이는 승인 카드가 이 모드에서 수집하지 않는 답변이 필요하기 때문입니다.

625 632

626`rm` 및 `rmdir` 제거가 [중요 경로](#critical-paths)를 대상으로 하는 경우(예: `rm -rf /` 및 `rm -rf ~`), `allow` 규칙이 일치하거나 `PreToolUse` 훅이 허용하더라도 거부됩니다. [네트워크 경로](/docs/ko/permissions#network-paths)에서의 읽기도 동일한 방식으로 거부됩니다.633`allow` 규칙이나 `PreToolUse` 훅으로는 다음을 승인할 수 없습니다:

627 634

628[클라우드 세션](/docs/ko/claude-code-on-the-web)은 `defaultMode: "dontAsk"`를 무시합니다. 자세한 내용은 [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode)를 참조하세요.635* 인식된 `rm` 및 `rmdir` [중요 경로](#critical-paths) 제거(예: `rm -rf /` 및 `rm -rf ~`)

636* [네트워크 경로](/docs/ko/permissions.md#network-paths)에서의 읽기

637

638[클라우드 세션](/docs/ko/claude-code-on-the-web.md)은 `defaultMode: "dontAsk"`를 무시합니다. 자세한 내용은 [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode)를 참조하세요.

629 639

630시작 시 플래그로 설정합니다:640시작 시 플래그로 설정합니다:

631 641

637 647

638`bypassPermissions` 모드는 권한 프롬프트와 안전 확인을 비활성화하여 [보호된 경로](#protected-paths)에 대한 쓰기를 포함한 도구 호출이 즉시 실행되도록 합니다.648`bypassPermissions` 모드는 권한 프롬프트와 안전 확인을 비활성화하여 [보호된 경로](#protected-paths)에 대한 쓰기를 포함한 도구 호출이 즉시 실행되도록 합니다.

639 649

640[어떤 모드도 자동 승인하지 않는 작업](#actions-no-mode-auto-approves)은 이 모드에서도 계속 프롬프트를 표시합니다. [다른 조직의 공개 아티팩트](/docs/ko/artifacts#read-an-artifact-shared-with-you)를 읽으려면 사용자의 승인이 필요한데, 이 모드는 승인을 요청하지 않으므로 Claude는 이를 읽을 수 없습니다. [PowerShell의 Remove-Item](#remove-item-in-powershell) 거부도 이 모드에서 적용됩니다.650[어떤 모드도 자동 승인하지 않는 작업](#actions-no-mode-auto-approves)은 이 모드에서도 계속 프롬프트를 표시합니다. [다른 조직의 공개 아티팩트](/docs/ko/artifacts.md#read-an-artifact-shared-with-you)를 읽으려면 사용자의 승인이 필요한데, 이 모드는 승인을 요청하지 않으므로 Claude는 이를 읽을 수 없습니다. [PowerShell의 Remove-Item](#remove-item-in-powershell) 거부도 이 모드에서 적용됩니다.

641 651

642두 가지 [세션 간 메시징](/docs/ko/cross-session-messaging) 보안 조치는 이 모드에서, 그리고 권한 우회가 가능한 대화형 터미널 계획 모드 세션에서도 계속 적용됩니다:652두 가지 [세션 간 메시징](/docs/ko/cross-session-messaging.md) 보안 조치는 이 모드에서, 그리고 권한 우회가 가능한 대화형 터미널 계획 모드 세션에서도 계속 적용됩니다:

643 653

644* 이 머신을 넘어 다른 세션으로의 메시지에 대한 [`isolatePeerMachines`](/docs/ko/settings-reference#isolatepeermachines) 승인 프롬프트는 계속 나타납니다.654* 이 머신을 넘어 다른 세션으로의 메시지에 대한 [`isolatePeerMachines`](/docs/ko/settings-reference#isolatepeermachines) 승인 프롬프트는 계속 나타납니다.

645* [`crossSessionInbound`](/docs/ko/cross-session-messaging#control-inbound-messages) 값이 적용되지 않을 때, Claude Code는 다른 세션에서의 인바운드 메시지를 승인 대기 상태로 유지하며, 송신 세션이 권한 프롬프트도 우회 중임을 식별할 때만 묻지 않고 전달합니다. 메시지가 대기 중인 상태에서 권한 모드를 종료하면, Claude Code는 인바운드 규칙을 다시 적용하고 현재 수락하는 대기 중인 메시지를 전달합니다.655* [`crossSessionInbound`](/docs/ko/cross-session-messaging#control-inbound-messages) 값이 적용되지 않을 때, Claude Code는 다른 세션에서의 인바운드 메시지를 승인 대기 상태로 유지하며, 송신 세션이 권한 프롬프트도 우회 중임을 식별할 때만 묻지 않고 전달합니다. 메시지가 대기 중인 상태에서 권한 모드를 종료하면, Claude Code는 인바운드 규칙을 다시 적용하고 현재 수락하는 대기 중인 메시지를 전달합니다.

646 656

647권한 우회가 가능한 대화형 터미널 세션에서, Claude Code는 [계획 모드의](#analyze-before-you-edit-with-plan-mode) 차단도 적용하지 않습니다. Claude는 여전히 편집 없이 계획하도록 지시받지만, 계획 중에 시도하는 파일 편집이나 셸 명령은 프롬프트 없이 실행됩니다. 명시적 [요청 규칙](/docs/ko/permissions#manage-permissions)과 [중요 경로](#critical-paths)를 대상으로 하는 `rm` 및 `rmdir` 제거는 계속 프롬프트를 표시합니다.657권한 우회가 가능한 대화형 터미널 세션에서, Claude Code는 [플랜 모드의](#analyze-before-you-edit-with-plan-mode) 차단도 적용하지 않습니다. Claude는 여전히 편집 없이 계획하도록 지시받지만, 계획 중에 시도하는 파일 편집이나 셸 명령은 프롬프트 없이 실행됩니다. 명시적 [요청 규칙](/docs/ko/permissions.md#manage-permissions)과 [중요 경로](#critical-paths)를 대상으로 하는 `rm` 및 `rmdir` 제거는 계속 프롬프트를 표시합니다.

648 658

649계획 모드는 Claude Code가 대화형 터미널 없이 실행되는 모든 곳에서 차단을 유지합니다. 여기에는 `-p`를 사용한 [비대화형 실행](/docs/ko/headless), [Agent SDK](/docs/ko/agent-sdk/permissions#plan-mode-plan) 세션, 그리고 [VS Code 확장](/docs/ko/vs-code)의 채팅 패널의 대화가 포함됩니다. 거기서 `--allow-dangerously-skip-permissions`는 나중에 `bypassPermissions`를 선택 가능하게 합니다.659계획 모드는 Claude Code가 대화형 터미널 없이 실행되는 모든 곳에서 차단을 유지합니다. 여기에는 `-p`를 사용한 [비대화형 실행](/docs/ko/headless.md), [Agent SDK](/docs/ko/agent-sdk/permissions.md#plan-mode-plan) 세션, 그리고 [VS Code 확장](/docs/ko/vs-code.md)의 채팅 패널의 대화가 포함됩니다. 거기서 `--allow-dangerously-skip-permissions`는 나중에 `bypassPermissions`를 선택 가능하게 합니다.

650 660

651> [!WARNING]661> [!WARNING]

652>662>

667* **수락하는 경우**: Claude Code는 `skipDangerousModePermissionPrompt`를 `~/.claude/settings.json`에서 `true`로 설정하므로 이후 세션은 대화상자를 건너뜁니다. 대화상자를 다시 보려면 해당 파일에서 키를 제거하거나 `false`로 설정하십시오. [`skipDangerousModePermissionPrompt` 참조](/docs/ko/settings-reference#skipdangerousmodepermissionprompt)는 사용자 또는 조직이 설정할 수 있는 다른 설정 파일을 나열합니다.677* **수락하는 경우**: Claude Code는 `skipDangerousModePermissionPrompt`를 `~/.claude/settings.json`에서 `true`로 설정하므로 이후 세션은 대화상자를 건너뜁니다. 대화상자를 다시 보려면 해당 파일에서 키를 제거하거나 `false`로 설정하십시오. [`skipDangerousModePermissionPrompt` 참조](/docs/ko/settings-reference#skipdangerousmodepermissionprompt)는 사용자 또는 조직이 설정할 수 있는 다른 설정 파일을 나열합니다.

668* **거부하는 경우**: Claude Code가 종료됩니다.678* **거부하는 경우**: Claude Code가 종료됩니다.

669 679

670[비대화형 모드](/docs/ko/headless)에서는 대화상자가 표시되지 않습니다.680[비대화형 모드](/docs/ko/headless.md)에서는 대화상자가 표시되지 않습니다.

671 681

672[백그라운드 세션](/docs/ko/agent-view)은 수락 기록이 사용자 설정 또는 관리형 설정에 있을 때 이를 적용합니다:682[백그라운드 세션](/docs/ko/agent-view.md)은 수락 기록이 사용자 설정 또는 관리형 설정에 있을 때 이를 적용합니다:

673 683

674* 수락 기록이 없으면 `claude --bg --permission-mode bypassPermissions`가 거부됩니다. 먼저 대화형 세션에서 대화상자를 수락하십시오.684* 수락 기록이 없으면 `claude --bg --permission-mode bypassPermissions`가 거부됩니다. 먼저 대화형 세션에서 대화상자를 수락하십시오.

675* `skipDangerousModePermissionPrompt`가 `.claude/settings.local.json`에만 설정되어 있으면, 백그라운드 세션은 [우회 요청을 무시한 채](#bypass-permissions-ignored-in-a-background-session) 시작됩니다:685* `skipDangerousModePermissionPrompt`가 `.claude/settings.local.json`에만 설정되어 있으면, 백그라운드 세션은 [우회 요청을 무시한 채](#bypass-permissions-ignored-in-a-background-session) 시작됩니다:

685--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons695--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

686```696```

687 697

688확인은 인식된 샌드박스 내에서 자동으로 건너뜁니다. 컨테이너에서 자율적으로 실행하려면, Claude Code를 비루트 사용자로 실행하는 [개발 컨테이너](/docs/ko/devcontainer) 구성을 사용하십시오.698확인은 인식된 샌드박스 내에서 자동으로 건너뜁니다. 컨테이너에서 자율적으로 실행하려면, Claude Code를 비루트 사용자로 실행하는 [개발 컨테이너](/docs/ko/devcontainer.md) 구성을 사용하십시오.

689 699

690[웹의 Claude Code](/docs/ko/claude-code-on-the-web)는 설정 파일의 `defaultMode: "bypassPermissions"` 또는 `"dontAsk"`를 적용하지 않으므로, 저장소의 체크인된 설정은 클라우드 세션을 권한 우회 모드로 시작할 수 없습니다. 설정은 자동으로 무시되고 세션은 모드 드롭다운에 표시된 권한 모드로 시작됩니다. [권한 모드 전환](#switch-permission-modes)에서 클라우드 세션이 제공하는 모드를 참조하십시오.700[웹의 Claude Code](/docs/ko/claude-code-on-the-web.md)는 설정 파일의 `defaultMode: "bypassPermissions"` 또는 `"dontAsk"`를 적용하지 않으므로, 저장소의 체크인된 설정은 클라우드 세션을 권한 우회 모드로 시작할 수 없습니다. 설정은 자동으로 무시되고 세션은 모드 드롭다운에 표시된 권한 모드로 시작됩니다. [권한 모드 전환](#switch-permission-modes)에서 클라우드 세션이 제공하는 모드를 참조하십시오.

691 701

692> [!WARNING]702> [!WARNING]

693>703>

694> `bypassPermissions`는 프롬프트 주입이나 의도하지 않은 작업에 대한 보호를 제공하지 않습니다. 훨씬 적은 권한 프롬프트로 백그라운드 안전 확인을 하려면 [자동 모드](#eliminate-prompts-with-auto-mode)를 대신 사용하십시오. 관리자는 [관리 설정](/docs/ko/managed-settings)에서 `permissions.disableBypassPermissionsMode`를 `"disable"`로 설정하여 이 모드를 차단할 수 있습니다.704> `bypassPermissions`는 프롬프트 주입이나 의도하지 않은 작업에 대한 보호를 제공하지 않습니다. 훨씬 적은 권한 프롬프트로 백그라운드 안전 확인을 하려면 [자동 모드](#eliminate-prompts-with-auto-mode)를 대신 사용하십시오. 관리자는 [관리 설정](/docs/ko/managed-settings.md)에서 `permissions.disableBypassPermissionsMode`를 `"disable"`로 설정하여 이 모드를 차단할 수 있습니다.

695 705

696### 백그라운드 세션에서 무시된 권한 우회706### 백그라운드 세션에서 무시된 권한 우회

697 707

698이 알림은 [백그라운드 세션](/docs/ko/agent-view)이 사용자 설정 또는 관리형 설정에서 [권한 우회 경고](#bypass-permissions-acceptance)에 대한 수락 기록을 찾지 못해, 시작 시 요청된 우회를 무시했음을 의미합니다:708이 알림은 [백그라운드 세션](/docs/ko/agent-view.md)이 사용자 설정 또는 관리형 설정에서 [권한 우회 경고](#bypass-permissions-acceptance)에 대한 수락 기록을 찾지 못해, 시작 시 요청된 우회를 무시했음을 의미합니다:

699 709

700```text theme={null}710```text theme={null}

701Bypass permissions was requested at launch and ignored · if that was you, ~/.claude/settings.json needs "skipDangerousModePermissionPrompt": true711Bypass permissions was requested at launch and ignored · if that was you, ~/.claude/settings.json needs "skipDangerousModePermissionPrompt": true

721 731

722[`--restricted`](/docs/ko/cli-reference#cli-flags)로 시작된 세션에서(Claude Code v2.1.248 이상 필요) 분류기는 보호된 경로 쓰기를 승인할 수 없습니다.732[`--restricted`](/docs/ko/cli-reference#cli-flags)로 시작된 세션에서(Claude Code v2.1.248 이상 필요) 분류기는 보호된 경로 쓰기를 승인할 수 없습니다.

723 733

724보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 [symlink check](/docs/ko/permissions#symlinks)가 보호된 경로로 확인하는 쓰기가 Claude가 요청한 경로 자체가 보호되지 않을 때 대신 프롬프트를 표시합니다.734보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 [symlink check](/docs/ko/permissions.md#symlinks)가 보호된 경로로 확인하는 쓰기가 Claude가 요청한 경로 자체가 보호되지 않을 때 대신 프롬프트를 표시합니다.

725 735

726설정 파일의 [`permissions.allow`](/docs/ko/permissions#manage-permissions) 규칙은 보호된 경로 쓰기를 사전에 승인하지 않습니다. 안전 확인은 Claude Code가 설정에서 allow 규칙을 평가하기 전에 실행되므로, `~/.claude/settings.json` 또는 `.claude/settings.json`의 `Edit(.claude/**)` 같은 항목은 위 표의 모드별 결과를 변경하지 않습니다. 프롬프트를 표시하는 모드에서는 프로젝트의 `.claude/` 폴더 또는 `~/.claude/`에 대한 쓰기 프롬프트가 다음 세션 범위 옵션 중 하나를 제공할 수 있습니다:736설정 파일의 [`permissions.allow`](/docs/ko/permissions#manage-permissions) 규칙은 보호된 경로 쓰기를 사전에 승인하지 않습니다. 안전 확인은 Claude Code가 설정에서 allow 규칙을 평가하기 전에 실행되므로, `~/.claude/settings.json` 또는 `.claude/settings.json`의 `Edit(.claude/**)` 같은 항목은 위 표의 모드별 결과를 변경하지 않습니다. 프롬프트를 표시하는 모드에서는 프로젝트의 `.claude/` 폴더 또는 `~/.claude/`에 대한 쓰기 프롬프트가 다음 세션 범위 옵션 중 하나를 제공할 수 있습니다:

727 737

742* `.claude`. 단, 다음과 같은 몇 가지 예외가 있습니다:752* `.claude`. 단, 다음과 같은 몇 가지 예외가 있습니다:

743 * `.claude/worktrees/` 아래에 있는 Claude 자체 git worktree753 * `.claude/worktrees/` 아래에 있는 Claude 자체 git worktree

744 * `~/.claude/plans/` 또는 직접 설정한 [`plansDirectory`](/docs/ko/settings-reference#plansdirectory)에 있는 현재 세션 자체의 플랜 파일754 * `~/.claude/plans/` 또는 직접 설정한 [`plansDirectory`](/docs/ko/settings-reference#plansdirectory)에 있는 현재 세션 자체의 플랜 파일

745 * `~/.claude/jobs/<id>/tmp/`에 있는 [백그라운드 세션](/docs/ko/agent-view#where-state-is-stored) 자체의 스크래치 디렉토리755 * `~/.claude/jobs/<id>/tmp/`에 있는 [백그라운드 세션](/docs/ko/agent-view.md#where-state-is-stored) 자체의 스크래치 디렉토리

746 * `--restricted` 없이 시작된 세션에서 `~/.claude/projects/<project>/memory/` 같은 프로젝트 [자동 메모리](/docs/ko/memory#storage-location) 디렉토리에 있는 markdown 파일756 * `--restricted` 없이 시작된 세션에서 `~/.claude/projects/<project>/memory/` 같은 프로젝트 [자동 메모리](/docs/ko/memory.md#storage-location) 디렉토리에 있는 markdown 파일

747 * `--restricted` 없이 시작된 세션에서 `.claude/agent-memory/` 같은 [서브에이전트 메모리](/docs/ko/sub-agents#enable-persistent-memory) 디렉토리에 있는 markdown 파일757 * `--restricted` 없이 시작된 세션에서 `.claude/agent-memory/` 같은 [서브에이전트 메모리](/docs/ko/sub-agents.md#enable-persistent-memory) 디렉토리에 있는 markdown 파일

748* [`--plugin-dir`](/docs/ko/plugins/mods/create#change-a-mod-with-claude)로 로드한 디렉토리. Claude Code는 파일이 변경될 때 이 디렉토리에서 mod의 코드를 다시 로드하고 실행하기 때문입니다.758* [`--plugin-dir`](/docs/ko/plugins/mods/create#change-a-mod-with-claude)로 로드한 디렉토리. Claude Code는 파일이 변경될 때 이 디렉토리에서 mod의 코드를 다시 로드하고 실행하기 때문입니다.

749* `~/.claude/dev-mods/` 또는 [`CLAUDE_CONFIG_DIR`](/docs/ko/env-vars)이 가리키는 디렉토리의 `dev-mods/`. Claude가 [사용자를 위해 작성한 mod](/docs/ko/plugins/mods/create#ask-claude-for-a-mod)를 저장하는 위치입니다.759* `~/.claude/dev-mods/` 또는 [`CLAUDE_CONFIG_DIR`](/docs/ko/env-vars)이 가리키는 디렉토리의 `dev-mods/`. Claude가 [사용자를 위해 작성한 mod](/docs/ko/plugins/mods/create.md#ask-claude-for-a-mod)를 저장하는 위치입니다.

750 760

751보호된 파일:761보호된 파일:

752 762

759* `.devcontainer.json`769* `.devcontainer.json`

760* `.ripgreprc`, `pyrightconfig.json`770* `.ripgreprc`, `pyrightconfig.json`

761* `.mcp.json`, `.claude.json`771* `.mcp.json`, `.claude.json`

762* 사용자, 프로젝트 또는 로컬 [설정 파일](/docs/ko/settings#settings-files-and-who-they-affect) 자체가 심볼릭 링크일 때(예: dotfiles 저장소로 연결되는 경우) 해당 설정 파일이 가리키는 파일. 보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 allow 규칙이 일치하더라도 이 파일에 대한 쓰기는 대신 확인을 요청합니다. 파일 자체의 경로가 다른 폴더의 `.claude/settings.json`처럼 설정 파일의 경로이기도 한 경우, 해당 쓰기는 다른 보호된 경로 쓰기와 마찬가지로 분류기로 전달됩니다772* 사용자, 프로젝트 또는 로컬 [설정 파일](/docs/ko/settings.md#settings-files-and-who-they-affect) 자체가 심볼릭 링크일 때(예: dotfiles 저장소로 연결되는 경우) 해당 설정 파일이 가리키는 파일. 보호된 경로 쓰기를 분류기로 라우팅하는 모드에서는 allow 규칙이 일치하더라도 이 파일에 대한 쓰기는 대신 확인을 요청합니다. 파일 자체의 경로가 다른 폴더의 `.claude/settings.json`처럼 설정 파일의 경로이기도 한 경우, 해당 쓰기는 다른 보호된 경로 쓰기와 마찬가지로 분류기로 전달됩니다

763 773

764## Critical paths774## Critical paths

765 775

766Critical paths는 Claude Code가 `rm` 및 `rmdir` 명령으로부터 보호하는 디렉토리입니다. 예를 들어 파일시스템 루트, 홈 디렉토리, 작업 디렉토리 등이 있습니다.776Critical paths는 Claude Code가 `rm` 및 `rmdir` 명령으로부터 보호하는 디렉터리로, 파일시스템 루트, 홈 디렉터리, 작업 디렉터리 등이 있습니다. Claude Code는 이러한 명령이 실행되기 전에 확인하며, 대상을 critical path로 인식한 명령은 어떤 [allow 규칙](/docs/ko/permissions.md#manage-permissions)으로도 승인되지 않습니다. 이 확인은 일부 명령을 놓칠 수 있으므로 [샌드박싱](/docs/ko/sandboxing.md)과 같은 운영 체제 수준의 제어를 대체하지 않습니다.

777

778Critical-path 제거란 Claude Code가 대상을 critical path로 인식하는 `rm` 또는 `rmdir` 명령입니다. `"allow"`를 반환하는 [`PreToolUse` 훅](/docs/ko/permissions#extend-permissions-with-hooks)도 이를 승인하지 않습니다. 다른 프롬프트를 건너뛰는 권한 모드에서도 allow 규칙이나 `PreToolUse` 훅은 이를 승인할 수 없습니다.

779

780> [!WARNING]

781>

782> 확인이 놓친 명령은 특별한 처리를 받지 않으므로, 세션에서 Bash 명령을 승인하는 모든 수단이 프롬프트 없이 이를 승인할 수 있습니다. 여기에는 allow 규칙, `bypassPermissions` 모드, 샌드박스의 [auto-allow mode](/docs/ko/sandboxing.md#auto-allow-mode)가 포함됩니다. 이 확인은 `rm`과 `rmdir`에 적용되므로, 승인된 다른 명령도 critical path를 삭제할 수 있습니다.

783

784다음 제어는 확인이 명령을 인식하는지 여부와 관계없이 적용됩니다:

767 785

768Claude Code는 [`permissions.allow`](/docs/ko/permissions#manage-permissions) 규칙이나 `"allow"`를 반환하는 [`PreToolUse` hook](/docs/ko/permissions#extend-permissions-with-hooks)이 critical path를 대상으로 하는 `rm` 또는 `rmdir` 명령을 승인하도록 허용하지 않습니다. 다른 프롬프트를 건너뛰는 모드에서도 마찬가지입니다. 이 차단기는 모델 오류를 방지합니다. 일치하는 deny 규칙은 여전히 명령을 완전히 차단합니다.786* **Deny 규칙**: 명령과 일치하는 [deny 규칙](/docs/ko/permissions.md#manage-permissions)은 명령을 차단합니다. 단, 설치한 [mod](/docs/ko/plugins/mods/overview.md)는 여전히 [그러한 호출 중 일부](/docs/ko/permissions.md#precedence-among-rules-hooks-and-mods)를 승인할 수 있습니다

787* **샌드박싱**: [샌드박싱](/docs/ko/sandboxing.md)은 운영 체제가 Bash 명령이 쓸 수 있는 경로를 제한하도록 합니다. 샌드박스 처리된 명령도 작업 디렉터리는 삭제할 수 있습니다

788* **Strict sandbox mode**: 기본적으로 샌드박스 처리된 명령은 [샌드박스 외부에서 재시도](/docs/ko/sandboxing.md#the-unsandboxed-retry-escape-hatch)될 수 있으며, allow 규칙이나 `bypassPermissions` 모드가 프롬프트 없이 이 재시도를 승인할 수 있습니다. [Strict sandbox mode](/docs/ko/sandboxing.md#turn-off-the-retry-with-strict-sandbox-mode)는 이 재시도를 끕니다

769 789

770대신 발생하는 일은 [권한 모드에 따라 달라집니다](#critical-path-removals-in-each-permission-mode). `Remove-Item` 및 `cmd` 제거 내장 명령은 자체 확인을 가지고 있으며, [PowerShell의 Remove-Item](#remove-item-in-powershell)에서 다룹니다.790Claude Code가 인식한 제거가 어떻게 처리되는지는 [권한 모드에 따라 달라집니다](#critical-path-removals-in-each-permission-mode). `Remove-Item` 및 `cmd` 제거 내장 명령은 자체 확인을 가지고 있으며, [PowerShell의 Remove-Item](#remove-item-in-powershell)에서 다룹니다.

771 791

772### Which paths are critical792### Which paths are critical

773 793

848 868

849#### Turn off the mounted drive prompt869#### Turn off the mounted drive prompt

850 870

851[다른 원인으로 인한 프롬프트](#removals-that-still-prompt-with-the-mounted-drive-prompt-off)는 유지하면서 마운트된 드라이브 프롬프트만 표시되지 않도록 하려면, 환경에 [`CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT=1`](/docs/ko/env-vars#variables)을 설정한 상태로 Claude Code를 시작합니다. 예를 들어 [셸](/docs/ko/env-vars#set-variables-in-your-shell)에서 변수를 설정하고 그 셸에서 `claude`를 시작합니다:871[다른 원인으로 인한 프롬프트](#removals-that-still-prompt-with-the-mounted-drive-prompt-off)는 유지하면서 마운트된 드라이브 프롬프트만 표시되지 않도록 하려면, 환경에 [`CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT=1`](/docs/ko/env-vars#variables)을 설정한 상태로 Claude Code를 시작합니다. 예를 들어 [셸](/docs/ko/env-vars.md#set-variables-in-your-shell)에서 변수를 설정하고 그 셸에서 `claude`를 시작합니다:

852 872

853```bash theme={null}873```bash theme={null}

854export CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT=1874export CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT=1

866 886

867`rm`에 대한 allow 규칙이 있는 Manual mode에서는 마운트된 드라이브 경로에 대한 `rm`이 `Dangerous rm operation on mounted drive path` 이유 없이 여전히 프롬프트를 표시할 수 있습니다:887`rm`에 대한 allow 규칙이 있는 Manual mode에서는 마운트된 드라이브 경로에 대한 `rm`이 `Dangerous rm operation on mounted drive path` 이유 없이 여전히 프롬프트를 표시할 수 있습니다:

868 888

869* **작업 디렉터리 외부의 대상**: `/Volumes/USB/project`에서 작업하는 동안 `rm -rf /Volumes/USB/other`를 실행하면 프롬프트가 표시됩니다. 이 프롬프트를 없애려면 [대상을 포함하는 디렉터리를 세션에 추가](/docs/ko/permissions#working-directories)합니다889* **작업 디렉터리 외부의 대상**: `/Volumes/USB/project`에서 작업하는 동안 `rm -rf /Volumes/USB/other`를 실행하면 프롬프트가 표시됩니다. 이 프롬프트를 없애려면 [대상을 포함하는 디렉터리를 세션에 추가](/docs/ko/permissions.md#working-directories)합니다

870* **`*`가 포함된 대상**: `rm -rf build/*`는 프롬프트가 표시됩니다. 프롬프트를 승인하여 명령을 실행하거나, Claude에게 `*` 없이 각 대상을 지정하도록 요청합니다890* **`*`가 포함된 대상**: `rm -rf build/*`는 프롬프트가 표시됩니다. 프롬프트를 승인하여 명령을 실행하거나, Claude에게 `*` 없이 각 대상을 지정하도록 요청합니다

871* **critical path인 대상**: `/mnt` 자체와 작업 디렉터리 자체는 여전히 [critical paths](#which-paths-are-critical)이므로, 둘 중 하나에 대한 `rm -rf`는 프롬프트가 표시됩니다. 프롬프트를 승인하여 `rm`을 실행합니다891* **critical path인 대상**: `/mnt` 자체와 작업 디렉터리 자체는 여전히 [critical paths](#which-paths-are-critical)이므로, 둘 중 하나에 대한 `rm -rf`는 프롬프트가 표시됩니다. 프롬프트를 승인하여 `rm`을 실행합니다

872 892

884 904

885명시적 [ask 규칙](/docs/ko/permissions#manage-permissions)이 명령과 일치하면 Claude Code는 `auto` mode에서도 승인을 요청합니다. 시간 제한 없이 요청합니다. 승인을 요청하는 모드에서 [`PermissionRequest` hook](/docs/ko/hooks#permissionrequest)은 프롬프트에 답할 수 있습니다.905명시적 [ask 규칙](/docs/ko/permissions.md#manage-permissions)이 명령과 일치하면 Claude Code는 `auto` mode에서도 승인을 요청합니다. 시간 제한 없이 요청합니다. 승인을 요청하는 모드에서 [`PermissionRequest` hook](/docs/ko/hooks#permissionrequest)은 프롬프트에 답할 수 있습니다.

886 906

887### Time limits and denials in auto and bypassPermissions modes907### Time limits and denials in auto and bypassPermissions modes

888 908

892* 프롬프트가 열려 있는 동안 아무 키나 누르면 카운트다운이 중지되고 프롬프트는 답변을 기다립니다.912* 프롬프트가 열려 있는 동안 아무 키나 누르면 카운트다운이 중지되고 프롬프트는 답변을 기다립니다.

893* 세션에서 이러한 프롬프트 3개가 답변 없이 끝나면 Claude Code는 더 이상 표시하지 않고 critical-path 제거를 즉시 거부합니다. 새 메시지를 보내면 카운트가 다시 시작됩니다.913* 세션에서 이러한 프롬프트 3개가 답변 없이 끝나면 Claude Code는 더 이상 표시하지 않고 critical-path 제거를 즉시 거부합니다. 새 메시지를 보내면 카운트가 다시 시작됩니다.

894 914

895`auto` mode에서 Claude Code가 터미널 프롬프트를 표시할 수 없는 곳에서는 명령을 즉시 거부합니다. 예를 들어 `-p`를 사용한 [non-interactive 실행](/docs/ko/headless), [Agent SDK](/docs/ko/agent-sdk/permissions) 세션, VS Code 확장의 채팅 패널 및 Desktop 앱에서입니다. 거부는 Claude에게 삭제하려던 항목을 보고하고 제거를 사용자에게 맡기도록 알려줍니다.915`auto` mode에서 Claude Code가 터미널 프롬프트를 표시할 수 없는 곳에서는 명령을 즉시 거부합니다. 예를 들어 `-p`를 사용한 [non-interactive 실행](/docs/ko/headless.md), [Agent SDK](/docs/ko/agent-sdk/permissions.md) 세션, VS Code 확장의 채팅 패널 및 Desktop 앱에서입니다. 거부는 Claude에게 삭제하려던 항목을 보고하고 제거를 사용자에게 맡기도록 알려줍니다.

896 916

897`auto` 및 `bypassPermissions` 처리에는 Claude Code v2.1.281 이상이 필요합니다. 이를 끄려면 Claude Code를 시작하는 환경에서 [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1`](/docs/ko/env-vars#variables)을 설정합니다. `auto` mode에서 critical-path 제거는 대신 분류기로 이동하고, `bypassPermissions` mode에서 프롬프트는 시간 제한이 없습니다.917`auto` 및 `bypassPermissions` 처리에는 Claude Code v2.1.281 이상이 필요합니다. 이를 끄려면 Claude Code를 시작하는 환경에서 [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1`](/docs/ko/env-vars#variables)을 설정합니다. `auto` mode에서 critical-path 제거는 대신 분류기로 이동하고, `bypassPermissions` mode에서 프롬프트는 시간 제한이 없습니다.

898 918

899### Remove-Item in PowerShell919### Remove-Item in PowerShell

900 920

901[PowerShell tool](/docs/ko/tools-reference#powershell-tool)을 활성화하면 Claude Code는 `Remove-Item`과 `cmd` 내장 명령 `rd`, `rmdir`, `del`, `erase`에 `rm` critical-path 목록과 별개의 자체 확인을 제공합니다. `Remove-Item`의 경우 결과는 대상에 따라 달라지며 첫 번째 일치하는 경우가 적용됩니다:921[PowerShell tool](/docs/ko/tools-reference.md#powershell-tool)을 활성화하면 Claude Code는 `Remove-Item`과 `cmd` 내장 명령 `rd`, `rmdir`, `del`, `erase`에 `rm` critical-path 목록과 별개의 자체 확인을 제공합니다. `Remove-Item`의 경우 결과는 대상에 따라 달라지며 첫 번째 일치하는 경우가 적용됩니다:

902 922

903* **System paths**: 파일시스템 루트 및 최상위 디렉토리, 드라이브 루트 및 최상위 디렉토리, 홈 디렉토리. Claude Code는 모든 모드에서 묻지 않고 명령을 거부합니다.923* **System paths**: 파일시스템 루트 및 최상위 디렉토리, 드라이브 루트 및 최상위 디렉토리, 홈 디렉토리. Claude Code는 모든 모드에서 묻지 않고 명령을 거부합니다.

904* **Wildcards**: bare `*`, 또는 `/*` 또는 `\*`로 끝나는 모든 대상(예: `$dir/*`과 같은 셸 변수 아래의 glob). Claude Code는 [분류기](#eliminate-prompts-with-auto-mode)가 보기 전에 모든 모드에서 묻지 않고 명령을 거부합니다.924* **Wildcards**: bare `*`, 또는 `/*` 또는 `\*`로 끝나는 모든 대상(예: `$dir/*`과 같은 셸 변수 아래의 glob). Claude Code는 [분류기](#eliminate-prompts-with-auto-mode)가 보기 전에 모든 모드에서 묻지 않고 명령을 거부합니다.

912 932

913## 참고 항목933## 참고 항목

914 934

915* [권한](/docs/ko/permissions): allow, ask, deny 규칙; 관리형 정책935* [권한](/docs/ko/permissions.md): allow, ask, deny 규칙; 관리형 정책

916* [auto mode 구성](/docs/ko/auto-mode-config): 분류기에 조직이 신뢰하는 인프라를 알립니다.936* [auto mode 구성](/docs/ko/auto-mode-config.md): 분류기에 조직이 신뢰하는 인프라를 알립니다.

917* [Hooks](/docs/ko/hooks): `PreToolUse` 및 `PermissionRequest` hooks를 통한 사용자 정의 권한 로직937* [Hooks](/docs/ko/hooks.md): `PreToolUse` 및 `PermissionRequest` hooks를 통한 사용자 정의 권한 로직

918* [보안](/docs/ko/security): safeguards 및 모범 사례938* [보안](/docs/ko/security.md): safeguards 및 모범 사례

919* [Sandboxing](/docs/ko/sandboxing): Bash 명령어에 대한 파일시스템 및 네트워크 격리939* [Sandboxing](/docs/ko/sandboxing.md): Bash 명령어에 대한 파일시스템 및 네트워크 격리

920* [비대화형 모드](/docs/ko/headless): `-p` 플래그를 사용하여 Claude Code 실행940* [비대화형 모드](/docs/ko/headless.md): `-p` 플래그를 사용하여 Claude Code 실행

permission-modes.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

권한 모드 선택

사용 가능한 모드

어떤 모드도 자동 승인하지 않는 작업

일반적인 설정

세션이 시작되는 모드

claude -p 및 Agent SDK 실행에서 거부되는 도구 호출

다른 권한 모드에서 시작

HIPAA 구성에서의 권한 모드

권한 모드 전환

acceptEdits 모드로 파일 편집 자동 승인

편집하기 전에 계획 모드로 분석하기

계획 검토 및 승인

계획 모드를 기본값으로 설정

자동 모드로 권한 프롬프트 제거

Bedrock, Agent Platform 또는 Foundry의 자동 모드

서버 측 분류기 검토

기본 분류기 모델

분류기 모델 선택

지정한 모델이 검토하지 않는 경우

분류기가 사용한 모델 확인

분류기가 기본적으로 차단하는 것

작업 디렉터리 외부의 첫 번째 읽기

대화에서 명시한 경계

대화에서 명시한 승인

자동 모드가 폴백할 때

반복된 블록 임계값

자동 모드가 작업을 평가하는 방법

dontAsk 모드로 사전 승인된 도구만 허용

bypassPermissions 모드로 모든 확인 건너뛰기

백그라운드 세션에서 무시된 권한 우회

claude agents가 대화형 세션에서는 건너뛰는 권한 우회 경고를 표시하는 경우

보호된 경로

Critical paths

Which paths are critical

Other targets that count as critical paths

Removals inside nested commands and inline scripts

Rewrite a flagged command

The mounted drive prompt

Paths that get the mounted drive prompt

Turn off the mounted drive prompt

Removals that still prompt with the mounted drive prompt off

Critical-path removals in each permission mode

Time limits and denials in auto and bypassPermissions modes

Remove-Item in PowerShell

참고 항목

`claude -p` 및 Agent SDK 실행에서 거부되는 도구 호출

`claude agents`가 대화형 세션에서는 건너뛰는 권한 우회 경고를 표시하는 경우