현직 개발자가 매일 사용하는 8가지 Claude Code 워크플로우

저는 6개월 동안 Claude Code를 주력 AI 코딩 도구로 사용해 왔습니다. 제가 했던 가장 유용한 연습은 제 생산성을 실제로 높여준 8가지 워크플로우를 정리하고, Claude 이전의 루틴에서 무엇을 대체했는지 적어보는 것이었습니다. Claude Code가 어디서 제 몫을 하는지, 어디서 단순히 소음만 더하는지 파악하려는 분들께 도움이 될까 하여 공유합니다.

나타난 패턴은 이렇습니다: Claude Code는 "행동을 명시하고 구현을 얻는" 작업에서 승리합니다. 반면 "명세가 머릿속에만 있고 아직 무엇인지 모르는" 작업에서는 패배합니다. 그래서 제 8가지 워크플로우는 모두 첫 번째 범주에 속합니다.

1. 테스트 생성
프롬프트: 함수를 붙여넣고, 다루고 싶은 동작을 설명한 뒤, 프로젝트 프레임워크에 맞는 테스트를 요청하세요.
대체한 것: 직접 테스트 코드 작성하기. 노력은 그대로인데 테스트 개수가 3배로 늘었습니다.
실패하는 경우: 테스트 설정 자체가 어려운 상태 기반 시스템의 테스트. Claude는 단언문(assertion)은 잘 쓰지만, 설정은 절반 정도 틀립니다.

2. 내 코드의 diff 리뷰
프롬프트: git diff를 붙여넣고, "버그, 엣지 케이스, 놓친 null 체크, 기존 코드베이스와의 스타일 문제를 리뷰해 줘"라고 요청하세요.
대체한 것: 제 코드를 직접 다시 읽는 것. 항상 꼼꼼하다고 생각했지만 실제론 그렇지 않았습니다.
실패하는 경우: 제품 맥락이 필요한 모든 것. Claude는 당신의 고객을 모릅니다.

3. 레거시 코드 리팩토링
프롬프트: 레거시 함수를 붙여넣고, 원하는 새로운 형태를 설명한 뒤, 동작을 유지하면서 리팩토링해 달라고 요청하세요.
대체한 것: 30~90분 걸리던 리팩토링 세션. 이제는 10분이면 끝나고 꼼꼼한 리뷰만 하면 됩니다.
중요: 테스트는 항상 실행하세요. Claude는 원본에 암시적으로 포함되어 있던 엣지 케이스 처리를 조용히 누락할 수 있습니다.

4. 마이그레이션 스크립트
데이터베이스 마이그레이션, 설정 파일 재작성, codemod 스크립트. Claude는 입력과 출력 스키마가 명확하기 때문에 일회성 마이그레이션에 유독 강합니다.

5. 익숙하지 않은 코드베이스 디버깅
프롬프트: 스택 트레이스를 붙여넣고, 관련 파일 2~3개를 붙여넣고, 시도해 본 것을 설명하세요.
대체한 것: 1시간 동안 grep과 git blame을 뒤지는 작업.

6. 기술 사양서(Tech spec) 초안 작성
기능을 설명하고, 목표, 비목표, 설계 질문, 롤아웃 계획이 포함된 1페이지 분량의 사양서를 써달라고 요청하세요. 이후 많이 수정하세요.
대체한 것: 모든 새 프로젝트마다 겪는 백지 상태의 막막함.

7. CI 실패 요약
4000줄짜리 CI 로그를 붙여넣고, "실제 근본 원인이 무엇이고 내가 봐야 할 5줄이 어디인지" 물어보세요.
대체한 것: 스크롤하기.

8. 모의 데이터(Mock) 및 픽스처 생성
특히 테스트용 API 응답 픽스처. 형태를 설명하고, 실제 예시를 붙여넣고, 엣지 케이스를 포함한 5가지 변형을 요청하세요.
대체한 것: fixtures/ 디렉토리를 수동으로 관리하기.

이 8가지는 제가 매일 사용하는 빈도순으로 나열했습니다. 1, 2, 5번은 매일, 3, 4, 7, 8번은 매주, 6번은 매달 사용합니다.

시도했다가 충분히 테스트한 후 제외한 3가지 워크플로우:

• 새 기능을 위한 페어 프로그래밍. Claude는 좋은 자동 완성 도구이지만 나쁜 페어입니다. "페어"라는 프레임은 제가 생각하는 것을 게을리하게 만듭니다. 동작을 명시하고 Claude의 결과물을 확인하는 편이 낫습니다.