클로드 코드를 처음 설치하면 영어로만 답하는데, CLAUDE.md에 한 줄 추가했더니 그 이후로는 항상 한국어로 답변이 나왔습니다. 어느 파일에 넣느냐에 따라 적용 범위가 달라지니 아래에서 상황에 맞는 방법을 바로 확인하세요.
📁 CLAUDE.md 파일 위치 4종과 우선순위
클로드 코드는 세션을 시작할 때 여러 위치의 CLAUDE.md를 자동으로 읽어 들입니다. 어디에 파일을 두느냐에 따라 한국어 규칙이 적용되는 범위가 달라집니다.
| 파일 위치 | 적용 범위 | macOS / Windows 경로 |
|---|---|---|
| 관리형 (Managed) | 모든 사용자·모든 프로젝트 | macOS: /Library/Application Support/ClaudeCode/CLAUDE.mdWindows: C:\Program Files\ClaudeCode\CLAUDE.md |
| 사용자 전체 | 내 모든 프로젝트 | ~/.claude/CLAUDE.md |
| 프로젝트 | 해당 프로젝트만 | ./CLAUDE.md 또는 ./.claude/CLAUDE.md |
| 로컬 (비공유) | 해당 프로젝트, git 미포함 | ./CLAUDE.local.md |
개인 장비에서 모든 프로젝트에 한국어 설정을 적용하려면 사용자 전체 파일인 ~/.claude/CLAUDE.md에 넣는 것이 가장 간단합니다. 팀 프로젝트에서 레포에 한국어 규칙을 올리고 싶지 않다면 ./CLAUDE.local.md에 넣으면 git에 올라가지 않아 나만 적용됩니다. 팀 전체에 한국어 설정을 강제하고 싶다면 ./CLAUDE.md나 ./.claude/CLAUDE.md에 넣고 레포에 커밋하면 됩니다.
✍️ 한국어 설정 규칙 추가하는 방법
CLAUDE.md 파일에 아래 문장 중 하나를 추가하면 됩니다. 문장 위치는 파일 맨 위나 맨 아래 어느 곳이든 상관없습니다.
기본 설정 (가장 단순한 방법)
CLAUDE.md 파일을 열고 아래 한 줄을 추가합니다.
항상 한국어로 답변해 주세요.이것만으로도 대부분의 경우 충분히 동작합니다. 더 강하게 적용하고 싶다면 아래처럼 범위를 명시합니다.
모든 설명과 답변은 한국어로 작성해 주세요. 코드 주석도 한국어로 작성하세요./memory 커맨드로 파일 열기
파일 경로를 찾아 직접 편집하기 번거롭다면 클로드 코드 세션 안에서 /memory를 입력하면 됩니다. CLAUDE.md 파일 목록이 나타나고, 선택하면 바로 편집 화면으로 이동합니다. 저장 후 다음 턴부터 즉시 적용됩니다. 재시작은 필요 없습니다.
/init 실행 후 규칙 추가
아직 CLAUDE.md가 없는 새 프로젝트라면 /init을 먼저 실행하세요. 클로드가 프로젝트를 분석해 CLAUDE.md 초안을 만들어 줍니다. 생성된 파일을 /memory로 열어 한국어 규칙 한 줄을 추가하면 프로젝트 설명과 언어 설정이 함께 담긴 파일이 완성됩니다.
⚙️ CLI 옵션으로 세션에 즉시 적용하기
CLAUDE.md를 수정하지 않고 한 번만 한국어로 세션을 시작하고 싶다면 CLI 플래그를 씁니다.
claude --append-system-prompt "항상 한국어로 답변해 주세요."이 플래그는 해당 세션에서만 유효하고 파일에는 저장되지 않습니다. 세션이 끝나면 설정도 사라집니다. 특정 세션 한 번만 한국어로 쓰고 싶을 때나, 다른 언어가 기본인 환경에서 임시로 전환할 때 유용합니다. 영구 적용이 필요하다면 파일에 넣는 것이 훨씬 편리합니다.
CI 환경이나 스크립트에서 클로드 코드를 비대화형으로 실행할 때도 동일한 플래그를 씁니다. 예를 들어 GitHub Actions 워크플로에서 claude -p "코드를 리뷰해줘" --append-system-prompt "한국어로 답변해 주세요"처럼 조합할 수 있습니다.
🧠 auto-memory와 rules 디렉토리 활용
CLAUDE.md 한 파일에 모든 규칙을 넣다 보면 나중에 파일이 지저분해집니다. 클로드 코드는 규칙을 모듈화할 수 있는 두 가지 방법을 추가로 제공합니다.
rules 디렉토리로 규칙 분리하기
~/.claude/rules/ 디렉토리에 파일을 넣으면 클로드가 자동으로 읽어 들입니다. 예를 들어 언어 규칙만 따로 파일로 분리하면 관리가 훨씬 깔끔해집니다.
~/.claude/rules/language.md
# 언어 설정
항상 한국어로 답변해 주세요.
코드 내 주석은 한국어로 작성하세요.이렇게 나누면 언어 규칙, 코딩 스타일 규칙, 보안 규칙을 각각 별도 파일로 관리할 수 있습니다. 팀 환경에서 규칙을 조합·교체할 때 특히 편리합니다.
auto-memory 기능
auto-memory는 클로드가 대화 중 스스로 중요한 정보를 노트해두는 기능입니다. 활성화하면 클로드가 ~/.claude/projects/<project>/memory/ 경로에 자동으로 메모를 기록합니다. 예를 들어 "이 프로젝트는 항상 한국어로 답해야 한다"는 것을 대화 중에 언급하면 클로드가 스스로 노트에 기록하고, 다음 세션에서도 기억합니다.
/memory 커맨드를 실행하면 auto-memory 토글이 나타납니다. 자동 기록이 잘못된 방향으로 누적되지 않도록, 처음에는 끄고 CLAUDE.md에 직접 규칙을 관리한 뒤 필요해지면 켜는 방법을 권장합니다. auto-memory 항목은 /memory 안에서 수동으로 삭제하거나 편집할 수 있습니다.
❓ 자주 묻는 질문 (FAQ)
Q. 한국어 설정을 넣었는데 영어로 답변이 나옵니다. 어떻게 하나요?
파일 위치를 먼저 확인하세요. 프로젝트 디렉토리의 CLAUDE.md에 넣었다면 그 프로젝트 안에서만 적용됩니다. 모든 프로젝트에서 한국어로 답받으려면 ~/.claude/CLAUDE.md에 규칙을 추가해야 합니다. 파일을 저장한 뒤 새 턴을 시작하면 바로 적용됩니다.
Q. 코드 변수명·함수명도 한국어로 만들어 줄 수 있나요?
코드 설명은 한국어로 하되 변수명·함수명은 영어로 유지하도록 규칙을 세분화할 수 있습니다. CLAUDE.md에 "모든 답변과 주석은 한국어로 작성하되, 코드 식별자(변수명, 함수명, 클래스명)는 영어로 유지해 주세요."처럼 구체적으로 지시하면 됩니다.
Q. CLAUDE.md 파일이 없는 경우 어떻게 만드나요?
가장 간단한 방법은 세션 안에서 /init을 실행하는 것입니다. 클로드가 프로젝트 분석 후 CLAUDE.md를 자동 생성합니다. 직접 만들고 싶다면 해당 경로에 파일을 새로 생성하고 내용을 입력하면 됩니다. 특별한 형식은 없으며 일반 마크다운 텍스트로 작성합니다.
Q. CLAUDE.local.md는 CLAUDE.md와 어떻게 다른가요?
CLAUDE.local.md는 git에 커밋되지 않는 로컬 전용 파일입니다. 팀이 공유하는 CLAUDE.md에는 공통 규칙을 넣고, 내 개인 언어 선호나 작업 스타일은 CLAUDE.local.md에 따로 관리할 수 있습니다. 두 파일이 모두 있으면 클로드가 양쪽을 다 읽습니다.
Q. 한국어 규칙을 넣으면 영어 입력에도 한국어로 답하나요?
네, CLAUDE.md에 한국어 규칙이 있으면 영어로 질문해도 한국어로 답변합니다. 다만 "이번 답변은 영어로 해줘"처럼 대화 중에 지시하면 그 턴에 한해 영어로 답합니다. CLAUDE.md 규칙보다 대화 중 직접 지시가 우선 적용됩니다.
한국어 설정에서 가장 중요한 것은 파일 위치입니다. 모든 프로젝트에 적용하려면 ~/.claude/CLAUDE.md, 특정 프로젝트에만 적용하려면 프로젝트 루트의 CLAUDE.md나 CLAUDE.local.md를 씁니다. 규칙 문장은 한 줄이면 충분하고, 저장 후 다음 턴부터 즉시 반영됩니다.
