# 처음 보는 코드베이스 파악하기
id: claude-code-codebase-tour · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-codebase-tour
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 20분
평가 점수: 32/100 (확인 없음 · 검수 대기)

처음 맡은 저장소를 Claude Code에게 먼저 훑게 하면, 파일을 하나씩 열어 보지 않고도 구조·데이터 흐름·규칙을 빠르게 잡을 수 있습니다.

설명: 저장소 폴더에서 Claude Code를 열고 개요 → 구조 → 데이터 모델 → 핵심 흐름 순서로 묻습니다. 용어집과 코딩 규칙을 정리시키고, 남길 내용은 CLAUDE.md로 옮깁니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] 저장소에서 열기 — 저장소 폴더로 이동해 Claude Code를 엽니다.
   프롬프트:
   > cd /path/to/project && claude
   기대 결과: 저장소에서 열린 세션
   확인 방법: 첫 화면에 그 폴더 경로가 보이는지 확인
2. [AI에게 · Claude Code] 개요와 구조 — 전체 개요와 쓰는 설계 방식부터 묻습니다.
   프롬프트:
   > 이 코드베이스의 개요를 알려 주고, 쓰는 주요 아키텍처 패턴을 설명해 줘.
   기대 결과: 개요와 구조 설명
   확인 방법: 설명에 나온 폴더가 실제로 있는지 확인
3. [AI에게 · Claude Code] 데이터와 핵심 흐름 — 핵심 데이터 모델과 기능 하나의 흐름을 따라갑니다.
   프롬프트:
   > 핵심 데이터 모델은 뭐야? 그리고 로그인 과정을 화면부터 데이터베이스까지 따라가며 관련 파일을 순서대로 알려 줘.
   기대 결과: 데이터 모델과 흐름
   확인 방법: 흐름에 나온 파일을 몇 개 열어 맞는지 확인
4. [AI에게 · Claude Code] 용어와 규칙 정리 — 프로젝트에서만 쓰는 용어와 코딩 규칙을 정리시킵니다.
   프롬프트:
   > 이 프로젝트에서만 쓰는 용어집과 코딩 규칙·패턴을 정리해 줘.
   기대 결과: 용어집과 규칙
   확인 방법: 규칙이 실제 코드와 맞는지 한두 개 확인
   결과 이름: {{conventions}} (뒤 단계에서 이어 쓴다)
5. [AI에게 · Claude Code] CLAUDE.md로 남기기 — 다음 세션에서도 쓸 내용은 /init이나 직접 편집으로 CLAUDE.md에 짧게 옮깁니다.
   프롬프트:
   > {{conventions}} 중 다음 작업에 꼭 필요한 것만 CLAUDE.md에 짧게 추가해 줘.
   기대 결과: 갱신된 CLAUDE.md
   확인 방법: CLAUDE.md가 200줄 안쪽인지 확인

주의:
- 설명이 그럴듯해도 틀릴 수 있음. 중요한 흐름은 파일을 열어 확인
- 큰 저장소는 서브에이전트에 나눠 조사시키면 메인 대화가 가벼움
- 비밀값이 든 파일은 권한 규칙으로 읽기 막아 두기

출처:
- Claude Code 문서: 자주 쓰는 작업(코드베이스 이해) https://code.claude.com/docs/en/common-workflows
- Claude Code 문서: CLAUDE.md https://code.claude.com/docs/en/memory