진도
⚙️ Stage 5 · Claude Code 완전 정복

AI 에이전트
개발 운영체계

Claude Code 완전 정복 — 명령어 암기가 아닌 운영 방식을 익힙니다

Claude Code는 터미널 도구가 아닙니다. AI와 함께 안전하게 개발하는 운영체계입니다. 이 Stage 하나로 Claude Code를 완전히 내 것으로 만듭니다.

학습 시간 약 8~10시간 (가장 핵심)
11개 챕터
산출물 3개 + 7일 로드맵
✦ 이 커리큘럼을 관통하는 한 문장
"기술은 AI가, 영혼은 사람이"
Claude Code를 마스터한다는 건 명령어를 외우는 게 아닙니다. "무엇을 시킬지, 어떻게 안전하게 시킬지, 결과를 어떻게 검증할지"라는 운영 방식을 몸에 새기는 일입니다. 그게 운영체계라는 단어의 의미입니다.
🎯 Stage 4에서 받아온 것 → Stage 5에서 만들 것
예시 프로젝트: AI 뉴스레터 자동화 서비스
Stage 1~4까지 만든 모든 것 — PRD·CLAUDE.md, SKILL·Hooks, 디자인 자산이 마침내 한 자리에 모입니다. Claude Code가 이 모든 재료를 자동으로 읽고 실제 작동하는 코드를 짜기 시작합니다. 이 Stage가 끝나면 뉴스레터 서비스의 첫 기능이 GitHub에 커밋되어 있습니다.
Stage 1: 기획
→
Stage 2: 문서
→
Stage 3: 컨텍스트
→
Stage 4: 디자인
→
Stage 5: Claude Code
→
Stage 6: 배포
CHAPTER 01
설치 & 첫 실행
Mac/Windows 어디서든 5분 안에 첫 명령까지

Claude Code는 터미널 위에서 도는 AI 에이전트 환경입니다. 설치 후 첫 5분이 가장 중요합니다. 잘못된 폴더에서 시작하거나 CLAUDE.md 없이 시작하면 모든 작업이 어긋납니다.

📦 설치 3가지 방법
★ 권장
curl 설치
curl -fsSL claude.ai/install.sh | sh
공식 권장. Python+Node.js 자동 설정. 대부분의 경우 이걸로.
패키지 매니저
Homebrew (Mac)
brew install anthropic/tap/claude
Mac에서 brew를 이미 쓰면 편함. 자동 업데이트 가능.
개발자용
NPM
npm i -g @anthropic-ai/claude-code
Node.js를 이미 쓰면 가장 빠름. 글로벌 설치.
🖥️ 터미널이 무서우면 — VS Code 확장으로
VS Code Marketplace에서 Claude Code 검색 → 설치하면 VS Code 안에서 사이드 패널로 사용. 터미널 명령 없이 GUI로 시작 가능. 비개발자라면 이 방법부터.
🔌 Python + Node.js — 왜 같이 깔리나

Claude Code 본체는 가벼운 셸이지만, Skills나 Hooks가 Python·Node 스크립트로 실행됩니다. 자동차로 치면 본체는 핸들·기어, 엔진은 Python·Node입니다. curl 설치 시 알아서 깔리니 신경 안 써도 됩니다.

🚀 첫 명령 — claude /init
Terminal — 첫 실행 흐름 5분
# 1. 로그인 (브라우저 자동 열림) $ claude auth login # 2. Stage 2~3에서 만든 프로젝트 폴더로 이동 $ cd ~/Documents/projects/newsletter-mvp # 3. CLAUDE.md 있는지 확인 (필수!) $ ls # → CLAUDE.md docs/ .claude/ src/ # 4. Claude Code 실행 $ claude # 5. 첫 명령 — 프로젝트 분석 + CLAUDE.md 자동 보강 > /init # Claude가 폴더 구조를 읽고 CLAUDE.md를 보완
🏛️ 황금 원칙 — 한 작업 = 한 폴더 = 한 세션
다른 프로젝트와 폴더를 섞지 마세요. AI가 엉뚱한 파일을 수정합니다. 작업 1 = 폴더 1 = 세션 1. 새 작업이면 새 세션. 비효율적으로 보여도 이게 가장 빠릅니다 — 사고가 없으니까.
CHAPTER 02
권한 모드 6가지
Shift+Tab으로 순환 — 작업 성격에 맞춰 강도 조절

