CoreCode블로그

가이드

Claude Code 한국어 설정: 한국어로 답변하게 만드는 language 설정과 CLAUDE.md 작성법

게시일 · 최종 확인

Claude Code는 기본적으로 영어로 답변합니다. 한국어로 답변하게 하는 방법은 Anthropic 문서에 두 가지가 있습니다. settings.json의 language 키와 CLAUDE.md의 한 줄입니다. 이 글에서는 작성법, 파일 위치, 제대로 불러왔는지 확인하는 방법, 코드 주석과 커밋 메시지 언어를 따로 정하는 방법을 설명합니다. 내용은 Anthropic의 Settings reference와 Memory 문서를 기준으로 하며, 2026년 11월 5일에 확인했습니다.

핵심 요약
  • Settings reference에 language 키가 있습니다. settings.json에 언어 이름을 적습니다. Claude Code는 이 값을 "항상 그 언어로 답변하라"는 지시로 Claude에게 그대로 전달하며, 값을 검증하지 않습니다.
  • 더 세밀하게 정하려면 ~/.claude/CLAUDE.md에 "답변은 한국어로. 코드, 명령어, 식별자는 영어 그대로 둔다."라고 적습니다. 모든 프로젝트에 적용됩니다.
  • 팀 저장소는 프로젝트의 ./CLAUDE.md, 나만의 프로젝트 설정은 ./CLAUDE.local.md에 적습니다.
  • 세션에서 /context all을 실행하고 Memory files 목록에서 파일이 로드됐는지 확인합니다.
  • CLAUDE.md는 컨텍스트이지 강제 설정이 아닙니다. 엄격한 준수는 보장되지 않는다고 Anthropic은 설명합니다.

방법 1: settings.json의 language

Settings reference에는 영어가 아닌 언어로 기본 답변을 하게 하는 language 키가 있습니다. 값은 문자열이며 어떤 언어 이름이든 쓸 수 있습니다. 문서의 예시는 "japanese"입니다. 답변 언어에 고정된 목록은 없고, 값이 Claude에게 그대로 전달되므로 Claude가 읽을 수 있는 언어 이름이면 된다고 설명합니다.

{
  "language": "korean"
}

이 키는 사용자 설정 ~/.claude/settings.json, 프로젝트 설정 .claude/settings.json, 로컬 설정 .claude/settings.local.json 어디에나 적을 수 있고, 조직이 배포하는 관리형 설정으로도 지정할 수 있습니다. 값을 검증하지 않으므로 철자가 틀려도 오류가 나지 않고 적은 그대로 Claude에게 전달됩니다. 위의 "korean"은 이 설명에 따라 적은 예시이며, 다른 표기를 일일이 시험해 보지는 않았습니다. 같은 값은 음성 받아쓰기 언어와 자동 생성되는 세션 제목의 언어에도 쓰입니다. 설정하지 않으면 세션 제목은 대화 언어를 따릅니다.

이 설정은 Claude의 답변 언어를 정하는 것입니다. 화면 표시 자체를 번역하는 설정이라는 내용은 이번에 확인한 문서에 없습니다.

방법 2: CLAUDE.md에 한 줄 쓰기

CLAUDE.md는 Claude Code가 세션을 시작할 때 읽는 지침 파일입니다. 문서에는 위치가 세 곳 나와 있습니다.

답변 언어는 개인 취향이므로 ~/.claude/CLAUDE.md가 알맞습니다. Anthropic은 확인할 수 있을 만큼 구체적으로 쓰라고 권합니다. 이렇게 적습니다.

- 답변은 항상 한국어로 한다.
- 코드, 명령어, 파일 이름, 식별자는 영어 그대로 둔다. 번역하지 않는다.

팀 전체가 한국어로 일한다면 같은 내용을 프로젝트의 ./CLAUDE.md에 적습니다. 저장소를 받은 모든 사람에게 적용됩니다. 한 프로젝트에서만 언어를 바꾸고 싶다면 커밋되지 않는 ./CLAUDE.local.md를 사용합니다.

코드 주석과 커밋 메시지는 별도 줄로 지정

"한국어로 답변"은 대화의 언어를 뜻합니다. 코드 주석, 커밋 메시지, 문서의 언어는 별개이므로 Claude가 추측하지 않게 분명히 적습니다.

- 답변은 한국어로 한다.
- 코드 주석은 영어로 쓴다.
- Git 커밋 메시지는 한국어로, "유형: 요약" 형식으로 쓴다.

이 표현은 저희의 제안이며, 구체적이고 확인 가능한 지침을 쓰라는 Anthropic의 조언을 따른 것입니다. 짧은 항목으로 나누면 긴 문단보다 지켜지기 쉽고, Anthropic도 제목과 글머리 기호로 구조를 잡으라고 권합니다.

적용됐는지 확인하기

  1. 파일을 수정한 뒤 새 세션을 열고 /context all을 실행합니다. Memory files 목록에 CLAUDE.md가 있는지 봅니다.
  2. /memory를 실행합니다. 사용자와 프로젝트 범위의 CLAUDE.md, CLAUDE.local.md 등의 위치가 나열되고, 선택한 파일을 열 수 있습니다.
  3. 영어로 간단한 질문을 하고 한국어로 답하는지 확인합니다.

강제가 아니라 지침일 뿐

Anthropic에 따르면 CLAUDE.md 내용은 시스템 프롬프트 뒤에 사용자 메시지로 전달됩니다. Claude는 이를 읽고 따르려고 하지만, 특히 모호하거나 서로 충돌하는 지침에서는 엄격한 준수가 보장되지 않습니다. 그래서 다음을 지킵니다.

CoreCode를 거쳐도 설정은 같습니다

language와 CLAUDE.md는 모두 Claude Code 클라이언트 쪽 설정이며, 내 컴퓨터와 저장소에 있습니다. CoreCode에 연결해도 바뀌는 것은 요청을 보내는 주소뿐이므로, 이 파일들은 평소처럼 읽히고 작성법도 직접 연결할 때와 같습니다. 연결 방법은 Claude Code 연결 가이드, CLAUDE.md 작성법 전체는 CLAUDE.md 작성법을 참고하세요.

FAQ

Claude Code가 한국어로 답변하게 하는 설정이 있나요?

있습니다. Settings reference의 language 키로 영어가 아닌 언어로 답변하게 할 수 있습니다. 값은 언어 이름이며 어느 설정 파일에나 쓸 수 있습니다. 코드 주석 언어 같은 세부 규칙은 CLAUDE.md에 적습니다.

~/.claude/CLAUDE.md와 프로젝트의 CLAUDE.md 중 어디에 적나요?

개인 언어 설정은 모든 프로젝트에 적용되는 ~/.claude/CLAUDE.md에 적습니다. 팀 공통 규칙은 프로젝트의 ./CLAUDE.md에 적습니다. 나만의 프로젝트 설정은 ./CLAUDE.local.md에 적고 .gitignore에 추가합니다.

설정했는데도 영어로 답합니다. 어떻게 하나요?

/context all로 파일이 로드됐는지 확인하고, 충돌하는 지침이 없는지 살펴봅니다. CLAUDE.md는 강제 설정이 아니며, 구체적으로 쓸수록 더 잘 지켜집니다.

출처