Claude Code 완전 가이드

분해하고 정복하라 ykdojo

큰 문제를 잘게 쪼개는 능력이 AI 협업의 핵심입니다. AI는 명확하고 구체적인 지시를 받았을 때 최고의 성능을 발휘합니다.

계획 모드 vs. 욜로 모드 Ado

계획 모드 (Shift+Tab ×2): 코드베이스 분석 → 아키텍처 파악 → 구현 계획 작성. 승인 전까지 편집 없음.

YOLO 모드: claude --dangerously-skip-permissions로 모든 작업 자동 승인.

컨텍스트 = AI의 작업 기억 ykdojo Ado

• 단일 목적 대화: 한 세션에서 한 가지 목표에만 집중
• 선제적 압축: 대화가 길어지면 HANDOFF.md 작성 후 /clear
• /context: 컨텍스트 윈도우 사용 현황 X-Ray
• 자동 압축 비활성화: 수동 관리로 중요 정보 손실 방지

여러 주제를 한 대화에 섞으면 성능이 39%까지 저하될 수 있습니다.

올바른 추상화 수준 선택 ykdojo

미지의 영역에서 더 용감하게 ykdojo

React 전문가가 아니었지만 프론트엔드 버그를 해결하고, Rust를 한 번도 안 써봤지만 Python+Rust 문제를 풀었습니다.

반복적 문제 해결: 초기 시도 → 속도 조절("천천히 가자") → 방향 전환 → 깊이 조절 → 최종 해결

커스텀 상태 라인 ykdojo

터미널 하단에 토큰 사용량, Git 브랜치, MCP 수 등을 실시간 표시:

~/project (main*) | Tokens: 45k/200k | Opus 4.5 | MCP: 3 active

/statusline 명령어로 대화형 커스터마이징도 가능합니다.

필수 슬래시 명령어 ykdojo Ado

! Prefix: !git status → Claude 처리 없이 즉시 실행, 토큰 절약

CLAUDE.md — AI를 위한 프로젝트 설명서 Ado ykdojo

• /init 실행 → Claude가 코드베이스 분석 후 CLAUDE.md 초안 자동 생성
• 자연어로 업데이트: "Update CLAUDE.md: always use bun instead of npm"
• 간결하게 유지: 장황한 설명 대신 핵심만. 과도한 정보는 컨텍스트 낭비

터미널 별칭 ykdojo

# ~/.zshrc 또는 ~/.bashrc
alias c='claude'
alias cc='claude --continue'     # 마지막 대화 이어가기
alias cr='claude --resume'       # 대화 목록에서 선택
alias ch='claude --chrome'       # 크롬 통합 모드

세션 관리 Ado

• claude --continue: 마지막 세션 즉시 이어가기
• /rename auth-system-refactor: 세션에 이름 붙이기
• claude --resume auth-system-refactor: 이름으로 재개
• claude --teleport <session_id>: 웹 세션을 로컬로
• /export: 대화 내역 마크다운으로 내보내기

🎤 음성으로 코딩하기 ykdojo

타이핑 분당 40단어 vs 말하기 분당 150단어 = 3.75배 속도 차이!

키보드 단축키 완전 정복 Ado

/vim으로 Vim 모드 활성화 가능 (hjkl, dd, yy, p 등 지원)

터미널 출력 추출 ykdojo

• pbcopy: Claude 출력을 클립보드로 복사
• VS Code: 생성된 코드를 임시 파일로 저장 → VS Code에서 열기
• GitHub Desktop: 변경 사항 시각적 검토, 원하지 않는 변경 되돌리기

마크다운 & Notion 활용 ykdojo

복잡한 정보를 마크다운으로 전달하면 Claude가 더 정확하게 이해합니다.

Notion 트릭: Slack에서 복사한 텍스트의 링크가 사라질 때 → Notion에 먼저 붙여넣고 → Notion에서 다시 복사 → 링크가 마크다운으로 보존됨

HANDOFF.md로 선제적 압축 ykdojo

대화가 50k 토큰 이상일 때:

1. /context로 사용량 확인
2. HANDOFF.md 생성 요청 (시도한 것, 성공한 것, 실패한 것, 다음 단계)
3. /clear로 새 세션 시작
4. @HANDOFF.md로 파일 로드하여 작업 이어가기