권한 모드는 "AI가 어디까지 자동으로 할 수 있는가"의 강도 조절입니다. 탐색만 할 때, 빠르게 짤 때, 위험한 작업할 때 각각 다른 모드를 씁니다. Shift+Tab으로 순환합니다.

1
default 안전
매번 확인 — 모든 도구 사용 전에 사용자 승인. 가장 안전. 처음 며칠 추천.
2
plan 읽기만
읽기·검색만, 어떤 수정도 안 함. 탐색·검토 모드. "이 코드 분석해줘", "이 폴더 구조 설명해줘"에 적합.
3
acceptEdits 반자동
파일 편집은 자동 승인, Bash는 매번 확인. 이미 익숙해진 후 일상 모드.
4
auto 자동(Max+)
위험한 명령(rm/git push --force 등)만 차단, 나머지 전부 자동. Max 플랜 이상.
5
acceptAll 고위험
대부분 자동 승인 + 위험 명령만 묻기. 검증된 작업에서만.
6
bypassPermissions 위험!
모든 확인 건너뜀. 운영 데이터 절대 금지. 격리된 컨테이너·테스트 환경에서만.
📈 초보자 추천 진화 순서
plan (탐색만) → default (매번 확인) → acceptEdits (파일은 자동) → auto (위험한 것만 차단). 3개월 안에 acceptEdits까지가 자연스러운 흐름. 처음부터 bypassPermissions 쓰지 마세요.
CHAPTER 03
슬래시 명령어 완전 정복
매일 쓰는 5개 + 세션 관리 7개 + 모델·성능 4개
★ 매일 쓰는 5개
/help전체 명령 목록
/clear대화 완전 초기화
/compact핵심만 요약 유지
/context현재 컨텍스트 사용량
/usage토큰·비용 확인
세션 관리 7개
/resume이전 세션 복귀
/rename세션 이름 변경
/rewind시간 되돌리기
/branch세션 분기
/diff변경 사항 보기
/export대화 내보내기
/btw옆에 메모 추가
모델·성능 4개
/modelhaiku/sonnet/opus
/effort사고 깊이 조절
/init프로젝트 초기 분석
/planPlan 모드 토글
💡 매일 쓰는 패턴
아침 시작: /resume → /context 확인 → 필요하면 /clear
작업 중: 컨텍스트 50% 넘으면 /compact
작업 종료: /diff로 변경 확인 → git commit → /clear
하루 마감: /usage로 비용 확인
CHAPTER 04
단축키 BEST 10
손이 키보드를 떠나지 않게 — 처음 10개만
Shift+Tab
권한 모드 순환 (default ↔ plan ↔ acceptEdits)
Esc
현재 응답·작업 즉시 멈춤
Esc+Esc
시간 되돌리기 (이전 메시지로)
Ctrl+C
비상 정지 (멈추지 않을 때)
Tab
파일·명령 자동완성
Shift+Enter
여러 줄 입력 (긴 프롬프트)
Ctrl+R
이전 명령 검색
Ctrl+G
외부 에디터로 긴 입력 작성
?
단축키 도움말 즉시 표시
Alt+T
Extended Thinking 토글
⌨️ 일주일 안에 손에 익히는 팁
매일 첫 5개만 의식적으로 쓰세요. Shift+Tab, Esc, Esc+Esc, Tab, Shift+Enter. 일주일 후 나머지 5개를 추가합니다. 한꺼번에 외우면 안 외워집니다.
CHAPTER 05 ★ 핵심
토큰 & 컨텍스트 관리
이 챕터를 못 익히면 비싼 요금 + 멍청한 AI를 동시에 마주칩니다

컨텍스트 창은 작업대 위 그릇입니다. 그릇에 너무 많이 담으면 새 재료를 못 올립니다. 토큰은 그릇 안 음식의 단위. 한국어는 영어보다 2~3배 더 토큰을 먹습니다 — 한국어 1자 ≈ 1~2 토큰, 영어 단어 1개 ≈ 1.3 토큰.

