방금 합류한 코드베이스에서 Claude Code 사용하기

Source: Dev.to

Introduction

Claude는 새로운 코드베이스에 합류했을 때 귀중한 동료가 될 수 있습니다. 코드가 무엇을 하는지 설명하고, 데이터 흐름을 추적하며, 컴포넌트가 어떻게 연결되는지 질문에 답할 수 있습니다. 하지만 기존 컨벤션을 이해하기 전에 Claude에게 변경을 요청하면 팀의 암묵적인 표준을 깨는 코드를 만들 위험이 있습니다.

Use Claude as a Reader

• 다음과 같은 질문을 해보세요:
  • “이 함수는 무엇을 하나요?”
  • “이 데이터는 어디서 오는 건가요?”
  • “왜 이렇게 구조화되었을까요?”

이러한 질의는 Claude가 코드를 수정하지 않고 설명자 역할을 하게 하여, 빠르게 정신 모델을 구축하도록 도와줍니다.

Get an Overview of the System

Claude에게 코드베이스의 관련 부분을 제공하고 다음을 물어보세요:

“이 시스템이 어떻게 구성되어 있는지 설명해 주세요. 주요 모듈은 무엇이며, 각각의 책임은 무엇이고, 어떻게 서로 통신하나요?”

Claude의 답변이 완벽하진 않겠지만, 모든 파일을 일일이 읽는 것보다 훨씬 빠르게 시작 모델을 제공해 줍니다.

Learn or Create Team Conventions

• 저장소에 CLAUDE.md 파일이 이미 있다면 먼저 읽어보세요.
• 없으면 첫 주가 끝난 뒤 하나 만들어 보세요. 포함할 내용:
  • 파일 구조
  • 네이밍 패턴
  • 오류 처리 방식
  • 테스트 스타일

이러한 컨벤션을 문서화하면 Claude의 출력이 기존 코드와 일관성을 유지하는 데 도움이 됩니다.

Make a Simple, Isolated Change

1. 작고 독립적인 작업을 식별합니다.
2. Claude에게 구현을 요청합니다.
3. 커밋하기 전에 생성된 코드를 주변 파일과 비교합니다:
   • 네이밍이 일치하나요?
   • 오류 처리가 동일한 패턴을 따르나요?

스타일이 다르면, 특정 인접 파일이나 함수에 맞추어 변경하도록 Claude에게 다시 작성해 달라고 요청하세요.

Sample Prompts for Exploration

• “이 코드베이스에서 인증은 어떻게 처리되나요? 관련 코드를 보여 주세요.”
• “새 API 엔드포인트를 추가해야 한다면, 기존 어느 엔드포인트를 모델로 삼아야 할까요?”
• “이 파일의 역할은 무엇인가요? 무엇이 이 파일에 의존하고 있나요?”
• “이 함수 시그니처를 바꾸면 무엇이 깨질까요?”

Further Resources

Agent Prompt Playbook에는 새로운 코드베이스를 일주일이 아닌 하루 만에 파악할 수 있도록 Claude 프롬프트를 제공하는 온보딩 질문 세트가 포함되어 있습니다.