SpyBara
Go Premium

settings-example.md 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

This page contains 7 additions and 3 deletions.

2026
Sat 12 03:02 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

예제 설정 파일

개발자, 팀, 조직을 위한 현실적인 settings.json 파일: 하나를 복사하고 원하는 키를 유지한 후 값을 변경하세요.

이 페이지에는 설정을 저장하는 각 위치에 대한 세 가지 예제 settings.json 파일이 있습니다:

  • 개발자의 ~/.claude/settings.json
  • 저장소에 커밋된 팀의 .claude/settings.json
  • 조직의 managed-settings.json

각 파일은 해당 독자를 위한 그럴듯한 파일이므로 형태를 확인하고 원하는 부분을 복사할 수 있습니다. 어느 것도 권장되는 기본값이 아닙니다. 모든 값은 설정 참조의 각 키 항목에서 나오며, 여기에는 해당 키의 유형, 기본값 및 설정할 수 있는 위치가 있습니다.

각 예제에는 두 개의 탭이 있습니다. 복사 가능한 설정 파일은 저장할 파일입니다. 각 키의 역할은 각 키 위에 주석이 있는 동일한 파일입니다. Claude Code는 설정 파일에서 주석을 허용하지 않으므로 첫 번째 탭에서 복사하세요.

자신의 설정

한 개발자의 개인 설정입니다. 모델과 노력 수준을 선택하고, 터미널을 조정하며, 읽기 전용 명령과 하나의 파일 읽기를 사전 승인합니다. 나열되지 않은 모든 것은 기본값을 유지합니다. 이와 같은 파일은 ~/.claude/settings.json에 저장되며, 열 때마다 모든 프로젝트에 적용됩니다.

이를 ~/.claude/settings.json으로 저장하세요. 주석이 없는 유효한 JSON이므로 그대로 붙여넣고 원하지 않는 키를 삭제할 수 있습니다.

{
"model": "claude-sonnet-5",
"modelSettings": {
"claude-sonnet-5": { "effortLevel": "xhigh" }
},
"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",
"permissions": {
"allow": [
"Bash(git diff *)",
"Read(~/.zshrc)"
]
},
"autoUpdatesChannel": "stable",
"cleanupPeriodDays": 20
}

팀의 공유 설정

저장소에 커밋된 팀의 공유 설정으로, 이를 복제하는 모든 사람이 동일한 권한, 훅, 원격 측정 및 플러그인 마켓플레이스를 얻습니다. 저장소의 최상위에 .claude/settings.json에 이와 같은 파일을 저장하세요. 커밋하기 전에 알아야 할 사항:

  • 클라우드 세션도 이를 읽습니다. 클라우드 세션은 저장소의 복제본에서 시작되므로 커밋된 파일이 거기에도 적용됩니다.
  • 허용 규칙은 신뢰를 기다립니다. 허용 규칙 및 extraKnownMarketplaces 항목은 각 사람이 이 폴더 자체를 신뢰한 후에 적용되며, 상위 폴더만이 아닙니다. 거부 및 요청 규칙은 신뢰 여부와 관계없이 모든 세션에 적용됩니다.
  • 훅은 저장소의 스크립트입니다. 이 파일의 훅은 .claude/hooks/block-rm.sh를 실행합니다. 훅이 해결되는 방식은 이를 작성하는 과정을 설명합니다.
  • 규칙은 작성된 대로 명령 및 경로와 일치합니다. Bash(git push *)는 git -C . push와 일치하지 않습니다. Read(./.env)는 그 자체로 파일 도구 및 cat .env와 같이 파일을 이름으로 지정하는 명령을 중지하지만, grep -r이 디렉토리에서 실행되는 것은 중지하지 않습니다. 이 파일의 sandbox 블록은 sandbox가 모든 샌드박스 명령이 읽을 수 없는 항목에 Read 거부 경로를 추가하기 때문에 이 격차를 메웁니다.

이를 저장소의 최상위에 .claude/settings.json으로 저장하고 커밋하세요. 주석이 없는 유효한 JSON이므로 그대로 붙여넣고 원하지 않는 키를 삭제할 수 있습니다.