📊 70% 룰 — 컨텍스트 신호등
현재 컨텍스트 사용량 (예시)
0%50%70%100%
0~50%
안전 · 자유 작업. AI 정확도 최고.
50~70%
주의 · 새 작업이면 /compact 고려.
70%↑
로트 · 즉시 /clear 또는 새 세션.
⚖️ /clear vs /compact 정확한 차이
명령하는 일언제 쓰나
/clear 대화 완전 초기화. CLAUDE.md만 다시 로드. 다른 작업으로 넘어갈 때. 이전 작업 이력 안 필요.
/compact 대화 핵심만 요약해서 유지. 파일 컨텐츠는 버림. 같은 작업 연속할 때. 흐름은 유지하되 토큰만 비우고 싶을 때.
💰 비용 절감 7가지 실전 전략
💸 매달 30~70% 절감하는 7가지
1. /model haiku — 단순 작업은 빠르고 싼 모델로 (10배 저렴)
2. /clear 자주 — 한 작업 끝나면 무조건 비움
3. CLAUDE.md 100줄 이내 — 매 세션 자동 로드되므로 짧을수록 절약
4. 파일 통째 첨부 금지 — 필요한 부분만 발췌
5. Plan 모드로 탐색 — 코드 수정 안 할 거면 토큰 안 씀
6. 한국어 → 영어 프롬프트 (2~3배 절약) — 결과는 한국어로 받기
7. Extended Thinking은 진짜 어려운 문제에만 (Alt+T)
🚱 주방 싱크대 안티패턴 — 가장 흔한 실수
한 세션에 "PRD 검토 + 발송 코드 + 결제 + 디자인 리뷰" 다 던지기. 컨텍스트 폭발 → AI가 모든 작업을 어중간하게. 한 작업당 한 세션. 끝나면 /clear. 새 작업 시작. 이게 모델 흐름의 정답:

설계 → /clear → 실행 → 검증 (4단계 분리)
CHAPTER 06 ★ 핵심
Explore → Plan → Code → Verify
Anthropic 공식 4단계 워크플로우 — 모든 큰 작업의 표준
STEP 01
🔍
Explore
Plan 모드로 코드만 둘러보기 (읽기만)
STEP 02
📐
Plan
변경 계획을 글로 정리, 사용자 검토
STEP 03
⚙️
Code
계획대로 정확히 구현
STEP 04
✅
Verify
테스트·타입체크·빌드 검증
📰 뉴스레터 자동 발송 기능 — 4단계 적용
① Explore (Plan 모드): "src/ 폴더 보고 발송 관련 파일 찾고 현재 어떻게 짜였는지 요약"
② Plan: "매일 8시 cron으로 활성 구독자 전체에게 발송하는 기능 추가. 어떤 파일 만들고 무엇을 수정할지 plan으로 보여줘" → 사용자 OK
③ Code (acceptEdits): 계획대로 구현. 새 파일 + 변경 파일 모두 시각화
④ Verify: pnpm typecheck && pnpm test send-email 실행 → 모두 통과 → git commit
🎤 인터뷰 패턴 — 큰 작업 시작법
Plan 단계에서 AI가 자신 없으면 "먼저 인터뷰해줘"를 시키세요. "발송 기능 만들기 전에 의문점 5가지를 질문해줘. 내가 답하면 그걸 반영한 plan을 세워줘."
이 한 줄이 누락 80%를 막습니다. 큰 작업일수록 효과적.
CHAPTER 07
Skills 자동화
반복 작업을 슬래시 명령 하나로 — Karpathy + 장PM 메타 스킬

Stage 3에서 Skill 개념은 익혔습니다. Stage 5에서는 실제로 설치하고 운영합니다. 슬래시 명령(예: /newsletter-draft)으로 호출하거나, 특정 키워드/파일 패턴에서 자동 트리거됩니다.

