권한 구성

​

권한 시스템

​

권한 관리

• Allow 규칙을 사용하면 Claude Code가 수동 승인 없이 지정된 도구를 사용할 수 있습니다.
• Ask 규칙은 Claude Code가 지정된 도구를 사용하려고 할 때마다 확인을 요청합니다.
• Deny 규칙은 Claude Code가 지정된 도구를 사용하지 못하도록 방지합니다.

​

권한 모드

​

권한 규칙 구문

​

도구의 모든 사용 일치

​

세분화된 제어를 위해 지정자 사용

​

와일드카드 패턴

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

​

도구별 권한 규칙

​

Bash

• Bash(npm run build)는 정확한 Bash 명령 npm run build와 일치합니다
• Bash(npm run test *)는 npm run test로 시작하는 Bash 명령과 일치합니다
• Bash(npm *)는 npm 로 시작하는 모든 명령과 일치합니다
• Bash(* install)은 install로 끝나는 모든 명령과 일치합니다
• Bash(git * main)은 git checkout main, git merge main과 같은 명령과 일치합니다

​

Read 및 Edit

• Edit(/docs/**): <project>/docs/의 편집 (NOT /docs/ and NOT <project>/.claude/docs/)
• Read(~/.zshrc): 홈 디렉토리의 .zshrc 읽기
• Edit(//tmp/scratch.txt): 절대 경로 /tmp/scratch.txt 편집
• Read(src/**): <current-directory>/src/에서 읽기

​

WebFetch

• WebFetch(domain:example.com)은 example.com으로의 가져오기 요청과 일치합니다

​

MCP

• mcp__puppeteer는 puppeteer 서버(Claude Code에서 구성된 이름)에서 제공하는 모든 도구와 일치합니다
• mcp__puppeteer__* 와일드카드 구문은 puppeteer 서버의 모든 도구와도 일치합니다
• mcp__puppeteer__puppeteer_navigate는 puppeteer 서버에서 제공하는 puppeteer_navigate 도구와 일치합니다

​

Agent (subagents)

• Agent(Explore)는 Explore subagent와 일치합니다
• Agent(Plan)은 Plan subagent와 일치합니다
• Agent(my-custom-agent)는 my-custom-agent라는 사용자 정의 subagent와 일치합니다

{
  "permissions": {
    "deny": ["Agent(Explore)"]
  }
}

​

훅으로 권한 확장

​

작업 디렉토리

• 시작 중: --add-dir <path> CLI 인수 사용
• 세션 중: /add-dir 명령 사용
• 영구 구성: 설정 파일의 additionalDirectories에 추가

​

권한이 샌드박싱과 상호 작용하는 방식

• 권한은 Claude Code가 사용할 수 있는 도구와 액세스할 수 있는 파일 또는 도메인을 제어합니다. 모든 도구(Bash, Read, Edit, WebFetch, MCP 등)에 적용됩니다.
• 샌드박싱은 Bash 도구의 파일 시스템 및 네트워크 액세스를 제한하는 OS 수준 적용을 제공합니다. Bash 명령 및 해당 자식 프로세스에만 적용됩니다.

• 권한 deny 규칙은 Claude가 제한된 리소스에 액세스하려고 시도하는 것을 차단합니다
• 샌드박스 제한은 프롬프트 주입이 Claude의 의사 결정을 우회하더라도 Bash 명령이 정의된 경계 외부의 리소스에 도달하는 것을 방지합니다
• 샌드박스의 파일 시스템 제한은 Read 및 Edit deny 규칙을 사용하며, 별도의 샌드박스 구성은 사용하지 않습니다
• 네트워크 제한은 WebFetch 권한 규칙과 샌드박스의 allowedDomains 목록을 결합합니다

​

관리형 설정

​

관리형 전용 설정

​

자동 모드 분류기 구성

​

신뢰할 수 있는 인프라 정의

{
  "autoMode": {
    "environment": [
      "Source control: github.example.com/acme-corp and all repos under it",
      "Trusted cloud buckets: s3://acme-build-artifacts, gs://acme-ml-datasets",
      "Trusted internal domains: *.corp.example.com, api.internal.example.com",
      "Key internal services: Jenkins at ci.example.com, Artifactory at artifacts.example.com"
    ]
  }
}

• 조직: 회사 이름 및 Claude Code가 주로 사용되는 용도(예: 소프트웨어 개발, 인프라 자동화 또는 데이터 엔지니어링)
• 소스 제어: 개발자가 푸시하는 모든 GitHub, GitLab 또는 Bitbucket 조직
• 클라우드 제공자 및 신뢰할 수 있는 버킷: Claude가 읽고 쓸 수 있어야 하는 버킷 이름 또는 접두사
• 신뢰할 수 있는 내부 도메인: *.internal.example.com과 같은 네트워크 내부의 API, 대시보드 및 서비스에 대한 호스트명
• 주요 내부 서비스: CI, 아티팩트 레지스트리, 내부 패키지 인덱스, 인시던트 도구
• 추가 컨텍스트: 규제 산업 제약, 다중 테넌트 인프라 또는 분류기가 위험으로 취급해야 할 규정 준수 요구사항

{
  "autoMode": {
    "environment": [
      "Organization: {COMPANY_NAME}. Primary use: {PRIMARY_USE_CASE, e.g. software development, infrastructure automation}",
      "Source control: {SOURCE_CONTROL, e.g. GitHub org github.example.com/acme-corp}",
      "Cloud provider(s): {CLOUD_PROVIDERS, e.g. AWS, GCP, Azure}",
      "Trusted cloud buckets: {TRUSTED_BUCKETS, e.g. s3://acme-builds, gs://acme-datasets}",
      "Trusted internal domains: {TRUSTED_DOMAINS, e.g. *.internal.example.com, api.example.com}",
      "Key internal services: {SERVICES, e.g. Jenkins at ci.example.com, Artifactory at artifacts.example.com}",
      "Additional context: {EXTRA, e.g. regulated industry, multi-tenant infrastructure, compliance requirements}"
    ]
  }
}

​

차단 및 allow 규칙 재정의

{
  "autoMode": {
    "environment": [
      "Source control: github.example.com/acme-corp and all repos under it"
    ],
    "allow": [
      "Deploying to the staging namespace is allowed: staging is isolated from production and resets nightly",
      "Writing to s3://acme-scratch/ is allowed: ephemeral bucket with a 7-day lifecycle policy"
    ],
    "soft_deny": [
      "Never run database migrations outside the migrations CLI, even against dev databases",
      "Never modify files under infra/terraform/prod/: production infrastructure changes go through the review workflow",
      "...copy full default soft_deny list here first, then add your rules..."
    ]
  }
}

​

기본값 및 효과적인 구성 검사

claude auto-mode defaults  # the built-in environment, allow, and soft_deny rules
claude auto-mode config    # what the classifier actually uses: your settings where set, defaults otherwise
claude auto-mode critique  # get AI feedback on your custom allow and soft_deny rules

​

설정 우선순위

1. 관리형 설정: 명령줄 인수를 포함한 다른 수준으로 재정의할 수 없습니다
2. 명령줄 인수: 임시 세션 재정의
3. 로컬 프로젝트 설정 (.claude/settings.local.json)
4. 공유 프로젝트 설정 (.claude/settings.json)
5. 사용자 설정 (~/.claude/settings.json)

​

예시 구성

​

참고 항목

• 설정: 권한 설정 테이블을 포함한 완전한 구성 참조
• 샌드박싱: Bash 명령에 대한 OS 수준 파일 시스템 및 네트워크 격리
• 인증: Claude Code에 대한 사용자 액세스 설정
• 보안: 보안 보호 및 모범 사례
• 훅: 워크플로우 자동화 및 권한 평가 확장