3. CLAUDE.md - AI가 나를 기억하는 단 하나의 파일
CLAUDE.md란 무엇인가?
CLAUDE.md는 Claude Code가 모든 대화 시작 전에 자동으로 읽는 파일입니다.
원리:
1. 당신이 Claude Code에서 대화 시작
2. Claude가 제일 먼저 ~/.claude/CLAUDE.md 파일 읽기
3. 파일에 저장된 정보를 기억한 채로 대화 시작
결과:
- 매번 "나는 카페 대표고..." 설명 불필요
- "내 프로젝트는..." 반복 불필요
- 바로 본론부터 시작
Before / After 비교
Before (CLAUDE.md 없을 때)
나: 강릉에 카페 오픈 프로젝트 브랜딩 전략 짜줘
Claude: 카페 브랜딩 전략을 제안드리겠습니다.
혹시 카페 운영 경험이 있으신가요?
나: 응, 카페 4개 운영 중이야
Claude: 좋습니다. 예산은 어느 정도인가요?
나: 3천만 원 정도...
Claude: 타겟 고객은 어떤 분들인가요?
나: 강릉 지역 방문객들...
(5분 소요)
After (CLAUDE.md 작성 후)
나: 강릉 카페 브랜딩 전략 짜줘
Claude: 이미커피 4개 매장 운영 경험을 기반으로 제안드리겠습니다.
강릉 지역 특성과 F&B 15년 노하우를 반영한 전략:
1단계: 시장 분석 (강릉 관광객 vs 로컬 비중)
2단계: 브랜드 포지셔닝 (페어링 콘셉트 적용)
3단계: 공간 설계 (가찍비 중심)
...
(바로 시작, 0분)
차이: 맥락 설명 5분 → 0분
어디에 저장되나?
글로벌 CLAUDE.md (추천!)
~/.claude/CLAUDE.md
"~/" 의미:
- Mac: /Users/당신이름/.claude/CLAUDE.md
- Windows: C:\Users\당신이름\.claude\CLAUDE.md
이 파일이 하는 일:
- 모든 프로젝트에서 자동으로 읽힘
- 당신의 기본 정보 (이름, 비즈니스, 작업 스타일)
- 자주 쓰는 경로, 환경 설정
프로젝트별 CLAUDE.md (선택)
/your-project/CLAUDE.md
프로젝트 폴더에 저장하면:
- 글로벌 CLAUDE.md + 프로젝트 CLAUDE.md 둘 다 읽음
- 특정 프로젝트 맥락 추가 (클라이언트 정보, 프로젝트 목표)
CLAUDE.md에 무엇을 쓸까?
최소한 이 3가지만 있어도 충분합니다:
1. 당신은 누구인가?
## 👤 사용자 프로필
- 이름: 홍길동
- 직업: 마케팅 팀장
- 회사: ABC 스타트업
2. 무슨 일을 하나?
## 💼 비즈니스
- 담당: 콘텐츠 마케팅, SNS 운영
- 목표: 월 100만 조회수 달성
- 주요 작업: 블로그 글 작성, 데이터 분석
3. 어떻게 일하나?
## ⚙️ 작업 스타일
- 실용성 우선 (이론보다 실전)
- 단계별 접근 (한 번에 하나씩)
- 간결한 문장 선호
이게 전부입니다. 복잡하게 쓸 필요 없습니다.
어디에 저장하나요?
글로벌 설정 (모든 프로젝트에 적용)
~/.claude/CLAUDE.md
당신의 기본 정보 (이름, 비즈니스, 작업 스타일)
프로젝트별 설정
/your-project/CLAUDE.md
특정 프로젝트의 맥락 (클라이언트 정보, 프로젝트 목표)
실전 예시 - 제 CLAUDE.md
실제로 제가 사용하는 파일 일부입니다:
# CLAUDE.md - 이림 비즈니스 컨텍스트
> F&B 15년 × AI 활용 | 3개 매장 운영 + AI 교육 사업
## 👤 사용자 프로필
**이름**: 이림 (이미커피 대표)
**핵심 정체성**: 오프라인 비즈니스 경험 + AI 실무 활용
**현재 역할**: 기획, 전략, 자동화 시스템 구축
### 비즈니스 현황
- **IMI (오프라인)**: imi coffee, 이미양과자, 이미 the balance
- **IMI WORK (AI 교육)**: AI 교육, F&B 컨설팅, GPTers 스터디장
### 작업 스타일
- **Claude Code 중심**: 모든 업무를 이 워크스페이스에서 처리
- **CLI 환경 활용**: 비개발자 영역에서 CLI + Claude Code로 효율성 극대화
- **실용성 우선**: 즉시 적용 가능한 솔루션
- **단계별 접근**: 복잡한 프로젝트를 작게 나누어 진행
## 🛠 기술 환경
### 인프라
- **자동화**: n8n (n8n.imiwork.com) - Docker, 미니PC
- **블로그**: Ghost v5 (blog.imiwork.com)
- **메인 환경**: Mac
- **PKM**: Obsidian (Johnny Decimal 시스템)
## 📂 PKM 시스템
**위치**: `/Users/rhim/Projects/pkm/`
**구조**: Johnny Decimal 시스템
### 폴더 구조
- 00-system/ # 시스템 설정, 템플릿
- 10-projects/ # 활성 프로젝트
- 20-operations/ # 비즈니스 운영
- 30-knowledge/ # 지식 아카이브
- 40-personal/ # 개인 노트
이 정보 덕분에:
- "강릉 카페 브랜딩 전략 짜줘" → F&B 15년 경험 기반 전략 제시
- "블로그 글 작성해줘" → Ghost v5 포맷 자동 적용
- "프로젝트 폴더 만들어줘" → /Users/rhim/Projects/pkm/10-projects/에 자동 생성
- "n8n 워크플로우 만들어줘" → 기존 자동화 시스템 맥락 반영
지금 바로 만드는 법
방법 1: Claude에게 만들어 달라고 요청 (추천!)
Claude Code에서 다음과 같이 요청하세요:
나: ~/.claude/CLAUDE.md 파일 만들어줘.
나는 [직업/역할]이고,
[담당 업무]를 주로 해.
[작업 스타일이나 선호사항].
예시:
나: ~/.claude/CLAUDE.md 파일 만들어줘.
나는 마케팅 팀장이고,
콘텐츠 제작과 SNS 운영을 담당해.
실용적인 답변을 선호하고, 단계별로 진행하는 걸 좋아해.
Claude가 3가지 정보를 기반으로 파일을 자동 생성해줍니다.
방법 2: 직접 만들기
Mac:
# 1. 파일 생성
touch ~/.claude/CLAUDE.md
# 2. 텍스트 에디터로 열기
open ~/.claude/CLAUDE.md
Windows:
# 1. .claude 폴더 생성 (없으면)
mkdir %USERPROFILE%\.claude
# 2. 메모장으로 열기
notepad %USERPROFILE%\.claude\CLAUDE.md
3가지 정보만 입력하세요
# CLAUDE.md
## 👤 사용자 프로필
- 이름: 홍길동
- 직업: 마케팅 팀장
- 회사: ABC 스타트업
## 💼 비즈니스
- 담당: 콘텐츠 마케팅, SNS 운영
- 목표: 월 100만 조회수 달성
- 주요 작업: 블로그 글 작성, 데이터 분석
## ⚙️ 작업 스타일
- 실용성 우선 (이론보다 실전)
- 단계별 접근 (한 번에 하나씩)
- 간결한 문장 선호
이게 전부입니다.
확인하기
# Mac/Linux
cat ~/.claude/CLAUDE.md
# Windows
type %USERPROFILE%\.claude\CLAUDE.md
✅ 파일 내용이 보이면 성공!
자주 묻는 질문
Q: CLAUDE.md는 한 번만 만들면 되나요?
A: 네. 한 번 만들면 계속 사용됩니다. 필요할 때 수정만 하면 됩니다.
Q: 얼마나 자세히 써야 하나요?
A: 최소 3가지 (누구, 무슨 일, 어떻게 일)만 있으면 충분합니다. 나중에 필요하면 추가하세요.
Q: 프로젝트별로 다르게 쓰고 싶으면?
A: 프로젝트 폴더에 별도 CLAUDE.md 파일을 만들면 됩니다. 글로벌 + 프로젝트 둘 다 읽습니다.
Q: 수정하려면?
A: Claude에게 "CLAUDE.md 파일 열어줘" 요청 후 수정하면 됩니다.
실제 활용 시나리오
시나리오 1: 프로젝트 컨설팅
CLAUDE.md 있을 때:
나: 강릉 카페 브랜딩 전략 짜줘
Claude: 이미커피 4개 매장 운영 경험 기반으로...
[F&B 15년 노하우 반영된 구체적 전략 즉시 제시]
시나리오 2: 블로그 글 작성
CLAUDE.md 있을 때:
나: 오늘 배운 n8n 자동화 내용으로 블로그 글 써줘
Claude: Ghost v5 포맷으로 작성하겠습니다.
IMI WORK 브랜드 톤앤매너와 "일을 잘한다" 철학을 반영해서...
[즉시 작성 시작]
시나리오 3: 파일 관리
CLAUDE.md 있을 때:
나: 새 프로젝트 폴더 만들어줘
Claude: /Users/rhim/Projects/pkm/10-projects/ 에
Johnny Decimal 시스템에 맞춰 생성하겠습니다.
[자동으로 올바른 위치에 생성]
얼마나 시간을 절약할까?
계산해봅시다
CLAUDE.md 작성 시간: 5분
앞으로 절약되는 시간:
- 대화 1번당 맥락 설명: 5분 절약
- 하루 10번 대화: 50분 절약
- 한 달: 약 20시간 절약
- 1년: 약 250시간 절약
250시간이면:
- 새로운 기술 2-3개 배우기
- 프로젝트 3-4개 완료하기
- 책 50권 읽기
- 또는... 여유롭게 쉬기
투자 대비 효과: 5분 → 250시간
지금 바로 시작하세요
나: ~/.claude/CLAUDE.md 파일 만들어줘.
나는 [직업/역할]이고,
[담당 업무]를 주로 해.
[작업 스타일].
5분 투자로 평생 효과를 얻으세요.
다음 글: Workspace 폴더 구조 - "파일을 어떻게 정리해야 AI가 3초 만에 찾을까?"
파일 찾는 시간 10분 → 3초로 줄이는 Johnny Decimal 시스템을 소개합니다.