Claude Code 추천 프롬프트 전체 모음

다양한 개발 시나리오를 위한 효율적인 프롬프트 템플릿으로, 개발자가 Claude Code 사용 기술을 빠르게 습득하도록 돕습니다.

프로젝트 초기화

프로젝트 분석

프로젝트의 README.md, package.json 및 주요 디렉토리를 읽고 이 프로젝트의 아키텍처와 기술 스택을 이해하도록 도와주세요. 하지만 지금은 코드를 작성하지 마세요.

프로젝트 구성 파일 생성

프로젝트 아키텍처 설명, 자주 사용하는 명령, 코드 규칙 및 개발 환경 구성을 포함하는 상세한 CLAUDE.md 파일을 만들어 주세요.

프로젝트 환경 구성

프로젝트의 환경 구성을 확인하고 모든 종속성이 올바르게 설치되었는지 확인한 후 초기화 스크립트를 실행해 주세요. 문제가 있으면 어떻게 해결할지 알려주세요.

기능 개발

새 기능 개발 프로세스

[기능 설명]을 개발해야 합니다. 다음 단계를 따라주세요:
1. 먼저 관련 코드를 읽고 기존 아키텍처를 이해하세요
2. 상세한 구현 계획을 세우세요
3. 핵심 기능을 구현하세요
4. 테스트를 작성하세요
5. 문서를 업데이트하세요
각 단계를 완료할 때마다 일시 중지하고 제 확인을 기다려주세요.

테스트 주도 개발

[기능 설명]을 구현하려고 합니다. 먼저 예상되는 입력과 출력을 기반으로 테스트 케이스를 작성하고, 테스트가 실패하는지 확인한 다음 테스트를 통과하도록 기능 코드를 구현해 주세요.

API 인터페이스 개발

[API 설명] 인터페이스를 설계하고 구현하는 것을 도와주세요. 다음을 포함합니다:
- 라우트 정의
- 요청 매개변수 검증
- 비즈니스 로직 구현
- 응답 형식 정의
- 오류 처리
- API 문서

컴포넌트 개발

[컴포넌트 이름] 컴포넌트를 만들어 주세요. 요구사항:
- 프로젝트의 기존 컴포넌트 패턴 따르기
- TypeScript 타입 정의 포함
- [구체적인 기능 요구사항] 지원
- 해당 테스트 파일 작성

코드 디버깅 및 최적화

오류 진단

이 오류가 발생했습니다: [오류 메시지]. 오류 원인을 분석하고 수정 방안을 제공해 주세요. 관련 코드를 확인해야 한다면 알려주세요.

성능 최적화

[파일/기능]의 성능 문제를 분석하고 최적화 제안을 제공해 주세요. 다음에 중점을 두세요:
- 실행 효율성
- 메모리 사용
- 로딩 속도
- 사용자 경험

코드 리팩토링

[파일 이름]의 [함수/클래스]를 리팩토링해 주세요. 목표는:
- 코드 가독성 향상
- 중복 코드 감소
- 모범 사례 준수
- 기능 유지
먼저 기존 코드를 분석한 다음 리팩토링 계획을 제공해 주세요.

코드 검토

[파일/기능]에 대한 코드 검토를 수행해 주세요. 다음을 중점적으로 확인하세요:
- 코드 규칙
- 보안 문제
- 성능 문제
- 모범 사례
- 잠재적 버그

테스트 관련

테스트 케이스 작성

[함수/클래스/컴포넌트]에 대한 포괄적인 테스트 케이스를 작성해 주세요. 다음을 포함합니다:
- 정상 케이스 테스트
- 경계 조건 테스트
- 오류 케이스 테스트
- 종속성 모킹

테스트 수정

몇 개의 테스트가 실패했습니다. 실패 원인을 분석하고 수정해 주세요. 테스트 실행 명령은: [테스트 명령]

테스트 커버리지 향상

현재 테스트 커버리지를 분석하고 커버리지가 부족한 부분에 대한 테스트 케이스를 추가해 주세요.

프론트엔드 개발

UI 컴포넌트 구현

이 디자인에 따라 UI 컴포넌트를 구현해 주세요: [디자인 업로드]
요구사항:
- 반응형 디자인
- 다크 모드 지원
- 접근성 지원
- 디자인 규격 준수

