Claude Code 프롬프트 잘 쓰는 5가지 패턴

1. 컨텍스트를 먼저 주고, 명령을 나중에

❌ "버튼 추가해줘"
✅ "src/components/Header.astro에 다크모드 토글 버튼을 추가해줘.
   기존 nav 오른쪽에 배치하고, tailwind의 dark: 프리픽스를 사용해."

파일 경로 + 위치 + 기술 스택을 명시하면 한 번에 원하는 결과가 나온다.

2. “~처럼” 레퍼런스 패턴

"Stripe 대시보드처럼 좌측 사이드바 + 메인 콘텐츠 레이아웃으로 만들어줘"
"Next.js의 middleware.ts 패턴처럼 인증 체크를 추가해줘"

추상적인 설명 대신 구체적인 레퍼런스를 주면 Claude가 정확한 멘탈 모델을 갖는다.

3. 제약 조건 명시

"React 컴포넌트를 만들어줘. 단, 외부 라이브러리 없이 순수 CSS만 사용하고,
 접근성(aria-label)을 반드시 포함해줘."

“하지 말 것”과 “반드시 할 것”을 명확히 하면 리비전 횟수가 줄어든다.

4. 단계별 작업 분리

❌ "풀스택 블로그 만들어줘"
✅ "1단계: 마크다운 파일을 읽어서 리스트로 보여주는 /posts 페이지 만들어줘"
   → 완성 후 → "2단계: 각 포스트의 상세 페이지 /posts/[slug] 추가해줘"

큰 작업을 쪼개면 각 단계의 품질이 올라간다.

5. CLAUDE.md로 프로젝트 컨텍스트 고정

프로젝트 루트에 CLAUDE.md를 만들어두면 매번 설명할 필요 없이 Claude가 프로젝트를 이해한다:

# 프로젝트 컨벤션
- Astro + React + Tailwind
- 한국어 콘텐츠는 파일명에 -ko 접미사
- 커밋 메시지는 conventional commits

이 파일 하나로 모든 세션에서 일관된 결과를 얻을 수 있다.