Karpathy Skills 플러그인 설치 한 줄
# Claude Code 안에서 > /plugin install karpathy-skills # 30개 이상의 검증된 SKILL이 .claude/skills/ 에 추가됨 # 코드 리뷰 · 리팩토링 · 테스트 작성 · 디버깅 등
🧰 장PM 메타 스킬 4종

Karpathy Skills는 일반적인 작업, 장PM 메타 스킬은 "다른 스킬을 만들고 운영하는" 메타 도구입니다. 4개 다 깔아두는 걸 추천.

📐
/blueprint
새 기능 시작 시 자동으로 에이전트 설계 문서 생성. 1단계 Blueprint 자동화.
🔍
/deep-dive
다단계 인터뷰로 요구사항 끌어내서 자세한 스펙 생성. 2단계 Deep-Dive.
📝
/reflect
세션 마무리 의식. 무엇을 배웠는지 요약 → CLAUDE.md "실전 교훈"에 자동 추가.
🔄
/autoresearch
기존 SKILL을 자동으로 분석·개선하는 메타 루프. 시간 갈수록 똑똑해짐.
📰 뉴스레터 서비스용 커스텀 Skill
Stage 3에서 만든 newsletter-draft.md, seo-check.md, send-preview.md를 이제 실제로 호출합니다. 호출 후 결과가 마음에 안 들면 /autoresearch로 SKILL을 자동 개선시킵니다. SKILL은 시간이 갈수록 정교해지는 자산.
CHAPTER 08
Hooks & 가드레일
CLAUDE.md는 70% 준수, 절대 규칙은 Hooks로 강제

CLAUDE.md에 적은 규칙은 AI가 대체로 지키지만 100%는 아닙니다. "절대 어기면 안 되는 것"은 Hooks로 코드 차원에서 강제합니다. Stage 3에서 만든 settings.json이 여기서 진가를 발휘합니다.

