settings.local.json으로 Claude Code의 기본 모델을 고정하여 비용 절약하기

Claude Code를 사용하다 보면, 자신도 모르는 사이에 고비용 모델(Opus)이 사용되는 경우가 있습니다.

/model

명령어로 세션 중의 모델을 전환할 수는 있지만, 세션을 넘어가면 매번 다시 설정해야 합니다.

설정 파일에 "model"을 지정함으로써, 세션을 넘어가더라도 자동으로 목적한 모델이 사용되도록 할 수 있습니다.

Claude Code에는 프로젝트 단위로 2종류의 설정 파일이 있습니다. 아래로 갈수록 우선순위가 높아져 덮어쓰게 됩니다.

파일	용도	Git 관리
.claude/settings.json	프로젝트 공유 설정	관리함 (커밋 대상)
.claude/settings.local.json	개인 덮어쓰기 설정	관리하지 않음 (.gitignore 대상)

settings.local.json은 Claude Code가 .gitignore에 자동으로 추가하도록 설계되어 있습니다.

만약을 위해 .gitignore에 포함되어 있는지 확인해 둡시다.

grep "settings.local" .gitignore

포함되어 있지 않다면 수동으로 추가합니다.

.claude/settings.local.json

.claude/settings.json에 추가합니다 (리포지토리에 커밋됩니다).

{
"model": "claude-sonnet-4-6"
}

.claude/settings.local.json을 생성(또는 편집)하여 추가합니다. 이 파일은 .gitignore 대상이므로 커밋되지 않습니다.

{
"model": "claude-sonnet-4-6"
}

settings.local.json은 settings.json보다 우선되므로, 공유 설정을 덮어쓸 수 있습니다.

모델 ID	통칭	용도 기준
claude-opus-4-7	Opus 4.7	복잡한 태스크 · 고정밀도가 필요할 때
claude-sonnet-4-6	Sonnet 4.6	일상적인 개발 작업 (가성비 최고)
claude-haiku-4-5-20251001	Haiku 4.5	경량 · 고속 태스크

일상적인 개발 작업에는 Sonnet이 비용 대비 효과의 균형이 좋아 추천합니다.

설정 후 Claude Code를 실행하여 /model 명령어를 실행하면 현재 모델을 확인할 수 있습니다.

> /model
Set model to Sonnet 4.6 for this session

.claude/settings.local.json의 "model" 키로 개인의 기본 모델을 고정할 수 있음 -
settings.local.json은 .gitignore 대상이므로 Git에 올라가지 않아 개인 설정으로 안전하게 사용할 수 있음 - 프로젝트 전체에서 통일하고 싶다면 .claude/settings.json에 작성하여 커밋함 - 일상 개발에는 claude-sonnet-4-6이 비용 측면에서 추천됨