# 권한 규칙으로 승인 창 줄이기
id: claude-code-permissions · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-permissions
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 15분
평가 점수: 32/100 (확인 없음 · 검수 대기)

자주 쓰는 안전한 명령은 allow 규칙으로 매번 묻지 않고 실행되고 위험한 명령과 비밀 파일은 deny 규칙으로 막혀서, 승인 창에 끊기지 않으면서도 사고를 줄일 수 있습니다.

설명: /permissions로 지금 규칙을 확인한 뒤, 팀이 같이 쓸 규칙은 .claude/settings.json의 permissions.allow와 deny에 적습니다. 그다음 Shift+Tab으로 권한 모드를 일에 맞게 바꿉니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] 지금 규칙 보기 — 세션에서 /permissions를 엽니다. 규칙마다 어느 설정 파일에서 왔는지 함께 보입니다.
   프롬프트:
   > /permissions
   기대 결과: 규칙 목록과 출처 파일
   확인 방법: "다시 묻지 않기"로 승인한 규칙이 .claude/settings.local.json에서 온 것으로 보이는지 확인
2. [사람이 · Claude Code] 허용·차단 규칙 적기 — 팀과 나눌 규칙은 .claude/settings.json에 적습니다. 규칙은 Tool 또는 Tool(지정자) 꼴이고 *로 뒤를 열어 둘 수 있습니다. 규칙은 deny, ask, allow 순서로 판단하므로 deny는 allow로 풀리지 않습니다.
   프롬프트:
   > {
   >   "permissions": {
   >     "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
   >     "deny": ["Read(./.env)", "Read(./.env.*)", "Bash(git push *)"]
   >   }
   > }
   기대 결과: .claude/settings.json의 permissions
   확인 방법: /permissions에 새 규칙이 보이는지 확인
3. [사람이 · Claude Code] 비밀 파일 막기 — Read 차단 규칙은 같은 경로의 Edit·Write도 막습니다. .claudeignore는 효과가 없으므로 그 내용을 Read deny로 옮기세요.
   프롬프트:
   > "deny": ["Read(./secrets/**)"]
   기대 결과: 비밀 폴더 차단 규칙
   확인 방법: Claude에게 그 파일을 읽어 달라고 해서 거절되는지 확인
4. [사람이 · Claude Code] 권한 모드 고르기 — Shift+Tab으로 모드를 바꿉니다. default는 매번 묻고, acceptEdits는 작업 폴더 안의 편집을 바로 하고, plan은 읽기와 계획만 합니다. 시작 모드를 정하려면 claude --permission-mode plan처럼 실행하거나 설정의 permissions.defaultMode를 씁니다.
   기대 결과: 상태 표시줄에 바뀐 모드
   확인 방법: Shift+Tab을 눌러 모드 이름이 바뀌는지 확인

주의:
- Bash 규칙은 명령 글자로만 맞춤. Bash(curl *) 차단은 /usr/bin/curl이나 sh -c 'curl …'을 못 막으므로 진짜 차단은 샌드박스로
- auto와 bypassPermissions는 프로젝트 설정(.claude/settings.json·settings.local.json)의 defaultMode로 켜지지 않음. 사용자 설정이나 실행 옵션으로만
- bypassPermissions는 격리된 컨테이너·VM에서만. 이 모드에서도 deny 규칙은 적용

출처:
- Claude Code 문서: 권한 설정 https://code.claude.com/docs/en/permissions
- Claude Code 문서: 권한 모드 https://code.claude.com/docs/en/permission-modes
- Claude Code 문서: 설정 파일 https://code.claude.com/docs/en/settings