Settings
-
Claude Code settings.json vs settings.local.json — 왜 둘로 나뉘었나IT 2026. 4. 23. 22:00
왜 파일이 두 개인가Claude Code를 쓰다 보면 어느 순간 홈 디렉토리에 ~/.claude/settings.json과 ~/.claude/settings.local.json이 나란히 생겨 있다. 이름이 비슷해서 처음에는 둘을 구별하지 않고 아무 쪽에나 설정을 적게 되는데, 이 둘의 역할은 명확하게 나뉘어 있다. 단순히 파일이 쪼개진 것이 아니라 공유 가능한 규칙과 개인 판단을 분리하기 위한 설계 결정이다.이 글에서는 Claude Code의 settings 계층 구조를 정리하고, .local.json이 접미사 하나로 무엇이 달라지는지, 그리고 어떤 설정을 어느 파일에 두는 것이 최선인지를 개인 환경의 실제 구성을 예로 들어 정리한다.Claude Code의 Settings 계층공식 문서에서 Claude ..