스타일 조정

[컴포넌트/페이지]의 스타일을 최적화하여 다음 효과를 달성해 주세요:
- [구체적인 스타일 요구사항]
- 전체 디자인과의 일관성 유지
- 다양한 기기에서 정상적으로 표시되도록 보장

상태 관리

[기능]에 대한 상태 관리를 구현해 주세요. 다음을 포함합니다:
- 상태 구조 설계
- Action 정의
- Reducer 구현
- 비동기 작업 처리

백엔드 개발

데이터베이스 설계

[기능]을 위한 데이터베이스 테이블 구조를 설계해 주세요. 다음을 포함합니다:
- 테이블 구조 정의
- 인덱스 설계
- 관계 제약
- 마이그레이션 스크립트

미들웨어 개발

[미들웨어 이름] 미들웨어를 구현해 주세요. 기능은 다음을 포함합니다:
- [구체적인 기능 요구사항]
- 오류 처리
- 로깅
- 성능 모니터링

서비스 통합

[타사 서비스]를 통합하는 것을 도와주세요. 다음을 포함합니다:
- SDK 구성
- API 호출 래핑
- 오류 처리
- 단위 테스트

문서 작성

API 문서 생성

프로젝트를 위한 API 문서를 생성해 주세요. 다음을 포함합니다:
- 인터페이스 목록
- 요청 매개변수 설명
- 응답 형식 예시
- 오류 코드 설명

코드 주석

[파일/함수]에 상세한 코드 주석을 추가해 주세요. 다음을 포함합니다:
- 기능 설명
- 매개변수 설명
- 반환값 설명
- 사용 예시

README 업데이트

프로젝트의 README.md 파일을 업데이트해 주세요. 다음을 포함하도록 보장하세요:
- 프로젝트 소개
- 설치 안내
- 사용 방법
- 기여 가이드

Git 워크플로우

코드 커밋

현재 변경 사항을 검토하고 적절한 커밋 메시지를 작성하여 코드를 커밋해 주세요. 커밋 메시지는 프로젝트의 커밋 규칙을 따라야 합니다.

PR 생성

Pull Request를 생성해 주세요. 다음을 포함합니다:
- 명확한 제목과 설명
- 변경 내용 요약
- 테스트 계획
- 관련 Issue 링크

브랜치 관리

새로운 기능 브랜치 [브랜치 이름]을 만들고 해당 브랜치로 전환하여 개발을 시작하도록 도와주세요.

프로젝트 관리

작업 분해

[큰 기능 설명]을 구현해야 합니다. 여러 작은 작업으로 분해하도록 도와주세요. 각 작업은 다음을 포함합니다:
- 작업 설명
- 예상 공수
- 종속성 관계
- 인수 기준

프로젝트 계획

프로젝트 개발 계획을 세우도록 도와주세요. 다음을 포함합니다:
- 기능 모듈 구분
- 개발 우선순위
- 일정 계획
- 위험 평가

기술 선택

[프로젝트 요구사항]에 대해 기술 선택을 분석하도록 도와주세요. 다양한 솔루션의 장단점을 비교하고 가장 적합한 기술 스택을 추천해 주세요.

코드 분석

종속성 분석

프로젝트의 종속성 관계를 분석하고 다음을 확인해 주세요:
- 중복 종속성이 있는지
- 보안 취약점이 있는지
- 버전 업데이트가 필요한지
- 대체 솔루션이 있는지

아키텍처 분석

프로젝트의 전체 아키텍처를 분석하고 다음을 평가해 주세요:
- 모듈 책임이 명확한지
- 결합도가 합리적인지
- 확장성이 어떤지
- 개선할 부분이 있는지

코드 통계

프로젝트의 코드 상황을 통계화해 주세요. 다음을 포함합니다:
- 코드 줄 수
- 파일 수
- 기술 스택 분포
- 테스트 커버리지

환경 구성

개발 환경 설정

개발 환경을 구성하도록 도와주세요. 다음을 포함합니다:
- 필요한 종속성 설치
- 환경 변수 구성
- 개발 도구 설정
- 환경이 정상적으로 작동하는지 확인

CI/CD 구성

프로젝트를 위한 CI/CD 프로세스를 구성해 주세요. 다음을 포함합니다:
- 자동화 테스트
- 코드 품질 검사
- 자동 배포
- 알림 메커니즘