.claude/settings.json (뉴스레터 서비스 완성본) JSON
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [{ "type": "command", "command": "./hooks/block-dangerous.sh" // rm -rf, git push --force, .env 수정 차단 }] } ], "Stop": [{ "hooks": [{ "type": "command", "command": "pnpm typecheck && pnpm lint && pnpm build" // 작업 종료 직전 자동 검증. 실패 시 AI가 다시 일함 }] }] }, "permissions": { "allow": ["Bash(pnpm:*)", "Bash(git:*)", "Read", "Edit", "Write"], "deny": ["Bash(rm -rf:*)", "Bash(git push --force:*)"] } }
💚 한 번 셋업 → 평생 보호
한 번 settings.json을 잘 짜두면 모든 세션에서 자동 작동. AI 사고를 90% 막습니다. 안전벨트가 없는 자동차로 안 다니는 것처럼, Hooks 없는 Claude Code로 작업하지 마세요.
CHAPTER 09
Harness 프레임워크 — 멀티스텝 에이전트
큰 기능을 step 단위로 분해해서 자동 실행 + 자가 교정

Harness는 Stage 1에서 만난 "적토마에 안장" 비유의 실체입니다. 큰 작업을 phase·step으로 분해하고, 각 step을 순차 실행하며, 실패 시 자동 재시도합니다. Claude Code 위에서 도는 워크플로우 엔진.

phases/index.json (뉴스레터 발송 기능 예시) JSON
{ "name": "newsletter-sender", "steps": [ { "id": "step1", "file": "step1.md", "status": "pending", // DB 스키마 }, { "id": "step2", "file": "step2.md", "status": "pending", // API 엔드포인트 }, { "id": "step3", "file": "step3.md", "status": "pending", // 발송 로직 }, { "id": "step4", "file": "step4.md", "status": "pending", // 테스트 }, { "id": "step5", "file": "step5.md", "status": "pending", // cron 등록 } ] }
STEP 1
DB 스키마
subscribers 테이블
→
STEP 2
API
/api/send 엔드포인트
→
STEP 3
발송 로직
SendGrid 통합
→
STEP 4
테스트
단위 + 통합
→
STEP 5
cron 등록
매일 08:00 실행
⚙️ execute.py 자동 실행 + 에러 복구
python execute.py 한 줄로 모든 step을 순차 실행. step3에서 실패하면 자동으로 status를 error로 바꾸고 사용자에게 알림 → 사용자가 step3.md를 수정하면 다시 pending → 자동 재시도. AI가 자기 잘못을 인지하고 고치는 자가 교정 루프.
⚡ Harness step.md 작성 프롬프트
뉴스레터 발송 기능을 Harness step으로 분해해줘. 목표: 매일 오전 8시 활성 구독자에게 개인화 뉴스레터 자동 발송 각 step.md 작성 형식: [id]: stepN [goal]: 이 step의 목표 한 문장 [input]: 이전 step에서 받는 것 (없으면 X) [work]: 구체적 작업 5단계 이내 [files]: 만들거나 수정할 파일 목록 (절대경로) [output]: 다음 step에 넘길 것 [verify]: 이 step이 성공했는지 확인하는 명령 [on_error]: 실패 시 시도할 것 5개 step으로 분해: 1. DB 스키마 (subscribers, send_logs 테이블) 2. API 엔드포인트 (/api/send POST) 3. 발송 로직 (Claude 요약 + SendGrid 통합) 4. 테스트 (단위 + 통합) 5. cron 등록 (매일 08:00 KST) 각 step.md는 마크다운, AI가 그대로 실행 가능하게 구체적으로.
CHAPTER 10
고급 패턴
병렬 세션 · 까다로운 검토자 · 엘레강트 · 자비스
🌳
병렬 세션 (git worktree)
Boris Cherny 방식. git worktree로 같은 저장소를 다른 폴더에 동시 체크아웃 → Claude Code 세션 2~3개 병렬 실행. 작업 격리.
🔬
까다로운 검토자 패턴
"이 코드를 시니어 엔지니어 입장에서 5가지 약점만 골라줘" 형식. AI가 자기 작업을 엄격히 검증. 자기 칭찬 패턴 차단.
✨
엘레강트한 해법 패턴
먼저 단순 동작으로 임시방편 → 동작 확인 → "더 엘레강트하게 다시 짜줘". 단계 분리로 안전하게 리팩토링.
🤖
자비스(Jarvis) 라우터
장PM 방법론. 한 에이전트가 작업 종류를 판별 → 적절한 sub-agent로 라우팅. 큰 시스템에서 효율 극대화.
⚡ 까다로운 검토자 역할 프롬프트
방금 작성한 코드를 시니어 엔지니어 시각으로 엄격히 리뷰해줘. 리뷰 관점 (5가지로만): 1. 보안 — SQL injection, XSS, 환경변수 노출 가능성 2. 에러 처리 — 실패 시 어떻게 되나, 재시도 로직 적절한가 3. 성능 — N+1 쿼리, 무한 루프 가능성, 메모리 누수 4. 유지보수 — 6개월 뒤 다른 사람이 읽기 쉬운가 5. 누락 — 빠진 엣지 케이스 (빈 입력, 동시 호출, 타임아웃) 각 관점에서 발견한 문제만 1줄씩. "잘 짰다"는 평가 금지. 문제 없으면 "OK". 문제 있으면 구체적 코드 라인과 개선안. 마지막에 가장 위험한 1개를 우선 수정하라고 알려줘.
CHAPTER 11
7일 실습 로드맵
매일 1~2시간씩 — 일주일 후 Claude Code가 손에 익습니다
D1
설치 & 첫 만남
curl 설치 → claude auth login → claude --version 확인 → /help 실행. 단순히 "안녕"만 보내보기.
D2
터미널 친해지기
Stage 2에서 만든 폴더로 cd → ls → claude 실행 → "이 폴더 구조 한국어로 설명해줘" (Plan 모드). 단축키 5개 익히기.
D3
첫 실전 작업 (/init + CLAUDE.md)
/init 실행 → CLAUDE.md 자동 보강 확인. Stage 3에서 만든 CLAUDE.md를 100줄 이내로 정리. settings.json 활성화.
D4
Plan 모드 익히기
Shift+Tab으로 plan 모드 → "발송 기능을 어떻게 구현할지 계획만 세워줘" → 결과 검토 → 마음에 들 때까지 수정.
D5
토큰 관리 체험
/context로 사용량 확인 → 70% 넘기 직전에 /compact, 새 작업이면 /clear. /usage로 비용 추적. /model로 haiku 전환 실험.
D6
단축키 마스터
나머지 5개 단축키 손에 익히기. Esc+Esc로 시간 되돌리기, Ctrl+G로 외부 에디터, Alt+T로 Extended Thinking 토글 체험.
D7
Skills 만들기 + 워크플로우 정리
/plugin install karpathy-skills → 장PM 메타 4개 설치 → /blueprint로 첫 Harness phase 만들기. 7일간 배운 것을 자기만의 워크플로우 1장 문서로.
🏁 7일 후의 모습
매일 30분~2시간씩만 했어도 일주일 후엔 Claude Code가 손에 익은 상태. 권한 모드를 자유롭게 전환하고, 컨텍스트를 의식적으로 관리하고, Plan-Code-Verify 흐름이 자연스러워집니다. 이때부터는 실전 기능 개발로 넘어갑니다 — Stage 6에서 본격 배포.
⚡ CLAUDE.md 기반 프로젝트 시작 프롬프트
CLAUDE.md를 읽고 이 프로젝트의 현재 상태를 파악해줘. 다음 순서로: 1. CLAUDE.md를 읽고 프로젝트 한 줄 요약 2. docs/ 폴더의 PRD.md, ARCHITECTURE.md를 읽고 어떤 단계인지 파악 3. .claude/skills/ 폴더 확인 — 어떤 SKILL이 등록되어 있는지 4. 최근 git log 5개를 보고 무엇이 마지막으로 작업됐는지 5. 이번 세션에서 무엇을 할지 후보 3가지 제안 내가 후보 중 하나를 선택하면 Plan 모드로 전환해서 계획부터 세워줘. 계획에 OK 하면 acceptEdits 모드로 실제 구현 시작. 작업 완료 후 /reflect로 학습한 내용을 CLAUDE.md "실전 교훈"에 추가.
🎯 Stage 5 산출물 — 이걸 만들어야 끝입니다
내 손으로 굴린 첫 AI 개발 사이클
읽기만 하면 의미 없습니다. 7일 로드맵을 따라 직접 Claude Code를 굴리세요. 아래 3개가 끝나면 뉴스레터 서비스의 첫 살아있는 코드가 GitHub에 올라가 있고, Stage 6 배포의 발판이 완성됩니다.
⚙️ Claude Code로 뉴스레터 기능 1개 구현 + GitHub 커밋
Explore → Plan → Code → Verify 4단계로 직접 굴려보세요. 가장 작은 기능 1개(예: "구독 가입 페이지" 또는 "관리자 발송 버튼") MVP. 마지막엔 git commit + push 완료. 폴더: src/
🧰 .claude/skills/ — 장PM 메타 스킬 4개 설치 완료
/plugin install karpathy-skills → blueprint, deep-dive, reflect, autoresearch 4개 모두 활성화 확인. Stage 3에서 만든 커스텀 SKILL 3개와 함께 작동. 폴더: .claude/skills/
🐎 phases/ — Harness 프레임워크 첫 Phase 완성
위에 만든 기능을 phases/index.json + step1.md ~ stepN.md로 분해. execute.py로 자동 실행 검증. 에러 → pending 자동 재시도 한 번 이상 경험. 폴더: phases/newsletter-sender/
📎 Stage 연결 고리: 지금 Claude Code로 짠 첫 기능 코드는 Stage 6에서 Supabase에 연결되고 Vercel에 배포됩니다. .claude/skills/와 settings.json은 Stage 6~9 전체 작업의 기반. phases/ Harness는 Stage 6에서 더 큰 기능(결제·구독·발송 통합)을 짤 때 그대로 재사용. 이 Stage가 가장 핵심인 이유 — 여기서 만든 운영체계가 나머지 4개 Stage를 굴립니다.
⚙️
Stage 5 AI 튜터
Claude Code · 권한 · 컨텍스트 · Skills · Hooks · Harness
LIVE AI
AI 튜터 응답