한국어로 다시 말하겠다는 사과를 영어로 하는 에이전트, 훅 두 개로 달래기

settings.json에 "language": "Korean"을 넣고, CLAUDE.md 첫머리에도 "모든 메시지는 한국어로"라고 적어 두었습니다. 그런데 Claude Code가 작업을 길게 이어 가다 보면 도구 호출 사이의 짧은 진행 안내가 어느새 영어로 바뀌어 있습니다. 지적하면 한 턴 정도는 한국어로 돌아오다가 다시 영어가 나옵니다.

이 증상을 막는 훅을 만들던 날, 그 세션에서 실제로 오간 문장 몇 개를 시간순으로 옮깁니다.

죄송합니다. 영어로 바뀌는 이유를 설명하는 답변까지 영어로 썼습니다. 그 자체가 제가 설명하려던 현상의 증거입니다.

Sorry. My previous answer about whether the rule is in CLAUDE.md came out in English again, so I'll repeat it here in Korean.

죄송합니다. 방금 메시지도 "한국어로 다시 전달하겠다"고 쓰면서 본문 전체를 영어로 썼습니다.

Writing in English again and again made you miss part of the process. Here is everything again, in Korean.

마지막 문장 뒤에는 한국어가 나오지 않았습니다. 영어 문단이 이어졌습니다. (끝내 이기지 못한 지킬 박사..) 공손한 지킬 박사가 사과를 하고, 도구 결과를 하나 읽고 나면 하이드가 나와서 "Here is everything again, in Korean"이라고 영어로 말합니다. 그날 저녁 그 세션에서 에이전트가 쓴 텍스트 블록 69개 중 59개가 영어였습니다.

이 글은 이 증상이 언제 나타나는지, 다른 사용자들이 찾아낸 두 가지 처방이 무엇인지, 그 처방을 묶은 플러그인을 하루 동안 써 보니 수치가 어떻게 바뀌었는지를 정리합니다.

나만 겪는 일이 아니었습니다

anthropics/claude-code#96326은 2026년 9월 23일에 일본어 사용자가 올린 이슈입니다. CLAUDE.md와 언어 설정 모두 일본어를 요구했는데, 영어로 된 명세서나 서브에이전트 보고, 코드 리뷰 결과를 읽은 직후의 답변이 영어로 나왔다는 내용입니다. 이후 히브리어, 이탈리아어, 한국어, 번체 중국어, 독일어, 러시아어, 페르시아어 사용자가 같은 증상과 각자의 측정치를 댓글로 남겼습니다.

저도 Opus로 작업을 하다가 "한국어로 답해"를 두 번 연속으로 하고 나서야 "뭔가 이상한데?" 생각했습니다. settings.json 파일의 "language" 값을 좀 특이하게 쓰고 있었는데, "language": "Conversations are in Korean, while coding and documentation work is done in English." 이렇게 쓰고 있었거든요. 대화는 한국어로 하고, 코딩이랑 문서 작업은 영어로 하라고요. 지금까지 아무 문제 없었는데, Opus도 처음에는 "이 설정이 기대하는 값은 Korean, English 같은 <언어>인데, 문장으로 쓰셔서 그런 것 아닐까요?"라고 피드백해 줬습니다. 가이드를 찾아보니 그렇게 쓰는 것 같긴 하더라고요. 그래서 Claude Code의 하네스 프롬프트에 저걸 Always Answer in ${{settings.language}} 이런 식으로 자리표시자로 쓰고 있는 건가? 의심도 했습니다. 그래서 저의 문장형 값이 들어가면 깨진 문장이 되면서 효과가 떨어진 게 아닐까 하고요. 그런데 Opus 5.5 이전까지는 없던 문제이긴 했으니까, "Korean"으로 고치면서 Claude 쪽 상류 이슈도 찾아보고 답변하라고 했습니다. 그래서 이 이슈를 알게 된 거죠. 그래서 같이 제 환경에서 설정은 그대로 두고 모델만 바꿔 가며 비교했습니다. 1,840개 턴을 세어 보니 Opus 5.5는 턴의 9.4%를 영어로 끝냈고, Opus 5와 Fable 5.1은 0.6%였습니다. 같은 지시문에서 모델만 바꿨을 때 이 정도로 차이가 났습니다. 저도 스레드에 코멘트를 남겼습니다.

하이드는 도구 결과를 읽은 뒤에 나옵니다

