claude-code-kr 0.1.18 → 0.1.20

package/README.md

@@ -8,25 +8,57 @@ Claude Code 한글 패치 CLI
 
 ## 설치
 
+**nvm 사용 시** (대부분)
 ```bash
 npm i -g claude-code-kr
 ```
 
+**시스템 Node.js 사용 시** (sudo로 CC 설치한 경우)
+```bash
+sudo npm i -g claude-code-kr
+```
+
 설치하면 자동으로:
 1. Claude Code의 빌트인 커맨드에 한글 alias + 한글 설명 추가
 2. CC 업데이트 후 자동 재패치 hook 등록
 
-> **시스템 Node.js 사용 시** (nvm이 아닌 경우)  
-> 패치에 쓰기 권한이 필요할 수 있습니다:
-> ```bash
-> sudo npm i -g claude-code-kr   # 또는
-> npm i -g claude-code-kr && sudo cckr apply
-> ```
+## 패치 상태 확인
+
+```bash
+cckr status
+```
+
+```
+📍 경로: ~/.nvm/.../cli.js
+🇰🇷 패치: 적용됨 ✅     ← 이렇게 나오면 정상
+📦 버전: 0.1.19
+```
+
+**"미적용 ❌"이 뜨는 경우:**
+```bash
+cckr apply              # nvm
+sudo cckr apply          # 시스템 Node.js
+```
+
+## 업데이트
+
+```bash
+npm i -g claude-code-kr@latest     # nvm
+sudo npm i -g claude-code-kr@latest  # 시스템 Node.js
+```
+
+> **주의:** 시스템 Node.js 환경에서 `sudo` 없이 업데이트하면 cckr는 업데이트되지만
+> 패치가 적용되지 않습니다. `cckr status`로 확인 후 `sudo cckr apply`를 실행하세요.
+
+> **Claude Code 업데이트(`claude upgrade`) 후:**
+> SessionStart hook이 자동으로 재패치를 시도합니다.
+> 만약 적용되지 않으면 `cckr apply` (또는 `sudo cckr apply`)를 실행하세요.
 
 ## 제거
 
 ```bash
-npm uninstall -g claude-code-kr
+npm uninstall -g claude-code-kr     # nvm
+sudo npm uninstall -g claude-code-kr  # 시스템 Node.js
 ```
 
 원본 자동 복원 + hook 제거.
@@ -153,7 +185,9 @@ Claude Code의 `cli.js` 번들을 패치합니다:
 
 ### UI 텍스트
 
-도구 사용 시 표시되는 메시지와 키보드 힌트를 한글화합니다.
+도구 표시, 요약 메시지, 권한 모드, 도움말 화면 등을 한글화합니다.
+
+**도구 동작**
 
 | 영어 | 한글 |
 |------|------|
@@ -162,12 +196,43 @@ Claude Code의 `cli.js` 번들을 패치합니다:
 | `Writing src/utils.ts` | `src/utils.ts 작성 중` |
 | `Searching for pattern` | `pattern 검색 중` |
 | `Running command` | `명령어 실행 중` |
-| `Running in the background` | `백그라운드 실행 중` |
+
+**도구 요약**
+
+| 영어 | 한글 |
+|------|------|
+| `Searching for 3 patterns, reading 1 file` | `검색 3 패턴, 읽는 중 1 파일` |
+| `Listed 1 directory` | `목록 완료 1 폴더` |
+
+**권한 모드**
+
+| 영어 | 한글 |
+|------|------|
+| `accept edits on` | `수정 허용 모드` |
+| `auto mode on` | `자동 모드` |
+| `Bypass Permissions` | `권한 무시` |
+| `Don't Ask` | `묻지 않기` |
+
+**도움말 (/help)**
+
+| 영어 | 한글 |
+|------|------|
+| `! for bash mode` | `! bash 모드` |
+| `/ for commands` | `/ 커맨드` |
+| `@ for file paths` | `@ 파일 경로` |
+| `/btw for side question` | `/근데 사이드 질문` |
+| `double tap esc to clear input` | `esc 두 번 입력 지우기` |
+
+**기타**
+
+| 영어 | 한글 |
+|------|------|
 | `(ctrl+o to expand)` | `(ctrl+o 펼치기)` |
 | `Space, Enter, or Escape to dismiss` | `Space·Enter·Esc로 닫기` |
 | `Interrupted · What should Claude do instead?` | `중단됨 · 대신 무엇을 할까요?` |
-| `accept edits on` | `수정 허용 모드` |
-| `Bypass Permissions` | `권한 무시` |
+| `◉ max · /effort` | `◉ max · /노력` |
+
+> 전체 번역 현황은 [TRANSLATION-STATUS.md](TRANSLATION-STATUS.md) 참고
 
 ## 번역 원칙
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kr",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Claude Code 한글 패치 CLI — /btw → /근데, /help → /도움, /compact → /압축",
   "main": "./index.js",
   "bin": {