터미널 탭으로 멀티태스킹 ykdojo

대화 복제 & 반복제 ykdojo

• /clone: 전체 복제 — A/B 비교 실험, 위험한 변경 전 백업
• /half-clone: 반복제 — 컨텍스트 절반 줄이면서 최근 작업 유지

realpath로 절대 경로 ykdojo

!realpath ../../config/database.ts
# → /Users/ykdojo/projects/myapp/config/database.ts

상대 경로 대신 절대 경로를 사용하면 Claude의 혼란을 방지할 수 있습니다.

Git + GitHub CLI 자동화 ykdojo

• 자동 커밋: "변경 사항을 분석하고 적절한 커밋 메시지를 작성한 후 커밋해줘"
• Draft PR: "현재 브랜치의 변경 사항으로 draft PR을 만들어줘"
• .github/pull_request_template.md를 만들어두면 Claude가 참고하여 PR 본문 작성

Git worktrees로 병렬 브랜치 ykdojo

# 하나의 저장소, 여러 작업 디렉토리
git worktree add ../myapp-feature-auth feature/auth
git worktree add ../myapp-hotfix hotfix/critical-bug

브랜치 전환 없이 병렬 작업. node_modules 재설치/빌드 재실행 불필요!

대화형 PR 리뷰 ykdojo

1. gh pr checkout 123 → 변경 사항 요약
2. 파일별 심층 리뷰 (보안 이슈, 성능 문제 확인)
3. 테스트 커버리지 평가 → 개선 제안 → 자동 수정

승인된 명령어 감사 (cc-safe) ykdojo

npx cc-safe ~/projects

rm -rf, sudo, curl | sh, git push --force 등 위험한 승인 명령어를 자동 감지합니다.

MCP — 외부 세계와의 연결 Ado

# 설치 예시
claude mcp add -s user playwright npx @playwright/mcp@latest
claude mcp add -s user supabase npx @supabase/mcp@latest
claude mcp add -s user firecrawl npx @firecrawl/mcp@latest

• Supabase MCP: DB 직접 쿼리 → "지난 7일간 가입한 사용자 수 조회해줘"
• Firecrawl MCP: 웹 크롤링 → "모든 제품 페이지를 CSV로 저장해줘"
• Playwright MCP: 브라우저 자동화 → 로그인 폼 테스트

Hooks — 규칙의 강제 Ado

특정 이벤트 발생 시 자동 실행되는 셸 명령어. AI의 확률적 행동에 결정론적 제어를 추가합니다.

Skills — 재사용 가능한 지식 Ado

Claude가 필요할 때 자동 호출하는 지식 조각. ~/.claude/skills/에 skill.md 파일로 생성.

Agents — 전문화된 서브에이전트 Ado

• 각자 독립적인 200k 컨텍스트 윈도우
• 병렬 실행 가능
• 전문화된 시스템 프롬프트

기능 비교표 ykdojo

시스템 프롬프트 슬림화 ykdojo

시스템 프롬프트를 19k → 10k 이하로 절반 가까이 줄이는 데 성공 (58개 패치).

• 장황한 예시, 반복 지시, 과도한 안전 경고, 미사용 도구 설명 제거
• 효과: 더 많은 코드/대화 가능, 응답 속도 향상, 비용 절감

수동 지수 백오프 ykdojo

장시간 작업 시 확인 간격을 점점 늘리기: 1분 → 2분 → 4분 → 8분…

토큰을 절약하고, Claude가 다른 작업을 병렬 수행할 수 있게 해줍니다.

백그라운드 실행 & 병렬 에이전트 ykdojo

Ctrl+B로 실행 중인 명령어를 백그라운드로. 서브에이전트 3개를 각각 다른 모듈 분석에 투입 가능.

자동화의 자동화 ykdojo

ykdojo의 자동화 여정 레벨:

1. ChatGPT 복사-붙여넣기
2. ChatGPT 플러그인 (Kaguya)
3. Claude Code 터미널 통합
4. 음성 전사 시스템
5. CLAUDE.md로 반복 지시 자동화
6. 커스텀 슬래시 명령어
7. Skills로 자동 판단
8. Hooks로 규칙 강제

Headless 모드 — CI/CD 통합 Ado

# 비대화형 실행
claude -p "Fix the lint errors"

