[Claude Code] CLAUDE.md 파일

1. CLAUDE.md 파일이란?

- 클로드 코드가 언제든 프로젝트 맥락을 이해할 수 있도록 프로젝트 구조, 목표, 코딩 스타일, 명령어 등을 저장해두는 설정 파일

- 클로드 코드 실행시 자동으로 읽는 파일. 정확히는 가장 먼저 전달하는 프롬프트.

 

예시)

# 프로젝트명
...

## 프로젝트 개요
...

## Commands
... (핵심 명령어들)

## Tech Stack
... (라이브러리 버전에 관한 정보)

## Architecture
... (파일 구조 설명)

## Code Style
... (코드, 주석, 에러 처리, 네이밍 규칙)

## Development Notes
...

 

 

2. CLAUDE.md 파일 생성

- /init 명령을 통해 클로드 코드가 현재 프로젝트 폴더를 분석하여 CLAUDE.md 문서를 만들고 내용을 채워준다.

추후 프로젝트에 새로운 기능을 구현하거나 중요한 설정을 변경할 때는 이 CLAUDE.md 을 변경해주면 되는데, 수정도 클로드 코드에게 요청하면 편리하다. 예를 들면, "특정 코딩 규칙이나 프로젝트 구조가 변경되었으니 업데이트 해줘" 라고 말이다.

 

 

3. CLAUDE.md의 위치

- 만약 모든 프로젝트에 적용할 CLAUDE.md이 필요하다면, 경로를 ~/.claude/CLAUDE.md 로 지정하면 된다. 윈도우의 경우에는 C:\Users\사용자명\.claude\CLAUDE.md가 된다.

- 각 하위 디렉터리 전용 CLAUDE.md도 세팅할 수 있다고 설명되어있다. 즉, CLAUDE.md는 계층적 구조를 활용하여 여러 곳에 분포할 수 있다는 것이다.

 

 

4. CLAUDE.md 작성 시 기타 주의점

- CLAUDE.md 파일은 세션 시작마다 읽다보니, 불필요한 내용이 들어있다면 토큰을 낭비하고 실제 작업에 사용할 수 있는 프롬프트 공간이 줄어들게 된다. 게다가 프롬프트 지시에 대한 준수율도 낮아질 수 있으니 정확하되 간결하게 작성하는 것이 중요하다.