가이드잘 쓰는 법
결과 품질을 높이는 습관
Claude가 제대로 일하게 하려면 두 가지가 핵심이다 — 문맥을 깔끔하게 관리하고, 검증으로 마무리하는 것.
한 문장으로탐색 → 계획 → 코딩 → 커밋. 큰 일은 계획부터 보고, 결과는 테스트·diff로 검증한다.
기본 리듬 — Explore → Plan → Code → Commit
Explore
탐색
먼저 코드·구조를 파악
→
Plan
계획
plan 모드로 계획 검토
→
Code
코딩
변경 제안 → 승인 → 적용
→
Commit
커밋
테스트·diff 검증 후 커밋
Shift+Tab 으로 plan 모드 전환(또는 --permission-mode plan). 검증을 지시에 포함하면 좋다: "테스트를 작성하고, 통과할 때까지 고쳐줘".
문맥 관리 — 유한한 자원
| 명령 | 언제 |
|---|---|
| /clear | 무관한 작업으로 넘어갈 때 대화 문맥 리셋 |
| /compact | 긴 대화를 요약해 압축 (초점 지정 가능) |
| /context | 현재 문맥 사용량 확인 |
| /rewind (Esc Esc) | 이전 시점(체크포인트)으로 되돌리기 |
| --continue / --resume | 지난 세션 이어서 하기 |
CLAUDE.md는 짧게모든 세션이 읽으므로 짧게 유지해야 중요 규칙을 놓치지 않는다. 자세한 최적화는 심화 → CLAUDE.md 관리·최적화.
막힐 때 — 증상별 처방
| 증상 | 원인 | 처방 |
|---|---|---|
| 엉뚱하게 일함 | 문맥에 잡동사니가 많음 | /clear 후 다시 지시 |
| 대충 답함 | 지시가 모호함 | 구체적으로 — 파일·증상·기대결과 명시 |
| 승인 창이 계속 뜸 | 매번 물어보는 기본 모드 | plan/acceptEdits 또는 allowlist 설정 |
| "완료"가 미덥다 | 검증 안 함 | "테스트 돌려서 통과 확인해줘" |
가장 중요검증 없이 "완료"로 믿지 않는다 — 테스트·스크린샷·diff로 눈으로 확인하고, 문맥은 자주 비운다(/clear).
출처: code.claude.com/docs/en/{best-practices, common-workflows}
출처: code.claude.com/docs/en/{best-practices, common-workflows}
클로드코드 시작하기공식 문서 · 12 가이드