리포 인식 리팩토링의 실제 승리: 클로드 코드를 자동완성처럼 사용하지 마세요

r/ClaudeAI의 한 개발자가 중요한 인사이트를 공유합니다: Claude Code는 전체 기능을 생성하는 자동완성처럼 사용할 때보다, 기존 코드베이스에서 점진적으로 작업하는 저장소 인식 리팩토링 도우미로 사용할 때 훨씬 유용해집니다.

무엇이 달라졌나

처음에 이 사용자는 Claude Code를 '전체 기능을 만들어 줘' 같은 원샷 생성에 의존했고, 결과는 엇갈렸습니다. 전환점은 실제 코드베이스에서 점진적이고 반복적인 편집으로 방향을 바꾸면서 찾아왔습니다.

가장 큰 성과

• 아키텍처 추적 — 낯선 코드베이스에서도 쉽게 파악
• 복잡한 파일 정리 — 큰 함수 분해, 의존성 명확화
• 반복적 편집 — 긴 세션 동안 단계별로 로직 개선
• 숨은 결합 발견 — 코드만 읽어서는 보이지 않는 모듈 간 연결
• 문제 원인 설명 — 단순한 패치 대신 왜 문제인지 파악

핵심 교훈

이 도구는 기존 저장소에서 점진적으로 작업할 때 빛을 발합니다. '앱 전체를 만들어 줘' 같은 원샷 프롬프트가 아닙니다. Claude Code에서 좋은 결과를 얻지 못하고 있다면 접근 방식을 바꿔보세요: 처음부터 생성하기보다 이해하고 리팩토링하는 데 사용하세요.