Claude Code 시리즈 튜토리얼 4: Claude Code 사용 사례는 무엇인가요?

일반적인 사용 사례

사용 사례를 네 가지 범주로 나누었습니다. 빈도가 높은 순서대로 정렬했습니다.

첫 번째 범주: 코드 이해

아마 가장 많이 사용되는 유형입니다. 다른 사람의 프로젝트를 인계받거나, 오래된 모듈을 보거나, 문서가 없는 저장소를 열었을 때 직접 물어보세요.

구체적인 방법:

claude "이 프로젝트는 무엇을 하나요? 진입점은 어디인가요?" — package.json, 디렉토리 구조, 주요 파일을 읽고 요약을 제공합니다.
함수를 열고 로직을 설명하거나 흐름을 그리도록 요청합니다(텍스트로 설명).
API 요청이 프론트엔드에서 데이터베이스까지 도달하는 전체 경로를 추적하도록 합니다.

여기서 하는 일은 본질적으로 "코드 읽기의 힘든 작업"을 도와주는 것입니다. 직접 오랫동안 grep하고 머릿속에서 퍼즐을 맞출 필요가 없습니다. 경로를 정리해 주면 판단은 사용자가 합니다.

이 범주에서 대체하는 대상은: 코드 저장소를 수동으로 뒤지고, 메모하고, 호출 그래프를 그리는 작업입니다.

두 번째 범주: 코드 작성 및 수정

이것이 가장 많이 논의되는 유형이지만 실제로 가장 많이 사용되지는 않습니다. 코드 작성 시나리오는 일반적으로 다음과 같습니다.

새 기능 생성: "user 모듈 아래에 이메일 수정 인터페이스를 추가하고, 이메일 형식을 검증하며, 단위 테스트를 작성하세요."
파일 간 리팩토링: "이 세 파일에 있는 모든 moment()를 dayjs()로 바꾸고, 다른 로직은 변경하지 마세요."
마이그레이션 및 업그레이드: "이 Vue 2 컴포넌트를 Vue 3 Composition API 방식으로 변경하세요."

생성된 코드가 항상 한 번에 완벽한 것은 아니지만, 파일 간 변경을 한 번에 모두 수행할 수 있으며, 파일별로 diff를 확인하고 승인 또는 거부할 수 있습니다.

이 범주에서 대체하는 대상은: 반복적인 코드 수동 작성, 파일 간 참조 수동 검색 및 교체입니다.

세 번째 범주: 디버깅 및 수정

버그가 발생했을 때 일반적인 워크플로는 오류 메시지를 보고, 파일을 파악하고, 원인을 추측하고, 수정해 보고, 실패하면 다시 확인하는 것입니다. Claude Code는 전체 오류 스택을 직접 받아 프로젝트 코드와 결합하여 스스로 문제를 파악할 수 있습니다.

일반적인 사용법:

실패한 테스트 출력을 넘겨주면 관련 코드를 읽고 수정 제안을 제공하며, 수정 후 테스트를 다시 실행하여 통과하는지 확인합니다.
CI 오류가 발생하면 로그를 붙여넣고 수정하도록 한 후, git diff를 실행하여 변경 사항을 확인합니다.

여기서의 역할은 "1차 조사자"에 가깝습니다. 문제를 생각하는 것은 사용자지만, 파일을 뒤지고, 차이점을 비교하고, 검증 명령을 실행하는 것은 Claude Code가 합니다.

이 범주에서 대체하는 대상은: 테스트를 반복해서 실행하고, 오류 로그를 읽고, 코드 차이를 수동으로 비교하는 작업입니다.

네 번째 범주: 기타 자동화

이 범주가 가장 눈에 띄지 않지만, 이러한 작업들이 누적되면 가장 많은 시간을 절약할 수 있습니다.

예시:

Git 커밋 메시지 작성: claude "현재 git diff를 기반으로 Conventional Commits 형식의 커밋 메시지를 작성해 주세요"
PR 설명 생성: 현재 브랜치와 main의 차이점을 비교하여 이번 변경 사항 요약과 테스트 설명을 생성합니다.
릴리스 노트 작성: Claude Code가 최근 일주일간의 커밋 기록을 읽어 CHANGELOG를 생성합니다.
환경 문제 해결: "이 의존성을 설치하는 중 오류가 발생했습니다. 터미널 출력을 확인하고 원인을 찾아주세요."

이러한 작업들의 공통점은 복잡하지는 않지만 번거롭다는 것입니다. 직접 하려면 창을 전환하고 많은 타이핑을 해야 합니다. Claude Code에 맡기면 몇 초 만에 끝납니다.

이 범주에서 대체하는 대상은: 텍스트를 수동으로 편집하고, 규격화된 문서를 작성하고, 환경 설정 문제를 검색하는 작업입니다.

하나의 "지도"

이 네 가지 범주를 일상 워크플로에 적용하면 대략 다음과 같은 지도가 됩니다.

익숙하지 않은 프로젝트를 받음
    │
    ▼
[코드 이해] ─── 구조, 진입점, 핵심 로직 파악
    │
    ▼
새 기능 작성 또는 모듈 수정 시작
    │
    ▼
[코드 작성/수정] ─── 구현 생성, 파일 간 리팩토링
    │
    ▼
테스트 실행 중 버그 발생
    │
    ▼
[디버깅 및 수정] ─── 오류 분석, 문제 파악, 수정, 재실행
    │
    ▼
커밋 준비
    │
    ▼
[기타 자동화] ─── 커밋 메시지, PR 설명, 릴리스 노트 작성
    │
    ▼
커밋, 완료

네 가지 영역을 모두 사용할 필요는 없습니다. 어떤 팀은 코드 이해에만 사용하고, 어떤 사람은 테스트 작성과 PR 발행에만 사용합니다. 가장 번거로운 부분부터 시작하세요.

유용한 두 가지 판단 기준

어떤 작업을 Claude Code에 맡길지 확실하지 않다면 스스로에게 두 가지 질문을 해보세요.

1. 이 작업이 "기계적"인가요, "창의적"인가요?

백 개의 참조를 수정하거나, 출력 형식을 지정하거나, 보일러플레이트 코드를 생성하는 작업은 혼자 하면 시간이 많이 걸리지만 이미 해결 방법을 알고 있습니다. 이러한 작업은 Claude Code에 적합합니다.

2. 이 작업의 "검증 비용"이 높은가요?

수정 사항을 확인하기 위해 반복적으로 이동하고, 테스트를 실행하고, 로그를 봐야 한다면 사람이 시행착오를 겪는 것은 느립니다. Claude Code는 "수정-실행-확인-재수정" 사이클을 스스로 수행할 수 있어 훨씬 수월해집니다.