{
"permissions": {
"allow": [
"Bash(npm run *)"
],
"ask": [
"Bash(git push *)"
],
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
]
},
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
"OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"
},
"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"
}
}
},
"enabledPlugins": {
"code-formatter@acme-tools": true
},
"sandbox": {
"enabled": true,
"filesystem": {
"allowWrite": [
"/tmp/build"
]
},
"network": {
"allowedDomains": [
"registry.npmjs.org",
"*.example.com"
]
}
},
"plansDirectory": "./plans"
}

조직의 관리 설정

관리 키의 형태를 보여주는 managed-settings.json 파일로, 각각에 대해 하나의 그럴듯한 값이 있습니다. 권장되는 정책이 아닙니다: 자신의 요구 사항과 일치하는 키를 선택하고 자신의 값을 설정하세요. 예제는 다음 키를 설정합니다:

  • forceLoginMethod 및 forceLoginOrgUUID는 로그인 방법 및 조직을 고정합니다
  • availableModels 및 enforceAvailableModels는 세션이 사용할 수 있는 모델을 제한합니다
  • permissions.deny는 두 개의 파일 읽기 및 curl 명령을 거부하고 Claude가 작성하는 방식으로, disableBypassPermissionsMode는 바이패스 권한 모드를 제거합니다
  • allowManagedPermissionRulesOnly 및 allowManagedMcpServersOnly는 관리 권한 및 MCP 허용 목록을 유일하게 적용되는 것으로 만듭니다
  • allowedMcpServers는 MCP 서버를 URL로 고정합니다
  • strictKnownMarketplaces는 하나의 플러그인 마켓플레이스를 허용합니다
  • sandbox는 고정 네트워크 허용 목록과 샌드박스되지 않은 재시도 없이 명령을 샌드박싱합니다
  • requiredMinimumVersion은 최소 Claude Code 버전을 설정합니다
  • cleanupPeriodDays는 세션 기록 및 기타 로컬 데이터의 보존을 7일로 단축합니다
  • companyAnnouncements는 시작 시 메시지를 표시합니다

관리자는 이와 같은 파일을 managed-settings.json으로 배포하거나, MDM 또는 서버 관리 설정을 통해 동일한 JSON을 배포합니다. 배포된 하나의 파일은 도달하는 모든 머신 또는 계정에 적용됩니다. 그룹에 다른 값을 제공하려면 해당 그룹에 다른 파일 또는 프로필을 배포하세요. 서버 관리 설정은 아직 그룹별 정책을 지원하지 않기 때문입니다.

이를 managed-settings.json으로 배포하거나, MDM 또는 claude.ai 콘솔을 통해 동일한 JSON을 배포하세요. 주석이 없는 유효한 JSON입니다. 예제 조직 UUID, 서버 URL 및 마켓플레이스를 자신의 것으로 바꾸고 원하지 않는 키를 삭제하세요.

{
"forceLoginMethod": "claudeai",
"forceLoginOrgUUID": [
"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
],
"availableModels": [
"opus",
"sonnet"
],
"enforceAvailableModels": true,
"permissions": {
"deny": [
"Bash(curl *)",
"Read(./.env)",
"Read(./secrets/**)"
],
"disableBypassPermissionsMode": "disable"
},
"allowManagedPermissionRulesOnly": true,
"allowedMcpServers": [
{
"serverUrl": "https://api.githubcopilot.com/*"
}
],
"allowManagedMcpServersOnly": true,
"strictKnownMarketplaces": [
{
"source": "github",
"repo": "acme-corp/approved-plugins"
}
],
"sandbox": {
"enabled": true,
"failIfUnavailable": true,
"allowUnsandboxedCommands": false,
"network": {
"allowedDomains": [
"registry.npmjs.org",
"github.com"
],
"allowManagedDomainsOnly": true
}
},
"requiredMinimumVersion": "2.1.150",
"cleanupPeriodDays": 7,
"companyAnnouncements": [
"Welcome to Acme Corp! Review our code guidelines at docs.example.com"
]
}