목차(클릭하세요)
전역 settings.json 하나 + 프로젝트별 CLAUDE.md 조합으로 시작하자!
1. CLAUDE.md 시작하기
1-1. 왜 CLAUDE.md가 필요한가?
•
Claude는 대화가 끝나면 기억이 완전히 초기화됨
•
매번 새 세션을 열 때마다 이런 상황이 반복
"저는 고등학교 AI 선생님이고요, Python 코드는 항상 한국어 주석으로, 들여쓰기는 꼭 4칸으로..."
•
CLAUDE.md가 있다면? 이걸 매번 설명하지 않아도 됨
이걸 매번 설명하지 않아도 됨1-2.CLAUDE.md = Claude에게 전달하는 영구 핸드북
•
세션이 시작될 때 Claude가 자동으로 읽어오는 파일이기 때문에, 한 번만 써두면 매번 설명할 필요가 없어짐
CLAUDE.md 없을 때 | CLAUDE.md 있을 때 |
매번 규칙 설명 반복 | 세션 시작 시 자동 적용 |
세션마다 결과물이 들쭉날쭉 | 항상 일관된 결과 |
컨텍스트 낭비 | 핵심 작업에 집중 |
2. 전역 vs 프로젝트 CLAUDE.md
~/.claude/CLAUDE.md ← 전역: 내 모든 프로젝트에 공통 적용
프로젝트폴더/CLAUDE.md ← 프로젝트: 이 폴더에서만 적용
Bash
복사
2-1. 모든 프로젝트에 적용되는 전역방식
2-2.해당 프로젝트에만 적용되는 방식
둘 다 있다면?•
합쳐서 적용됨, 초보라면 전역 하나만으로 충분
•
해당 프로젝트에만 쓰는 방식 권장
3. CLAUDE.md 만들기
3-1. Claude를 활용
•
일반 Claude한테 만들어달라고 하면 됨
나의 작업 환경과 선호도를 파악해서
CLAUDE.md 파일을 만들어줘.
필요한 정보가 있으면 질문해줘.
Bash
복사
•
나온 결과로 프로젝트 폴더안에 넣고, claude로 확인해보기
3-2. /init 명령어 사용 (Claude Code실행상태에서)
•
Claude Code 터미널에서 다음과 같이 초기화 가능
/init
Bash
복사
•
3-3. 현재 사용중인 전역 CLAUDE.md 예시
# OOO 전역 설정
## 나는 누구인가
- OO고등학교 AI/정보 교사
- 주요 과목: AI 기초, 로봇공학과 공학세계, 소프트웨어와 생활
## 응답 방식
- 항상 한국어로 답변
- 새 개념은 비유로 먼저 설명한 뒤 심화 내용으로 확장
- 고등학생도 이해할 수 있는 쉬운 설명, 단 학술적으로 정확하게
## 코드 작성 규칙
- Python은 항상 한국어 주석 포함
- 들여쓰기 후 줄바꿈 (한 줄 압축 문법 사용 금지)
- 코드 블록에 설명 주석 필수
## 자주 쓰는 도구
- Google Apps Script, Gemini API
- Arduino, ESP32, MicroPython
## 결과물 규칙
- 오른쪽 상단과 하단에 © Made By Yangphago 표시
- Yangphago 클릭 시 https://yangphago.oopy.io/ 링크 연결
Bash
복사
4. CLAUDE.md 사용시 주의점
이렇게 쓰세요
•
구체적으로 → "코드를 잘 써줘" → "모든 함수에 한국어 주석 달기"
→ "모든 함수에 한국어 주석 달기" •
금지 패턴 명시 → "any 타입 사용 금지", "한 줄 압축 문법 금지"
•
자주 쓰는 명령어 포함 → Claude가 자동으로 해당 명령 실행
이런 건 피하세요
•
너무 길게 → 500~2,000자 정도가 적당 (CLAUDE.md도 컨텍스트를 차지함)
•
모호한 표현 → "좋은 코드로" 같은 추상적 지시는 의미 없음
•
API 키, 비밀번호 → 절대 CLAUDE.md에 넣지 말 것
무엇보다 지속적으로 업데이트 할 것을 추천•
쓰면서 조금씩 다듬는 것이 가장 좋은 방법