클로드 코드 권한 모드와 허용 규칙 설정하기

Claude Code는 명령을 실행하거나 파일을 고치기 전에 승인 창을 띄워 사용자에게 허락을 묻습니다. 같은 명령마다 승인 창을 누르다 보면 자주 쓰는 명령은 묻지 않고 실행하게 하고, 파일 지우기 같은 명령은 아예 막고 싶어집니다. 이 글은 같은 요청이 권한 규칙에 따라 그냥 실행되거나, 실행 전에 묻거나, 막히는 모습을 실제 화면으로 나란히 놓고 설명합니다.

클로드 코드의 권한 규칙은 특정 명령과 파일을 묻지 않고 실행할지(allow), 실행 전에 물어볼지(ask), 막을지(deny) 정해 두는 설정으로, settings.json 파일의 permissions 항목에 적습니다. 이 글은 2026년 10월 25일 기준 Claude Code 공식 문서(Configure permissions, Settings, Permission modes)와 이날 macOS 터미널의 Claude Code v2.1.310에서 본 화면을 근거로 씁니다.

클로드 코드 권한 규칙이란: 출입 규정표와 settings.json

담당자는 새 직원이 드나들 방을 출입 규정표에 정해 둡니다. 문 앞의 출입 관리자는 그 규정표를 보고 문을 바로 열어 주거나, 담당자에게 인터폰으로 묻거나, 열어 주지 않습니다. Claude Code에서는 Claude가 새 직원이고, Claude가 실행하려는 명령과 열려는 파일이 방이며, settings.json 파일의 permissions 항목이 출입 규정표입니다. 규정표를 확인하는 출입 관리자는 Claude Code 프로그램이고, 규정표를 써 두고 인터폰을 받는 담당자는 사용자입니다.

공식 문서는 권한 규칙을 AI 모델이 아니라 Claude Code 프로그램이 지키게 한다고 적습니다. 요청이나 CLAUDE.md에 적은 "지우지 마"는 Claude가 하려는 일에 영향을 줄 뿐 Claude Code가 허용하는 범위를 바꾸지 않습니다. 반드시 막아야 하는 명령은 deny 규칙으로 막습니다.

권한 모드와 권한 규칙의 차이

권한 모드는 Claude Code가 대체로 얼마나 자주 묻는지 정하는 설정이고, 권한 규칙은 특정 명령이나 파일을 항상 어떻게 처리할지 정하는 목록입니다. 규칙에 맞는 명령은 규칙대로 처리되고, 어느 규칙에도 맞지 않는 명령은 지금 권한 모드가 처리합니다.

권한 모드 여섯 가지(Manual, acceptEdits, plan, auto, dontAsk, bypassPermissions)와 Shift+Tab으로 모드를 바꾸는 순서, 상태 표시줄 문구는 입문 수업 클로드 코드란과 플랜 모드 활용하기에서 다뤘습니다. 이 글의 화면은 매번 묻는 Manual 모드(상태 표시줄 ⏸ manual mode on)를 기준으로 합니다. Claude Code v2.1.283 이상의 대화형 터미널은 auto 모드로 시작하므로, 같은 화면을 보려면 claude --permission-mode default로 시작합니다.

모드와 규칙이 만나는 곳에서 알아 둘 점은 두 가지입니다. 공식 문서에 따르면 deny 규칙은 모든 권한을 허용하는 bypassPermissions 모드에서도 막고, ask 규칙에 맞는 명령은 어떤 모드에서도 자동으로 승인되지 않습니다.

settings.json에 allow, ask, deny 규칙 쓰는 법

규칙은 설정 파일의 permissions 안에 세 목록으로 적습니다. 형식은 도구 또는 도구(조건)입니다.

Bash는 터미널 명령을 실행하는 도구이고 Read는 파일을 읽는 도구입니다. 위 예시는 zip 명령은 묻지 않고, 파일을 옮기는 mv 명령은 묻고, 파일을 지우는 rm 명령과 비밀 폴더 읽기는 막습니다.

별표(*)는 별표 위치에 들어가는 어떤 글자와도 맞습니다. 공식 문서는 별표를 명령 이름과 하위 명령 뒤에 공백과 함께 두라고 안내합니다. Bash(git log *)는 git log 명령만 잡지만 Bash(git *)는 모든 git 명령을 잡습니다.

파일 경로 규칙에서 알아 둘 점은 다음과 같습니다.

