wesammustafa/Claude-Code-Everything-You-Need-to-Know

Claude Code – 실용적인 가이드

무엇인가요 – 이 리포지토리는 Anthropic의 공식 명령줄 인터페이스인 Claude Code에 대한 단계별 튜토리얼입니다. 이 도구를 사용하면 터미널에서 직접 Claude(회사의 대규모 언어 모델)를 실행할 수 있습니다. 가이드에서는 CLI 설치, 인증, 코드 읽기 및 편집을 위한 Claude 프롬프트 사용법, 그리고 사용자 정의 Skills, Hooks, Sub-agents, Workflows, MCP 서버를 통한 확장 방법을 안내합니다.

누구를 위한가요 –

• 초보자는 "설정 → 프롬프트 엔지니어링 → 첫 번째 스킬" 경로를 따라 약 15분 내에 시작할 수 있습니다.
• 경험자는 Skills, Hooks, 그리고 Model-Context-Protocol(MCP)의 심층적인 섹션에 직접 들어갈 수 있습니다.
• 팀 리더 / 자동화 엔지니어는 다중 에이전트 팀, 동적 워크플로우, 대규모 프로젝트용 BMAD 프레임워크를 구축하는 방법을 배울 수 있습니다.

다루는 주요 개념

기능	기능 설명	파일 위치
Skills (슬래시 명령어)	재사용 가능한 마크다운 프롬프트로, /skill-name로 Claude가 호출할 수 있습니다. 반복 작업에 적합합니다 (예: PR 열기, 테스트 실행).	.claude/commands/*.md
Hooks	세션 시작, 도구 사용, 서브에이전트 종료와 같은 이벤트 발생 시 자동 실행되는 스크립트입니다.	.claude/settings.json (.claude/hooks/의 파이썬 스크립트와 연결)
Sub-agents	고유한 컨텍스트를 가진 격리된 Claude 세션으로, 대규모 하위 작업에 유용합니다.	.claude/agents/*.md
Workflows	여러 에이전트와 도구를 조율하여 복잡한 작업을 해결하는 자바스크립트 파일입니다.	.claude/workflows/*.js
MCP (Model-Context-Protocol) 서버	Claude가 CLI에서 외부 서비스(브라우저, 데이터베이스, API 등)를 호출할 수 있도록 합니다. 프로젝트별로 구성됩니다.	프로젝트별 구성 파일 (고정 경로 아님)

이 리포지토리가 어떻게 도움이 되는가

• .claude/ 디렉터리는 각 확장 포인트(7개의 슬래시 스킬, 5개의 서브에이전트, 동적 워크플로우, 파이썬 훅 등)를 포함한 복사해서 바로 사용 가능한 예제 프로젝트입니다.
• 상세한 마크다운 가이드(docs/skills.md, docs/reference/effort-levels.md 등)는 * effort levels*, 프롬프트 엔지니어링, 그리고 AI 에이전트 프레임워크 구축을 위한 BMAD 방법의 사고 모델을 설명합니다.
• 체크시트 링크와 표를 통해 적절한 모델(Sonnet 5, Opus 4.8, Fable 5 등)과 적절한 노력 수준(low → ultracode)을 쉽게 선택할 수 있습니다.

왜 중요한가 – Claude Code는 LLM 기반의 코딩 지원을 개발자의 기본 쉘 워크플로우에 통합하여 모델이 다음을 가능하게 합니다:

1. 전체 리포지토리 읽기 (파일 트리, 임포트, grep 결과) → 단순히 붙여넣은 스니펫만이 아니라.
2. 파일을 직접 편집하고 테스트 스위트를 자동으로 실행하여 즉각적인 피드백을 제공합니다.
3. 슬래시 명령어, 훅, 외부 MCP 서비스를 통해 기존 도구와 조합할 수 있습니다.

구체적이고 복사-붙여넣기 가능한 예제를 제공함으로써, 이 가이드는 특정 에디터나 IDE에 종속되지 않고 팀이 AI 기반 자동화를 도입하는 장벽을 낮춥니다.

---

빠른 시작

npm install -g @anthropic-ai/claude-code   # CLI 설치
claude                                    # 인증 (브라우저 열림)
cd my-project && claude                    # Claude 세션 시작
/explain what this codebase does           # 예제 프롬프트