Claude Code는 터미널에서 실행되는 명령줄 에이전트로, 저장소를 읽고 파일을 편집하며 명령을 실행하고 잠재적으로 파괴적인 작업을 수행하기 전에 확인을 요청합니다. 낯선 코드베이스 탐색부터 프로덕션 코드 배포 및 유지보수까지 소프트웨어 개발 생명주기의 모든 단계에서 지원하도록 설계되었습니다.
아래 표는 Claude Code가 개발 생명주기 전반에 어떻게 적용되는지 요약합니다. 이 문서의 나머지 부분에서는 개발자가 가장 자주 사용하는 10가지 작업을 각각 샘플 프롬프트와 예상 결과와 함께 설명합니다.
1. 발견 | 2. 설계 | 3. 구축 | 4. 배포 | 5. 지원 및 확장 |
코드베이스 및 히스토리 탐색 | 프로젝트 계획 | 코드 구현 | CI/CD 자동화 | 오류 디버깅 |
문서 검색 | 기술 사양 개발 | 테스트 작성 및 실행 | 환경 구성 | 대규모 리팩토링 |
온보딩 및 학습 | 아키텍처 정의 | 커밋 및 PR 생성 | 배포 관리 | 사용량 및 성능 모니터링 |
이 가이드를 사용하는 방법
아래의 각 사용 사례에는 사용 시기, 예제 프롬프트 및 예상 결과가 포함됩니다. §9(이슈 추적기 통합)를 제외한 모든 항목에는 구성이 필요하지 않으며, 이는 일회성 MCP 커넥터 설정이 필요합니다.
사용 사례는 대부분의 개발자가 만나는 시점을 기준으로 대략 정렬되어 있습니다. 현재 작업과 일치하는 항목을 선택하세요.
사용 사례
1. 실패한 테스트 수정
사용 시기: 테스트가 실패하고 원인이 즉시 명확하지 않을 때. Claude Code를 사용하여 근본 원인을 찾고 먼저 소스 파일을 식별할 필요 없이 수정을 제안하도록 합니다.
예제 프롬프트:
> the tests in tests/auth.test.ts are failing, can you figure out why and fix them
예상 결과: Claude Code는 테스트 파일을 읽고, 테스트 중인 모듈을 통해 코드 경로를 추적하며, 불일치를 식별하고 편집을 제안합니다. 변경을 승인하면 테스트 스위트를 다시 실행하여 수정을 확인합니다.
2. 낯선 코드 이해
사용 시기: 변경을 수행하기 전에 모듈, 함수 또는 하위 시스템이 어떻게 작동하는지 이해해야 할 때(예: 코드를 인수받거나 낯선 영역을 검토할 때).
예제 프롬프트:
> walk me through how the payment retry logic works
예상 결과: Claude Code는 관련 파일을 찾고 구현을 읽으며 제어 흐름을 평문으로 설명합니다: 진입점, 결정 분기, 엣지 케이스 및 코드가 시스템의 나머지 부분과 어떻게 연결되는지. 후속 질문(예: "X는 어디서 설정되나요")을 통해 더 깊이 파고들 수 있습니다.
3. 무언가가 발생하는 위치 찾기
사용 시기: 코드베이스에 동작이 존재하지만 파일명이나 간단한 텍스트 검색으로 찾을 수 없을 때.
예제 프롬프트:
> where do we validate email addresses in this codebase? I want to add a new rule
예상 결과: Claude Code는 저장소를 검색하고 후보 파일을 열며 올바른 일치를 식별하기에 충분한 주변 컨텍스트와 함께 파일 경로 및 줄 번호를 반환합니다. 여러 위치가 존재하면 어느 것이 정보의 출처인지 표시합니다.
4. 오류 또는 스택 추적 분류
사용 시기: 런타임 오류, 스택 추적 또는 로그 출력이 있고 이를 담당 코드에 매핑해야 할 때.
예제 프롬프트:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />
at validateSession (src/auth/session.ts:47)<br /> at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>
예상 결과: Claude Code는 추적에서 참조된 파일을 읽고, 정의되지 않은 항목과 그 이유를 설명하며, 수정을 제안합니다. 깔끔한 스택 추적이 없는 오류의 경우 사용 가능한 로그 출력을 붙여넣으면 Claude Code가 컨텍스트에서 실패를 재구성합니다.
5. 계획을 세우고 리팩토링
사용 시기: 변경이 여러 파일에 걸쳐 있고 편집이 수행되기 전에 전체 범위를 검토하려고 할 때.
필수 조건: Shift+Tab을 누르면 모드 표시기가 "plan."을 표시할 때까지 누릅니다.
예제 프롬프트:
> refactor the auth module to use the new session store instead of SessionCache
예상 결과: Claude Code는 코드를 분석하고 수정할 모든 파일과 각 파일의 변경 사항을 나열하는 번호가 매겨진 계획을 생성합니다. 계획을 그대로 승인하거나 수정할 수 있습니다(예: "로그아웃 경로는 건드리지 마세요"). 승인할 때까지 파일이 편집되지 않습니다.
참고: 권한
6. 기존 코드에 대한 테스트 작성
사용 시기: 소스 파일의 테스트 커버리지가 부족하거나 프로젝트의 기존 테스트 규칙과 일치하는 추가 엣지 케이스 테스트가 필요할 때입니다.
예시 프롬프트:
> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/
예상 결과: Claude Code는 소스 파일과 참조 테스트 디렉토리를 읽고, 기존 스타일로 새로운 테스트 파일을 생성한 후 실행하여 테스트가 통과하는지 확인합니다. 명백한 커버리지 갭이 남아 있으면 이를 표시하고 해결할지 여부를 묻습니다.
7. 풀 리퀘스트 검토
사용 시기: PR을 검토하거나 요약해야 할 때, 특히 잘 알지 못하는 코드베이스 영역에서 필요합니다.
전제 조건: GitHub CLI 인증 필요 (gh auth login 한 번 실행).
예시 프롬프트:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /pr-comments
https://github.com/acme/api/pull/4471<br /> > is the error handling
solid?</td> </tr> </tbody> </table>
예상 결과: Claude Code는 diff, 검토 의견, CI 상태를 가져온 후 변경된 파일을 전체 저장소 컨텍스트에서 읽습니다. 집중된 검토를 작성하거나, 검토 의견을 작성하거나, 특정 우려 사항을 확인하거나, PR을 요약할 수 있습니다.
8. 새로운 저장소에 온보딩
사용 시기: 처음으로 저장소에서 작업하고 있으며 아키텍처, 빌드 명령, 규칙에 대한 구조화된 개요가 필요할 때입니다.
예시 프롬프트:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /init<br /> > give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>
예상 결과: /init는 프로젝트를 스캔하고 빌드 명령, 아키텍처, 규칙을 요약하는 CLAUDE.md 파일을 작성합니다. 후속 투어 프롬프트는 프로젝트 구조의 안내 둘러보기를 제공합니다. 프로젝트 컨텍스트는 세션의 나머지 기간 동안 로드된 상태로 유지됩니다.
참고: 메모리 및 CLAUDE.md
9. 이슈를 처음부터 끝까지 처리
사용 시기: 티켓을 읽고, 수정 사항을 구현하고, 도구를 전환하지 않고 단일 대화에서 검증하려고 할 때입니다.
전제 조건: MCP를 통해 연결된 이슈 추적기 (일회성 .mcp.json 구성).
예시 프롬프트:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> what's the top-priority issue assigned
to me?<br /> > go ahead and fix it</td> </tr> </tbody> </table>
예상 결과: Claude Code는 이슈 추적기를 쿼리하고, 티켓을 읽고, 관련 코드를 찾고, 수정 사항을 제안하고, 테스트를 실행합니다. 세션은 검토 가능한 diff와 티켓을 종료하는 데 필요한 컨텍스트로 끝납니다.
참고: MCP
10. 반복되는 작업을 슬래시 명령으로 변환
사용 시기: 동일한 다단계 프롬프트를 정기적으로 반복하고 (커밋 전 확인, 스탠드업 요약, PR 설명, 릴리스 노트) 전체 팀이 재사용할 수 있도록 하려고 할 때입니다.
예시 프롬프트:
> make me a /ship command that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing
예상 결과: Claude Code는 .claude/commands/에 마크다운 파일을 작성합니다. /ship 명령은 즉시 사용 가능하며 재시작이 필요하지 않으며, 저장소를 복제하는 모든 사람과 공유됩니다.
참고: 슬래시 명령
부록: 빠른 참조
# | 사용 사례 | 샘플 프롬프트 |
1 | 실패한 테스트 수정 |
|
2 | 낯선 코드 이해 |
|
3 | 무언가가 발생하는 위치 찾기 |
|
4 | 오류 분류 | 스택 추적을 붙여넣은 후 다음을 묻습니다: |
5 | 계획을 세우고 리팩토링 | Shift+Tab → 계획 모드 → 리팩토링 설명 |
6 | 테스트 작성 |
|
7 | PR 검토 |
|
8 | 저장소에 온보딩하기 |
|
9 | 이슈를 처음부터 끝까지 작업하기 |
|
10 | 슬래시 명령어 만들기 |
|
부록: 리소스 디렉토리
리소스 | 링크 |
빠른 시작 | |
일반적인 워크플로우 | |
권한 | |
메모리 및 | |
MCP 커넥터 | |
슬래시 명령어 |
/init, @-참조, 권한 모드, 스킬, MCP 및 훅에 대한 자세한 내용은 code.claude.com/docs를 참조하세요. Claude Code는 자주 업데이트되므로 내부 배포 전에 code.claude.com/docs에서 버전별 세부 사항을 확인하세요.