v0.1.0

첫 릴리스입니다. Claude가 도구 호출의 한글, 일본어, 중국어를 \uXXXX 이스케이프로 쓰다가 엉뚱한 글자로 바꾸는 문제를 막는 Claude Code 플러그인입니다. anthropics/claude-code#83033의 우회책입니다.

기능

• 세션이 시작될 때(startup, resume, clear, compact) SessionStart 훅이 Claude에게 도구 호출의 비ASCII 문자를 \uXXXX가 아니라 UTF-8 글자 그대로 쓰라고 알립니다. #83033에서 효과가 확인된 우회법입니다.
• 도구를 호출하기 전마다 PreToolUse 훅이 입력을 검사하고, 깨져 보이면 그 호출을 한 번 멈추고 어떤 글자가 어디 있는지 Claude에게 알려 줍니다. 같은 호출을 그대로 다시 보내면 통과하므로 작업이 막히지 않습니다.
  • KS X 1001 2,350자 밖의 한글 음절(완료 → 완릷, 코딩 → 코딅)
  • 가나가 섞인 문장에서 JIS X 0208 6,355자 밖의 한자(揃え → 諿え, 側 → 侧, #54051)
  • 짝 없는 서로게이트, U+FFFD, 코드가 아닌 곳에 텍스트로 남은 한글·가나·한자 이스케이프
• 하루에 한 번 백그라운드에서 #83033의 상태를 확인하고, 고쳐진 것(completed)으로 닫히면 세션을 시작할 때 플러그인을 꺼도 된다고 알려 줍니다.
• /config에서 "Notify when fixed upstream", "Check Korean syllables", "Check Japanese kanji"를 각각 끌 수 있습니다.
• 흔한 글자로 바뀐 경우(잡히지 → 잡힐지, 鳴る → 鳥る)와 중국어 문장의 틀린 한자는 잡지 못합니다. 이런 경우는 세션 시작 지시로만 예방합니다.
• Ubuntu, Windows, macOS CI에서 Node 18과 24로 테스트하고, tsc로 JSDoc 타입을 엄격하게 검사하고, 실제 Claude Code로 SessionStart 훅이 도는지 확인합니다. 매일 최신 Claude Code로 돌며 upstream 이슈의 상태도 보고합니다.
• 한국어, English, 日本語 소개 페이지: https://m1nu0x0.github.io/claude-utf8-guard/

설치

/plugin install utf8-guard --marketplace M1nu0x0/claude-utf8-guard

PATH에 Node.js 18 이상이 있어야 합니다. 새 세션부터 적용됩니다.

README: 한국어 | English | 日本語