Master Claude Code - Complete Guide
Master Claude Code
1️⃣ Claude Code가 모든 것을 바꾸는 이유
Claude Code는 단순한 AI 챗봇이 아닙니다. 채팅 창에서 방문하는 AI 도구를 전체 워크플로우에서 실행되는 운영 체제 레이어로 바꿔놓습니다. 누군가에게 도움을 요청하는 것과 실제로 실행할 수 있는 유능한 팀원을 갖는 것의 차이입니다.
2️⃣ Claude Code로 할 수 있는 것들
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 환경변수로 활성화됩니다.
3️⃣ Claude Code 워크플로우
Claude Code는 단일 작업뿐만 아니라, 분석부터 반복까지의 전체 개발 사이클을 지원합니다.
🧑💼 프로덕트 매니저를 위한 예시
Claude Code는 개발자만을 위한 것이 아닙니다. PM이라면 미팅 트랜스크립트로부터 PRD를 자동 생성하고, Jira 티켓을 자동으로 만들고, Slack 요약을 자동으로 게시하고, 대시보드를 업데이트하는 워크플로우를 구축할 수 있습니다. 비기술적 사용자도 자연어로 모든 작업을 수행할 수 있습니다.
4️⃣ 시작하기 (Getting Started)
📋 요구사항 체크리스트
| 항목 | 요구사항 |
|---|---|
| 운영체제 | macOS 13+, Ubuntu 20+, 또는 Windows 10+ (WSL/Git Bash) |
| Node.js | Node.js 18+ 필수 (npm으로 설치하므로 반드시 필요) |
| 구독/크레딧 | Claude Pro ($20/mo), Max ($100~$200/mo), 또는 API 크레딧 |
🖥️ 권장 설치 방법: Cursor와 함께
최상의 경험을 위해 Cursor IDE와 함께 사용하는 것이 권장됩니다.
# 1. Cursor 다운로드 (cursor.com) # 2. Cursor에서 프로젝트 폴더 열기 # 3. 터미널 열기 (View → Terminal) # 4. Claude Code 설치 & 실행 npm install -g @anthropic-ai/claude-code claude # 5. 브라우저 팝업으로 인증
💻 대안: 직접 터미널 설치
# Mac/Linux curl -fsSL https://claude.ai/install.sh | bash # Windows (PowerShell) irm https://claude.ai/install.ps1 | iex # 프로젝트 폴더로 이동 후 실행 cd ~/your-project-folder claude # 버전 확인 claude --version # 업데이트 claude update
5️⃣ MCP로 모든 것을 연결 (Connect Everything)
🔗 MCP란?
Model Context Protocol은 Claude를 외부 도구에 연결하는 개방형 표준입니다. "AI를 위한 USB-C"라고 생각하면 됩니다 — 하나의 프로토콜로 수백 개의 연결이 가능합니다.
연결 가능한 도구 카테고리
🛠️ Developer Tools
📊 Productivity
🔬 Data & Research
💬 Communication
빠른 추가 명령어
# HTTP 전송 방식으로 MCP 서버 추가 claude mcp add --transport http notion https://mcp.notion.com/mcp # OAuth 클라이언트 자격증명이 필요한 서버 (v2.1+ 신규) claude mcp add --transport http --client-id YOUR_ID --client-secret YOUR_SECRET slack https://mcp.slack.com # MCP 서버 목록 확인 claude mcp list # MCP 디버그 모드로 시작 claude --mcp-debug
6️⃣ 필수 명령어 & 단축키
⌨️ Slash 명령어 (/ 로 실행)
명령어는 정밀한 제어를 제공합니다. 긴 지시사항을 타이핑하는 대신, 하나의 명령어가 복잡한 동작을 트리거합니다.
| 명령어 | 기능 | 비고 |
|---|---|---|
/help | 사용 가능한 모든 명령어 표시 | 커스텀 명령어도 포함 |
/clear | 컨텍스트 초기화 (작업 간 사용) | 되돌릴 수 없음 |
/compact | 대화 압축으로 토큰 절약 | 75% 도달 시 자동 실행 |
/model | Opus/Sonnet/Haiku 모델 전환 | 작업 복잡도에 따라 선택 |
/init | 프로젝트 CLAUDE.md 초기화 | 새 프로젝트에서 먼저 실행 |
/review | 최근 변경사항 코드 리뷰 | — |
/cost | 세션 토큰 사용량 & 비용 확인 | — |
/context | 컨텍스트 창 사용량 시각화 | 컬러 그리드 표시 |
/mcp | MCP 서버 연결 상태 확인 | — |
/doctor | 설치 이슈 진단 | — |
/config | 설정 열기 | — |
/resume | 이전 세션 재개 | ID 또는 이름으로 지정 가능 |
/memory | CLAUDE.md 메모리 파일 편집 | — |
/agents | 서브에이전트 관리 | — |
/permissions | 권한 설정 관리 | — |
/status | 시스템 상태 확인 | — |
/rewind | 코드 변경 되돌리기 | 🆕 v2.0+ |
/usage | 플랜 사용량 한도 확인 | 🆕 v2.0+ |
/debug | 세션 문제 해결 도움 | 🆕 v2.1+ |
/tasks | 백그라운드 작업 관리 | 🆕 v2.1+ |
/teleport | 세션을 claude.ai/code로 전송 | 🆕 v2.1+ |
/plan | 계획 모드 진입 | 복잡한 작업 전 계획 수립 |
📎 파일 참조 (@ 사용)
| 구문 | 예시 | 설명 |
|---|---|---|
@filename | @report.csv | 특정 파일 참조 |
@folder/ | @data/ | 디렉토리 참조 |
| Tab 키 | — | 자동완성 경로 |
⌨️ 키보드 단축키
| 동작 | 단축키 | 비고 |
|---|---|---|
| 취소/중지 | Ctrl+C | — |
| 체크포인트 되감기 | Esc × 2 | — |
| 히스토리 검색 | Ctrl+R | 이전 세션 내용 탐색 |
| Thinking 모드 토글 | Alt+T | ⚠️ v2.1.31+에서 Tab → Alt+T로 변경됨 |
| 줄바꿈 | Shift+Enter | 🆕 v2.1+ (설정 불필요) |
| 백그라운딩 | Ctrl+B | 🆕 에이전트 & 셸 동시 백그라운딩 |
| 이미지 붙여넣기 | Ctrl+V | — |
| 셸 직접 실행 | ! 로 시작 | 예: !ls -la |
| 빠른 메모리 추가 | # 로 시작 | CLAUDE.md에 빠르게 추가 |
| 파일 자동완성 | @ + 경로 | 파일/디렉토리 참조 |
| 외부 에디터 | Ctrl+G | 긴 프롬프트 작성 시 유용 |
| 트랜스크립트 보기 | Ctrl+O | 실시간 thinking 블록 표시 |
7️⃣ Skills & CLAUDE.md
🧩 Claude Skills (재사용 가능한 자동화)
Skills는 Claude가 관련될 때 자동으로 로드하는 작업별 명령 패키지입니다. SKILL.md 파일을 만들면 Claude의 도구 키트에 추가됩니다. 직접 /skill-name으로 호출하거나, Claude가 자동으로 사용합니다.
폴더 구조
~/.claude/skills/ # 개인 스킬 (본인에게만 적용) ├── explain-code/ │ └── SKILL.md ├── prd-generator/ │ └── SKILL.md └── data-cleaner/ └── SKILL.md .claude/skills/ # 프로젝트 스킬 (팀 모두에게 적용) └── review/ └── SKILL.md
내장 스킬 (Built-in Skills)
📝 CLAUDE.md (프로젝트 메모리)
CLAUDE.md는 Claude에게 프로젝트에 대한 영구적인 컨텍스트를 제공하는 마크다운 파일입니다. 세션 간에도 지속되며, 프로젝트 규칙과 정보를 저장합니다.
# Project: Marketing Dashboard ## Key Commands - npm run build - npm test ## Style Guide - Use TypeScript - Follow existing patterns ## Important Context - Main data source: /data/analytics.csv - Deploy target: Vercel
CLAUDE.md 배치 위치
| 범위 | 경로 | 설명 |
|---|---|---|
| 🌐 전역 (Global) | ~/.claude/CLAUDE.md | 모든 프로젝트에 적용 |
| 📁 프로젝트 | /CLAUDE.md (프로젝트 루트) | 해당 프로젝트에만 적용 |
8️⃣ 프롬프팅 테크닉
Claude Code에서 최고의 결과를 얻으려면 효과적인 프롬프트 전략이 필수입니다.
| 테크닉 | 사용 시기 | 예시 |
|---|---|---|
| 🎯 구체적으로 | 항상 | "이 CSV 정리" → "B 열이 비어있는 행을 제거하고 이메일 중복 제거" |
| 📝 예시 제공 | 출력 형식이 중요할 때 | 원하는 출력물의 1-2개 예시를 보여주기 |
| 🔗 단계 연결 | 복잡한 작업 | "먼저 분석하고, 요약한 다음, 액션 아이템을 만들어줘" |
| 📏 제약조건 설정 | 품질 관리 | "최대 500단어" / "2024년 이후 데이터만 사용" |
| 🎭 역할 부여 | 전문 분석 | "데이터 분석가로서 이 데이터셋을 리뷰해줘" |
| 🧹 /clear 자주 사용 | 관련 없는 작업 사이 | 새 작업 시작 전에 컨텍스트를 초기화하여 토큰 절약 |
🏆 Pro 패턴: Checkpoint + Iterate
복잡한 작업에서 최상의 결과를 얻기 위한 반복적 접근법입니다.
① 계획 먼저 요청 "plan: 인증 시스템을 OAuth2로 리팩토링하는 계획을 세워줘" ② 실행 전 계획 검토 "이 계획이 좋아. 1단계부터 시작해줘" ③ 체크포인트 생성 # Claude가 자동으로 체크포인트를 만듦 ④ 문제 발생 시 되감기 # Esc 두 번으로 이전 체크포인트로 되돌리기 # 또는 /rewind 명령어 사용 ⑤ 구체적 피드백으로 반복 "토큰 리프레시 로직에 만료 시간 체크를 추가해줘"
💭 Think 모드 활용법
작업 복잡도에 따라 적절한 thinking 수준을 선택하세요.
| 모드 | 사용 비율 | 예시 |
|---|---|---|
| Standard (기본) | ~80% | "내비게이션에 버튼 추가해줘" |
| think: | ~15% | "think: DB 연결을 최적으로 구조화하는 방법은?" |
| think hard: | ~5% | "think hard: 전체 API 구조를 리팩토링해줘" |
9️⃣ 🆕 v2.1 신기능 하이라이트
Claude Code v2.1.0은 2026년 1월 7일에 출시되었으며 1,096개의 커밋이 포함된 대규모 업데이트입니다. 이후 v2.1.34+까지 지속적으로 개선되고 있습니다.
/teleport으로 터미널 세션을 claude.ai/code로 전송. 기기 간 이동이나 협업자와 세션 공유에 이상적.pages: "1-5"). 10페이지 이상 PDF는 경량 참조로 처리.Bash(*-h*)), 에이전트가 도구 사용 거부 시에도 중단되지 않음, respectGitignore 설정, IS_DEMO 환경변수 (스트리밍/녹화 시 이메일 숨김), Claude in Chrome (Beta) 브라우저 제어 기능.
🔟 가격 & 리소스
💰 요금제 비교 (2026년 2월 기준)
📚 공식 문서 & 리소스
| 리소스 | URL |
|---|---|
| 📖 Setup Guide | code.claude.com/docs/en/setup |
| 🔌 MCP Reference | code.claude.com/docs/en/mcp |
| ⭐ Best Practices | anthropic.com/engineering/claude-code-best-practices |
| 📝 Prompt Engineering | docs.claude.com/en/docs/build-with-claude/prompt-engineering/overview |
| 🔗 Anthropic MCP Servers | github.com/anthropics/anthropic-mcp-servers |
| 🧩 Claude Skills Tutorial | code.claude.com/docs/en/slash-commands |
| 📋 Changelog | github.com/anthropics/claude-code/blob/main/CHANGELOG.md |
📋 원본 대비 수정 & 보충 사항
이 가이드는 Aakash Gupta의 "Master Claude Code v1.0 (January 2026)" 치트시트를 기반으로 다음 사항들을 검수하고 업데이트했습니다.
🔧 수정된 내용
1. Node.js 요구사항 누락 (중요): 원본에서 요구사항 체크리스트에 Node.js 18+가 빠져 있었습니다. Claude Code는 npm으로 설치되므로 Node.js가 반드시 필요합니다.
2. Thinking 토글 단축키 변경: 원본에서는 키보드 단축키로 Esc만 기재했으나, v2.1.31+에서 Thinking 토글이 Tab에서 Alt+T로 변경되었습니다 (실수 방지 목적).
3. 이미지 붙여넣기 단축키: 원본에서 "Ctrl+V (not Cmd+V on Mac)"이라고 했으나, 실제로는 Mac에서도 Cmd+V 또는 Ctrl+V 모두 동작합니다.
➕ 추가된 내용 (v2.1+ 업데이트)
1. 새 명령어: /rewind, /usage, /debug, /tasks, /teleport, /plan, /review, /cost, /context, /memory, /agents, /resume, /status, /permissions — 원본에는 6개 명령어만 있었으나, 실제로는 20개 이상 존재합니다.
2. 새 단축키: Shift+Enter (줄바꿈), Ctrl+B (백그라운딩), Ctrl+R (히스토리 검색), Ctrl+G (외부 에디터), Ctrl+O (트랜스크립트), # (빠른 메모리 추가).
3. 주요 신기능: Agent Teams, Auto-Memory, Session Teleportation, Skills Hot Reload, Claude Opus 4.6 지원, 1M 컨텍스트 윈도우, 다국어 출력, Plan Feedback, PDF 페이지 범위 읽기, Claude in Chrome (Beta), 와일드카드 도구 권한, OAuth 클라이언트 자격증명 지원 등.
4. Think 모드 설명: standard / think / think hard 세 단계의 thinking 모드와 활용 비율을 추가했습니다.
5. 비용 정보 구체화: 평균 사용 비용 ($6/일), ROI 분석, Pro/Max 사용량 제한이 롤링 방식임을 명시했습니다.
Based on "Master Claude Code" by Aakash Gupta (v1.0, Jan 2026)
Updated & Verified for Claude Code v2.1.34+ (Feb 2026)
🔗 socdesignengineer.blogspot.com
댓글
댓글 쓰기