Claude Code로 개발하면서 “코드를 짜달라”고만 말하고 계신가요? Claude Code PDCA 워크플로우를 적용하면 체계적인 개발은 물론, 프롬프트 토큰까지 획기적으로 절약할 수 있습니다. 이 글에서는 PDCA가 무엇인지부터 실전 적용, 그리고 토큰을 아끼는 구체적인 방법까지 한 번에 정리합니다.
Claude Code PDCA란? — 4단계 개발 사이클 이해하기
PDCA는 Plan → Do → Check → Act의 4단계 반복 개선 사이클입니다. 원래 제조업 품질관리에서 시작된 방법론인데, AI 코딩 시대에 더욱 빛을 발합니다.
왜냐하면 AI에게 “이거 만들어줘”라고 한 번에 던지면 원하지 않는 결과물이 나올 확률이 높기 때문입니다. PDCA를 적용하면 각 단계에서 방향을 잡아주기 때문에 재작업(rework)이 줄어들고, 결과적으로 토큰도 절약됩니다.
PDCA 4단계 한눈에 보기
| 단계 | 영어 | 하는 일 | Claude Code 명령어 |
|---|---|---|---|
| 1단계 | Plan | 요구사항 정의, 범위 설정 | /pdca plan 기능명 |
| 2단계 | Do | 실제 코드 구현 | /pdca do 기능명 |
| 3단계 | Check | 설계 vs 구현 갭 분석 | /pdca analyze 기능명 |
| 4단계 | Act | 부족한 부분 자동 개선 | /pdca iterate 기능명 |
팁: Plan과 Do 사이에 Design 단계(
/pdca design 기능명)를 추가하면 더 정밀한 결과를 얻을 수 있습니다. 큰 기능일수록 Design 단계가 효과적입니다.
실전 예시: 로그인 기능을 PDCA로 만들기
처음 접하는 분을 위해 실제 사용 예시를 보여드리겠습니다.
Step 1: Plan — 무엇을 만들지 정의
/pdca plan user-login이 명령어 한 줄이면 Claude가 자동으로 Plan 문서를 생성합니다. 문서에는 기능 범위, 핵심 요구사항, 구현 순서 등이 포함됩니다.
이때 중요한 것은 기능명을 영어로, 간결하게 쓰는 것입니다. user-login처럼 하이픈으로 연결하면 파일명으로도 깔끔하게 사용됩니다.
Step 2: Design — 어떻게 만들지 설계
/pdca design user-loginPlan 문서를 기반으로 기술 설계서가 만들어집니다. 어떤 파일을 수정할지, 컴포넌트 구조는 어떻게 할지, API 스펙은 무엇인지 등이 정리됩니다.
Step 3: Do — 실제 구현
/pdca do user-login설계서를 참고해서 구현 가이드가 제공됩니다. 이 가이드를 따라 Claude에게 코드 작성을 요청하면 됩니다.
Step 4: Check — 갭 분석
/pdca analyze user-login구현이 끝나면 설계 문서와 실제 코드를 비교합니다. 매치율(Match Rate)이 90% 이상이면 성공, 미만이면 자동 개선이 필요합니다.
Step 5: Act — 자동 개선
/pdca iterate user-login매치율이 90% 미만이면 이 명령어로 자동 수정을 진행합니다. 최대 5회까지 반복하며, 90% 이상 달성하면 자동으로 멈춥니다.
프롬프트 토큰 절약하는 7가지 핵심 전략
Claude Code를 쓰다 보면 토큰 사용량이 순식간에 늘어나는 경험을 해보셨을 겁니다. 다음 7가지 전략을 적용하면 체감상 30~50% 토큰 절약이 가능합니다.
1. 새 대화 자주 시작하기 (가장 효과적)
대화가 길어질수록 Claude는 이전 메시지를 모두 컨텍스트에 포함합니다. 한 대화에서 여러 작업을 이어서 하면 매 응답마다 누적된 토큰이 재전송됩니다.
❌ 하나의 대화에서 3시간 연속 작업
✅ 작업 단위로 새 대화 시작 (30분~1시간 단위)PDCA와 찰떡궁합: Plan → 새 대화 → Design → 새 대화 → Do 이런 식으로 단계별로 대화를 나누면 각 대화가 가볍게 유지됩니다.
2. CLAUDE.md 파일 활용하기
프로젝트 루트에 CLAUDE.md 파일을 만들어두면, 매번 같은 설명을 반복할 필요가 없습니다.
# CLAUDE.md 예시
- 이 프로젝트는 Next.js 14 + TypeScript
- 컴포넌트는 src/components/ 에 작성
- 스타일은 Tailwind CSS 사용
- 한국어 UI, 영어 코드이 파일은 모든 대화에 자동으로 포함되므로, “이 프로젝트는 Next.js를 쓰고 있고…” 같은 설명을 매번 토큰으로 낭비하지 않아도 됩니다.
3. 명확하고 짧은 프롬프트 사용
❌ "이 파일을 보면 함수가 좀 복잡한데 혹시 리팩토링을 해줄 수 있을까요?
성능도 좀 개선하면 좋겠고 변수명도 바꿔주세요"
✅ "utils.ts의 calculateTotal 함수 리팩토링:
1) 중복 로직 제거 2) 변수명 camelCase 통일"구체적인 파일명 + 함수명 + 번호 목록 형태가 토큰 대비 효율이 가장 좋습니다.
4. /compact 명령어로 컨텍스트 압축
대화가 길어졌는데 새 대화를 시작하기 어려운 상황이라면:
/compact이 명령어는 지금까지의 대화 내용을 요약본으로 압축합니다. 핵심 컨텍스트는 유지하면서 토큰 사용량을 크게 줄여줍니다.
5. 파일 전체가 아닌 특정 부분만 요청
❌ "이 파일 전체를 리뷰해줘"
✅ "MainWindow.cs의 120~150번째 줄 리뷰해줘"Claude가 파일을 읽을 때도 토큰이 소모됩니다. 관심 있는 부분만 지정하면 불필요한 파일 읽기 토큰을 절약할 수 있습니다.
6. 한 번에 하나의 작업만 요청
❌ "로그인 기능 만들고, 회원가입도 만들고, 프로필 페이지도 만들어줘"
✅ "로그인 기능부터 만들어줘" → 완료 후 → "회원가입 만들어줘"여러 작업을 한 번에 요청하면 Claude가 전체를 동시에 파악하려고 컨텍스트를 크게 잡습니다. 순차적으로 요청하면 각 작업에 필요한 최소한의 컨텍스트만 사용합니다.
7. 불필요한 확인 요청 줄이기
❌ "이거 맞아?" → "그러면 이건?" → "진짜?" → "확실해?"
✅ 코드를 직접 확인하고 구체적인 수정 요청확인 질문도 토큰을 소모합니다. Claude의 답변을 직접 코드에서 확인한 후 구체적인 피드백을 주는 것이 훨씬 효율적입니다.
PDCA + 토큰 절약 실전 조합 팁
PDCA 워크플로우와 토큰 절약 전략을 함께 쓰면 시너지가 납니다.
| 조합 | 효과 |
|---|---|
| Plan 단계에서 CLAUDE.md 작성 | 이후 모든 대화에서 반복 설명 불필요 |
| 단계별 새 대화 시작 | 컨텍스트 누적 방지, 각 단계 집중 |
| Check에서 정확한 갭 분석 | 불필요한 수정 시행착오 방지 |
| 구체적 기능명 사용 | Claude가 바로 해당 코드를 찾아 작업 |
PDCA를 안 쓰면 어떻게 될까?
솔직히 말하면, 간단한 작업(버그 수정, 파일 1개 수정 등)에는 PDCA가 오히려 과합니다. 하지만 다음과 같은 상황에서는 PDCA 없이는 토큰 낭비가 심해집니다:
- 새로운 기능 추가 (파일 3개 이상 수정)
- 리팩토링 (여러 파일에 걸친 변경)
- 아키텍처 변경
- 팀원에게 인수인계할 문서가 필요한 경우
이런 작업에서 PDCA를 적용하면 방향 잃지 않고, 재작업 없이, 토큰도 절약하면서 개발할 수 있습니다.
자주 묻는 질문 (FAQ)
Q: PDCA 문서는 어디에 저장되나요?
Plan은 docs/01-plan/features/, Design은 docs/02-design/features/, 분석 결과는 docs/03-analysis/에 자동 저장됩니다.
Q: 매치율 90%를 못 넘기면 어떻게 하나요?/pdca iterate 명령어가 최대 5번까지 자동 수정을 시도합니다. 그래도 안 되면 수동으로 갭 리스트를 확인하고 하나씩 수정하면 됩니다.
Q: 혼자 개발하는데도 PDCA가 필요한가요?
네, 오히려 혼자일 때 더 유용합니다. Plan 문서가 일종의 셀프 코드리뷰 역할을 해서, 나중에 “이걸 왜 이렇게 만들었지?” 할 일이 줄어듭니다.
Q: 토큰 사용량은 어디서 확인하나요?
Claude Code 하단 상태바에서 현재 세션의 토큰 사용량을 확인할 수 있습니다. 또한 Anthropic Console에서 전체 사용량을 모니터링할 수 있습니다.
마무리: 오늘 바로 시작하세요
Claude Code PDCA는 어렵지 않습니다. /pdca plan 기능명 한 줄이면 시작됩니다. 처음에는 Plan → Do → Check 3단계만 써보세요. 익숙해지면 Design과 Act를 추가하면 됩니다.
토큰 절약의 핵심은 새 대화 자주 시작 + CLAUDE.md 활용 + 명확한 프롬프트 이 세 가지입니다. 이것만 실천해도 월말 토큰 청구서가 확 줄어드는 걸 느끼실 겁니다.
Claude Code 사용법 완벽 가이드도 함께 읽어보시면 기본기부터 탄탄하게 다질 수 있습니다. 바이브 코딩 입문도 참고해보세요.
