- 프롬프트 레시피 - 코드 탐색, 버그 수정, 리팩토링, 테스트, PR 및 문서화
- 이전 대화 재개 - 작업이 여러 세션에 걸쳐 진행될 수 있도록
- worktree를 사용하여 병렬 세션 실행 - 동시 편집이 충돌하지 않도록
- 편집 전에 계획 - 변경사항이 디스크에 닿기 전에 검토
- subagent에게 연구 위임 - 주 컨텍스트를 깨끗하게 유지
- Claude를 스크립트로 파이프 - CI 및 배치 처리용
프롬프트 레시피
이는 낯선 코드 탐색, 디버깅, 리팩토링, 테스트 작성, PR 생성과 같은 일상적인 작업을 위한 프롬프트 패턴입니다. 각각은 모든 Claude Code 표면에서 작동하며, 프로젝트에 맞게 표현을 조정하십시오.새로운 코드베이스 이해하기
모노레포 또는 대규모 코드베이스에서 Claude Code를 구성하는 방법은 모노레포 및 대규모 저장소를 참조하십시오.코드베이스의 빠른 개요 얻기
새로운 프로젝트에 방금 참여했고 그 구조를 빠르게 이해해야 한다고 가정해봅시다.1
프로젝트 루트 디렉토리로 이동
2
Claude Code 시작
3
높은 수준의 개요 요청
4
특정 구성 요소에 대해 더 깊이 있게 살펴보기
관련 코드 찾기
특정 기능이나 기능과 관련된 코드를 찾아야 한다고 가정해봅시다.1
Claude에게 관련 파일을 찾도록 요청
2
구성 요소가 어떻게 상호작용하는지에 대한 컨텍스트 얻기
3
실행 흐름 이해하기
효율적으로 버그 수정하기
오류 메시지가 나타났고 그 원인을 찾아 수정해야 한다고 가정해봅시다.1
Claude와 오류 공유하기
2
수정 권장사항 요청하기
3
수정 적용하기
코드 리팩토링
오래된 코드를 최신 패턴과 관행을 사용하도록 업데이트해야 한다고 가정해봅시다.1
리팩토링할 레거시 코드 식별
2
리팩토링 권장사항 얻기
3
안전하게 변경사항 적용하기
4
리팩토링 검증하기
테스트 작업하기
적용되지 않은 코드에 대한 테스트를 추가해야 한다고 가정해봅시다.1
테스트되지 않은 코드 식별
2
테스트 스캐폴딩 생성
3
의미 있는 테스트 케이스 추가
4
테스트 실행 및 검증
풀 요청 만들기
Claude에게 직접 풀 요청을 만들도록 요청하거나 (“create a pr for my changes”), 단계별로 Claude를 안내할 수 있습니다:1
변경사항 요약하기
2
풀 요청 생성하기
3
검토 및 정제하기
gh pr create를 사용하여 PR을 만들면 세션이 자동으로 해당 PR에 연결됩니다. 나중에 claude --from-pr 123으로 재개하거나 (123을 PR 번호로 바꾸기), /resume 선택기에 PR URL을 붙여넣어 재개할 수 있습니다.
문서 처리하기
코드에 대한 문서를 추가하거나 업데이트해야 한다고 가정해봅시다.1
문서화되지 않은 코드 식별
2
문서 생성하기
3
검토 및 개선하기
4
문서 검증하기
노트 및 비코드 폴더에서 작업하기
Claude Code는 모든 디렉토리에서 작동합니다. 노트 저장소, 문서 폴더 또는 마크다운 파일의 모든 컬렉션 내에서 실행하여 코드처럼 콘텐츠를 검색, 편집 및 재구성합니다..claude/ 디렉토리와 CLAUDE.md는 다른 도구의 구성 디렉토리와 충돌 없이 나란히 있습니다. Claude는 각 도구 호출에서 파일을 새로 읽으므로 다른 애플리케이션에서 만든 편집을 다음에 파일을 읽을 때 봅니다.
이미지 작업하기
코드베이스에서 이미지를 작업해야 하고 Claude의 이미지 콘텐츠 분석 도움을 원한다고 가정해봅시다.1
대화에 이미지 추가하기
다음 방법 중 하나를 사용할 수 있습니다:
- Claude Code 창으로 이미지를 드래그 앤 드롭하기
- 이미지를 복사하고 Ctrl+V로 CLI에 붙여넣기. macOS에서는 iTerm2에서도 Cmd+V가 작동합니다.
- Claude에 이미지 경로 제공하기. 예: “Analyze this image: /path/to/your/image.png”
2
Claude에게 이미지 분석 요청하기
3
컨텍스트를 위해 이미지 사용하기
4
시각적 콘텐츠에서 코드 제안 얻기
파일 및 디렉토리 참조하기
@를 사용하여 Claude가 읽을 때까지 기다리지 않고 파일이나 디렉토리를 빠르게 포함합니다.1
단일 파일 참조하기
2
디렉토리 참조하기
3
MCP 리소스 참조하기
일정에 따라 Claude 실행하기
Claude가 정기적으로 작업을 자동으로 처리하도록 하고 싶다고 가정해봅시다. 예를 들어 매일 아침 열린 PR을 검토하거나, 매주 종속성을 감사하거나, 밤새 CI 실패를 확인합니다. 작업을 실행할 위치에 따라 일정 옵션을 선택합니다:Claude의 기능에 대해 Claude에게 물어보기
Claude는 자신의 문서에 대한 기본 제공 액세스 권한을 가지고 있으며 자신의 기능과 제한사항에 대한 질문에 답할 수 있습니다.예제 질문
Claude는 이러한 질문에 대해 문서 기반 답변을 제공합니다. 실행 가능한 예제 및 실습 시연을 위해
/powerup을 실행하여 애니메이션 데모가 있는 대화형 수업을 받거나 위의 특정 워크플로우 섹션을 참조하십시오.이전 대화 재개하기
작업이 여러 세션에 걸쳐 진행될 때 컨텍스트를 다시 설명하는 대신 중단한 부분부터 계속합니다. Claude Code는 모든 대화를 로컬에 저장합니다.No conversation found to continue를 출력하고 종료합니다. claude --resume을 사용하여 목록에서 선택하거나 실행 중인 세션 내에서 /resume을 사용합니다. 세션 관리에서 이름 지정, 분기 및 전체 선택기 참조를 참조하십시오.
worktree를 사용하여 병렬 세션 실행하기
한 터미널에서 기능을 작업하는 동안 Claude가 다른 터미널에서 버그를 수정하며, 편집이 충돌하지 않습니다. 각 worktree는 자체 분기의 별도 체크아웃입니다..worktreeinclude 및 비git VCS 지원을 참조하십시오. 별도의 터미널 대신 한 화면에서 병렬 세션을 모니터링하려면 백그라운드 에이전트를 참조하십시오.
편집 전에 계획하기
변경사항이 디스크에 닿기 전에 검토하려는 경우 계획 모드로 전환합니다. Claude는 파일을 읽고 계획을 제안하지만 승인할 때까지 편집하지 않습니다.Shift+Tab을 눌러 계획 모드로 전환할 수도 있습니다. 계획 모드에서 승인 흐름 및 텍스트 편집기에서 계획 편집을 참조하십시오.
subagent에게 연구 위임하기
큰 코드베이스를 탐색하면 컨텍스트가 파일 읽기로 채워집니다. 탐색을 위임하여 결과만 돌아오도록 합니다.Claude를 스크립트로 파이프하기
CI, 사전 커밋 훅 또는 배치 처리를 위해 Claude를 비대화형으로 실행합니다. stdin 및 stdout은 모든 Unix 도구처럼 작동합니다.다음 단계
모범 사례
Claude Code에서 최대한 활용하기 위한 패턴
세션 관리
대화 재개, 이름 지정 및 분기
Worktrees
격리된 병렬 세션 실행
Claude Code 확장하기
skill, hook, MCP, subagent 및 플러그인 추가