OriNachum/claude-code-guide

공식 Claude Code 가이드를 찾고 계신가요? Anthropic의 Claude Code 문서를 확인하세요. 이 프로젝트는 여러분이 Claude Code를 선제적으로 마스터할 수 있도록 돕는 커뮤니티 플러그인입니다.

Claude Code 가이드 — 설정, 베스트 프랙티스 (Best Practices), 자동화 및 효과적인 워크플로 (Workflows)에 대한 대화형 온보딩 (Onboarding) 및 Q&A를 플러그인 형태로 제공합니다. 초보자 🌱부터 전문가 🌳까지 모두를 위해 애정을 담아 설계되었습니다.

플랫폼 (Platforms): Windows (Git Bash), macOS, 그리고 Linux (Ubuntu)에서 테스트되었습니다.

새로운 기능! **게임 모드 (Game Mode)**를 통해 선제적인 학습을 시작하세요!

/guide:game-mode on 명령어로 활성화할 수 있습니다.

이 가이드를 들어보세요 — NotebookLM 오디오 개요 (Audio Overview)는 가이드 콘텐츠를 AI가 생성한 오디오로 반영하여 제공합니다.

⭐ 이 내용이 유용했나요? 업데이트를 확인하고 지원을 표현하기 위해 저장소(Repo)에 스타(Star)를 눌러주세요!

이 저장소는 **Claude Code 플러그인 (Plugin)**입니다. 이를 설치하면 Claude Code 내부에서 직접 대화형 가이드 기술을 사용할 수 있습니다.

Claude Code v1.0.33 이상의 버전이 필요합니다. claude --version을 실행하여 버전을 확인하세요. 설치 또는 업데이트를 위한 설정 문서를 참조하십시오.

Claude Code 내부에서:

/plugin marketplace add OriNachum/claude-code-guide
/plugin install guide@claude-code-guide

또는 CLI에서:

claude plugin marketplace add OriNachum/claude-code-guide
claude plugin install guide@claude-code-guide

플러그인 이름은

guide

이며, 마켓플레이스 (Marketplace) 이름은

claude-code-guide

(marketplace.json 기준)이므로, 설치 대상은

guide@claude-code-guide

입니다.

설치 후에는 Claude Code를 재시작하거나 /reload-plugins를 실행해야 플러그인 기술을 사용할 수 있습니다.

/plugin update guide@claude-code-guide

설치 없이 사용하기 (세션 전용)

git clone https://github.com/OriNachum/claude-code-guide.git
claude --plugin-dir ./claude-code-guide

현재 세션에 대해서만 플러그인을 로드합니다. 재시작이 필요하지 않습니다.

로컬 클론 (Local Clone)에서 설치하기

/plugin marketplace add ./claude-code-guide
/plugin install guide@claude-code-guide

또는 CLI에서:

claude plugin marketplace add ./claude-code-guide
claude plugin install guide@claude-code-guide

설치가 완료되면, 다음의 7가지 기술(skills)을 사용할 수 있습니다:

— 대화형 시작 가이드 워크스루 (Interactive getting-started walkthrough). 환경 설정, 첫 세션 시작, 그리고 모범 사례(best practices)를 안내합니다. /guide:onboard

— Claude Code 기능에 관한 모든 질문에 답변합니다. 관련 참조 문서(reference docs)를 읽어 정확하고 상세한 답변을 제공합니다. /guide:ask

— 자기 성찰적 개발 (Introspective Development). 프로젝트의 라이프사이클 커버리지를 감사하고, 도구 및 문서의 공백을 찾아내며, 발견된 문제를 자동으로 수정합니다. 작업 완료 후 "어떻게 하면 더 잘할 수 있었을까요?"라고 물어보세요. /guide:introspect

— 게임 모드 (Game Mode) 활성화. 가이드가 로컬에서 사용자의 Claude 사용량을 추적하고, 기능 영역별로 레벨을 부여하여 Claude Code를 마스터할 수 있도록 돕습니다. /guide:game-mode