Docker 구성

프로젝트를 위한 Docker 구성을 만들어 주세요. 다음을 포함합니다:
- Dockerfile
- docker-compose.yml
- 환경 변수 구성
- 배포 안내

고급 기술

일괄 처리

프로젝트의 모든 [파일 유형] 파일에 대해 [작업]을 수행해 주세요. 다음을 보장하세요:
- 작업의 일관성
- 기존 기능을 손상시키지 않음
- 프로젝트 규격 준수

자동화 스크립트

[작업 설명]을 위한 자동화 스크립트를 만들어 주세요. 스크립트는 다음을 포함해야 합니다:
- 명령줄 매개변수 지원
- 오류 처리 포함
- 상세한 로그 제공
- 유지보수 용이성

코드 생성

[구성/템플릿]에 따라 해당 코드 파일을 생성해 주세요. 다음을 포함합니다:
- [구체적인 파일 유형]
- 프로젝트 규칙 준수
- 필요한 주석 포함
- 기본 테스트 통과

사용 제안

프롬프트 작성 원칙

명확하고 구체적으로

요구사항을 상세히 설명하고 모호한 표현 피하기

단계별로

복잡한 작업을 여러 단계로 분해

경계 설정

무엇을 할지, 무엇을 하지 말지 명확히 하기

컨텍스트 포함

필요한 배경 정보 제공

검증 및 확인

중요한 단계는 계속하기 전에 확인 요청

자주 사용하는 수식어

"먼저 분석해 주세요...": Claude가 행동하기 전에 이해하도록 요구
"지금은...하지 마세요": 명확한 경계 설정
"각 단계를 완료할 때마다 일시 중지": 실행 속도 제어

효율성 향상 팁

@ 사용하여 파일 참조

@src/components/Button.tsx로 파일 내용 직접 참조

확장 사고 활용

Shift+TAB을 두 번 눌러 PLAN 모드로 진입하여 계획 수립

컨텍스트 정리 합리적으로

/clear/compact를 사용하여 대화 기록 관리

사용자 정의 명령 생성

.claude/commands/ 디렉토리에 자주 사용하는 명령 정의

일괄 작업

한 번에 여러 유사한 작업을 처리하여 효율성 향상

💡 : 이러한 프롬프트 템플릿은 구체적인 프로젝트 요구사항에 따라 조정할 수 있습니다. 이 글을 일상 개발 참고 자료로 저장하고 Claude Code와의 효율적인 소통 방식을 점진적으로 익히는 것을 권장합니다.

실전 예시

예시 1: 빠른 버그 수정

npm test를 실행할 때 오류가 발생했습니다:
"TypeError: Cannot read property 'map' of undefined at UserList.tsx:45"

다음을 수행해 주세요:
1. 오류 원인 분석
2. 수정 방안 제공
3. 이 문제가 발생한 이유 설명
4. 유사한 문제를 피하는 방법 제안

예시 2: 코드 성능 최적화

사용자가 목록 페이지 로딩이 느리다고 피드백했습니다. 다음을 수행해 주세요:
1. @src/pages/UserList.tsx의 성능 병목 분석
2. React DevTools Profiler 결과를 사용하여 최적화
3. 가상 스크롤링 또는 페이지네이션 구현
4. 로딩 상태 및 오류 처리 추가
5. 최적화 후 기능이 정상적으로 작동하는지 확인

예시 3: 새 기능 구현

Excel 내보내기 기능을 추가해야 합니다:
1. 먼저 기존 테이블 컴포넌트 구현을 확인
2. 내보내기 기능의 인터페이스 설계
3. 프론트엔드 내보내기 로직 구현
4. 내보내기 버튼 및 진행 표시 추가
5. 대용량 데이터의 배치 내보내기 처리
6. 해당 테스트 케이스 작성

이러한 신중하게 설계된 프롬프트를 사용함으로써 Claude Code의 강력한 기능을 더 잘 활용하고 개발 효율성과 코드 품질을 크게 향상시킬 수 있습니다.

AI와 함께 무한한 혁신, 끝없는 기회
소개
기능 특성
사용 문서
가격 플랜
연락하기
약관 및 정책
이용 약관
개인정보 약관
특정 상거래법