스레드에 모인 데이터는 영어가 나오는 위치를 꽤 구체적으로 보여 줍니다. @jelitz가 한 달 동안 한국어 환경에서 집계한 결과는 다음과 같습니다.

  • 사용자의 한국어 프롬프트 직후, 첫 도구 호출 전에 쓴 텍스트는 2.5%만 영어였습니다.
  • 도구 결과를 한 번이라도 읽은 뒤의 진행 안내는 약 20%가 영어였고, 턴이 길어져도 그 수준에 머물렀습니다.
  • 턴의 최종 답변은 다시 2.8%로 내려갔습니다.

결국 사용자가 보는 진행 안내 다섯 줄 중 한 줄쯤이 영어라는 뜻입니다. 특히 서브에이전트의 영어 보고를 받은 직후나, 에이전트가 방금 영어로 서브에이전트 브리프를 써 보낸 직후에 자주 나타났습니다. 맨 위에 옮긴 세 번째 사과문에서 에이전트 스스로도, 직전의 영어 메시지가 영어 서브에이전트 보고를 받은 직후에 나왔다고 짚었습니다.

CLAUDE.md에 규칙을 더 세게 적는 방법은 별로 효과가 없었다고 합니다. 제 규칙에는 날짜와 측정치까지 붙어 있었지만, 위의 장면은 그 규칙이 로드된 세션에서 일어났습니다. (muse가 중국어 쓸 때만큼 무서웠어요)

스레드에서 나온 처방 두 가지

1. 영어를 "누가 읽는가"로 정의합니다

@murooka-t는 문제가 된 장면을 실제 transcript에서 100번씩 다시 생성하면서 규칙 문장만 바꿔 비교했습니다. 원래 규칙은 "코드, 로그, 위임 브리프 등은 영어여도 된다"는 식으로 허용 목록을 나열하고 있었고, 이 조건에서 100번 중 15번이 영어로 나왔습니다. "방금 읽은 것이 영어여도 언어를 바꾸지 말라"는 문장을 덧붙이자 오히려 19번으로 늘었습니다. 반면 허용 목록을 "영어는 사용자가 아닌 독자가 읽는 것(서브에이전트 브리프, 코드, 식별자, 커밋, 저장하는 파일)과 원문 인용에만 쓴다"로 바꾸자 1번으로 줄었습니다.

해석은 이렇습니다. 에이전트가 "브리프는 영어로 써도 된다"는 허용을 받아 영어 브리프를 쓰고 나면, 그 모드가 다음 줄의 사용자 안내까지 이어진다는 것입니다. @murooka-t는 이 문장을 UserPromptSubmit과 PostToolUse 훅으로 반복해서 주입하는 방식도 함께 제안했습니다.

2. 턴이 끝날 때 검사하고 다시 쓰게 합니다

@TipsyDrifter는 Stop 훅에서 이번 응답의 텍스트를 검사해, 대부분 영어라면 같은 내용을 다시 쓰게 하는 아이디어를 기존 transcript에 재생해 검증했습니다. @SinaEstavi는 이를 페르시아어 환경에서 실제로 운용했고, 훅이 44번 차단했을 때 44번 모두 다음 텍스트가 페르시아어로 나왔다고 보고했습니다. 이 방식은 사용자가 이미 본 영어 초안을 지우지는 못합니다. 다만 사용자가 "한국어로 해 주세요"라고 다시 말하지 않아도 에이전트가 스스로 다시 쓰게 만듭니다.

두 처방을 플러그인 하나로 묶었습니다

훅은 누구나 직접 쓸 수 있습니다. 하지만 스레드의 마지막 요청이 "사용자마다 훅을 따로 쓰지 않아도 되게 해 달라"였습니다. 그래서 저는 나름의 처방으로 두 아이디어를 cc-agents-kit의 reply-language 플러그인으로 묶었습니다. 물론 저에게 해달라고 요청한 것은 아니지만요. 플러그인 목록과 설명은 skills.donminzzi.kr에서도 볼 수 있습니다.

/plugin marketplace add AndrewDongminYoo/cc-agents-kit
/plugin install reply-language@cc-agents-kit
  • 리마인더(UserPromptSubmit, PostToolUse): 사용자 메시지와 Agent, SendMessage 호출 직후에는 "누가 읽는가" 문장 전체를 넣습니다. 그 밖의 도구 결과 뒤에는 "사용자에게 보이는 다음 텍스트는 한국어로 씁니다"라는 한 줄을 넣습니다. @jelitz의 데이터대로 첫 도구 결과 이후부터 영어가 늘어나기 때문입니다.
  • 검사(Stop): 이번 응답에서 사용자에게 보인 텍스트, 또는 그 마지막 블록에서 한글 비율이 30% 미만이면 한 번 차단합니다. 그리고 새 도구 작업 없이 같은 내용을 한국어로 다시 쓰게 합니다. 코드 블록, 경로, URL, 인용문은 세지 않으므로 기술 용어가 섞인 한국어 답변은 통과합니다.

