Claude Code 창시자 Boris Cherny의 팁, 공식 문서, 개발자 커뮤니티에서 반복적으로 언급되는 것들만 추렸습니다.
Claude Code v2.1.91 기준 |
🐣 [NEW v2.1.89] /buddy
Claude Code v2.1.89에 만우절(April 1st) 기념으로 추가된 이스터에그입니다.
/buddy # 버디 부화
/buddy pet # 쓰다듬기
/buddy card # 스탯 카드 보기
/buddy mute # 말풍선 끄기
/buddy unmute # 말풍선 켜기
/buddy off # 버디 숨기기
직접 /buddy를 실행해봤더니 Fimber라는 이름의 BLOB 타입 버디가 나타났습니다. 등급은 UNCOMMON이고, 스탯 구성이 꽤 그럴듯합니다:
| 스탯 | 수치 |
|---|---|
| DEBUGGING | 40 |
| PATIENCE | 70 |
| CHAOS | 51 |
| WISDOM | 29 |
| SNARK | 18 |
버디 소개 문구도 일품입니다:
"A perpetually damp blob that thrives on finding bugs through sheer stubborn persistence, narrating each breakpoint like it's solving an ancient puzzle, but forgets what it was looking for halfway through and just... oozes around your code contemplatively."
PATIENCE 70에 CHAOS 51... 어딘가 공감되는 스탯 배분이네요 😄
+이름을 직접 불러서 대화할 수도 있습니다. 예를 들어 버디 이름이 "Fimber"이라면 "Fimber, 안녕"이라고 입력하면 버디가 응답합니다. + 한글로 대답 해줘 하면 한글로 대답해요!
아직 못 본 버디 목록이 궁금하다면 → All the Claude Code buddies you haven't unlocked (Reddit)
들어가며
Claude Code 창시자 Boris Cherny가 직접 공유한 파워유저 팁, Anthropic 공식 문서의 Common Workflows, 그리고 개발자 커뮤니티에서 반복적으로 언급되는 패턴을 기반으로 웹 개발자가 실제로 가장 많이 쓰는 명령어 15개를 선정했습니다.
단순 기능 소개가 아니라 언제, 왜 쓰는지 중심으로 작성했습니다.
🏆 Top 15 웹 개발자 필수 Claude Code 명령어
1위 — /plan (Shift+Tab)
카테고리: 워크플로 | 커뮤니티 압도적 1위
개발자 커뮤니티에서 가장 많이 언급되는 습관이 바로 "plan first" 입니다. 코드를 바로 짜지 않고, 먼저 어떤 파일을 건드릴지, 어떤 방향으로 접근할지 계획을 세웁니다. 승인 전까지 파일을 수정하지 않아서 엉뚱한 방향으로 20분을 날리는 최악의 상황을 막아줍니다.
/plan
/plan OAuth2 마이그레이션 계획 세워줘
# 또는 세션 시작할 때 바로
claude --permission-mode plan💡 실전 팁: "Planning costs minutes. Rewriting generated code that went in the wrong direction costs hours." — 실제 개발자 후기. 단일 파일 수정은 그냥 하고, 멀티파일 변경이나 아키텍처 결정이 필요할 때만 /plan을 씁니다.
2위 — /compact
카테고리: 컨텍스트 관리 | 토큰 절약의 핵심
긴 세션에서 컨텍스트가 가득 찼을 때 대화를 요약해서 공간을 확보합니다. 웹 개발에서 여러 파일을 수정하다 보면 금방 컨텍스트가 차는데, 이게 없으면 세션을 통째로 다시 시작해야 합니다.
/compact
/compact 인증 구현 부분 위주로 요약해줘💡 실전 팁: 자동 압축은 컨텍스트가 한계에 근접하면 알아서 동작합니다. 하지만 큰 작업을 시작하기 전에 수동으로
/compact를 한 번 돌려두면 작업 도중 갑자기 압축이 걸리는 상황을 피할 수 있습니다. 완전히 새 작업이라면/clear로 깔끔하게 시작하는 게 낫습니다.
3위 — CLAUDE.md 설정
카테고리: 프로젝트 설정 | 가장 큰 생산성 레버
엄밀히 커맨드는 아니지만, 커뮤니티에서 가장 강조하는 것입니다. 프로젝트 루트에 CLAUDE.md를 만들어 코딩 컨벤션, 기술 스택, 금지 패턴 등을 적어두면 매 세션마다 같은 설명을 반복하지 않아도 됩니다.
# 처음 설정할 때 Claude에게 물어보기
"이 프로젝트 구조 보고 CLAUDE.md 초안 작성해줘"
# 예시 내용
# - 기술 스택: Next.js 14, TypeScript, Tailwind, Prisma
# - 컴포넌트는 항상 /components 폴더에
# - API 라우트는 항상 에러 핸들링 포함
# - console.log 대신 logger 사용💡 실전 팁: "CLAUDE.md는 조언이고, Hooks는 강제입니다." — 반드시 지켜야 하는 것(포맷, 린트)은 CLAUDE.md 대신 PreToolUse Hook으로 설정하세요.
4위 — /resume / --resume
카테고리: 세션 | 매일 쓰는 커맨드
이전 세션을 이어서 작업합니다. 웹 개발은 하루에 여러 기능을 작업하기 때문에 세션 관리가 중요합니다. --from-pr로 PR과 연결된 세션을 바로 재개할 수 있습니다.
claude --resume # 세션 목록에서 선택
claude --resume <id> # 특정 세션 바로 재개
claude --from-pr 42 # PR #42와 연결된 세션 재개💡 실전 팁:
/rename으로 세션 이름을 붙여두면/resume목록에서 훨씬 빠르게 찾을 수 있습니다.feature/auth,bugfix/payment식으로 브랜치명과 맞춰두면 편합니다.
5위 — claude -p (print 모드)
카테고리: 자동화 | 스크립트/CI 연동
가장 과소평가된 기능입니다. -p 플래그로 Claude를 파이프라인에 넣을 수 있습니다. 웹 개발 자동화에 실용적으로 쓰입니다.
# PR 보안 리뷰
gh pr diff 42 | claude -p "security review this PR"
# 커밋 메시지 자동 생성
git diff --staged | claude -p "write a conventional commit message" --model haiku
# 에러 로그 분석
tail -500 /var/log/app.log | claude -p "find the root cause"
# 릴리즈 노트 생성
git log --oneline -20 | claude -p "write release notes from these commits"💡 실전 팁: 커밋 메시지 생성 같은 단순한 작업은
--model haiku로 돌리면 빠르고 저렴합니다.
6위 — /clear
카테고리: 컨텍스트 관리 | 자주 쓰는 리셋 버튼
현재 컨텍스트를 완전히 초기화합니다. 한 작업이 끝나고 완전히 다른 작업을 시작할 때 이전 컨텍스트가 간섭하지 않도록 합니다. /compact가 요약이라면 /clear는 새 출발입니다.
/clear💡 실전 팁: 새 기능 작업을 시작하기 전에
/clear를 치는 것이 좋은 습관입니다. 이전 버그 수정 맥락이 새 기능 구현에 섞이면 예상치 못한 결과가 나올 수 있습니다.
7위 — --worktree / -w
카테고리: Git 워크플로 | Boris Cherny가 강조한 기능
Claude Code 창시자가 특히 강조한 기능입니다. 격리된 git worktree에서 실행해서 메인 브랜치를 건드리지 않고 실험할 수 있습니다. 여러 Claude 인스턴스를 병렬로 돌릴 때도 씁니다.
claude --worktree # 격리된 worktree에서 시작
claude -w
# 실전 패턴: 두 가지 구현을 병렬로 시도
# 터미널 1: claude -w (방법 A)
# 터미널 2: claude -w (방법 B)
# 더 나은 쪽을 merge💡 실전 팁: 대규모 리팩터링, A/B 구현 비교, 실험적 기능 개발에 씁니다. 모노레포라면
worktree.sparsePaths로 필요한 디렉터리만 체크아웃하세요.
8위 — /btw
카테고리: 워크플로 | 흐름을 끊지 않는 사이드 질문
Claude가 작업 중일 때 응답을 기다리지 않고 끼워넣는 사이드 질문입니다. 긴 작업 중에 궁금한 게 생겨도 메인 작업을 중단시키지 않습니다.
/btw 이 함수 왜 async로 만든 거야?
/btw 지금 몇 개 파일 수정했어?
/btw 이 패턴 이름이 뭐지?💡 실전 팁: 대규모 리팩터링 진행 중에
/btw로 현재 진행 상황이나 다음 단계를 물어보면 흐름을 유지하면서 상황을 파악할 수 있습니다.
9위 — /model
카테고리: 비용 최적화 | 작업별 모델 전환
세션 중간에 모델을 바꿉니다. 웹 개발에서 작업 성격이 계속 바뀌기 때문에 모델도 맞춰서 바꾸면 비용을 크게 절약할 수 있습니다.
/model claude-opus-4-6 # 복잡한 아키텍처 설계
/model claude-sonnet-4-6 # 일반 기능 개발 (기본값)
/model claude-haiku-4-5 # 단순 반복 작업💡 실전 팁: 단순 커밋 메시지, 변수명 제안, 간단한 보일러플레이트는 Haiku로 처리하면 됩니다. Opus는 시스템 설계, 복잡한 버그 추적 등 진짜 어려운 것에만 씁니다.
10위 — /memory
카테고리: 컨텍스트 관리 | 세션 간 기억 관리
Claude가 자동으로 저장한 메모리를 관리합니다. 프로젝트 컨텍스트, 자주 쓰는 패턴, 팀 컨벤션 등을 기억하게 해서 매 세션마다 같은 설명을 반복하지 않아도 됩니다.
/memory
# ~/.claude/MEMORY.md 직접 편집도 가능💡 실전 팁: 프로젝트 초반에 "우리 팀은 React Query를 쓰고, 상태관리는 Zustand, 스타일은 Tailwind만 써" 같은 맥락을 알려주면 자동으로 기억합니다. 이후 세션에서도 일관성이 유지됩니다.
11위 — /context
카테고리: 컨텍스트 관리 | 토큰 낭비 추적
현재 컨텍스트 창의 토큰 사용량과 최적화 제안을 줍니다. 어떤 파일이나 도구가 토큰을 많이 먹는지 파악해서 비용을 줄일 수 있습니다.
/context
# 도구별, 파일별 토큰 사용량 확인
# 구체적인 최적화 제안 제공💡 실전 팁: MCP 서버가 많을수록 토큰 오버헤드가 커집니다.
/context확인 후 현재 작업과 무관한 MCP 서버는 비활성화하세요.
12위 — /loop & /schedule
카테고리: 자동화 | 반복 모니터링
둘 다 반복 실행이지만 동작 방식이 다릅니다. /loop는 내 컴퓨터에서 돌아가고, /schedule은 Anthropic 클라우드에서 돌아서 컴퓨터를 꺼도 계속 실행됩니다.
# /loop — 로컬 실행, 내 터미널이 열려 있어야 함
/loop 5m 빌드 상태 확인해줘
/loop 30s 테스트 실패 여부 체크
# /schedule — 클라우드 실행, 컴퓨터 꺼도 동작
/schedule 매일 아침 PR 리뷰 해줘
/schedule 매주 월요일 의존성 업데이트 확인해줘💡 실전 팁: 배포 직후 단기 모니터링은
/loop, 매일 아침 PR 리뷰나 주간 보안 감사처럼 정기적인 작업은/schedule이 적합합니다./schedule은 웹이나 Desktop 앱에서도 만들 수 있습니다.
13위 — /permissions
카테고리: 워크플로 | 반복 확인 제거
Claude가 실행할 수 있는 bash 명령어와 파일 접근 범위를 관리합니다. 매번 묻는 확인 절차를 없애서 작업 속도를 올립니다.
/permissions
# "Always Allow" 설정으로 자주 쓰는 명령어 등록💡 실전 팁:
git status,git log,npm test,cat,ls같은 읽기 전용 명령어는 Always Allow로 등록해두세요. 매번 확인하는 시간을 아낄 수 있습니다.
14위 — /mcp
카테고리: 도구 연동 | 웹 개발 필수 연동
MCP 서버를 관리합니다. 웹 개발자에게 특히 유용한 연동 목록입니다.
claude mcp add playwright # 브라우저 자동화, E2E 테스트
claude mcp add github # PR 생성, 이슈 관리
claude mcp add postgres # DB 스키마 조회, 쿼리 실행
claude mcp add figma # 디자인 → 코드 변환💡 실전 팁: Playwright MCP는 웹 개발자에게 특히 강력합니다. Claude가 실제로 브라우저를 열어서 버튼을 클릭하고 UI를 검증합니다. E2E 테스트 작성이 완전히 달라집니다.
15위 — claude doctor
카테고리: 디버깅 | 막혔을 때 1순위
설치 환경, 인증, Node.js 버전, MCP 서버 연결 상태를 한 번에 진단합니다. "왜 안 되지?" 싶을 때 가장 먼저 실행할 명령어입니다.
claude doctor
# ✓ Claude Code version: 2.1.91
# ✓ Node.js version: v20.11.0
# ✓ API key: configured
# ✗ Git: not found in PATH ← 이렇게 문제를 짚어줌💡 실전 팁: 새 팀원 온보딩 시 막히면
claude doctor결과를 공유하게 하세요. 대부분의 환경 문제가 여기서 잡힙니다.
한눈에 보는 요약
| 순위 | 명령어 | 언제 쓰나 |
|---|---|---|
| 1 | /plan | 멀티파일 변경 전 항상 |
| 2 | /compact | 컨텍스트 80% 이상 찼을 때 |
| 3 | CLAUDE.md | 프로젝트 시작할 때 한 번 |
| 4 | /resume | 매일 작업 시작할 때 |
| 5 | claude -p | CI/CD, 스크립트 자동화 |
| 6 | /clear | 새 작업 시작 전 |
| 7 | --worktree | 실험적 구현, 병렬 작업 |
| 8 | /btw | 작업 중 궁금한 것 생겼을 때 |
| 9 | /model | 작업 복잡도에 맞게 |
| 10 | /memory | 팀 컨벤션 기억시킬 때 |
| 11 | /context | 토큰 오버헤드 파악할 때 |
| 12 | /loop & /schedule | 배포 모니터링, 정기 자동화 |
| 13 | /permissions | Always Allow 세팅 한 번 |
| 14 | /mcp | Playwright, GitHub 연동 |
| 15 | claude doctor | 뭔가 안 될 때 제일 먼저 |
웹 개발자 추천 워크플로 패턴
커뮤니티에서 가장 많이 언급되는 패턴입니다:
새 기능 개발: /plan → 검토 → 구현 → /compact → 다음 기능
버그 수정: claude doctor (환경 이상 없는지) → /resume (이전 맥락) → 수정
배포 후: claude -p로 로그 분석 + /loop으로 단기 모니터링, /schedule로 정기 점검 등록💡 보너스 팁 — 알면 유용한 단축키 & 숨은 커맨드
Esc 두 번 — 코드 되돌리기 (/rewind)
Claude가 코드를 수정한 뒤 "아, 이전으로 돌아가고 싶다"는 순간에 씁니다. Esc를 빠르게 두 번 누르면 대화와 파일 변경을 특정 시점으로 되돌리는 /rewind picker가 열립니다.
/rewind # 되돌릴 시점 선택 (alias: /checkpoint)
# 또는 Esc 두 번으로 동일하게 실행💡
/rewind는 대화 히스토리 + 실제 파일 변경을 함께 되돌립니다. git reset과 비슷하지만 Claude 대화 맥락까지 같이 돌아간다는 게 차이점입니다. 잘못된 방향으로 한참 진행했을 때 구원투수가 됩니다.
# 단축키 — 메모리에 즉시 저장
대화 중 중요한 내용을 바로 메모리에 저장하는 단축키입니다.
# 프롬프트 앞에 # 붙이기
# 우리 팀은 ESLint + Prettier 조합 사용, 탭은 2스페이스
# API 응답은 항상 { data, error, meta } 형태로 통일💡 CLAUDE.md를 열어서 수동으로 추가하는 것보다 훨씬 빠릅니다. 작업 중 발견한 컨벤션을 즉시 기록해두면 다음 세션에도 자동으로 반영됩니다.
! 접두사 — 즉석 bash 모드
프롬프트 앞에 !를 붙이면 Claude 없이 bash 명령어를 바로 실행하고 결과를 컨텍스트에 넣습니다.
!git status
!npm test
!cat package.json💡 결과가 컨텍스트에 자동으로 들어가서 Claude가 바로 참고할 수 있습니다. "git status 보여줘"라고 타이핑하는 것보다 훨씬 빠릅니다.
이 글은 Anthropic 공식 문서, Claude Code 창시자 Boris Cherny의 팁, 개발자 커뮤니티(GitHub, Medium, builder.io 등)에서 반복적으로 언급된 내용을 기반으로 작성했습니다.
여러분의 필수 커맨드는 뭔가요? 댓글로 알려주세요!
저는 /compact 와 /clear 없이 못살아요 ㅋㅋㅋ