---
name: opencurrent-code-permissions
description: "자주 쓰는 안전한 명령은 allow 규칙으로 매번 묻지 않고 실행되고 위험한 명령과 비밀 파일은 deny 규칙으로 막혀서, 승인 창에 끊기지 않으면서도 사고를 줄일 수 있습니다. 이럴 때 사용: /permissions로 지금 규칙을 확인한 뒤, 팀이 같이 쓸 규칙은 .claude/settings.json의 permissions.allow와 deny에 적습니다. 그다음 Shift+Tab으로 권한 모드를 일에 맞게 바꿉니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-permissions"
  opencurrent-id: "claude-code-permissions"
  verification: "pending"
  exported-at: "2026-11-21T11:09:05.360Z"
---

# 권한 규칙으로 승인 창 줄이기

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-permissions
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-permissions")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. 지금 규칙 보기 (명령 실행 · Claude Code)

세션에서 /permissions를 엽니다. 규칙마다 어느 설정 파일에서 왔는지 함께 보입니다.

프롬프트:

```text
/permissions
```

기대 결과: 규칙 목록과 출처 파일

확인 방법: "다시 묻지 않기"로 승인한 규칙이 .claude/settings.local.json에서 온 것으로 보이는지 확인

### 2. 허용·차단 규칙 적기 (사람이 · Claude Code)

팀과 나눌 규칙은 .claude/settings.json에 적습니다. 규칙은 Tool 또는 Tool(지정자) 꼴이고 *로 뒤를 열어 둘 수 있습니다. 규칙은 deny, ask, allow 순서로 판단하므로 deny는 allow로 풀리지 않습니다.

프롬프트:

```text
{
  "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로 옮기세요.

프롬프트:

```text
"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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-permissions 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
