[Workaround] Claude Code CLI 한글 입력 / Korean IME input on Windows 11 — winpty + Git Bash solution

Summary / 요약

We found a practical workaround for the Korean IME input issues on Windows 11 25H2 that significantly improves the experience. Sharing this here so Anthropic can promote it in the official docs or README until a proper fix lands.

Windows 11 25H2에서 한글 IME 입력 문제를 실질적으로 개선하는 방법을 찾았습니다. 정식 픽스 전까지 공식 문서나 README에 안내해 주시면 한국 사용자들에게 큰 도움이 될 것 같습니다.

Root Cause / 원인

React Ink repeatedly moves the terminal cursor via ANSI escape codes during rendering. On Windows 11 25H2, the Korean IME (TSF mode) tracks the physical cursor position aggressively, causing the composition window to jump and resulting in input errors (wrong composition, character swallowing, cursor misplacement).

React Ink이 렌더링 시마다 ANSI 이스케이프 코드로 커서를 이동시키고, Windows 11 25H2의 한국어 IME(TSF 방식)가 이를 민감하게 추적하여 조합 오류, 글자 씹힘, 커서 튀김 현상이 발생합니다.

Workaround / 해결 방법

Use Git Bash with winpty instead of Windows Terminal directly.

Git Bash + winpty 조합을 사용하세요.

1. Open Git Bash (comes with Git for Windows — no extra install needed)

Git Bash 실행 (Git for Windows 기본 포함 — 별도 설치 불필요)

1. Run winpty claude instead of claude

claude 대신 winpty claude 실행

1. Font: D2Coding recommended for proper Korean character spacing

폰트: 한글 자간을 위해 D2Coding 권장

Optional: Project-specific profiles in Windows Terminal / Windows Terminal 프로젝트별 프로필

{
    "commandline": "C:\Program Files\Git\bin\bash.exe -i -l -c 'winpty claude; exec bash'",
    "name": "My Project",
    "startingDirectory": "C:\path\to\project"
}

This opens Claude Code directly in the project folder and returns to bash after exiting.
프로젝트 폴더에서 Claude Code 자동 실행, 종료 후 bash로 복귀합니다.

Request to Anthropic / 요청사항

Please consider adding this workaround to the official documentation or README for Windows Korean users until the underlying React Ink / IME issue is resolved.

근본적인 React Ink / IME 문제가 해결될 때까지, 이 방법을 공식 문서나 README에 안내해 주시면 한국 사용자들에게 큰 도움이 될 것 같습니다.

Environment / 테스트 환경

• OS: Windows 11 25H2 (build 26200)
• Claude Code: v2.1.116
• Related issues: #16322, #35307, #38798, #47329