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이 비용 측면에서 추천됨
