클로드 코드 한글 설정, 영어 답변과 한글 깨짐 해결 순서

영어로 답하는 문제는 답변 언어 설정부터, 타이핑 중 한글이 씹히는 문제는 입력 환경부터 확인합니다. 물음표·네모로 표시되는 문제는 인코딩과 글꼴도 살펴야 합니다. "language": "korean"을 넣는 것만으로 세 증상이 모두 해결되지는 않습니다.

지금 보이는 증상	먼저 확인할 것
질문은 한글인데 답변이 영어	답변 언어와 설정 우선순위
타이핑 중 글자가 빠지거나 조합 위치가 이상함	업데이트·입력기·터미널을 나눠 확인
완성된 글자도 물음표나 네모로 표시	출력 인코딩·글꼴 확인

설치한 프로그램이 실행되지 않는 단계라면 클로드 코드 설치 오류부터 확인하세요. 이 글은 Claude Code가 실행되는 상태에서의 언어·입력 문제를 다룹니다.

웹 채팅을 쓰고 있다면 언어 메뉴부터 확인하세요

브라우저에서 Claude 웹 채팅을 쓰는 경우와, 터미널에서 Claude Code를 실행하는 경우는 설정 위치가 다릅니다. 터미널은 명령어를 입력하는 프로그램입니다. 일반 웹 채팅 화면의 메뉴를 한국어로 바꾸려면 아래 순서부터 따라 하세요.

1. Claude 웹사이트에 로그인합니다.
2. 화면 왼쪽 아래의 프로필 아이콘을 누르고 Language(언어) 항목을 찾습니다.
3. 한국어를 선택한 뒤 화면의 메뉴가 한국어로 바뀌는지 확인합니다.

메뉴 언어와 대화 언어는 별개입니다. 메뉴가 영어여도 채팅 입력칸에 “한국어로 답해줘”라고 요청할 수 있습니다. 아래에서 설명하는 settings.json 편집은 Claude Code 설정입니다. 일반 웹 채팅 입력칸에 설정 코드를 붙여넣는 절차가 아닙니다.

웹 화면 경로는 Claude 공식 언어 설정 안내를 기준으로 확인했습니다. Language 항목이 보이지 않으면 현재 화면이 일반 채팅인지, Claude Code 작업 화면인지 먼저 확인하세요.

클로드 코드 답변을 한국어로 설정하기

언어를 지정하는 공식 설정은 language입니다. 내 모든 프로젝트에 적용하려면 ~/.claude/settings.json, 한 프로젝트에서 나만 사용하려면 프로젝트 안의 .claude/settings.local.json을 사용합니다. 팀원과 함께 적용할 설정은 .claude/settings.json에 둡니다.

macOS에서는 Finder의 이동 → 폴더로 이동에 ~/.claude를 입력해 폴더를 찾을 수 있습니다. Claude Code 안에서 /config로 설정 화면을 여는 방법도 있습니다.

파일이 새로 만든 빈 설정 파일일 때의 전체 내용은 다음과 같습니다.

{
  "language": "korean"
}

이미 내용이 있다면 위 코드로 파일 전체를 덮어쓰지 마세요. 기존 권한·도구 설정은 유지하고, 가장 바깥쪽 중괄호 안에 "language": "korean" 항목만 추가하거나 기존 language 값을 바꿉니다. 앞 항목과 쉼표로 구분하며 같은 키를 두 번 쓰지 않습니다.

직접 편집이 어렵다면 아래처럼 요청할 수 있습니다. 개인 설정을 바꾸는 요청이므로 회사나 팀이 관리하는 설정에는 적용하지 않습니다.

내 사용자 설정 ~/.claude/settings.json을 먼저 백업해줘.
기존 권한과 다른 설정은 유지하고 language만 korean으로 바꿔줘.
이미 language가 있으면 수정하고, JSON 문법이 맞는지 확인해줘.
API 키나 토큰 값은 답변에 출력하지 마.

설정이 적용됐는지 확인하는 방법

저장한 다음 What can you help me with?처럼 영어 질문을 보내 보세요. 한국어 답변이 나오는지 확인하면 됩니다. 아래는 기존에 같은 질문으로 확인한 설정 전후 화면입니다.

설정 파일 변경은 대부분 실행 중인 세션에도 반영됩니다. 계속 영어로 답하면 파일 저장·JSON 문법을 확인하고, 프로젝트의 .claude/settings.local.json이나 .claude/settings.json에 다른 언어가 지정돼 있는지 살펴보세요. 사용자 설정보다 프로젝트 설정이 우선하며, 조직 관리 설정이 있으면 그 정책이 우선할 수 있습니다.

language는 답변 언어 지시, 자동 생성 세션 제목, 지원되는 음성 받아쓰기 언어에 사용됩니다. 메뉴·진행 안내까지 모두 한국어로 바꾸는 설정은 아닙니다. CLAUDE.md에 “한국어로 답해줘”라고 쓰는 방법도 있지만, 기본 언어는 language에 두고 문서에는 프로젝트 작업 규칙을 두면 역할이 분명해집니다.

