Permission mode

실무에서 뜻하는 것

2026-10 기준 권한 모드는 여섯 가지입니다. default(Manual)는 읽기만 묻지 않고 실행합니다. acceptEdits는 파일 편집까지 묻지 않습니다. plan은 계획을 승인할 때까지 편집을 막습니다. auto에서는 별도 분류기 모델이 사용자 대신 각 작업을 검토합니다. dontAsk는 미리 허용한 도구만 실행합니다. bypassPermissions는 모든 확인을 건너뛰므로 격리된 컨테이너에서만 씁니다. 세션 중에는 Shift+Tab으로 모드를 바꿉니다.

리텐션에서 쓴 예

AI 에이전트에게 사업을 맡기는 대표가 놓치는 “Human In The Lead” 글에서 Claude Code의 권한 시스템은 한 세션 동안 여러 작업을 막았습니다. 프로덕션 브랜치 머지, 설정 자기수정, 외부 저장소 포스팅, LaunchAgent 설치가 차단 대상이었습니다. 막을 때마다 무엇이 위험한지 사유를 밝혔습니다. 글은 이 설명을 회사의 보안 전략으로 쓰라고 권했습니다.

헷갈리기 쉬운 것

권한 모드는 기준선입니다. 특정 도구를 허용하거나 막는 권한 규칙은 그 위에 따로 쌓습니다. 거부(deny) 규칙은 bypassPermissions에서도 적용됩니다. 판단과 상관없이 반드시 막아야 하는 동작은 훅로 한 번 더 막을 수 있습니다.