taekchef/claude-code-zh-cn

해결하는 문제

터미널 기반의 AI 프로그래밍 보조 도구인 Claude Code는 기본적으로 간체중국어 인터페이스를 제공하지 않습니다. 이 프로젝트는 터미널 UI, 대기 프롬프트, 시스템 알림, 기본 AI 응답을 간체중국어로 번역하는 포괄적인 로컬라이제이션 플러그인을 제공하여 중국어 사용 개발자들이 더 쉽게 사용할 수 있도록 합니다.

작동 방식

공식적인 i18n 인프라 없이 로컬라이제이션을 구현하기 위해 4계층 아키텍처를 사용합니다:

1. 설정 주입: language, spinnerTipsOverride, spinnerVerbs 를 설정 파일에 주입하여 AI 응답과 스피너 텍스트를 변경합니다.
2. 훅 시스템: SessionStart 및 Notification 훅을 사용하여 중국어 컨텍스트를 삽입하고 시스템 알림을 번역합니다.
3. 플러그인 시스템: 표준 Claude Code 플러그인을 구현하여 중국어 출력 스타일을 제공합니다.
4. CLI 패치: Node.js 기반의 문자열 리터럴 스캐너를 사용하여 cli.js 파일 또는 네이티브 바이너리 내의 하드코딩된 UI 문자열을 찾아 교체합니다. 원본 파일을 자동 백업하고 시작 시 자기 검사를 수행하여 패치 실패 시에도 CLI가 정상 작동하도록 보장하는 안전 메커니즘을 포함합니다.

대상 사용자

간체중국어 인터페이스와 경험을 선호하는 Claude Code 사용자.

주요 특징

• 광범위한 번역: 2,065개의 UI 문자열, 187개의 독특한 스피너 동사, 41개의 스피너 팁을 커버합니다.
• 크로스플랫폼 지원: macOS, Linux, Windows(Windows PowerShell 또는 WSL을 통해)에서 작동합니다.
• 안전성 우선: 원본 파일을 자동 백업하고 패치 또는 자기 검사 실패 시 복원합니다.
• 자동 업데이트: Claude Code의 버전 변경을 감지하고 UI를 자동으로 재패치하려고 시도합니다.
• 스킬 로컬라이제이션: 설치된 스킬 및 플러그인 명령어 설명을 번역하는 옵션 기능입니다.