Claude Code 권한 모드 이해 | AI 교육

Claude Code 권한 모드 이해 | AI 교육 · 클로드 5회

9월 25, 2026

Claude Code 권한 모드 정리. Manual·accept edits·plan·auto 차이, Shift+Tab 전환, 허락 창 답하기, 시작 모드(v2.1.283부터 모든 요금제 auto, 관리자가 끄면 Manual).

오늘 배울 것: 허락 창에 답하는 법, Shift + Tab으로 권한 모드를 바꾸는 법, 내 Claude Code가 어느 모드로 시작하는지 안다.

왜 필요한가

상담 기록 폴더에서 Claude Code를 켰다고 해 보자. "파일 이름을 날짜순으로 바꿔 줘"라고 했는데 묻지도 않고 수십 개를 한꺼번에 바꿔 버리면 곤란하다. 반대로 주보 초안 폴더에서 글자 하나 고칠 때마다 허락을 구하면 번거롭다. 권한 모드는 "Claude가 나에게 묻지 않고 해도 되는 일"의 범위를 정하는 스위치다. 폴더의 무게에 맞춰 고르면 된다.

모드 네 가지

상태 표시줄에 지금 모드가 이렇게 보인다.

Manual (⏸ manual mode on): 파일 읽기만 알아서 하고, 고치거나 명령을 실행하기 전에는 매번 묻는다.
accept edits (⏵⏵ accept edits on): 작업 폴더 안 파일 고치기와 폴더 만들기·옮기기 같은 흔한 파일 명령은 묻지 않는다. 그 밖의 명령은 묻는다.
plan (⏸ plan mode on): 살펴보고 계획만 세운다. 내가 계획을 승인하기 전에는 파일을 고치지 않는다.
auto (⏵⏵ auto mode on): 별도의 검토 모델이 나 대신 하나하나 살피고, 대부분은 묻지 않고 진행한다. 공식 문서도 auto 모드가 안전을 보장하지는 않는다고 적어 둔다.

어느 모드로 시작하나

기본: v2.1.283 이후 버전은 요금제와 상관없이 터미널에서 켜면 auto 모드로 시작한다. 그 전 버전에서는 Pro·Max·Team만 auto로 시작하고 나머지는 Manual로 시작했다.
예외: 관리자가 auto 모드를 꺼 뒀거나, auto를 지원하지 않는 모델을 쓰면 Manual로 시작한다. auto 모드는 모든 요금제에서 쓸 수 있지만, Team과 Enterprise는 관리자가 조직 차원에서 꺼 둘 수 있다. Enterprise와 API 계정은 auto 모드의 검토 호출도 사용량에 잡힌다.

내 모드가 헷갈리면 상태 표시줄을 보면 된다.

따라 하기

연습 폴더에서 claude를 켜고 상태 표시줄의 모드를 확인한다.
Shift + Tab을 누를 때마다 모드가 바뀐다. auto에서 한 번 누르면 Manual, 그다음은 accept edits, plan, 다시 auto 순서다. Manual에 맞춘다.
파일을 고치는 일을 시켜 본다.

광고.txt의 날짜를 다음 주 날짜로 고쳐 줘

허락 창이 뜬다. 방향키로 고르고 Enter를 누른다. Yes는 이번 한 번 허락, No는 거절이다. 계속 허락하는 선택지도 있는데, 파일 고치기는 이번 세션이 끝날 때까지만 유효하다. Esc를 누르면 No와 같다.
이번엔 plan 모드로 바꾸고 같은 일을 시킨다. 계획만 보여 주고 승인을 기다린다. No, keep planning을 고르면 계획을 더 다듬는다.
처음부터 Manual로 켜고 싶은 날은 이렇게 켠다.

claude --permission-mode default

자주 막히는 곳

묻지도 않고 고쳤다. auto나 accept edits 모드였을 가능성이 크다. 교인 정보가 담긴 폴더에서는 먼저 Shift + Tab으로 Manual에 놓고 시작하자.
auto가 목록에 안 나온다. 조직 관리자가 껐거나, 지원하지 않는 모델을 쓰거나, Anthropic이 잠시 꺼 둔 경우다.
"don't ask again"을 눌렀던 명령이 계속 그냥 실행된다. 명령 허락은 저장돼 다음 세션에도 남는다. /permissions에서 목록을 보고 지울 수 있다.