예제 설정 파일

{
  // 모든 세션을 Sonnet 5에서 시작
  "model": "claude-sonnet-5",
  // 저장된 수준이 없는 모델에서 기본 높음 수준보다 더 깊게 추론합니다. /effort는 모델당 수준을 저장하고, --effort는 단일 세션에 대해 설정합니다
  "effortLevel": "xhigh",
  // 프롬프트에서 Vim 키 바인딩
  "editorMode": "vim",
  // 색맹 친화적인 밝은 테마
  "theme": "light-daltonized",
  // 프롬프트 아래의 상태 줄: 모델 이름 및 사용된 컨텍스트
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",
    "padding": 2
  },
  // 스피너 아래에서 회전하는 팁 숨기기
  "spinnerTipsEnabled": false,
  // 완료된 작업이나 대기 중인 권한 프롬프트와 같은 알림에 대해 터미널 벨 울리기
  "preferredNotifChannel": "terminal_bell",
  // Claude Code가 git diff를 실행하고 묻지 않고 .zshrc를 읽도록 허용
  "permissions": {
    "allow": [
      "Bash(git diff *)",
      "Read(~/.zshrc)"
    ]
  },
  // 안정 채널에서 업데이트 받기
  "autoUpdatesChannel": "stable",
  // 20일보다 오래된 세션 기록 및 기타 로컬 세션 데이터 삭제
  "cleanupPeriodDays": 20
}

{
  "permissions": {
    // npm 스크립트를 묻지 않고 실행
    "allow": [
      "Bash(npm run *)"
    ],
    // git push 명령 전에 확인
    "ask": [
      "Bash(git push *)"
    ],
    // 파일 도구 및 파일 읽기 명령으로 env 파일 및 secrets 폴더 읽기 거부
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  // OpenTelemetry 메트릭을 팀의 수집기로 gRPC를 통해 전송합니다. 엔드포인트를 수집기의 URL로 바꾸세요
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"
  },
  // 모든 Bash 명령 전에 저장소의 스크립트를 실행하여 이를 차단할 수 있습니다
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh"
          }
        ]
      }
    ]
  },
  // 모든 복제에서 팀의 플러그인 마켓플레이스 등록
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/claude-plugins"
      }
    }
  },
  // 해당 마켓플레이스에서 하나의 플러그인을 활성화합니다. GitHub 저장소와 같은 외부 소스의 플러그인은 여전히 각 사람이 한 번 설치해야 합니다
  "enabledPlugins": {
    "code-formatter@acme-tools": true
  },
  // 샌드박스 명령: 쓰기 가능한 빌드 디렉토리; npm 및 example.com 사전 허용, 다른 호스트는 여전히 프롬프트
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": [
        "/tmp/build"
      ]
    },
    "network": {
      "allowedDomains": [
        "registry.npmjs.org",
        "*.example.com"
      ]
    }
  },
  // 계획 파일을 저장소 내부에 유지
  "plansDirectory": "./plans"
}

{
  // claude.ai 로그인만, 그리고 이 조직에서만
  "forceLoginMethod": "claudeai",
  "forceLoginOrgUUID": [
    "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  ],
  // Opus 및 Sonnet 모델만; enforceAvailableModels를 사용하면 기본 옵션도 목록을 따릅니다
  "availableModels": [
    "opus",
    "sonnet"
  ],
  "enforceAvailableModels": true,
  "permissions": {
    // 모든 머신에서 curl 명령 및 프로젝트의 .env 파일과 secrets 폴더 읽기 거부
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./secrets/**)"
    ],
    // 모든 세션에서 바이패스 권한 모드 제거
    "disableBypassPermissionsMode": "disable"
  },
  // 사용자, 프로젝트 및 로컬 설정의 권한 규칙 무시
  "allowManagedPermissionRulesOnly": true,
  // GitHub MCP 서버만, 사용자가 모든 서버를 "github"로 이름 지을 수 있으므로 이름이 아닌 URL로 일치합니다.
  // 목록과 일치하지 않는 사용자 추가 서버는 로드되지 않으며, 목록에 URL 항목만 있을 때 모든 stdio 서버를 포함합니다.
  // 아래의 allowManagedMcpServersOnly 키는 이 관리 목록을 유일하게 적용되는 허용 목록으로 만듭니다
  "allowedMcpServers": [
    {
      "serverUrl": "https://api.githubcopilot.com/*"
    }
  ],
  "allowManagedMcpServersOnly": true,
  // 플러그인은 이 마켓플레이스에서만 올 수 있습니다
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/approved-plugins"
    }
  ],
  // Claude가 실행하는 모든 명령을 샌드박싱하고, 샌드박스를 설정할 수 없으면 시작을 거부하며,
  // 차단된 명령이 샌드박스 외부에서 재시도되도록 허용하지 않습니다. 네트워크는
  // npm 및 GitHub로 제한되며, 사용자는 도메인을 추가할 수 없습니다
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true,
    "allowUnsandboxedCommands": false,
    "network": {
      "allowedDomains": [
        "registry.npmjs.org",
        "github.com"
      ],
      "allowManagedDomainsOnly": true
    }
  },
  // 2.1.150보다 오래된 버전에서 시작하기를 거부합니다
  "requiredMinimumVersion": "2.1.150",
  // 7일 후 세션 기록 및 기타 로컬 세션 데이터 삭제
  "cleanupPeriodDays": 7,
  // 모든 사용자가 시작 시 보는 메시지
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.example.com"
  ]
}