한글 입력이 씹히거나 조합 위치가 어긋날 때

한글은 자음·모음을 조합하는 과정이 있어 입력기와 터미널의 화면 처리 방식에 영향을 받습니다. 같은 증상이라도 버전·운영체제·터미널에 따라 원인이 다를 수 있으므로 “이미 고쳐진 버그”라고 단정하지 않습니다.

1. 사용 환경을 기록합니다. Claude Code 밖의 터미널에서 claude --version으로 버전을 확인하고 운영체제·터미널 이름을 함께 적습니다.
2. 설치 방식에 맞게 업데이트합니다. 기본 설치본은 claude update 안내를 확인합니다. Homebrew 등으로 설치했다면 해당 설치 방식의 업데이트 절차를 따릅니다.
3. 짧은 한글과 붙여넣기를 비교합니다. 예를 들어 “가나다 테스트”를 직접 입력한 경우와 메모장에서 복사한 경우를 비교합니다. 붙여넣기만 정상이라면 조합 입력 문제를 의심할 단서가 됩니다.
4. 계속 막히면 입력 화면을 바꿔 비교합니다. 긴 문장은 메모장에서 작성해 붙여넣거나, 데스크톱 Code 탭에서 같은 문장을 입력해 봅니다. 화면을 바꾸면 반드시 해결된다는 뜻은 아닙니다.

CLAUDE_CODE_NO_FLICKER=1은 공식 문서상 전체 화면 렌더링을 선택하는 실험 기능입니다. 한글 오류를 고치는 전용 설정은 아니므로 첫 해결책으로 권하지 않습니다. 시험한다면 원래 화면에서의 결과와 비교하고, 입력이 더 불편해지면 원래 설정으로 돌아갑니다.

윈도우에서 한글이 물음표나 네모로 깨질 때

물음표와 네모는 원인이 같다고 단정할 수 없습니다. 문자 인코딩이 맞지 않거나 글꼴에 해당 글자가 없을 수 있습니다. 같은 터미널의 다른 프로그램에서도 깨지는지, 다른 터미널에서는 같은 글자가 보이는지 비교하세요.

명령 프롬프트(cmd)를 사용 중이라면 현재 코드 페이지를 확인한 뒤 UTF-8로 바꿔 시험할 수 있습니다.

chcp
chcp 65001

변경 뒤 Claude Code를 다시 실행해 결과를 비교합니다. chcp는 현재 콘솔의 코드 페이지를 바꾸며, 이미 실행 중인 프로그램에 새 설정이 소급 적용되는 것은 아닙니다. 이미 손상돼 저장된 파일의 글자를 복구하는 명령도 아닙니다.

Windows Terminal은 cmd·PowerShell 등을 띄우는 앱입니다. 앱만 바꾼다고 그 안의 모든 프로그램과 파일이 자동으로 UTF-8이 되는 것은 아닙니다. PowerShell 버전과 파일을 읽고 쓰는 프로그램의 인코딩도 따로 확인해야 합니다. 글자가 네모로만 보이면 한글을 지원하는 글꼴도 비교해 보세요.

여전히 해결되지 않을 때 전달할 정보

설치 상태는 터미널의 claude doctor로 확인할 수 있습니다. 입력 문제를 도움받을 때는 버전·운영체제·터미널 이름, 직접 입력과 붙여넣기의 차이, 짧은 재현 문장을 함께 전달하세요. 캡처에는 API 키·토큰·개인정보가 보이지 않게 합니다. 오류 내용과 화면을 전달하는 예시도 참고할 수 있습니다.

자주 묻는 질문

Claude Code CLI에서 설정했는데 메뉴는 영어로 남아 있어도 되나요?

네. 답변을 한국어로 받는 설정과 프로그램 화면 전체의 번역은 구분해야 합니다. 질문에 대한 답변으로 적용 여부를 확인하세요.

한 프로젝트에서만 다시 영어로 답하면 무엇을 보나요?

해당 프로젝트의 settings.local.json과 settings.json에 언어 설정이 있는지 확인하세요. 사용자 설정과 다른 우선순위의 파일이 적용되고 있을 수 있습니다.

한국어로 질문하고 답을 받을 수 있게 됐다면 체크리스트를 만들고 한 가지 기능을 수정하는 첫 실습으로 이어갈 수 있습니다. 설치부터 전체 순서는 클로드 코드 시작 가이드에서 확인하세요.

검증 기준

• 마지막 업데이트일: 2026-09-09
• 확인 환경: macOS의 Claude Code CLI 2.1.263 확인, 공식 설정·환경 변수·Microsoft 인코딩 문서 대조. 기존 언어 설정 전후 캡처 2장은 유지했습니다. 모든 터미널의 조합 오류와 Windows 인코딩 문제를 이번에 재현한 것은 아닙니다.
• 주요 근거: language 설정 · 설정 파일과 우선순위 · 화면 관련 환경 변수 · Windows chcp · PowerShell 문자 인코딩