언어는 settings.json의 language 값에서 읽습니다. (CLAUDE.md에 쓴 값을 찾아오지는 않아요) 한국어 외에도 일본어, 중국어, 키릴 문자, 페르시아어, 아랍어, 히브리어, 힌디어, 태국어, 그리스어처럼 고유 문자를 쓰는 언어를 지원합니다. 라틴 문자를 쓰는 언어는 문자만으로 영어와 구분할 수 없어서 대상에서 제외했습니다. (뭔가 아이디어가 있다면 제보해 주세요!) 2026년 11월 11일 기준 버전(0.2.0)부터는 CC_REPLY_LANGUAGE_MODELS=opus-5-5처럼 지정해서, 영어가 새는 모델에서만 훅이 동작하게 할 수 있습니다.

하루 써 보니

훅을 게시, 설치하고 나서 체감상으로는 증상이 거의 멎었습니다. 효과가 바로 느껴지긴 했어요. 그런데 도구 호출 사이의 진행 안내는 제가 매번 지켜보는 메시지가 아니라서, 제가 부풀려서 느낀 것일 수도 있다고 생각했어요. 그래서 transcript를 다시 셌습니다. 기준은 Opus 5.5의 메인 스레드 텍스트 블록이고, 코드와 경로를 뺀 뒤 한글이 글자의 15% 미만이면 영어로 셌습니다. 설치 전은 10월 8일부터 11월 9일까지 136개 세션, 설치 후는 약 하루 동안 15개 세션입니다.

  • 도구 호출 사이의 진행 안내: 24.3% → 8.5%
  • 턴의 최종 답변: 7.1% → 0.0%
  • 전체 텍스트 블록: 15.8% → 4.1%
  • Stop 훅은 5번 차단했고, 5번 모두 다음 텍스트가 한국어였습니다.

검사 훅이 차단한 횟수는 5번뿐이었습니다. 따라서 최종 답변이 0%로 내려간 것은 대부분 리마인더의 효과로 보입니다. 두 기간 사이에 언어 설정, 출력 스타일, CLAUDE.md의 한국어 규칙은 바뀌지 않았습니다. 다만 하루치 관찰이고 작업 구성도 달랐으므로, "효과가 있다" 이상으로 해석하지는 않으려고 합니다.

체감과 달리 하이드가 완전히 사라지지는 않았습니다. 남아 있는 영어 진행 안내를 무작위로 12개 골라 보니 모두 실제 영어 문장이었고, "Gates pass. Committing as two concerns: …" 같은 한 줄 보고가 대부분이었습니다. 주로 영어 리뷰 결과를 계속 읽는 PR 작업 세션에서 나왔습니다.

그리고 좀 특이한 경험인데, 이 도구를 만들고 나서, Fable 5.2를 처음 사용해 보려고 하니까, 이 모델은 "자신에게는 해당되지 않는 사항"이라며 (Opus를 손절???) 플러그인 훅의 v2 버전을 직접 작성해줬습니다. 그래서 CC_REPLY_LANGUAGE_MODELS 변수 주입이 생긴 겁니다...:O

그러니까 얼른 Opus 5.6을 내놓든지 아니면 리셋권을 내놓든지 해주세요 앤트로픽!!!

한계, 그리고 이 플러그인의 수명

  • 진행 안내의 영어는 줄었을 뿐 없어지지 않았습니다.
  • Stop 훅은 이미 화면에 나온 영어 초안을 숨기지 못합니다.
  • 훅이 넣는 문장은 system 역할의 메시지로 전달되는데, @murooka-t의 측정에서는 이 경로가 도구 결과 안에 넣는 방식보다 약했습니다.

이 플러그인은 처음부터 임시 우회책으로 만들었습니다. 이슈가 고쳐지면 플러그인을 내릴 생각이고, README에도 그렇게 적어 두었습니다. language는 Claude Code 자체의 설정이므로, 영어가 새기 시작하는 지점에서 Claude Code가 그 값을 직접 다시 알려 주는 편이 맞습니다. 같은 내용을 이슈 댓글로도 남겼습니다.

그때까지는 하이드가 나오면 훅이 지킬을 다시 불러오게 해 두려고 합니다. 이 글의 초안 작업도 그 훅이 켜진 세션에서 진행했습니다.