{
  "markdown": "# CCK — Claude Code Korean\n\n> **한국어로 말하면 Claude Code가 알아서 실행합니다.**\n> 새로운 명령어를 외울 필요 없습니다. 설치 후 바로 한국어로 사용하세요.\n\n---\n\n## 목차\n\n- [소개](#소개)\n- [설치](#설치)\n- [사용법](#사용법)\n- [스킬 상세](#스킬-상세)\n- [지원 워크플로우](#지원-워크플로우)\n- [플러그인 구조](#플러그인-구조)\n- [기여하기](#기여하기)\n- [라이선스](#라이선스)\n\n---\n\n## 소개\n\nCCK는 한국어 사용자가 Claude Code를 자연스럽게 사용할 수 있게 해주는 **투명한 플러그인**입니다.\n\n- `korean-autopilot` 스킬이 백그라운드에서 자동으로 동작\n- 사용자가 한국어로 입력하면 적절한 Claude Code 커맨드를 자동으로 실행하거나 안내\n- 별도의 명령어 학습 불필요 — 그냥 말하면 됨\n\n### 동작 원리\n\n```\n사용자 입력 (한국어)\n        ↓\nkorean-autopilot 자동 감지\n        ↓\naliases.json → 키워드 매핑\ncommands.json → 커맨드 정보 조회\nrecipes.json → 멀티스텝 워크플로우 참조\n        ↓\n실행 가능 커맨드 → 직접 실행\n터미널 커맨드   → 복사 가능한 코드 블록으로 안내\n멀티스텝 작업  → 단계별 순서 안내\n```\n\n---\n\n## 설치\n\n### 요구사항\n\n- [Claude Code](https://claude.ai/code) 최신 버전\n\n### 방법 1: 마켓플레이스 (권장)\n\n공식 마켓플레이스에 등록되면 한 줄로 설치 가능합니다:\n\n```bash\nclaude plugin install cck@shinhyukahn\n```\n\n> 공식 마켓플레이스 등록 전까지는 아래 방법을 사용하세요.\n\n### 방법 2: 자체 마켓플레이스\n\n먼저 마켓플레이스를 등록합니다 (최초 1회):\n\n```bash\nclaude plugin marketplace add shinhyukahn/cck\n```\n\n이후 설치:\n\n```bash\nclaude plugin install cck@shinhyukahn\n```\n\n### 방법 3: Git Clone 후 직접 실행\n\n```bash\ngit clone https://github.com/shinhyukahn/cck.git\ncd cck\nclaude --plugin-dir .\n```\n\n> **Windows 사용자:** 절대 경로(`C:\\path\\to\\cck`)는 동작하지 않을 수 있습니다. 반드시 `cck` 디렉토리 안에서 `claude --plugin-dir \".\"` 로 실행하세요.\n\n### 설치 확인\n\nClaude Code 세션에서 `/cck:cheat`를 입력했을 때 한국어 치트시트가 출력되면 정상입니다.\n\n---\n\n## 사용법\n\n### 그냥 한국어로 말하면 됩니다\n\nCCK가 설치된 상태에서 한국어로 입력하면 자동으로 처리됩니다.\n\n| 이렇게 말하면 | Claude가 알아서 |\n|---|---|\n| \"코드 리뷰해줘\" | `/review` 실행 |\n| \"변경사항 보여줘\" | `/diff` 실행 |\n| \"컨텍스트 정리해\" | `/compact` 실행 |\n| \"이전으로 되돌려\" | `/rewind` 실행 |\n| \"비용 얼마야?\" | `/cost` 실행 |\n| \"보안 취약점 점검해줘\" | `/security-review` 실행 |\n| \"다른 모델로 바꿔줘\" | `/model` 실행 |\n| \"어제 하던 거 이어서 하고 싶어\" | `claude -c` 터미널 커맨드로 안내 |\n| \"독립된 공간에서 작업하고 싶어\" | `claude -w 작업명` 안내 |\n| \"PR 올리고 싶어\" | PR 워크플로우 단계별 안내 |\n| \"여러 작업 동시에 하고 싶어\" | 병렬 워크트리 워크플로우 안내 |\n| \"응답이 느려진 것 같아\" | 컨텍스트 문제 감지 → `/compact` 제안 |\n| \"CLAUDE.md 만들어줘\" | `/cck:setup` 실행 안내 |\n\n### 명시적 호출 명령어\n\n```\n/cck:cheat\n```\nClaude Code 한국어 치트시트를 즉시 출력합니다. 자주 쓰는 커맨드와 단축키를 한눈에 볼 수 있습니다.\n\n```\n/cck:setup\n/cck:setup 웹앱\n/cck:setup api서버\n```\n현재 프로젝트에 맞는 `CLAUDE.md` 한국어 템플릿을 생성합니다. 프로젝트 파일을 자동 감지해서 기술 스택을 채워넣습니다.\n\n---\n\n## 스킬 상세\n\n### `korean-autopilot` (자동 활성화)\n\n`user-invocable: false`로 설정되어 사용자가 직접 호출하지 않아도 백그라운드에서 자동 동작합니다.\n\n한국어 입력을 감지하면 아래 네 가지 패턴 중 하나로 응답합니다.\n\n**패턴 A — 세션 내 실행 가능한 커맨드**\n\n`/compact`, `/diff`, `/review`, `/rewind`, `/cost` 등 Claude Code 세션 안에서 직접 실행할 수 있는 커맨드는 바로 실행합니다.\n\n**패턴 B — 터미널 커맨드 안내**\n\n`claude -c`, `claude -w`, `claude mcp add` 등 새 터미널 세션에서 입력해야 하는 커맨드는 복사 가능한 코드 블록으로 안내합니다.\n\n```\n[한 줄 설명]\n\n터미널에서 실행해:\n`[커맨드]`\n```\n\n**패턴 C — 멀티스텝 워크플로우**\n\nPR 만들기, 병렬 작업, MCP 연결 등 여러 단계가 필요한 작업은 `recipes.json`을 참조해서 현재 단계를 실행하고 다음 단계를 안내합니다.\n\n**패턴 D — 문제 상황 선제 감지**\n\n사용자가 요청하지 않아도 문제 신호를 감지하면 먼저 제안합니다.\n\n| 신호 | 제안 |\n|---|---|\n| \"응답이 느려졌어\", \"이상하게 대답해\" | `/compact` 제안 |\n| \"아까 한 거 되돌리고 싶어\" | `/rewind` 제안 |\n| \"토큰 많이 쓰고 있어?\" | `/cost` 실행 |\n| 새 주제로 전환 감지 | `/compact`로 정리 제안 |\n\n---\n\n### `cheat` — `/cck:cheat`\n\n포함 내용:\n- 시작 커맨드 (`claude`, `claude -c`, `claude -r` 등)\n- 세션 커맨드 (`/compact`, `/diff`, `/rewind`, `/cost` 등)\n- 프로젝트 관리 (`/init`, `/memory`, `/permissions`, `/plugin`)\n- 코드 작업 (`/review`, `/security-review`, `/simplify`, `/batch`)\n- 실행 플래그 (`--worktree`, `--effort`, `--tmux`, `--chrome` 등)\n- 키보드 단축키\n\n---\n\n### `setup` — `/cck:setup [프로젝트유형]`\n\n현재 프로젝트 디렉토리를 탐색해서 기술 스택을 자동 감지하고, 프로젝트 유형에 맞는 한국어 `CLAUDE.md` 템플릿을 생성합니다.\n\n| 유형 | 감지 파일 |\n|---|---|\n| 웹앱 | `package.json` + React/Next.js/Vue 등 |\n| API 서버 | `pom.xml`, `package.json` + Express, `requirements.txt` + FastAPI 등 |\n| 데이터 파이프라인 | `requirements.txt`, `Pipfile`, `pyproject.toml` |\n| 모노레포 | `pnpm-workspace.yaml`, `lerna.json`, `nx.json` |\n| 사이드 프로젝트 | 감지 파일 없을 때 기본값 |\n\n인자 없이 `/cck:setup`만 입력하면 유형을 물어봅니다.\n\n---\n\n## 지원 워크플로우\n\n`data/recipes.json`에 정의된 워크플로우입니다. 한국어로 말하면 `korean-autopilot`이 해당 레시피를 참조해서 단계별로 안내합니다.\n\n| 워크플로우 | 카테고리 | 난이도 |\n|---|---|---|\n| 코드 리뷰 받기 | 일상 | 초급 |\n| 버그 잡기 | 일상 | 초급 |\n| 리팩토링 | 일상 | 중급 |\n| 테스트 작성 | 일상 | 초급 |\n| 컨텍스트 관리 | 일상 | 초급 |\n| PR 만들어서 올리기 | 프로젝트 관리 | 중급 |\n| 여러 작업 병렬 처리 | 프로젝트 관리 | 고급 |\n| 프로젝트 초기 셋업 | 프로젝트 관리 | 초급 |\n| MCP 서버 연결 | 고급 | 고급 |\n| 서브에이전트 활용 | 고급 | 고급 |\n\n---\n\n## 플러그인 구조\n\n```\ncck/\n├── .claude-plugin/\n│   ├── plugin.json              # 플러그인 매니페스트 (이름, 버전, 저자, 경로)\n│   └── marketplace.json         # 자체 마켓플레이스 등록 정보\n├── data/\n│   ├── commands.json            # Claude Code 커맨드 DB (한국어 설명 포함)\n│   ├── aliases.json             # 한국어 자연어 키워드 → 커맨드 ID 매핑\n│   └── recipes.json             # 멀티스텝 워크플로우 레시피 정의\n├── commands/\n│   ├── cheat.md                 # /cck:cheat — 치트시트 출력\n│   ├── setup.md                 # /cck:setup — CLAUDE.md 템플릿 생성\n│   └── templates/\n│       ├── web-app.md\n│       ├── api-server.md\n│       ├── data-pipeline.md\n│       ├── monorepo.md\n│       └── side-project.md\n├── skills/\n│   └── korean-autopilot/        # 백그라운드 자동 활성화 스킬\n│       └── SKILL.md\n└── agents/\n    └── korean-helper.md         # 한국어 서브에이전트 정의\n```\n\n### 데이터 파일 스키마\n\n**`commands.json`** 핵심 필드:\n\n```jsonc\n{\n  \"id\": \"compact\",\n  \"type\": \"slash\",              // \"slash\" | \"flag\" | \"terminal\"\n  \"name\": \"/compact\",\n  \"summary_ko\": \"...\",          // 한 줄 한국어 설명\n  \"detail_ko\": \"...\",           // 상세 한국어 설명\n  \"session_executable\": true,   // true → 세션 내 직접 실행, false → 터미널 안내\n  \"tags\": [\"정리\", \"컨텍스트\"], // 자연어 검색 키워드\n  \"category\": \"대화관리\",\n  \"difficulty\": \"beginner\"\n}\n```\n\n**`aliases.json`** 구조:\n\n```jsonc\n{\n  \"이어서\": [\"continue-flag\", \"resume\"],\n  \"정리\":   [\"compact\", \"clear\"],\n  \"느려\":   [\"compact\", \"effort-flag\", \"fast\"]\n}\n```\n\n**`recipes.json`** 스텝 타입:\n\n| 타입 | 설명 |\n|---|---|\n| `terminal` | 터미널에서 실행하는 커맨드 (복사 가능하게 안내) |\n| `claude-command` | Claude Code 세션 내 슬래시 커맨드 (직접 실행) |\n| `claude-prompt` | 사용자가 Claude에게 입력할 프롬프트 예시 |\n| `manual` | 사용자가 직접 수행해야 하는 작업 |\n| `auto` | Claude가 자동으로 처리하는 단계 |\n\n---\n\n## 기여하기\n\n이슈와 PR 환영합니다.\n\n| 영역 | 방법 |\n|---|---|\n| 새 커맨드 추가 | `data/commands.json`에 커맨드 객체 추가 |\n| 자연어 표현 추가 | `data/aliases.json`에 키워드 → 커맨드 ID 추가 |\n| 새 워크플로우 | `data/recipes.json`에 레시피 추가 |\n| CLAUDE.md 템플릿 | `commands/templates/`에 `.md` 파일 추가 |\n| 버그 수정 | 이슈 등록 후 PR |\n\n### 로컬 테스트\n\n```bash\ngit clone https://github.com/shinhyukahn/cck.git\ncd cck\nclaude --plugin-dir .\n```\n\n### 데이터 정합성 검사\n\n`aliases.json`이 `commands.json`에 없는 커맨드 ID를 참조하는지 빠르게 확인:\n\n```powershell\n$commands = Get-Content -Raw -Encoding utf8 data/commands.json | ConvertFrom-Json\n$aliases = Get-Content -Raw -Encoding utf8 data/aliases.json | ConvertFrom-Json\n$ids = @{}\nforeach($c in $commands.commands){ $ids[$c.id] = $true }\n$missing = @()\nforeach($prop in $aliases.mappings.PSObject.Properties){\n  foreach($id in $prop.Value){\n    if(-not $ids.ContainsKey($id)){\n      $missing += [PSCustomObject]@{ keyword = $prop.Name; missing_id = $id }\n    }\n  }\n}\nif($missing.Count -eq 0){\n  \"OK: 모든 aliases 매핑이 유효한 command id를 참조합니다.\"\n} else {\n  $missing | Format-Table -AutoSize\n}\n```\n\n---\n\n## 라이선스\n\nMIT © [shinhyukahn](https://github.com/shinhyukahn)\n\n---\n\n# CCK — Claude Code Korean (English)\n\n> **Speak Korean. Claude Code handles the rest.**\n> No commands to memorize. Just install and talk naturally in Korean.\n\n## What It Does\n\nCCK is a transparent plugin for Claude Code. Once installed, its `korean-autopilot` skill runs silently in the background. When it detects Korean input, it automatically routes to the right Claude Code command — executing it directly when possible, or providing a ready-to-copy terminal command when not.\n\n## Installation\n\n```bash\n# Via marketplace (once listed)\nclaude plugin install cck@shinhyukahn\n\n# Via self-hosted marketplace\nclaude plugin marketplace add shinhyukahn/cck\nclaude plugin install cck@shinhyukahn\n\n# Local (confirmed working)\ngit clone https://github.com/shinhyukahn/cck.git\ncd cck\nclaude --plugin-dir .\n```\n\n> **Windows:** Absolute paths may not work with `--plugin-dir`. Run from inside the `cck` directory using `claude --plugin-dir \".\"`.\n\n## How It Works\n\nThe `korean-autopilot` skill (`user-invocable: false`) activates automatically when Korean is detected. It references three data files:\n\n- `data/commands.json` — full command DB with Korean metadata and `session_executable` flag\n- `data/aliases.json` — natural language keyword → command ID mappings\n- `data/recipes.json` — multi-step workflow recipes\n\nCommands with `session_executable: true` are executed directly. Commands with `session_executable: false` are shown as copyable terminal instructions.\n\n## Explicit Commands\n\n```\n/cck:cheat          Korean cheatsheet for all Claude Code commands\n/cck:setup          Generate a Korean CLAUDE.md for the current project\n/cck:setup web-app  Skip the prompt and generate a specific template\n```\n\n## Plugin Structure\n\n```\ncck/\n├── .claude-plugin/\n│   ├── plugin.json             # Manifest\n│   └── marketplace.json        # Self-hosted marketplace registry\n├── data/\n│   ├── commands.json           # Command DB\n│   ├── aliases.json            # NL keyword mappings\n│   └── recipes.json            # Workflow recipes\n├── commands/\n│   ├── cheat.md                # /cck:cheat\n│   ├── setup.md                # /cck:setup\n│   └── templates/              # CLAUDE.md templates\n├── skills/\n│   └── korean-autopilot/       # Auto-activated background skill\n│       └── SKILL.md\n└── agents/\n    └── korean-helper.md\n```\n\n## License\n\nMIT © [shinhyukahn](https://github.com/shinhyukahn)\n",
  "bytes": 9259,
  "sha": "77031f453187e9fa40f02d5a73640f0761508f516d936d60a2f3194b938e9d4e",
  "repo_slug": "shinhyukahn/cck",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_shinhyukahn_cck_cck_4d771e84/readme"
}