# 파이프라인 통합
git diff | claude -p "Explain these changes"

# JSON 출력
echo "Review this PR" | claude -p --json

GitHub Actions에 통합하여 PR 자동 리뷰 가능!

Docker 컨테이너로 격리 ykdojo

docker run -it --rm \
  -v $(pwd):/workspace \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  claude-sandbox

# 컨테이너 안에서 안전하게 YOLO 모드
claude --dangerously-skip-permissions

워커 Claude 오케스트레이션: 로컬 메인 Claude가 tmux를 통해 컨테이너 안 워커 Claude에게 작업 지시 → 결과 수집

Sandbox 모드 Ado

/sandbox로 자동 승인할 명령어 범위를 정의. 와일드카드 지원.

네이티브 브라우저 통합 Ado

claude --chrome으로 Chrome과 직접 통합. 페이지 탐색, 버튼 클릭, 폼 작성, 콘솔 에러 읽기, 스크린샷 촬영 가능.

Playwright MCP Ado

헤드리스 브라우저, 다중 브라우저 지원, 네트워크 요청 가로채기, 파일 다운로드 자동화. E2E 테스트에 최적.

Gemini CLI 대체 수단 ykdojo

Claude의 브라우저로 접근 불가한 사이트 → Gemini CLI 사용. 멀티 모델 오케스트레이션도 가능!

작성-테스트 사이클 & TDD ykdojo

코드 작성 → 테스트 작성 → 실행 → 실패 시 수정 → 반복. TDD 방식도 완벽 지원:

실패하는 테스트 작성 → commit → 최소 구현 → 테스트 통과 → commit

연구 도구 & $10,000 절약 ykdojo

GitHub Actions 로그 분석, Reddit 감정 분석 등. ykdojo는 Claude Code 연구로 서비스 구독 대신 직접 구현하여 $10,000을 절약했습니다.

출력 검증 4가지 방법 ykdojo

1. 📝 테스트 코드 작성 (엣지 케이스 포함)
2. 👀 GitHub Desktop으로 시각적 diff 검토
3. 📋 Draft PR 생성하여 리뷰
4. 🔄 자기 검증 요청: "모든 주장을 검증하고 표로 정리해줘"

범용 인터페이스 ykdojo

코딩만이 아닙니다:

• 🎬 비디오 편집 (ffmpeg)
• 🎙️ 오디오 전사 (Whisper)
• 💾 디스크 공간 정리
• 📝 기술 문서 & 블로그 포스트 작성
• 🔧 DevOps — Docker 최적화, CI/CD 디버깅

10억 토큰 규칙 ykdojo

개인화된 소프트웨어 시대 ykdojo

"원하는 것이 있으면 Claude Code에게 만들어달라고 하세요. 충분히 작은 프로젝트라면 1-2시간 안에 완성할 수 있습니다."

지식 공유의 선순환 ykdojo

팁을 공유하면서 더 많이 배움. Anthropic에 기능 요청/버그 리포트도 적극 기여 → 실제 반영됨.

Extended Thinking Ado

ultrathink 키워드를 포함하면 최대 32k 토큰을 내부 추론에 할당. 복잡한 아키텍처 결정, 까다로운 디버깅에 유용.

"ultrathink: 이 아키텍처 결정의 장단점을 깊이 분석해줘"

LSP 통합 Ado

IDE 수준의 코드 인텔리전스: 즉시 진단, 코드 탐색, 타입 정보. 편집하는 즉시 타입 에러 감지 & 수정.

Claude Agent SDK Ado

import { query } from '@anthropic-ai/claude-agent-sdk';

for await (const msg of query({
  prompt: "Generate markdown API docs for all public functions in src/",
  options: {
    allowedTools: ["Read", "Write", "Glob"],
    permissionMode: "acceptEdits"
  }
})) {
  if (msg.type === 'result') console.log("Docs generated:", msg.result);
}

🌱 초급 (1-3개월)

🌿 중급 (3-12개월)

🌳 고급 (1년+)

📚 필독 참고 자료

• Claude Code 공식 문서
• ykdojo의 claude-code-tips (GitHub)
• Ado의 Advent of Claude 2025
• Anthropic 베스트 프랙티스
• r/ClaudeAI 서브레딧

⌨️ 키보드 단축키

🔧 슬래시 명령어

🖥️ CLI 플래그