— 기능 로드맵 및 개인 맞춤형 다음 단계 코칭. 현재 숙련도에 따라 다음에 무엇을 학습해야 할지 보여줍니다. /guide:level-up

— Cursor, Windsurf, Copilot, Continue, Aider, Cody 또는 Codex 설정을 Claude Code로 마이그레이션합니다. 설정을 탐색하고, 불필요한 요소를 제거하며, 깔끔한 마이그레이션 계획을 제안합니다. /guide:migrate-to-claude

— 설치된 모든 기술(skills), MCP 서버, 그리고 설정 구성(setup configuration)을 보여주는 대화형 대시보드입니다. /guide:visualize-setup

이 플러그인은 실제 사례 기반의 훅(hooks) 예시 역할도 겸합니다. 게임 모드(Game Mode)는 세 가지 훅 이벤트(hook events)를 모두 사용하여 게임화(gamification) 시스템을 구동합니다:

PostToolUse— 사용자가 어떤 Claude Code 기능을 사용하는지 추적합니다 (track-usage.sh)
UserPromptSubmit— 프롬프트 내의 슬래시 명령어(slash-command) 사용(skills, plugins, /loop)을 감지합니다 (track-prompt.sh)
Stop— 세션 수를 계산하고, 토큰을 추적하며, 피보나치 수열(Fibonacci intervals) 간격으로 새로운 기능을 시도하도록 독려합니다 (track-stop.sh)

전체 구현 내용은 hooks.json 및 hooks/scripts/를 참조하세요.

예제를 통한 학습 — 이 내러티브 워크스루(narrative walkthroughs)는 여러 기능이 결합되는 현실적이고 엔드 투 엔드(end-to-end)인 시나리오에서의 Claude Code를 보여줍니다. 각 스토리는 개발자가 실제 워크플로우를 수행하는 과정을 따라가므로, 각 요소가 어떻게 맞물려 돌아가는지 확인할 수 있습니다.

• 일일 워크플로우 (Daily Workflow) — 아침의 컨텍스트 설정부터 하루의 마무리까지, Claude Code를 사용하는 전형적인 하루

• Claude Code 시작하기 (Getting Started with Claude Code) — 기존 팀에서 보내는 첫 며칠 — /init 사용 및 유기적인 기술 습득

• 기존 리포지토리 내 새 프로젝트 (New Project in Existing Repo) — 기존 코드베이스 내에 새로운 모듈/서비스 추가하기

• CLAUDE.md 자동 유지 관리 (Auto-Maintain CLAUDE.md) — CLAUDE.md를 매주 최신 상태로 유지하기 위한 GitHub Actions 크론 잡 (cron job)

• 컨텍스트 관리 (Context Management) — /clear, /compact를 사용하는 시점 및 컨텍스트 관리 방법

• 모놀리스 내 서브 에이전트 (Sub Agents in a Monolith) — 거대한 모놀리스 (Monolith) 구조 내에서 탐색하고 작업하기 위한 서브 에이전트 활용

• 플러그인 탐색 (Discovering Plugins) — 마켓플레이스 둘러보기, 평가 및 첫 플러그인 설치

• 실전 메모리 활용 (Memory in Practice) — 자동 메모리 (Auto Memory) 작동 방식 — 유지되는 수정 사항 및 CLAUDE.md로의 승격

• 자동 브리핑 (Automated Briefings) — /loop을 이용한 프로덕션 모니터링 — 배포, 배포 후 검증, 온콜 (on-call) 분류

• 타 AI 도구로부터의 마이그레이션 (Migrating from Other AI Tools) — Cursor, Windsurf, Copilot, Codex에서 전환하기 — 기능 매핑 및 최적화 방법

• 환경 설정 (Setting Your Environment) — CLAUDE.md, 권한 (permissions), 모델 선택, MCP 서버, 커스터마이징

