---
name: opencurrent-code-codebase-tour
description: "처음 맡은 저장소를 Claude Code에게 먼저 훑게 하면, 파일을 하나씩 열어 보지 않고도 구조·데이터 흐름·규칙을 빠르게 잡을 수 있습니다. 이럴 때 사용: 저장소 폴더에서 Claude Code를 열고 개요 → 구조 → 데이터 모델 → 핵심 흐름 순서로 묻습니다. 용어집과 코딩 규칙을 정리시키고, 남길 내용은 CLAUDE.md로 옮깁니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-codebase-tour"
  opencurrent-id: "claude-code-codebase-tour"
  verification: "pending"
  exported-at: "2026-11-21T11:03:35.407Z"
---

# 처음 보는 코드베이스 파악하기

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-codebase-tour
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-codebase-tour")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. 저장소에서 열기 (명령 실행 · Claude Code)

저장소 폴더로 이동해 Claude Code를 엽니다.

프롬프트:

```text
cd /path/to/project && claude
```

기대 결과: 저장소에서 열린 세션

확인 방법: 첫 화면에 그 폴더 경로가 보이는지 확인

### 2. 개요와 구조 (AI에게 · Claude Code)

전체 개요와 쓰는 설계 방식부터 묻습니다.

프롬프트:

```text
이 코드베이스의 개요를 알려 주고, 쓰는 주요 아키텍처 패턴을 설명해 줘.
```

기대 결과: 개요와 구조 설명

확인 방법: 설명에 나온 폴더가 실제로 있는지 확인

### 3. 데이터와 핵심 흐름 (AI에게 · Claude Code)

핵심 데이터 모델과 기능 하나의 흐름을 따라갑니다.

프롬프트:

```text
핵심 데이터 모델은 뭐야? 그리고 로그인 과정을 화면부터 데이터베이스까지 따라가며 관련 파일을 순서대로 알려 줘.
```

기대 결과: 데이터 모델과 흐름

확인 방법: 흐름에 나온 파일을 몇 개 열어 맞는지 확인

### 4. 용어와 규칙 정리 (AI에게 · Claude Code)

프로젝트에서만 쓰는 용어와 코딩 규칙을 정리시킵니다.

프롬프트:

```text
이 프로젝트에서만 쓰는 용어집과 코딩 규칙·패턴을 정리해 줘.
```

기대 결과: 용어집과 규칙

확인 방법: 규칙이 실제 코드와 맞는지 한두 개 확인

결과 이름: `{{conventions}}` — 이 결과를 뒤 단계 프롬프트의 같은 자리에 넣을 것.

### 5. CLAUDE.md로 남기기 (AI에게 · Claude Code)

다음 세션에서도 쓸 내용은 /init이나 직접 편집으로 CLAUDE.md에 짧게 옮깁니다.

프롬프트:

```text
{{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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-codebase-tour 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
