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

Claude Code – 알아야 할 모든 것

개요 – 커뮤니티에서 유지 관리하는 Claude Code 단계별 가이드입니다. Anthropic의 공식 명령줄 인터페이스를 통해 터미널에서 직접 Claude(대규모 언어 모델)를 실행할 수 있습니다. 이 가이드는 초기 설치부터 프롬프트 엔지니어링, 커스텀 Skills(슬래시 명령어), Hooks, 하위 에이전트, 동적 워크플로우, 외부 도구 통합을 위한 Model-Context-Protocol(MCP)까지 안내합니다.

대상 독자

• 신규 사용자: 15분 안에 Claude Code 세션을 작동시키고 싶은 분.
• 숙련된 사용자: Skills, Hooks, MCP 및 멀티 에이전트 설정에 대한 심층적인 내용을 찾는 분.
• 팀 리더 / 자동화 엔지니어: 재사용 가능한 에이전트 팀, 동적 JavaScript 워크플로우, AI 에이전트 오케스트레이션을 위한 BMAD 프레임워크 구축에 관심이 있는 분.

주요 섹션

섹션	학습 내용
설정	원라인 설치 (`curl …
프롬프트 엔지니어링	구조화된 "탐색 → 계획 → 코드 → 커밋" 워크플로우, 노력 수준 다이얼 (low → max + ultracode), ultrathink를 사용한 깊은 추론 방법.
Skills / 슬래시 명령어	재사용 가능한 마크다운 기반 명령어(.claude/commands/*.md) 생성 방법 및 리포지토리에 포함된 기본 스킬 세트(PR 위생, TDD, UX 등).
Hooks	세션 시작, 권한 변경 또는 Claude가 사용자 입력을 필요로 할 때 실행되는 자동화 Python 훅.
하위 에이전트 및 에이전트 팀	격리된 에이전트 정의(.claude/agents/*.md), 실험적인 Agent Teams 기능 사용, 준비된 역할 프롬프트 라이브러리.
동적 워크플로우	여러 에이전트를 조정하는 JavaScript 워크플로우 스크립트(.claude/workflows/*.js)(예: 오래된 문서 감사).
MCP (Model-Context-Protocol)	세션 내에서 외부 브라우저, 데이터베이스 또는 API를 호출하도록 Claude 설정.
생산성 프레임워크	노력 수준, Fast Mode, "Super Claude" 프레임워크, AI 에이전트 파이프라인 구축을 위한 BMAD 방법론.

리포지토리 구성 (자신의 프로젝트에 복사 가능한 부분)

• .claude/commands/ – 7개의 즉시 사용 가능한 슬래시 스킬 (예: /pr, /review).
• .claude/skills/ – 에이전트 스킬 예제 (/claude-md-review).
• .claude/agents/ – 5개의 스타터 하위 에이전트 및 10개의 전문 역할 프롬프트.
• .claude/workflows/ – 동적 워크플로우 샘플 (/stale-docs-audit).
• .claude/hooks/ – Python 알림 훅 (uv Python 설치 프로그램 필요).
• .claude/settings.json – 기본 권한 모드 및 훅 연결.

시작하기

# Claude Code 설치 (macOS/Linux/WSL)
curl -fsSL https://claude.ai/install.sh | bash
# 인증 (브라우저 열림)
claude
# 리포지토리 내에서 실행
cd my-project && claude
# 내장 명령어 테스트
/explain what this codebase does
# 또는 리포지토리의 커스텀 스킬 실행
/pr

예제 설정을 재사용하려면 리포지토리를 복제하고 필요한 파일만 복사하십시오. 실행 전 각 파일의 보안을 검토하십시오.

중요성 – Claude Code는 개발자가 터미널에서 Anthropic의 Claude 모델과 상호 작용하는 주요 방법으로, 모델이 리포지토리 파일 트리, 테스트 러너 및 외부 도구에 "실제" 접근할 수 있게 합니다. 이 가이드는 5가지 확장 포인트(Skills, Hooks, Subagents, Workflows, MCP)를 명확히 하고 구체적인 복사/붙여넣기 예제를 제공하여, 범용 CLI를 프로그래밍 가능한 AI 어시스턴트 플랫폼으로 변환합니다.

라이선스 및 유지 관리 – MIT 스타일 오픈 소스 (LICENSE 참조). README에는 2026년 7월 검토 및 2026년 10월 수정 사항이 기록되어 있어 활발히 유지 관리되고 있음을 보여줍니다.