권한 규칙으로 승인 창 줄이기
자주 쓰는 안전한 명령은 allow 규칙으로 매번 묻지 않고 실행되고 위험한 명령과 비밀 파일은 deny 규칙으로 막혀서, 승인 창에 끊기지 않으면서도 사고를 줄일 수 있습니다.
/permissions로 지금 규칙을 확인한 뒤, 팀이 같이 쓸 규칙은 .claude/settings.json의 permissions.allow와 deny에 적습니다. 그다음 Shift+Tab으로 권한 모드를 일에 맞게 바꿉니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
준비
- Claude Code 설치와 로그인
1. 지금 규칙 보기
세션에서 /permissions를 엽니다. 규칙마다 어느 설정 파일에서 왔는지 함께 보입니다.
/permissions결과: 규칙 목록과 출처 파일
확인: "다시 묻지 않기"로 승인한 규칙이 .claude/settings.local.json에서 온 것으로 보이는지 확인
2. 허용·차단 규칙 적기
팀과 나눌 규칙은 .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. 비밀 파일 막기
Read 차단 규칙은 같은 경로의 Edit·Write도 막습니다. .claudeignore는 효과가 없으므로 그 내용을 Read deny로 옮기세요.
"deny": ["Read(./secrets/**)"]결과: 비밀 폴더 차단 규칙
확인: Claude에게 그 파일을 읽어 달라고 해서 거절되는지 확인
4. 권한 모드 고르기
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 규칙은 적용
댓글