Claude Code 사용법: 30분 공식 워크숍 실무 치트키와 복붙 프롬프트

curl -fsSL https://claude.ai/install.sh | bash

brew install --cask claude-code

npm install -g @anthropic-ai/claude-code

cd my-project
claude

claude --version
claude doctor

claude --permission-mode plan

이 프로젝트를 먼저 분석해줘.

아직 코드는 수정하지 마.

다음 순서로 설명해줘.
1. 이 프로젝트가 무엇을 하는지
2. 전체 폴더 구조와 각 폴더의 역할
3. 애플리케이션이 시작되는 진입 파일
4. 핵심 비즈니스 로직이 있는 파일
5. 데이터가 들어와 화면에 표시되기까지의 흐름
6. 수정할 때 특히 조심해야 하는 파일이나 설정
7. 내가 먼저 읽으면 좋은 파일 5개

설명에는 근거가 된 파일 경로를 함께 적어줘.
확실하지 않은 내용은 추측이라고 표시해줘.

결제 완료 후 주문 상태가 변경되는 흐름만 조사해줘.

코드는 수정하지 마.
관련된 화면, API, 데이터베이스 코드, 외부 결제 연동 파일을 찾아줘.

다음 내용을 정리해줘.
- 요청이 시작되는 위치
- 주요 함수의 호출 순서
- 주문 상태가 실제로 저장되는 위치
- 실패 처리와 재시도 방식
- 관련 테스트
- 수정할 가능성이 높은 파일

각 설명 옆에 파일 경로와 함수 이름을 적어줘.

다음 기능을 추가하고 싶어.

기능:
[만들고 싶은 기능을 적어주세요]

아직 코드는 작성하지 마.
먼저 구현 계획만 만들어줘.

계획에는 다음 내용을 포함해줘.
1. 현재 동작과 변경 후 동작
2. 수정하거나 새로 만들 파일
3. 파일별 변경 내용
4. 기존 기능에 영향을 줄 수 있는 부분
5. 데이터 구조나 API 변경 여부
6. 필요한 테스트
7. 구현 순서
8. 가장 위험한 가정과 확인 방법

가능한 접근법이 둘 이상이면 장단점을 비교하고 하나를 추천해줘.
내가 계획을 승인하기 전에는 파일을 수정하지 마.

데이터베이스 스키마 변경은 제외해줘.
현재 구조를 최대한 유지하는 최소 변경안으로 다시 작성해줘.
테스트 방법과 롤백 방법도 추가해줘.
아직 코드는 작성하지 마.

계획을 승인할게. 이제 구현해줘.

다음 조건을 지켜줘.
- 승인한 범위를 벗어나지 마.
- 기존 프로젝트의 코드 스타일과 패턴을 따라가.
- 필요한 테스트를 함께 작성하거나 수정해.
- 계획과 다른 상황을 발견하면 임의로 확장하지 말고 알려줘.
- 구현 후 테스트와 빌드를 실행해.
- 실패하면 원인을 분석하고 수정한 뒤 다시 실행해.
- 마지막에 변경 파일, 테스트 결과, 남은 위험 요소를 정리해줘.
- 커밋과 푸시는 내가 요청하기 전까지 하지 마.

방금 작업을 스스로 검증해줘.

1. 변경된 파일을 다시 읽고 요구사항 누락을 찾아줘.
2. 프로젝트의 테스트, 타입 검사, 린트, 빌드 명령어를 확인해 실행해줘.
3. 실패한 항목이 있으면 원인을 설명하고 수정해줘.
4. 수정 후 같은 검사를 다시 실행해줘.
5. 테스트가 통과해도 경계값과 예외 상황을 검토해줘.
6. 실행하지 못한 검사는 통과했다고 말하지 말고 이유를 적어줘.
7. 최종 결과를 성공, 실패, 미확인으로 구분해 정리해줘.

다음 버그를 고쳐줘.

현상:
[발생한 문제]

재현 방법:
[문제를 다시 만드는 순서]

기대 결과:
[원래 나와야 하는 결과]

바로 수정하지 말고 먼저 버그를 재현해줘.
재현할 수 있으면 원인에 대한 가설을 세우고 근거를 찾아줘.
원인이 확인되면 실패하는 테스트를 먼저 추가해줘.
그다음 최소 범위로 수정하고 테스트가 통과하는지 확인해줘.
비슷한 문제가 다른 위치에도 있는지 마지막에 점검해줘.

첨부한 디자인 목업을 기준으로 이 화면을 구현해줘.

작업 후 브라우저에서 화면을 직접 열고 스크린샷을 찍어줘.
목업과 결과를 다음 기준으로 비교해줘.
- 전체 레이아웃
- 여백과 정렬
- 글자 크기와 굵기
- 색상
- 버튼과 카드 크기
- 모바일 화면

차이가 큰 항목부터 수정하고 다시 스크린샷을 찍어줘.
최대 3번 반복한 뒤 남아 있는 차이를 목록으로 정리해줘.

# 프로젝트 개요

이 프로젝트는 [누구를 위해 무엇을 제공하는 프로젝트인지] 설명합니다.

## 기술 스택

