Claude Code의 히브리어 및 아랍어 렌더링 문제를 해결한 Kivun 터미널 공개

실용적 조언

히브리어나 아랍어 사용자는 Konsole 터미널을 설치하고 프로필 설정에서 BidiLineLTR=false를 적용하여 Claude Code를 사용하라.
Windows 환경에서 설정이 복잡하다면 공개된 Kivun 터미널 설치 프로그램을 사용하여 WSL2 기반의 최적화된 환경을 즉시 구축할 수 있다.

섹션별 상세

Claude Code가 모든 응답 앞에 불렛 기호(●)를 붙이면서 유니코드 양방향 알고리즘(UAX #9)의 방향 감지 로직이 오작동하는 문제가 발생했다. 대부분의 터미널은 첫 번째 문자인 불렛을 보고 텍스트 방향을 LTR(왼쪽에서 오른쪽)로 고정해버려 히브리어나 아랍어 문장이 뒤섞이게 된다. 작성자는 이를 해결하기 위해 중립 문자를 건너뛰고 실제 문자에서 방향을 감지하는 메커니즘이 필요함을 기술적으로 분석했다.

Konsole 터미널의 숨겨진 설정인 'BidiLineLTR=false'를 적용하여 각 라인별로 방향을 자동 감지하도록 구성했다. 기본값인 true 상태에서는 글자 순서만 바뀔 뿐 라인 정렬은 여전히 왼쪽에 고정되어 가독성이 떨어지지만, 이 설정을 변경하면 히브리어 라인은 우측 정렬로, 영어 라인은 좌측 정렬로 올바르게 렌더링된다. 현재까지 이 규칙을 정확히 준수하여 RTL 언어를 처리하는 터미널 조합은 이것이 유일하다는 점이 확인됐다.

Windows 사용자를 위해 WSL2, Ubuntu, Konsole, Claude Code를 하나의 패키지로 묶은 설치 프로그램을 배포했다. WSLg의 Wayland 소켓 인식 오류나 Qt 런타임 디렉토리 권한 문제(0777을 0700으로 수정) 등 리눅스 환경을 윈도우에서 구동할 때 발생하는 기술적 결함들을 사전에 수정하여 안정성을 높였다. 또한 Alt+Shift 키보드 전환이 전달되지 않는 문제를 해결하기 위해 VcXsrv를 선택적 폴백으로 포함했다.

Claude Code 자체의 소스코드를 수정하는 대신 터미널 환경을 최적화하는 방식을 선택했다. cli.js 파일에서 불렛 기호를 제거하는 패치가 가능하지만, npm 패키지의 서명을 수정할 경우 Windows SmartScreen 등 보안 시스템에서 차단될 위험이 크기 때문이다. 대신 Anthropic 측에 RLM(Right-to-Left Mark) 접두사를 활용해 시각적 불렛은 유지하면서 방향성만 교정하는 방식의 수정안을 공식 제안한 상태이다.

용어 해설

양방향 텍스트(BiDi): — 왼쪽에서 오른쪽으로 읽는 언어(LTR)와 오른쪽에서 왼쪽으로 읽는 언어(RTL)가 혼용된 텍스트를 처리하는 알고리즘이다. 히브리어나 아랍어처럼 방향이 다른 문자가 섞일 때 글자 순서와 정렬을 올바르게 렌더링하는 데 필수적이다.
유니코드 양방향 알고리즘(UAX #9): — 유니코드 표준에서 정의한 텍스트 렌더링 규칙으로, 문자의 논리적 순서를 시각적 순서로 변환하는 메커니즘을 규정한다. 특히 중립적인 문자가 앞에 올 때 텍스트의 방향성을 어떻게 결정할지에 대한 세부 규칙을 포함한다.
WSL 그래픽 지원(WSLg): — Windows Subsystem for Linux에서 GUI 애플리케이션을 실행할 수 있게 해주는 기능이다. Wayland 서버를 통해 리눅스용 터미널이나 에디터를 윈도우 환경에서 네이티브 앱처럼 실행할 수 있게 돕는다.

언급된 도구

Konsole추천

KDE 데스크탑 환경의 기본 터미널로, 고급 BiDi 렌더링 설정을 지원한다.

Kivun Terminal추천

RTL 언어 환경에 최적화된 Claude Code 전용 터미널 패키지이다.

언급된 리소스

GitHubKivun Terminal GitHub Repository

문서Claude Code BiDi Issue Report