Claude Code 실전 시나리오와 워크플로
다음은 가장 대표적이고 실용적인 Claude Code 워크플로로, 새 프로젝트 인수, Bug 수정, 리팩터링, 테스트 보강, 문서 작성 같은 일상 작업을 대부분 커버합니다.
자주 쓰는 워크플로
- 새 코드베이스 이해: 프로젝트 디렉터리로 이동한 뒤
claude를 실행하고 먼저 '코드베이스 개요를 보여줘', '주요 아키텍처 패턴을 설명해줘', '핵심 데이터 모델이 무엇인지 알려줘'라고 물어보세요. - 효율적인 Bug 수정: 전체 오류 메시지와 재현 단계를 그대로 붙여넣으세요. 예: 'npm test 실행 중 이 오류가 발생했습니다. 문제를 찾아서 수정해 주세요.'
- 코드 리팩터링: 먼저 Claude에게 기존 API나 중복 로직을 찾게 한 다음, '기존 동작은 그대로 유지'한다는 조건을 명확히 요구하며 리팩터링하세요.
- 테스트 처리: Claude가 커버되지 않은 코드를 먼저 식별하게 하고, 테스트와 엣지 케이스를 보강한 뒤 마지막으로 테스트를 실행해 검증합니다.
- Pull Request 생성: 먼저 변경 사항을 요약한 뒤 PR 제목, 요약, 테스트 설명 생성을 요청하고, 필요하면 보안 설명도 추가합니다.
- 문서 처리: Claude가 주석이 없는 함수를 찾고 JSDoc, README 조각 또는 마이그레이션 설명을 보완하게 할 수 있습니다.
- 이미지 사용: 스크린샷, 디자인 시안, 오류 이미지를 드래그 앤 드롭으로 전달할 수 있어 UI 문제 파악과 디자인 시안 재현에 적합합니다.
- 프로젝트 메모리 설정:
/init으로CLAUDE.md를 생성하여 자주 쓰는 명령어, 아키텍처 규칙, 코드 컨벤션을 기록합니다. - Unix 파이프 연동:
claude -p로 로그, 빌드 출력, diff를 받아 스크립트와 CI 파이프라인에 통합하기에 적합합니다. - MCP 서버 설정:
claude mcp add/list/get/remove로 외부 기능 확장을 관리합니다.
MCP 서버 설정 예시
bash
claude mcp add my-server -e API_KEY=123 -- /path/to/server
claude mcp list
claude mcp get my-server
claude mcp remove my-server파이프 연동 예시
bash
cat build-error.txt | claude -p "이 빌드 오류의 근본 원인을 간단명료하게 설명해줘" > output.txt