일반적인 워크플로우
Claude Code를 사용하여 코드베이스 탐색, 버그 수정, 리팩토링, 테스트 및 기타 일상적인 작업을 위한 단계별 가이드입니다.
이 페이지는 일상적인 개발을 위한 짧은 레시피를 모아놓았습니다. 프롬프팅 및 컨텍스트 관리에 대한 더 높은 수준의 지침은 모범 사례를 참조하십시오.
이 페이지는 다음을 다룹니다:
- 프롬프트 레시피 - 코드 탐색, 버그 수정, 리팩토링, 테스트, PR 및 문서화
- 이전 대화 재개 - 작업이 여러 세션에 걸쳐 진행될 수 있도록
- worktree를 사용하여 병렬 세션 실행 - 동시 편집이 충돌하지 않도록
- 편집 전에 계획 - 변경사항이 디스크에 닿기 전에 검토
- subagent에게 연구 위임 - 주 컨텍스트를 깨끗하게 유지
- Claude를 스크립트로 파이프 - CI 및 배치 처리용
프롬프트 레시피
이는 낯선 코드 탐색, 디버깅, 리팩토링, 테스트 작성, PR 생성과 같은 일상적인 작업을 위한 프롬프트 패턴입니다. 각각은 모든 Claude Code 표면에서 작동하며, 프로젝트에 맞게 표현을 조정하십시오.
새로운 코드베이스 이해하기
모노레포 또는 대규모 코드베이스에서 Claude Code를 구성하는 방법은 모노레포 및 대규모 저장소를 참조하십시오.
코드베이스의 빠른 개요 얻기
새로운 프로젝트에 방금 참여했고 그 구조를 빠르게 이해해야 한다고 가정해봅시다.
프로젝트 루트 디렉토리로 이동
cd /path/to/project
Claude Code 시작
claude
높은 수준의 개요 요청
give me an overview of this codebase
특정 구성 요소에 대해 더 깊이 있게 살펴보기
explain the main architecture patterns used here
what are the key data models?
how is authentication handled?
관련 코드 찾기
특정 기능이나 기능과 관련된 코드를 찾아야 한다고 가정해봅시다.
Claude에게 관련 파일을 찾도록 요청
find the files that handle user authentication
구성 요소가 어떻게 상호작용하는지에 대한 컨텍스트 얻기
how do these authentication files work together?
실행 흐름 이해하기
trace the login process from front-end to database
효율적으로 버그 수정하기
오류 메시지가 나타났고 그 원인을 찾아 수정해야 한다고 가정해봅시다.
Claude와 오류 공유하기
I'm seeing an error when I run npm test
수정 권장사항 요청하기
suggest a few ways to fix the @ts-ignore in user.ts
수정 적용하기
update user.ts to add the null check you suggested
코드 리팩토링
오래된 코드를 최신 패턴과 관행을 사용하도록 업데이트해야 한다고 가정해봅시다.
리팩토링할 레거시 코드 식별
find deprecated API usage in our codebase
리팩토링 권장사항 얻기
suggest how to refactor utils.js to use modern JavaScript features
안전하게 변경사항 적용하기
refactor utils.js to use ES2024 features while maintaining the same behavior
리팩토링 검증하기
run tests for the refactored code
테스트 작업하기
적용되지 않은 코드에 대한 테스트를 추가해야 한다고 가정해봅시다.
테스트되지 않은 코드 식별
find functions in NotificationsService.swift that are not covered by tests
테스트 스캐폴딩 생성
add tests for the notification service
의미 있는 테스트 케이스 추가
add test cases for edge conditions in the notification service
테스트 실행 및 검증
run the new tests and fix any failures
Claude는 프로젝트의 기존 패턴과 규칙을 따르는 테스트를 생성할 수 있습니다. 테스트를 요청할 때 검증하려는 동작에 대해 구체적으로 설명하십시오. Claude는 기존 테스트 파일을 검토하여 이미 사용 중인 스타일, 프레임워크 및 어설션 패턴을 일치시킵니다.
포괄적인 적용 범위를 위해 Claude에게 놓쳤을 수 있는 엣지 케이스를 식별하도록 요청하십시오. Claude는 코드 경로를 분석하고 오류 조건, 경계값 및 쉽게 간과할 수 있는 예상치 못한 입력에 대한 테스트를 제안할 수 있습니다.
풀 요청 만들기
Claude에게 직접 풀 요청을 만들도록 요청하거나 ("create a pr for my changes"), 단계별로 Claude를 안내할 수 있습니다:
변경사항 요약하기
summarize the changes I've made to the authentication module
풀 요청 생성하기
create a pr
검토 및 정제하기
enhance the PR description with more context about the security improvements
gh pr create를 사용하여 PR을 만들면 세션이 자동으로 해당 PR에 연결됩니다. 나중에 claude --from-pr <number>로 재개하거나 /resume 선택기에 PR URL을 붙여넣어 재개할 수 있습니다.
문서 처리하기
코드에 대한 문서를 추가하거나 업데이트해야 한다고 가정해봅시다.
문서화되지 않은 코드 식별
find functions without proper JSDoc comments in the auth module
문서 생성하기
add JSDoc comments to the undocumented functions in auth.js
검토 및 개선하기
improve the generated documentation with more context and examples
문서 검증하기
check if the documentation follows our project standards
노트 및 비코드 폴더에서 작업하기
Claude Code는 모든 디렉토리에서 작동합니다. 노트 저장소, 문서 폴더 또는 마크다운 파일의 모든 컬렉션 내에서 실행하여 코드처럼 콘텐츠를 검색, 편집 및 재구성합니다.
.claude/ 디렉토리와 CLAUDE.md는 다른 도구의 구성 디렉토리와 충돌 없이 나란히 있습니다. Claude는 각 도구 호출에서 파일을 새로 읽으므로 다른 애플리케이션에서 만든 편집을 다음에 파일을 읽을 때 봅니다.
이미지 작업하기
코드베이스에서 이미지를 작업해야 하고 Claude의 이미지 콘텐츠 분석 도움을 원한다고 가정해봅시다.
대화에 이미지 추가하기
다음 방법 중 하나를 사용할 수 있습니다:
- Claude Code 창으로 이미지를 드래그 앤 드롭하기
- 이미지를 복사하고 ctrl+v로 CLI에 붙여넣기 (cmd+v 사용하지 않기)
- Claude에 이미지 경로 제공하기. 예: "Analyze this image: /path/to/your/image.png"
Claude에게 이미지 분석 요청하기
What does this image show?
Describe the UI elements in this screenshot
Are there any problematic elements in this diagram?
컨텍스트를 위해 이미지 사용하기
Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
시각적 콘텐츠에서 코드 제안 얻기
Generate CSS to match this design mockup
What HTML structure would recreate this component?
파일 및 디렉토리 참조하기
@를 사용하여 Claude가 읽을 때까지 기다리지 않고 파일이나 디렉토리를 빠르게 포함합니다.
단일 파일 참조하기
Explain the logic in @src/utils/auth.js
이것은 대화에 파일의 전체 내용을 포함합니다.
디렉토리 참조하기
What's the structure of @src/components?
이것은 파일 정보가 있는 디렉토리 목록을 제공합니다.
MCP 리소스 참조하기
Show me the data from @github:repos/owner/repo/issues
이것은 @server:resource 형식을 사용하여 연결된 MCP 서버에서 데이터를 가져옵니다. 자세한 내용은 MCP 리소스를 참조하십시오.
일정에 따라 Claude 실행하기
Claude가 정기적으로 작업을 자동으로 처리하도록 하고 싶다고 가정해봅시다. 예를 들어 매일 아침 열린 PR을 검토하거나, 매주 종속성을 감사하거나, 밤새 CI 실패를 확인합니다.
작업을 실행할 위치에 따라 일정 옵션을 선택합니다:
| 옵션 | 실행 위치 | 최적 사용 |
|---|---|---|
| Routines | Anthropic 관리 인프라 | 컴퓨터가 꺼져 있어도 실행되어야 하는 작업. API 호출 또는 GitHub 이벤트 외에도 일정에 따라 트리거될 수 있습니다. claude.ai/code/routines에서 구성합니다. |
| 데스크톱 예약 작업 | 데스크톱 앱을 통한 컴퓨터 | 로컬 파일, 도구 또는 커밋되지 않은 변경사항에 직접 액세스해야 하는 작업. |
| GitHub Actions | CI 파이프라인 | 열린 PR 또는 cron 일정과 같은 저장소 이벤트와 연결된 작업. 워크플로우 구성과 함께 있어야 합니다. |
/loop |
현재 CLI 세션 | 세션이 열려 있는 동안 빠른 폴링. 새 대화를 시작하면 작업이 중지됩니다. --resume 및 --continue는 만료되지 않은 것을 복원합니다. |
Claude의 기능에 대해 Claude에게 물어보기
Claude는 자신의 문서에 대한 기본 제공 액세스 권한을 가지고 있으며 자신의 기능과 제한사항에 대한 질문에 답할 수 있습니다.
예제 질문
can Claude Code create pull requests?
how does Claude Code handle permissions?
what skills are available?
how do I use MCP with Claude Code?
how do I configure Claude Code for Amazon Bedrock?
what are the limitations of Claude Code?
이전 대화 재개하기
작업이 여러 세션에 걸쳐 진행될 때 컨텍스트를 다시 설명하는 대신 중단한 부분부터 계속합니다. Claude Code는 모든 대화를 로컬에 저장합니다.
claude --continue
이것은 현재 디렉토리에서 가장 최근 세션을 재개합니다. 아직 없으면 No conversation found to continue를 출력하고 종료합니다. claude --resume을 사용하여 목록에서 선택하거나 실행 중인 세션 내에서 /resume을 사용합니다. 세션 관리에서 이름 지정, 분기 및 전체 선택기 참조를 참조하십시오.
worktree를 사용하여 병렬 세션 실행하기
한 터미널에서 기능을 작업하는 동안 Claude가 다른 터미널에서 버그를 수정하며, 편집이 충돌하지 않습니다. 각 worktree는 자체 분기의 별도 체크아웃입니다.
claude --worktree feature-auth
다른 이름으로 두 번째 터미널에서 동일한 명령을 실행하여 격리된 병렬 세션을 시작합니다. Worktrees에서 정리, .worktreeinclude 및 비git VCS 지원을 참조하십시오. 별도의 터미널 대신 한 화면에서 병렬 세션을 모니터링하려면 백그라운드 에이전트를 참조하십시오.
편집 전에 계획하기
변경사항이 디스크에 닿기 전에 검토하려는 경우 계획 모드로 전환합니다. Claude는 파일을 읽고 계획을 제안하지만 승인할 때까지 편집하지 않습니다.
claude --permission-mode plan
세션 중에 Shift+Tab을 눌러 계획 모드로 전환할 수도 있습니다. 계획 모드에서 승인 흐름 및 텍스트 편집기에서 계획 편집을 참조하십시오.
subagent에게 연구 위임하기
큰 코드베이스를 탐색하면 컨텍스트가 파일 읽기로 채워집니다. 탐색을 위임하여 결과만 돌아오도록 합니다.
use a subagent to investigate how our auth system handles token refresh
subagent는 자체 컨텍스트 윈도우에서 파일을 읽고 요약을 보고합니다. Subagents에서 자체 도구 및 프롬프트가 있는 사용자 정의 에이전트 정의를 참조하십시오.
Claude를 스크립트로 파이프하기
CI, 사전 커밋 훅 또는 배치 처리를 위해 Claude를 비대화형으로 실행합니다. stdin 및 stdout은 모든 Unix 도구처럼 작동합니다.
git log --oneline -20 | claude -p "summarize these recent commits"
비대화형 모드에서 출력 형식, 권한 플래그 및 팬아웃 패턴을 참조하십시오.