CLAUDE.md 설정
/init 명령어로 프로젝트 맥락을 Claude Code에게 알려줍니다
CLAUDE.md는 Claude Code에게 프로젝트에 대한 맥락을 알려주는 특별한 파일입니다. 이 파일이 있으면 Claude Code가 프로젝트를 더 잘 이해하고, 더 적절한 코드를 작성합니다.
CLAUDE.md란?
CLAUDE.md는 프로젝트 루트(최상위 폴더)에 위치하는 마크다운 파일로, 아래와 같은 정보를 담습니다:
- 프로젝트 설명 (어떤 앱인지)
- 주요 명령어 (빌드, 테스트, 실행 방법)
- 코딩 스타일 (선호하는 패턴이나 규칙)
- 기술 스택 (사용하는 라이브러리, 프레임워크)
왜 필요한가요?
CLAUDE.md가 없어도 Claude Code는 동작합니다. 하지만 이 파일이 있으면 매번 같은 맥락을 반복 설명하지 않아도 되므로, 바이브코딩이 훨씬 효율적이 됩니다.
/init으로 자동 생성
Claude Code 안에서 아래 명령어를 입력하면 CLAUDE.md를 자동으로 생성합니다:
/initClaude Code가 프로젝트를 분석하고, 적절한 내용으로 CLAUDE.md 파일을 만들어줍니다.
생성된 CLAUDE.md 확인
/init 실행 후 프로젝트 폴더에 CLAUDE.md 파일이 생깁니다. VS Code에서 열어 내용을 확인해 봅시다.
일반적으로 아래와 같은 내용이 포함됩니다:
# CLAUDE.md
## Project Overview
Next.js 기반 웹 애플리케이션
## Commands
- `npm run dev` — 개발 서버 실행
- `npm run build` — 프로덕션 빌드
- `npm run lint` — 코드 검사
## Tech Stack
- Next.js, React, TypeScript
- Tailwind CSSCLAUDE.md에 추가하면 좋은 정보
자동 생성된 내용에 아래 정보를 추가하면 Claude Code가 더 잘 동작합니다:
프로젝트 설명
## Project Description
개인 포트폴리오 웹사이트입니다.
한국어로 작성하며, 반응형 디자인을 적용합니다.코딩 스타일
## Style Guide
- 모든 UI 텍스트는 한국어로 작성
- 컴포넌트는 함수형으로 작성
- CSS는 Tailwind CSS 클래스 사용주의사항
## Important Notes
- 커밋은 사용자가 요청할 때만 수행
- 불필요한 주석은 추가하지 않음편하게 수정하세요
CLAUDE.md는 일반 텍스트 파일이므로, VS Code에서 자유롭게 편집할 수 있습니다. 바이브코딩을 하면서 필요한 내용을 계속 추가해 나가면 됩니다.
핵심 슬래시 명령어
Claude Code에서 사용할 수 있는 주요 슬래시 명령어를 알아두면 편리합니다:
| 명령어 | 기능 |
|---|---|
/init | CLAUDE.md 자동 생성 |
/help | 도움말 표시 |
/clear | 대화 내역 초기화 |
/compact | 대화 내역을 요약하여 컨텍스트 절약 |
/context | 컨텍스트 최적화 제안 표시 |
/cost | 현재 세션의 사용량 확인 |
/model | 사용 모델 변경 |
/exit | Claude Code 종료 |
/compact 활용 팁
대화가 길어지면 Claude Code의 응답 품질이 떨어질 수 있습니다. 주기적으로 /compact를 실행하여 대화를 요약하면 좋습니다.