Claude Code가 모든 명령을 실행하도록 허용하는 방법: 권한 모드, allow 규칙, 권한 건너뛰기

• default(Manual로 표시): 각 도구를 처음 사용할 때 확인을 요청합니다.
• acceptEdits: 작업 디렉터리에서 파일 편집과 mkdir, touch, mv, cp 같은 일반 파일 시스템 명령을 자동 수락합니다.
• plan: 탐색하고 읽기 전용 명령을 실행하지만 소스 파일은 편집하지 않습니다.
• auto: 일상적인 확인이 없습니다. 백그라운드 분류기가 셸 명령과 네트워크 요청을 사용자의 요청과 대조해 검사합니다. v2.1.283부터 내장 시작 모드입니다.
• dontAsk: 사전 승인한 도구를 제외하고 확인이 필요한 모든 것을 거부합니다.
• bypassPermissions: .git, .claude 같은 보호된 경로에 대한 쓰기를 포함해 확인을 건너뜁니다. 격리된 컨테이너나 VM에서만 사용합니다.

• 세션 중: Shift+Tab을 눌러 default → acceptEdits → plan(및 활성화된 다른 모드)을 순환합니다.
• 한 세션: claude --permission-mode plan(또는 default, acceptEdits, auto, dontAsk).
• 기본값으로: ~/.claude/settings.json에 permissions.defaultMode를 설정합니다.

allow 규칙은 모든 검사를 건너뛰는 것보다 안전합니다. *는 하위 명령 뒤에 둡니다. Bash(git log *)는 git log만 허용하고, Bash(git *)는 모든 git 명령을 허용합니다. Deny 규칙이 항상 우선합니다.

{
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(git commit *)"],
    "deny": ["Bash(git push *)"]
  }
}

Claude Code 안에서 /permissions를 사용해 모든 규칙과 각 규칙이 정의된 설정 파일을 확인합니다.

--allowedTools(--allowed-tools로도 표기)는 한 세션 동안 확인 없이 실행할 도구를 나열합니다. settings.json의 permissions.allow와 같은 규칙 문법을 사용합니다. --disallowedTools는 deny 규칙을 추가하며, Edit처럼 도구 이름만 쓰면 해당 도구가 세션에서 제거됩니다.

claude --allowedTools "Bash(git log *)" "Bash(git diff *)" "Read"

• 규칙은 deny, ask, allow 순서로 검사됩니다. Bash(aws *) 같은 넓은 deny는 더 좁은 allow 규칙이 일치하더라도 호출을 차단합니다.
• Bash 규칙은 셸 연산자를 이해합니다. Bash(safe-cmd *)는 safe-cmd && other-cmd를 승인하지 않습니다. 각 하위 명령이 개별적으로 일치해야 합니다.
• Bash(ls:*)는 Bash(ls *)와 같습니다. :* 형식은 패턴 끝에서만 작동합니다.
• MCP 도구: mcp__puppeteer는 puppeteer 서버의 모든 도구를, mcp__puppeteer__puppeteer_navigate는 도구 하나를 허용합니다. Allow glob에는 리터럴 서버 이름이 필요하므로 mcp__* allow 규칙은 경고와 함께 무시됩니다.
• 웹 가져오기: WebFetch(domain:example.com)는 example.com만 일치합니다. 하위 도메인까지 포함하려면 WebFetch(domain:*.example.com)를 추가합니다.
• 존재할 내장 도구 자체를 제한하려면 allow 목록 대신 --tools "Bash,Edit,Read"를 사용합니다.