• 경로 앞 기호: //경로는 파일 시스템 맨 위부터 쓴 절대 경로, ~/경로는 홈 폴더 기준, /경로는 그 설정 파일 기준(프로젝트 설정이면 작업 폴더), 경로나 ./경로는 현재 폴더 기준입니다. /Users/나/파일처럼 빗금 하나로 시작하면 절대 경로가 아니므로, 절대 경로는 //Users/나/파일로 씁니다.
• 파일 쓰기 규칙은 Edit로: 파일을 고치거나 만드는 일을 막는 경로 규칙은 Edit(보고서/**)처럼 씁니다. Write(보고서/**)처럼 경로를 넣은 Write 규칙은 설정에 받아들여지지만 어떤 파일에도 맞지 않습니다.
• Read deny는 편집도 막음: Read deny 규칙은 같은 경로의 파일 고치기와 새로 만들기도 막습니다.
• .claudeignore는 효과가 없음: 읽히면 안 되는 파일은 Read deny 규칙으로 옮깁니다.

도구 이름만 쓴 deny 규칙("deny": ["Bash"])은 그 도구를 Claude가 보는 도구 목록에서 아예 뺍니다. Bash(rm *)처럼 조건을 붙인 규칙은 도구를 남겨 두고 맞는 호출만 막습니다.

규칙 우선순위: deny, ask, allow 순서로 대조합니다

Claude Code는 실행하려는 명령을 deny, ask, allow 순서로 대조하고 처음 맞는 규칙이 결과를 정합니다. 규칙이 얼마나 구체적인지는 이 순서를 바꾸지 않습니다. 그래서 넓은 deny 규칙 Bash(rm *) 아래에서는 좁은 allow 규칙 Bash(rm 임시.txt)가 있어도 rm 임시.txt가 막힙니다. ask와 allow 사이도 같아서, ask 규칙에 맞는 명령은 더 좁은 allow 규칙이 있어도 승인 창이 뜹니다.

&&나 ;로 이어 붙인 명령은 부분마다 따로 대조합니다. allow 규칙 Bash(zip *)가 있어도 zip -r 보고서.zip 보고서 && rm 임시.txt는 뒤의 rm 부분이 allow 규칙에 없으므로 바로 실행되지 않고 승인 창이 뜹니다(Manual 모드 기준). deny와 ask 규칙은 어느 한 부분에만 맞아도 적용됩니다.

공식 문서가 스스로 밝히는 한계도 있습니다. Bash 규칙은 Claude가 쓴 명령 글자를 대조하므로 같은 프로그램을 다른 형태로 부르면 맞지 않습니다. Bash(rm *)는 rm -rf build/를 막지만 /bin/rm -rf build/나 bash -c 'rm -rf build/'는 막지 못합니다. Read deny 규칙도 파이썬이나 Node 스크립트가 직접 여는 파일까지 막지는 못합니다. 모든 프로그램의 파일 접근을 막아야 한다면 운영체제 수준에서 파일과 네트워크 접근을 제한하는 샌드박스를 켭니다.

설정 파일 세 곳과 적용 범위

같은 규칙도 어느 파일에 적느냐에 따라 적용되는 사람과 폴더가 다릅니다. ~는 홈 폴더, .claude는 작업 폴더 안의 .claude 폴더입니다.

설치만으로는 설정 파일이 생기지 않습니다. .claude/settings.local.json은 승인 창에서 "다시 묻지 않기"를 처음 고를 때 Claude Code가 만들고, 이때 Git에 올리지 않을 파일 목록에 이 파일을 넣습니다. 손으로 만들었다면 .gitignore에 직접 넣습니다.

같은 설정 값이 여러 파일에 있으면 관리 정책, 명령줄 인자, 프로젝트 로컬, 공유 프로젝트, 사용자 순서로 위에 있는 값이 이깁니다. 그런데 permissions.allow 같은 목록은 이기고 지는 대신 여러 파일의 목록을 합칩니다. 합친 목록을 다시 deny, ask, allow 순서로 대조하므로, 사용자 설정에서 허용한 명령도 프로젝트 설정에서 막으면 막히고 그 반대도 같습니다. 관리 정책의 deny 규칙은 명령줄 인자로도 풀 수 없습니다.

설정 파일에서 자주 막히는 조건은 두 가지입니다.

• 프로젝트 allow와 폴더 신뢰: 공유 프로젝트 파일 .claude/settings.json의 allow 규칙은 그 폴더를 처음 열 때 뜨는 신뢰 창(Quick safety check: Is this a project you created or one you trust?)에서 Yes, I trust this folder를 고른 뒤에만 적용됩니다. deny와 ask 규칙은 바로 적용됩니다.
• 시작 모드 defaultMode: permissions.defaultMode는 세션을 어떤 권한 모드로 시작할지 정하는 값입니다. 프로젝트 파일(.claude/settings.json, .claude/settings.local.json)에 적은 "auto"는 무시되어 내장 기본값으로 시작하고, "bypassPermissions"는 적용되지 않아 Manual 모드로 시작합니다. 두 값은 사용자 설정이나 관리 정책에 적거나, claude --permission-mode auto처럼 시작할 때 줍니다.

지금 불러온 설정 파일은 /status의 Status 탭 Setting sources 줄에서 볼 수 있습니다.

승인 창에서 "다시 묻지 않기"(항상 허용)를 고르면 저장되는 규칙

규칙 없이 Manual 모드에서 zip 명령을 시키면 Claude Code v2.1.310은 아래 승인 창을 띄웠습니다.

흔히 "항상 허용"이라고 부르는 선택지가 2번입니다. 공식 문서에 따르면 터미널의 Claude Code는 이 규칙을 git 저장소 맨 위의 .claude/settings.local.json에만 저장하고, 저장소 안의 하위 폴더에서 연 세션에도 같은 규칙이 적용됩니다. git 저장소가 아닌 폴더와 Windows에서는 작업 폴더의 .claude 폴더에 저장합니다.

도구마다 "다시 묻지 않기"가 남는 기간이 다릅니다.

승인 창에 1번 Yes와 4번 No만 나올 때도 있습니다. 공식 문서는 저장될 범위를 창에 다 보여 줄 수 없을 때 "다시 묻지 않기"를 빼고 한 번 승인만 보여 준다고 설명합니다. 그 명령을 계속 허용하려면 /permissions에서 규칙을 직접 더합니다. mkdir 완료처럼 폴더를 만드는 명령에서는 2번 선택지가 작업 폴더 접근을 허락하는 문구로 나왔습니다.

/permissions 화면에서 규칙을 보고 고치기

세션 안에서 /permissions를 입력하면 권한 규칙 화면이 열립니다. v2.1.310의 탭은 Recently denied, Allow, Ask, Deny, Auto mode, Workspace이고, 왼쪽과 오른쪽 화살표 키로 탭을 옮깁니다.

규칙을 더할 때는 탭의 첫 줄 Add a new rule을 고르고 Bash(rm *)처럼 입력한 뒤, 저장할 파일을 세 가지(Project settings (local), Project settings, User settings) 가운데 고릅니다. 목록에서 규칙을 고르면 터미널에 규칙 삭제 확인 창이 뜨고, 삭제 확인 창에 From project local settings처럼 고른 규칙이 들어 있는 설정 파일이 나옵니다. 작업 도중에 규칙을 더하거나 지우면 Claude가 다음 도구를 호출할 때부터 적용됩니다.

직접 해 보기: 연습 폴더에서 zip 규칙 확인하기

Claude Code 설치와 로그인이 끝났다면 진행합니다. 아직이라면 설치 기초를 먼저 따라 합니다. 요청을 보내면 계정의 사용량이 듭니다.

1. Finder나 파일 탐색기에서 빈 폴더 연습을 만들고, 그 안에 텍스트 편집기(Windows 메모장, Mac 텍스트 편집기)로 초안.txt, 임시.txt를 만들고 하위 폴더 보고서를 만듭니다. 실제 업무 파일은 넣지 않습니다.
2. 터미널이나 PowerShell에서 cd 뒤에 연습 폴더를 끌어다 놓고 Enter를 누른 뒤 claude --permission-mode default를 입력합니다. 신뢰 창이 나오면 Yes, I trust this folder를 고릅니다. 상태 표시줄에 ⏸ manual mode on이 보이면 Manual 모드입니다.
3. 입력창에 "보고서 폴더를 zip으로 묶어 줘"를 보냅니다. 승인 창이 뜨면 2번 Yes, and don't ask again for: zip </strong>*을 고릅니다.
4. 텍스트 편집기(Windows 메모장, Mac 텍스트 편집기)로 연습/.claude/settings.local.json을 열어 "allow": ["Bash(zip *)"]가 생겼는지 봅니다. Finder에서는 Command+Shift+.을 눌러야 .claude 폴더가 보입니다.
5. Finder나 파일 탐색기에서 보고서.zip을 지우고 같은 요청을 다시 보냅니다. 이번에는 승인 창 없이 실행돼야 합니다.
6. /permissions를 입력하고 Deny 탭의 Add a new rule에 Bash(rm *)를 입력해 1번 Project settings (local)에 저장합니다.
7. "Bash 도구로 rm 임시.txt를 실행해 줘. 막히면 다른 방법을 쓰지 말고 멈춰 줘"를 보냅니다. Ctrl+O로 자세히 보기를 켜면 Error: Permission to use Bash with command rm 임시.txt has been denied.가 보이고, Finder나 파일 탐색기에서 임시.txt가 그대로 있어야 합니다.

다른 조건으로 한 번 더 해 봅니다. /permissions의 Ask 탭에 Bash(zip *)를 Project settings로 더한 뒤 zip 요청을 보내면, 로컬 파일의 allow 규칙이 있어도 Permission rule Bash(zip *) requires confirmation for this command. 문구와 함께 승인 창이 다시 뜹니다. 연습이 끝나면 /exit로 세션을 끝내고 연습 폴더를 지웁니다.

막혔을 때

상황	원인	할 일
승인 창이 아예 안 뜨고 명령이 실행됨	세션이 auto 모드로 시작했습니다	상태 표시줄을 보고, Shift+Tab으로 ⏸ manual mode on까지 바꾸거나 claude --permission-mode default로 다시 시작합니다
"다시 묻지 않기"를 골랐는데 또 물음	다른 설정 파일에 같은 명령에 맞는 ask 규칙이 있거나, 명령 모양이 저장된 규칙과 다릅니다(이어 붙인 명령 등)	/permissions의 Ask 탭에서 그 명령에 맞는 규칙과 출처 파일을 봅니다
공유 프로젝트 파일의 allow가 적용되지 않음	그 폴더를 신뢰한다고 고르지 않았습니다	대화형 세션에서 폴더를 열어 신뢰 창에서 Yes, I trust this folder를 고릅니다
defaultMode를 bypassPermissions로 프로젝트 파일에 적었는데 Manual로 시작	프로젝트 파일(.claude/settings.json, .claude/settings.local.json)의 bypassPermissions는 적용되지 않습니다	~/.claude/settings.json으로 옮기거나 claude --permission-mode bypassPermissions로 시작합니다
defaultMode를 auto로 프로젝트 파일에 적었는데 적용되지 않음	프로젝트 파일의 auto는 무시되고 내장 기본값으로 시작합니다	~/.claude/settings.json으로 옮기거나 claude --permission-mode auto로 시작합니다
deny 규칙을 적었는데 비슷한 작업이 실행됨	Claude가 규칙에 맞지 않는 다른 형태의 명령이나 스크립트를 썼습니다	규칙 범위를 넓히거나 샌드박스를 켜고, 실제로 막히는지 연습 파일로 시험합니다
시작할 때 규칙 경고가 나옴	규칙의 도구 이름에 오타가 있습니다(예: Bsh)	공식 도구 이름(Bash, Read, Edit 등)으로 고칩니다

자주 묻는 질문

클로드 코드에서 모든 권한을 허용하려면 어떻게 하나요?

claude --dangerously-skip-permissions 또는 claude --permission-mode bypassPermissions로 시작하면 bypassPermissions 모드가 되어 승인 창 대부분을 건너뜁니다. 공식 문서는 이 모드를 Claude Code가 피해를 줄 수 없는 컨테이너나 가상 머신 같은 격리 환경에서만 쓰라고 경고합니다. 이 모드는 세션을 시작할 때만 켤 수 있고, 켜도 deny 규칙, ask 규칙, 중요한 경로를 지우는 rm 명령은 그대로 막히거나 묻습니다. 상태 표시줄에는 ⏵⏵ bypass permissions on이 보입니다. 내 컴퓨터에서 승인 창을 줄이려면 모든 권한을 여는 대신 자주 쓰는 명령만 allow 규칙에 적습니다.

auto 모드와 allow 규칙은 무엇이 다른가요?

allow 규칙은 사용자가 적은 명령만 묻지 않고 실행합니다. auto 모드는 규칙에 없는 명령도 별도 분류 모델이 요청 범위 안인지 검사해 실행하거나 막습니다. 공식 문서에 따르면 auto 모드에서도 deny, ask, allow 규칙에 맞는 명령은 규칙대로 처리되고, 작업 폴더 안의 읽기와 파일 편집은 자동으로 승인되며, 그 밖의 명령을 분류 모델이 검사합니다. 보호된 경로에 쓰는 일처럼 allow 규칙에 맞아도 분류 모델이 검사하는 예외가 있고, Bash(*)처럼 모든 명령을 여는 allow 규칙은 auto 모드에 있는 동안 적용되지 않고, auto 모드를 나오면 다시 적용됩니다. 설정 파일의 규칙은 그대로 남습니다.

팀 전체가 bypassPermissions 모드를 못 쓰게 할 수 있나요?

할 수 있습니다. 관리 정책 설정에 "permissions": {"disableBypassPermissionsMode": "disable"}을 두면 bypassPermissions 모드를 켤 수 없고, auto 모드는 disableAutoMode로 막습니다. 두 값은 어느 설정 파일에서도 작동하지만, 관리 정책에 두어야 사용자가 덮어쓸 수 없습니다.

참고 자료

• Claude Code 공식 문서: Configure permissions(규칙 문법, 대조 순서, /permissions)
• Claude Code 공식 문서: Settings files and precedence(설정 파일 범위와 우선순위)
• Claude Code 공식 문서: Choose a permission mode(권한 모드, 시작 모드, bypassPermissions)
• Claude Code 공식 문서: Sandboxing(운영체제 수준 차단)