클로드코드 13-settings

1. Settings

참고: Claude Code의 전역/프로젝트 설정과 환경 변수

1.1. 설정 범위 (Scopes)

- 범위: 위치: 영향: 팀 공유?
- Managed: 서버/시스템 레벨: 해당 머신의 모든 사용자: ✅ (IT 배포)
- User: ~/.claude/: 모든 프로젝트의 사용자 본인: ❌
- Project: .claude/: 해당 저장소의 모든 협업자: ✅ (git 커밋)
- Local: .claude/settings.local.json: 해당 저장소의 사용자 본인: ❌ (gitignored)

1.2. 우선순위

Managed (최상위, 재정의 불가)
CLI 인자
Local
Project
User (최하위)

참고: Permission 규칙은 범위별로 병합(merge)된다. Scalar 값은 상위 범위가 하위를 덮어쓴다.

1.3. 주요 설정

1.3.1. Permissions

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

1.3.2. Hooks

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "npx prettier --write"
      }]
    }]
  }
}

1.3.3. Environment Variables

{
  "env": {
    "FOO": "bar",
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
  }
}

1.3.4. 모델 설정

{
  "model": "opus",
  "effortLevel": "xhigh"
}

1.3.5. Auto memory

{
  "autoMemoryEnabled": true,
  "autoMemoryDirectory": "~/my-memory-dir"
}

1.3.6. 업데이트 채널

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

1.3.7. Sandboxing

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": ["~/.kube"],
      "denyRead": ["~/"]
    },
    "network": {
      "allowedDomains": ["github.com", "npmjs.org"]
    }
  }
}

1.3.8. 기타 유용한 설정

- 설정: 설명: 예시
- alwaysThinkingEnabled: Extended thinking 기본 활성화: true
- editorMode: 입력 프롬프트 키 바인딩 모드: "vim"
- language: Claude의 응답 언어: "japanese"
- cleanupPeriodDays: 세션 파일 보관 기간: 30
- companyAnnouncements: 시작 시 표시할 공지: ["Welcome to Acme Corp!"]

1.4. Managed Settings 배포

1.4.1. Server-managed

Claude.ai admin console을 통해 배포.

1.4.2. MDM/OS-level

- macOS: com.anthropic.claudecode managed preferences
- Windows: HKLM\SOFTWARE\Policies\ClaudeCode 레지스트리
- Linux/WSL: /etc/claude-code/managed-settings.json

1.4.3. Drop-in 디렉토리

managed-settings.d/에 10-telemetry.json, 20-security.json 등으로 분할 배포. 알파벳 순서로 병합.

1.5. JSON Schema

$schema 키로 자동 완성과 유효성 검사를 활성화할 수 있다.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json"
}