Claude Code 권한 모드

한 줄 요약: Claude Code 공식 문서 "Choose a permission mode". 세션에서 Claude가 묻지 않고 할 수 있는 일을 정하는 여섯 가지 권한 모드(Manual=default, acceptEdits, plan, auto, dontAsk, bypassPermissions)와, 세션이 어떤 모드로 시작하는지, 인터페이스별 전환 방법, 자동 모드 분류기(classifier)가 기본으로 막고 허용하는 것, 어떤 모드도 자동 승인하지 않는 동작, 보호 경로(protected paths)와 치명 경로(critical paths)를 다룬다.

원본 정보#

• 제목: Choose a permission mode
• 발행: Anthropic, Claude Code 공식 문서 (원본 날짜 미상)
• URL: https://code.claude.com/docs/en/permission-modes (새 창)
• 수집(fetch)일: 2026-10-18. 본문의 버전 조건(v2.1.2xx), 설정 키, 숫자, 지원 모델 목록은 이 날짜 기준이다.

핵심 주장#

1. 모드는 기준선이고, 권한 규칙이 그 위에 얹힌다. 모드마다 묻지 않고 도는 범위가 다르다: Manual은 읽기만, acceptEdits는 읽기·파일 편집·흔한 파일 시스템 명령, plan은 읽기(자동 모드를 쓸 수 있으면 분류기가 승인한 명령까지), auto는 백그라운드 안전 검사를 거쳐 모든 것, dontAsk는 미리 허용한 도구만(물어야 할 것은 거부), bypassPermissions는 모든 것. deny 규칙은 bypassPermissions를 포함해 모든 모드에서 막고, allow 규칙은 bypassPermissions에서 효과가 없다. → 권한 모드, Claude Code 권한 모드 고르기
2. 어떤 모드도 자동 승인하지 않는 동작이 있다. 명시적 ask 규칙에 걸린 도구, 조직이 ask로 정한 커넥터 도구(그 설정이 Claude Code에 닿는 세션에서), 사용자 상호작용이 필요한 도구(AskUserQuestion, requiresUserInteraction MCP 도구), 치명 경로를 겨냥한 rm·rmdir, 세션 간 메시지 안전장치, blockReadsOutsideWorkingDirectories가 켜진 상태의 작업 디렉터리 밖 읽기다. → 권한 모드
3. 자동 모드는 사람 대신 두 번째 모델(분류기)이 검토한다. 요청 범위를 넘어서는 일, 모르는 인프라를 겨냥한 일, Claude가 읽은 적대적 콘텐츠에 이끌린 것으로 보이는 일을 막는다. v2.1.283 이상에서 대화형 터미널·VS Code 세션의 기본 시작 모드다. 다만 원본은 "권한 확인 창을 줄일 뿐 안전을 보장하지 않는다"고 경고하고, 민감한 작업의 검토를 대신하는 용도가 아니라고 한다. → 권한 모드, Claude Code 권한 모드 고르기
4. 관리자는 managed settings로 모드를 통제한다. permissions.disableAutoMode: "disable"로 자동 모드를 없애고, permissions.disableBypassPermissionsMode: "disable"로 bypassPermissions를 막고, permissions.defaultMode로 조직의 시작 모드를 정한다. 일상 동작이 막히면 autoMode.environment에 신뢰하는 저장소·버킷·서비스를 등록한다. → Claude Code 관리자 권한 통제 (참고, 2026-10-21: 이 문서의 permissions.disableAutoMode 표기와 배포 문서의 "top-level key" 표기의 차이는 settings reference 수집으로 해소됐다. 기본 형태는 최상위 "disableAutoMode": "disable"이고 permissions.disableAutoMode도 받는다. Claude Code 설정 키 전체 레퍼런스)
5. 대화로 말한 경계는 규칙이 아니다. "push하지 마"라고 하면 분류기가 막지만, 분류기는 경계를 매번 대화 기록에서 다시 읽으므로 컴팩션이 그 메시지를 지우면 사라질 수 있다. 확실히 보장하려면 deny 규칙을 쓴다. → 장기 작업 컨텍스트 관리, 권한 모드

원본의 숫자·설정값 (2026-10-18 기준)#

• 자동 모드 반복 차단 기준: 연속 3회 또는 세션 합계 20회 차단이면 자동 모드가 멈추고 다시 묻기 시작한다. 이 기준은 바꿀 수 없다.
• 서버 측 검토에서 판정 없는 응답이 연속 10회면 턴을 멈춘다.
• 치명 경로 삭제 확인 창(자동·bypassPermissions 모드, 터미널): 2분 카운트다운. 세션에서 답 없이 3번 시간이 지나면 이후 치명 경로 삭제는 바로 거부한다.
• 분류기 모델: 기본 Claude Sonnet 5(사용자의 /model 선택과 별개). 세션 모델이 Sonnet 4.6이거나 availableModels가 Sonnet 5를 빼면 세션 모델을, Fable 모델 세션이면 Opus 모델을 쓴다.
• 자동 모드 지원 모델(Anthropic API·Claude Platform on AWS): Opus 4.6 이상, Sonnet 4.6 이상, Haiku 5.5, Fable 모델. Bedrock·Google Cloud Agent Platform·Microsoft Foundry·Claude apps gateway: Sonnet 5 이상, Opus 4.7 이상, Haiku 5.5, Fable 모델. Sonnet 4.5, Opus 4.5, Haiku 4.5, claude-3 모델은 어디서도 지원하지 않는다.
• 버전 조건(일부): 자동 모드 기본 시작(모든 플랜) v2.1.283, 기본 auto 시작 최소 v2.1.228(macOS·Linux·WSL)·v2.1.233(Windows), HIPAA 구성 v2.1.285, blockReadsOutsideWorkingDirectories v2.1.257, --restricted v2.1.248, 치명 경로 카운트다운 v2.1.281, 실행 중 세션에 disableAutoMode 즉시 적용 v2.1.251, Bash 확인 창의 "Yes, and switch to auto mode" v2.1.247.