클로드 코드를 처음 쓰면 질문을 한국어로 해도 답변이 영어로 나오는 경우가 있어요. 매번 “한국어로 답해줘”라고 붙이기 번거롭다면, 클로드 코드 한글 설정을 한 번만 해두면 돼요. 이 글에서는 2026년 10월 Anthropic 공식 문서를 기준으로 settings.json 한 줄로 한국어 답변을 고정하는 방법부터 CLAUDE.md로 커밋 메시지·주석까지 한국어로 맞추는 방법까지 정리했어요.
아직 클로드 코드를 설치하지 않았다면 클로드 코드 윈도우 설치 방법 글을 먼저 참고해 주세요.
클로드 코드 한글 설정, 가장 확실한 방법은 language 설정
클로드 코드에는 답변 언어를 정하는 language 설정이 있어요. 여기에 언어 이름을 적어두면, 클로드 코드가 그 값을 “항상 이 언어로 답하라”는 지시로 전달해요. 한 번 설정하면 새 대화를 열 때마다 따로 요청할 필요가 없어요.
공식 문서 기준으로 이 설정은 아래 세 가지에 적용돼요.
- Claude의 답변 언어
- 음성 받아쓰기(voice dictation) 언어
- 자동으로 만들어지는 대화(세션) 제목
settings.json에 한국어 설정 추가하는 방법
모든 프로젝트에서 한국어로 답변받고 싶다면 사용자 설정 파일에 추가하면 돼요. 윈도우 기준 파일 위치는 아래와 같아요.
%USERPROFILE%\.claude\settings.json- 파일 탐색기 주소창에
%USERPROFILE%\.claude를 입력해 폴더를 열어요. - settings.json 파일을 메모장이나 VS Code로 열어요. 파일이 없다면 같은 이름으로 새로 만들면 돼요. 클로드 코드는 설치만 해서는 이 파일을 자동으로 만들지 않아요.
- 아래 내용을 넣고 저장해요.
{
"language": "korean"
}
이미 다른 설정이 들어 있는 파일이라면, 기존 중괄호 안에 쉼표로 구분해서 한 줄만 추가하면 돼요.
{
"model": "기존 설정",
"language": "korean"
}⚠️ settings.json은 형식이 엄격해요. 마지막 줄 뒤에 쉼표를 붙이거나, // 주석을 넣으면 오류가 나요. 저장 후 클로드 코드를 실행했을 때 “Settings Error”가 뜬다면 쉼표와 따옴표를 먼저 확인해 보세요.
클로드 코드는 설정 파일이 바뀌면 자동으로 다시 읽어서, 대부분의 경우 재시작하지 않아도 바로 적용돼요. 제대로 불러왔는지 확인하고 싶다면 클로드 코드 안에서 /status를 입력해 보세요. “Setting sources” 항목에 User settings가 보이면 정상이에요.
특정 프로젝트에서만 한국어로 쓰고 싶다면
한 프로젝트에서만 적용하고 싶다면 그 프로젝트 폴더 안의 .claude\settings.local.json에 같은 내용을 넣으면 돼요. 팀원과 함께 쓰는 프로젝트라면 .claude\settings.json에 넣어서 공유할 수도 있어요.
CLAUDE.md로 커밋 메시지·주석까지 한국어로 맞추기
language 설정은 답변 언어를 정하는 기능이에요. 여기에 더해 커밋 메시지, 코드 주석, 문서까지 한국어로 쓰게 하고 싶다면 CLAUDE.md 파일에 규칙을 적어두면 돼요. CLAUDE.md는 클로드 코드가 대화를 시작할 때마다 읽는 안내문 같은 파일이에요.
- 모든 프로젝트에 적용:
%USERPROFILE%\.claude\CLAUDE.md - 특정 프로젝트에만 적용: 프로젝트 폴더의
CLAUDE.md
예를 들어 이렇게 적어두면 돼요.
# 언어 규칙
- 모든 답변은 한국어로 작성한다.
- 커밋 메시지와 코드 주석도 한국어로 작성한다.
- 변수명, 함수명은 영어로 유지한다.클로드 코드 안에서 /memory를 입력하면 CLAUDE.md 파일을 바로 열어서 편집할 수도 있어요.
이번 한 번만 한국어로 쓰고 싶을 때
설정 파일을 건드리지 않고 이번 실행에서만 적용하고 싶다면, 클로드 코드를 실행할 때 지시를 덧붙이는 방법도 있어요.
claude --append-system-prompt "항상 한국어로 답변해 주세요."물론 가장 간단한 방법은 대화 중에 “앞으로 한국어로 답해줘”라고 요청하는 거예요. 다만 이 방법은 새 대화를 열면 다시 말해야 해요.
클로드 코드 한글 설정 방법 비교
| 방법 | 적용 범위 | 이럴 때 추천 |
|---|---|---|
| language 설정 | 모든 대화 (설정 파일 위치에 따라 전체 또는 프로젝트) | 항상 한국어로 받고 싶을 때 |
| CLAUDE.md | 모든 대화 (파일 위치에 따라 전체 또는 프로젝트) | 커밋·주석 등 세부 규칙까지 정하고 싶을 때 |
| –append-system-prompt | 이번 실행 한 번 | 설정을 바꾸지 않고 잠깐 쓸 때 |
| 대화로 요청 | 현재 대화 | 가장 빠르게 해결하고 싶을 때 |
클로드 코드 한글 설정 자주 묻는 질문
“korean” 대신 “한국어”라고 써도 되나요?
공식 문서에 따르면 클로드 코드는 이 값을 검사하지 않고 그대로 Claude에게 전달해요. 그래서 Claude가 알아들을 수 있는 언어 이름이면 동작하지만, 문서 예시처럼 영어 소문자("korean")로 적는 게 가장 무난해요.
메뉴나 버튼 글자도 한글로 바뀌나요?
language 설정은 Claude의 답변, 음성 받아쓰기, 대화 제목 언어를 정하는 기능이에요. 클로드 코드 화면의 메뉴 글자까지 바꾸는 설정으로 안내되어 있지는 않아요.
VS Code나 데스크톱 앱에서도 적용되나요?
네. 터미널, VS Code·JetBrains 확장, 데스크톱 앱은 같은 설정 파일을 읽어요. 다만 VS Code 채팅 패널과 데스크톱 앱에서는 /config 메뉴가 열리지 않으니, settings.json 파일을 직접 수정하면 돼요.
설정했는데 영어로 답할 때가 있어요
먼저 /status로 설정 파일이 제대로 불러와졌는지 확인해 보세요. 프로젝트 설정 파일에 다른 language 값이 있으면 그쪽이 우선 적용돼요. 그래도 영어가 섞인다면 CLAUDE.md에 한국어 규칙을 함께 적어두면 더 확실해요.
마무리
정리하면, 클로드 코드 한글 설정은 settings.json에 “language”: “korean” 한 줄 추가가 가장 확실하고, 커밋 메시지나 주석까지 맞추고 싶다면 CLAUDE.md에 한국어 규칙을 더하면 돼요. 설정 항목은 업데이트에 따라 바뀔 수 있으니 자세한 내용은 Claude Code 공식 설정 문서도 함께 확인해 보세요.
클로드 코드 요금제가 궁금하다면 클로드 코드 요금제 총정리 글도 참고해 주세요.