Claude Code 권한 모드 정리 (default, acceptEdits, plan, bypassPermissions)

016가지 모드 한눈에 보기

default는 설정, hook, --permission-mode 플래그에서 쓰는 이름이에요. CLI, IDE 확장, 데스크톱 앱에서는 Manual로 표시되고, CLI에서는 manual을 별칭으로 쓸 수 있어요.

02모드 전환 방법

terminal에서 Shift+Tab을 누르세요. default, acceptEdits, plan 순으로 바뀌고, 그다음 세션에서 허용된 선택 모드가 이어져요. dontAsk는 이 순환에 나오지 않고 플래그로만 설정할 수 있어요.

특정 모드로 세션을 시작하려면:

claude --permission-mode plan

특정 모드를 기본값으로 쓰려면 ~/.claude/settings.json에 설정하세요:

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

플래그가 설정보다 우선하고, 설정은 내장 기본값보다 우선해요. 알아 둘 제한이 하나 있어요. auto와 bypassPermissions는 프로젝트의 .claude/settings.json이나 .claude/settings.local.json에 넣으면 적용되지 않아요. 저장소가 몰래 bypass 모드로 바꿀 수 없게 하기 위해서예요. 이 두 모드는 사용자 설정에 넣거나 플래그로 지정하세요.

새 세션의 시작 모드

최신 Claude Code(v2.1.283 이상)는 auto 모드를 쓸 수 있으면, 설정에서 따로 지정하지 않는 한 대화형 terminal 및 VS Code 세션을 auto로 시작해요. claude -p와 Agent SDK 실행은 default로 시작해요. 모드를 고른 적이 없는데 prompt가 별로 안 뜬다면 이 때문이에요.

03모드별 상세 설명

default (Manual)

Claude는 묻지 않고 파일을 읽을 수 있어요. 편집, 셸 명령, 네트워크 접근은 각각 prompt가 떠요. Bash prompt에서 "Yes, and don't ask again"을 고르면 허용 규칙이 .claude/settings.local.json에 저장돼서, 이 저장소에서는 해당 명령을 다시 묻지 않아요. 파일 편집 승인은 세션이 끝날 때까지 유지돼요.

acceptEdits

작업 디렉터리 안의 편집과 간단한 파일 명령(mkdir, touch, rm, rmdir, mv, cp, sed)은 prompt 없이 실행돼요. 다른 셸 명령은 여전히 물어봐요. diff를 실시간으로 지켜볼 때 적당한 절충안이에요.

plan

Claude가 읽기와 읽기 전용 명령으로 코드를 살펴본 뒤 계획을 제시해요. 승인하기 전까지 소스는 전혀 수정되지 않아요. 낯선 코드나 위험한 변경에 쓰세요.

auto

별도의 모델이 각 작업을 실행 전에 검토해서, 요청 범위를 벗어나거나 모르는 인프라를 대상으로 하거나 악의적인 콘텐츠에 휘둘린 것처럼 보이는 작업을 차단해요. 명시적인 ask 규칙은 그대로 prompt를 띄워요. classifier가 연속 3번 또는 한 세션에서 20번 차단하면 auto 모드가 일시 중지되고 일반 prompt 방식으로 돌아가요. Anthropic은 auto 모드가 "권한 prompt를 줄여 주지만 안전을 보장하지는 않는다"고 설명해요.

dontAsk

prompt가 필요한 작업은 모두 거부돼요. 허용 규칙에 해당하거나 승인이 필요 없는 작업만 실행돼요. 응답할 사람이 없는 스크립트와 CI용이에요.

bypassPermissions와 --dangerously-skip-permissions

--dangerously-skip-permissions는 --permission-mode bypassPermissions와 같아요. .git, .claude 같은 보호 경로에 쓰는 작업까지 포함해 prompt를 건너뛰어요. 단, 명시적인 ask 규칙, AskUserQuestion, 일부 위험한 rm 명령 등 몇 가지는 어떤 모드에서든 prompt가 뜨거나 거부돼요. 거부 규칙도 여전히 차단해요.

Anthropic은 인터넷 접근이 없는 컨테이너, VM, dev container에서만 쓰라고 안내해요. Mac과 Linux에서는 인식된 샌드박스 밖에서 root나 sudo로 실행하면 Claude Code가 이 모드로 시작하지 않아요. bypass를 켜지 않고 쓸 수 있게만 하려면 --allow-dangerously-skip-permissions를 쓰세요. 전환하지 않고 Shift+Tab 순환에만 추가해 줘요.

04규칙은 모드 위에 적용돼요

모드가 기본 동작을 정하고, 설정의 권한 규칙이 이를 세밀하게 조정해요:

{
  "permissions": {
    "allow": ["Bash(npm run test *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"]
  }
}

규칙은 거부, 확인(ask), 허용 순으로 검사하고 처음 일치하는 규칙이 결과를 정해요. 거부 규칙은 bypassPermissions를 포함한 모든 모드에서 차단해요. 허용 규칙은 bypassPermissions에서는 효과가 없어요. 이미 모든 게 허용돼 있으니까요. /permissions를 실행하면 모든 규칙과 각 규칙이 정의된 파일을 볼 수 있어요.

hook도 관여할 수 있어요. PreToolUse hook은 어떤 모드에서든 도구 호출을 차단할 수 있어요. PermissionRequest hook은 prompt에 대신 응답할 수 있지만 거부 규칙을 무시할 수는 없어요. 방법은 PermissionRequest 가이드를 참고하세요.

05자리를 비울 때 모드 고르기

사람들이 --dangerously-skip-permissions를 찾는 이유는 대개 Claude를 돌려 놓고 자리를 비웠다가, 돌아와 보니 세션이 prompt에 멈춰 있는 상황을 피하고 싶어서예요. 실제로 불편한 문제이긴 하지만, bypass 모드는 내 컴퓨터에서 내가 확인하는 과정 자체를 없애는 방식으로 이 문제를 해결해요.

더 안전한 조합은 다음과 같아요.

• 지루한 명령은 allow 규칙으로. 테스트, lint, 빌드 명령은 allow에 추가하고, git push와 배포는 ask로 두고, 모드는 default나 acceptEdits를 유지하세요.
• auto 모드: 일상적인 작업은 classifier의 판단에 맡겨도 괜찮은 긴 작업에 적합해요.
• prompt를 내가 있는 곳으로 가져오기. 확인을 요청하는 모드를 유지하고, 중요한 몇 개의 prompt만 휴대폰에서 응답하세요.

마지막 방법이 바로 Claude Code Notifier가 하는 일이에요. Anthropic이 만든 도구가 아닌 독립 도구예요. 명령줄 도구인 ccn이 Mac, Windows, Linux에서 Claude Code hook으로 실행돼요. 자리를 비운 사이 Claude Code가 권한을 요청하려 하면, 그 요청이 페어링된 iPhone이나 Android 휴대폰으로 전송되고, 거기서 한 번 허용, 세션 동안 허용, 거부 중에 고를 수 있어요. Claude Code가 어차피 보여 줄 prompt만 받기 때문에, 무엇을 물어볼지는 여전히 모드와 규칙이 결정해요. auto 모드에서는 요청이 줄어들고, bypassPermissions에서는 아예 오지 않아요. 다만 "Claude 작업 완료" 알림과 질문은 계속 와요. 설정 방법은 휴대폰 승인 가이드에, 위험 요소는 휴대폰으로 승인해도 안전할까요?에 정리돼 있어요.

06FAQ