- 프레임워크: [예: Next.js]
- 언어: [예: TypeScript]
- 패키지 관리자: [예: pnpm]
- 데이터베이스: [예: PostgreSQL]
- 테스트: [예: Vitest, Playwright]

## 자주 사용하는 명령어

- 개발 서버: pnpm dev
- 단위 테스트: pnpm test
- 타입 검사: pnpm typecheck
- 린트: pnpm lint
- 프로덕션 빌드: pnpm build

## 작업 규칙

- 답변은 한국어로 작성합니다.
- 코드 수정 전에 관련 파일을 조사하고 계획을 먼저 제안합니다.
- 승인 전에는 파일을 수정하지 않습니다.
- 기존 코드 패턴을 우선하고 불필요한 리팩터링은 하지 않습니다.
- 변경한 기능에는 적절한 테스트를 추가합니다.
- 작업 후 테스트, 타입 검사, 린트, 빌드를 실행합니다.
- 실행하지 못한 검사는 성공으로 보고하지 않습니다.
- 커밋과 푸시는 사용자가 요청할 때만 수행합니다.

## 프로젝트 구조

- src/app: 라우트와 페이지
- src/components: 공용 UI 컴포넌트
- src/features: 기능별 비즈니스 로직
- src/lib: 외부 서비스와 공용 유틸리티
- tests: 자동화 테스트

## 주의사항

- [수정하면 안 되는 파일이나 폴더]
- [환경 변수 사용 규칙]
- [배포 전에 반드시 확인할 사항]

앞으로 이 프로젝트에서는 pnpm만 사용한다는 규칙을 CLAUDE.md에 추가해줘.
기존 내용과 충돌하는 규칙이 있는지도 확인해줘.

git log --oneline -20 | claude -p "최근 변경을 기능별로 묶어 한국어 주간 보고서로 정리해줘"

claude --worktree feature-auth

claude --worktree add-auth-tests

이 작업을 여러 Claude 세션에서 병렬로 진행하고 싶어.

먼저 코드를 수정하지 말고 작업을 분석해줘.
서로 같은 파일을 수정하지 않아도 되는 독립 작업으로 나눠줘.

각 작업마다 다음 내용을 적어줘.
- 작업 목표
- 담당할 파일
- 입력으로 필요한 정보
- 완료 조건
- 실행할 테스트
- 다른 작업과 합칠 때 주의할 점

독립적으로 나눌 수 없는 작업은 병렬화하지 말고 선행 작업으로 표시해줘.

이 폴더의 이미지 파일을 먼저 조사해줘.
아직 파일을 변경하지 마.

파일 형식, 크기, 해상도, 촬영 날짜를 표로 정리하고
다음 규칙으로 정리할 계획을 제안해줘.

- 긴 변을 최대 1080px로 조정
- 원본 비율 유지
- 촬영 날짜별 폴더 생성
- 파일 이름을 날짜-순번 형식으로 변경
- 원본은 original 폴더에 보존

계획과 예상 변경 파일 수를 보여준 뒤 내 승인을 기다려줘.
작업 후에는 처리 전후의 파일 수와 누락 여부를 검증해줘.

이 CSV 파일을 분석해줘.
원본 파일은 수정하지 마.

먼저 다음 내용을 확인해줘.
- 전체 행 수
- 열 이름과 데이터 형식
- 빈 값과 중복 행
- 날짜 범위
- 금액 열에 숫자가 아닌 값이 있는지

그다음 월별 합계와 평균을 계산해 새 CSV로 저장해줘.
마지막에는 원본 합계와 월별 합계가 일치하는지 검산해줘.

이 함수에 인자가 많은 이유를 현재 코드만 보고 추측하지 마.
Git 히스토리와 관련 커밋을 조사해서 인자가 추가된 순서를 찾아줘.

각 인자마다 처음 추가된 커밋, 추가 이유, 현재도 필요한지,
제거할 때 영향을 받는 호출부를 정리해줘.
근거가 부족하면 모른다고 표시하고 아직 리팩터링하지 마.

[CLI 이름]을 사용해 [하려는 작업]을 처리해줘.

사용법을 추측하지 말고 먼저 --help와 필요한 하위 명령의 --help를 확인해줘.
실행할 명령어와 예상 영향을 먼저 설명해줘.
파일 삭제, 배포, 외부 전송이 포함되면 실행 전에 내 승인을 받아줘.
작업 후에는 실제 결과를 다시 조회해 확인해줘.

이번 주의 Git 커밋과 병합된 변경을 조사해서 주간 보고서 초안을 만들어줘.

다음 기준으로 묶어줘.
- 사용자에게 전달된 기능
- 수정한 버그
- 성능이나 품질 개선
- 문서와 운영 작업
- 다음 주에 이어갈 일

각 항목에는 근거가 된 커밋이나 PR을 표시해줘.
내가 하지 않은 작업은 포함하지 마.

현재 변경 사항을 커밋 전에 리뷰해줘.
아직 커밋하거나 푸시하지 마.

요구사항 누락, 예상하지 못한 변경, 버그와 경계값,
보안 위험, 테스트 부족, 불필요하게 복잡한 코드를 확인해줘.

문제를 심각도 순으로 정리하고 파일 경로와 근거를 적어줘.
확인 후 수정이 필요한 항목은 별도 계획으로 제안해줘.