처음 보는 코드베이스 파악하기
처음 맡은 저장소를 Claude Code에게 먼저 훑게 하면, 파일을 하나씩 열어 보지 않고도 구조·데이터 흐름·규칙을 빠르게 잡을 수 있습니다.
저장소 폴더에서 Claude Code를 열고 개요 → 구조 → 데이터 모델 → 핵심 흐름 순서로 묻습니다. 용어집과 코딩 규칙을 정리시키고, 남길 내용은 CLAUDE.md로 옮깁니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
준비
- Claude Code 설치와 로그인
1. 저장소에서 열기
저장소 폴더로 이동해 Claude Code를 엽니다.
cd /path/to/project && claude결과: 저장소에서 열린 세션
확인: 첫 화면에 그 폴더 경로가 보이는지 확인
2. 개요와 구조
전체 개요와 쓰는 설계 방식부터 묻습니다.
이 코드베이스의 개요를 알려 주고, 쓰는 주요 아키텍처 패턴을 설명해 줘.결과: 개요와 구조 설명
확인: 설명에 나온 폴더가 실제로 있는지 확인
3. 데이터와 핵심 흐름
핵심 데이터 모델과 기능 하나의 흐름을 따라갑니다.
핵심 데이터 모델은 뭐야? 그리고 로그인 과정을 화면부터 데이터베이스까지 따라가며 관련 파일을 순서대로 알려 줘.결과: 데이터 모델과 흐름
확인: 흐름에 나온 파일을 몇 개 열어 맞는지 확인
4. 용어와 규칙 정리
프로젝트에서만 쓰는 용어와 코딩 규칙을 정리시킵니다.
이 프로젝트에서만 쓰는 용어집과 코딩 규칙·패턴을 정리해 줘.결과: 용어집과 규칙
확인: 규칙이 실제 코드와 맞는지 한두 개 확인
5. CLAUDE.md로 남기기
다음 세션에서도 쓸 내용은 /init이나 직접 편집으로 CLAUDE.md에 짧게 옮깁니다.
{{conventions}} 중 다음 작업에 꼭 필요한 것만 CLAUDE.md에 짧게 추가해 줘.결과: 갱신된 CLAUDE.md
확인: CLAUDE.md가 200줄 안쪽인지 확인
주의
- 설명이 그럴듯해도 틀릴 수 있음. 중요한 흐름은 파일을 열어 확인
- 큰 저장소는 서브에이전트에 나눠 조사시키면 메인 대화가 가벼움
- 비밀값이 든 파일은 권한 규칙으로 읽기 막아 두기
댓글