• 작업 시작하기 (Starting to Work) — 권한 모드 (Permission modes), 플랜 모드 (Plan Mode), 편집 수락 (Accept Edits), 탐색-계획-구현 (explore-plan-implement) 워크플로우

• 모델 선택 (Choosing Your Model) — Opus 4.6, Sonnet 4.6, Haiku, 노력 수준 (effort levels), 각 모델의 사용 시점

• 베스트 프랙티스 (Best Practices) — 셀프 테스트 루프 (Self-testing loops), 컨텍스트 관리, 효과적인 프롬프팅 (prompting), 일반적인 실패 패턴

• 자동 메모리 (Auto Memory) — Claude가 세션 간에 기억하는 방식, CLAUDE.md와의 비교

• 워크플로우 자동화 (Automating Your Workflows) — 세 가지 자동화 메커니즘 개요: 훅 (Hooks), 스킬 (Skills), 서브 에이전트 (Sub Agents)

• 훅 (Hooks) — 라이프사이클 이벤트 자동화 — 트리거 (triggers), 핸들러 (handlers), 매처 (matchers), 일반적인 패턴

• HTTP 훅 (Hooks HTTP) — HTTP 기반 훅 패턴 및 통합

• 스킬 (Skills) — 마크다운 (Markdown) 스킬 파일로서 재사용 가능한 프롬프트 워크플로우 생성

• 서브 에이전트 (Sub Agents) — 범위가 지정된 권한 (scoped permissions) 및 워크트리 격리 (worktree isolation)를 통한 전문 에이전트 위임

• 에이전트 팀 (Agent Teams) —
  ⚠️ 실험적 기능 (Experimental): 공유된 작업 목록을 가진 협업형 멀티 에이전트 세션

• Claude 설정 (Configuring Your Claude) — 지속적인 설정 — 스킬(skills), 에이전트(agents), 훅(hooks)을 구축하는 시점과 그 진화 방식

• 플러그인 (Plugins) — Claude Code 플러그인 설치, 생성 및 공유

• 마켓플레이스 (Marketplace) — 플러그인 마켓플레이스 탐색, 브라우징, 평가, 게시 및 관리

• 플러그인 예시 (Plugin Examples) — 패턴과 설치 지침이 포함된 주목할 만한 플러그인 큐레이션 쇼케이스

• MCP — MCP (Model Context Protocol) — 사용 시점, 레스토랑 비유, 서버 설정 및 스코프 (scopes)

• 내장 기능 (Built-ins) — 내장 슬래시 명령어 (slash commands), 번들된 스킬 (bundled skills), 훅 이벤트 (hook events), 서브 에이전트 (sub agents) 및 도구 (tools)

• 진행 중인 작업 (Ongoing Work) — 장기 실행 작업 관리, 작업 재개 및 세션 연속성

• Claude 에이전트 SDK (Claude Agent SDK) — 프로그래밍 방식의 Claude Code 통합을 위한 TypeScript 및 Python SDK

• GitHub Actions — GitHub Actions를 사용한 CI/CD 파이프라인에서의 Claude Code 실행

• Windows 지원 (Windows Support) — 설정, jq 설치 및 Windows 전용 조정 사항

• 루프 (Loop) — /loop를 사용한 반복 작업 실행 — 폴링 (polling), 배포 모니터링, 온콜 트리아지 (on-call triage)

claude-code-guide/
├── .claude-plugin/
│ ├── plugin.json ........................ 플러그인 매니페스트 (name: "guide", version, metadata)
...

기여(Contributions)를 환영합니다! 7개의 스킬은 skills/onboard/, skills/ask/, skills/introspect/, skills/game-mode/, skills/level-up/, skills/migrate-to-claude/, 그리고 skills/visualize-setup/에 위치합니다. 참조 문서 (Reference docs)는 skills/ask/references/에 있으며, 훅 (hooks)은 hooks/에 있습니다.

CC BY 4.0 — 자세한 내용은 LICENSE를 참조하세요.