Claude Code 팁 – Beyond the Prompt: 숙련 사용자를 위한 완전 가이드

핵심 원칙: 자기 작업을 검증할 방법을 줘라
1. 기본을 넘는 패턴들
2. .claude 디렉터리 제대로 이해하기
3. CLAUDE.md 제대로 쓰기
4. 스킬 심화
5. 커스텀 서브에이전트 만들기
6. 잘 쓰지 않는 명령어들
7. MCPs를 파워 툴로
8. 일일 워크플로 최적화
참고 자료

Claude Code를 “프롬프트-응답” 챗봇이 아니라 가드레일이 있는 자율 에이전트로 다루기 시작하면 워크플로가 바뀐다. 이 가이드는 .claude 디렉터리부터 MCP 파워 툴까지, 숙련 사용자가 실제로 쓰는 패턴을 정리한다.

핵심 원칙: 자기 작업을 검증할 방법을 줘라

Boris Cherny(Claude Code 팀 리드)가 강조하는 가장 중요한 원칙:

Claude에게 자기 작업을 검증할 방법을 줘라. 없으면 당신이 유일한 피드백 루프다. 있으면 Claude가 실제로 작동할 때까지 반복한다. 이것 하나만으로 품질이 2~3배 향상된다.

1. 기본을 넘는 패턴들

Explore → Plan → Code: Shift+Tab 두 번으로 계획 모드(Plan mode). 읽기 전용으로 파일·흐름·데이터 모델을 탐색한 뒤 계획을 세우고 실행한다. 한 파일 이상 건드리는 작업엔 항상 사용한다.

계획 모드를 설계 문서처럼 활용: Claude 하나가 계획을 쓰면, 다른 Claude를 새 세션에서 열어 컨텍스트 편향 없이 스태프 엔지니어처럼 리뷰하게 한다. 구현이 어긋나면 계획 모드로 돌아가 검증 단계를 포함해 다시 계획한다.

참조, 설명하지 않기: “auth 모듈을 봐”가 아니라 @src/auth/login.py. 오류는 설명하지 말고 cat error.log | claude로 파이핑한다.

위임, 같이 코딩하지 않기: Cat Wu(Claude Code 팀): “모델은 직접 지시하는 엔지니어처럼 다룰 때 가장 잘 동작한다.” 단계별로 안내하지 말고 전체 작업을 위임하라.

2. .claude 디렉터리 제대로 이해하기

.claude/
├── CLAUDE.md         # 프로젝트 공유 지침 (git 추적)
├── CLAUDE.local.md   # 개인 지침·오늘 할 일 (git 무시)
├── settings.json     # 권한·hooks 설정
└── skills/           # 커스텀 스킬 모음

CLAUDE.local.md를 일일 드라이버로 활용: 오늘 작업 중인 것, 건드리면 안 되는 것, 임시 선호도. 매일 업데이트해 세션 메모리처럼 쓴다.

3. CLAUDE.md 제대로 쓰기

CLAUDE.md는 200줄짜리 핸드북이 아니다. Boris 방식의 핵심 구성:

## Architecture
- 상태는 항상 store/에만 존재
- 컴포넌트는 부작용 없음

## Never Do
- 전역 변수 사용
- console.log를 커밋에 포함

## Commands
- test: npm test
- build: npm run build
- lint: npm run lint

왜 이 결정을 내렸는지(아키텍처 근거), 절대 하지 말아야 할 것, 자주 쓰는 명령어. 이 세 가지에 집중한다.

4. 스킬 심화

스킬은 프롬프트가 아니라 실제로 실행되는 프로세스다.

.claude/skills/my-skill/
├── SKILL.md       # 언제, 어떻게 사용하는지
└── scripts/       # 에이전트가 실행하는 스크립트

실용적인 스킬 예시 (Go API 컨벤션):

# go-api

## 언제 사용하나
Go API 엔드포인트 작성 시

## 규칙
- 핸들러는 항상 errors 패키지로 오류 래핑
- 응답 구조체는 pkg/response/ 에 정의
- 테스트는 testify/assert 사용

참고할 스킬 컬렉션:

mattpocock/skills — “실제 엔지니어를 위한 스킬”
addyosmani/web-quality-skills — 웹 성능·품질 스킬

5. 커스텀 서브에이전트 만들기

서브에이전트는 특정 역할에 특화된 Claude 인스턴스다. /pr-review 에이전트 예시:

# pr-review

## 역할
시니어 코드 리뷰어

## 검토 항목
1. 버그 및 논리 오류
2. 보안 취약점 (OWASP Top 10)
3. 성능 문제
4. 테스트 커버리지 충분성
5. PR이 하나의 목적에 집중하는지

## 출력 형식
- 심각도 (critical/major/minor)별로 분류
- 코드 라인 참조 포함

참고: popular-subagents 에서 검증된 서브에이전트 패턴 확인.

6. 잘 쓰지 않는 명령어들

/goal — Ralph 루프 내장. 명확한 목표 설정 시 Claude가 달성까지 반복
/bg — 세션을 백그라운드로 전환, 다른 작업 시작
claude --bg [task] — 바로 백그라운드 작업 시작
claude --continue — 이전 세션 이어서 작업

7. MCPs를 파워 툴로

MCP는 코드베이스를 넘어 실제 데이터·서비스에 접근하게 한다.

실전 예: Obsidian 노트 워크플로

Obsidian MCP 연결 → 노트를 컨텍스트로 활용
코딩 세션 요약을 자동으로 노트에 저장
이전 결정과 패턴을 다음 세션에 주입

8. 일일 워크플로 최적화

아침: CLAUDE.local.md 업데이트 — 오늘 목표, 건드리면 안 되는 것
작업 중: Plan mode로 탐색, 위임으로 실행
PR 전: /pr-review 서브에이전트로 리뷰
끝: 세션 요약 → 노트 저장

참고 자료

Beyond the Prompt: Claude Code — Arpan Patel (2026-05-27)

Like?

AI Sparkup