매일 아침 같은 설명을 반복해야 하는 집사
지난 회에서는 위임과 확인의 균형에 대해 이야기드렸습니다. 이번에는 더욱 편리한 사용법——CLAUDE.md로 집사에게 가훈을 전수하는 방법——을 소개해 드리겠습니다.
잠시 상상해 보시기 바랍니다.
매일 아침, 새로 부임한 집사에게 “이 저택에서는 반드시 한국어로 답하시오”, “제 허락 없이는 커밋하지 마시오”, “npm이 아닌 bun을 사용하는 것이 이 집의 방식입니다"라고 설명해야 한다면——.
그것은 참으로 비효율적인 일이지 않겠습니까.
CLAUDE.md란 무엇인가
CLAUDE.md는 프로젝트의 루트 디렉토리에 두는 마크다운 파일입니다. Claude Code는 새 세션을 시작할 때마다 이 파일을 자동으로 읽어 들입니다.
다시 말해, 한 번 작성해 두면 매번 설명하지 않아도 집사가 당연하게 그 지시를 따릅니다.
가훈을 적은 두루마리를 집사 대기실에 항상 비치해 두는 것과 같은 개념입니다.
CLAUDE.md는 3단계 계층으로 사용할 수 있다
사실, CLAUDE.md는 프로젝트마다 하나씩만 있어야 하는 것이 아닙니다. 배치하는 위치에 따라 적용 범위가 달라집니다.
| 위치 | 경로 | 적용 범위 |
|---|---|---|
| 글로벌 | ~/.claude/CLAUDE.md | 모든 프로젝트 공통 |
| 프로젝트 | {프로젝트 루트}/CLAUDE.md | 해당 프로젝트에만 |
| 서브디렉토리 | {임의의 디렉토리}/CLAUDE.md | 해당 디렉토리 이하 |
세션 시작 시, 이 모든 파일이 읽혀져 병합됩니다.
권장하는 활용 방법은 이렇습니다——“항상 한국어로 답할 것”, “자동 커밋은 하지 말 것"과 같은 보편적인 요청은 글로벌에. “이 프로젝트에서는 bun을 사용할 것”, “Firebase에 배포할 것"과 같은 프로젝트 고유의 규칙은 프로젝트 루트에. 이렇게 하면 어느 프로젝트에서도 기본적인 작법이 지켜지면서, 프로젝트마다의 세부 지시도 반영됩니다.
가훈의 예시: CLAUDE.md의 내용
저택마다 규칙은 다릅니다. 참고가 될 만한 예시를 준비했습니다.
# 프로젝트 가훈
## 언어 및 커뮤니케이션
- 모든 답변은 반드시 한국어로 할 것
- 기술 용어는 영어 그대로 사용해도 되지만, 설명은 한국어로
## 코드 및 개발 방식
- 패키지 매니저는 bun을 사용할 것 (npm 사용 금지)
- 커밋은 반드시 주인님의 확인을 받은 후 실행할 것
- 테스트 없이 코드를 수정하지 말 것
## 금지 사항
- 프로덕션 환경에 단독으로 배포하지 말 것
- 파일 삭제 시 반드시 확인을 받을 것
- package.json의 의존성을 무단으로 추가하지 말 것
## 스타일
- 코드 주석은 한국어로 작성
- 함수명·변수명은 영어 카멜케이스
이것을 한 번 작성해 두면, 세바스는 프로젝트를 열 때마다 이 가훈을 마음에 새기고 작업에 임합니다.
왜 이렇게 편리한가
Claude Code는 매우 뛰어난 집사입니다. 그러나 이전 대화의 기억은 다음 세션으로 이어지지 않습니다.
어제 “bun을 사용해 달라"고 말씀하셨더라도, 다음 날 대화에서는 기억하지 못합니다. 매번 같은 내용을 설명하는 것은 주인님에게도, 집사에게도 비효율적입니다.
CLAUDE.md는 그 문제를 근본적으로 해결합니다.
스마트폰으로 Claush를 사용하시는 주인님께 특히
Claush 앱을 통해 모바일에서 집사를 사용하시는 주인님께는 CLAUDE.md가 특히 든든한 존재가 됩니다.
스마트폰의 작은 화면에서 “매번 같은 전제 조건을 입력하는” 수고는 상당합니다. CLAUDE.md가 있으면, 주인님은 본론만 말씀하시면 됩니다.
“세바스, 로그인 화면의 버그를 고쳐 줘.”
이것만으로도, 집사는 bun을 사용하고, 한국어로 답하며, 커밋 전에 확인을 받고, 테스트를 작성하며 작업을 진행합니다.
실제 설정 방법
설정은 매우 간단합니다.
- 프로젝트 루트 디렉토리에
CLAUDE.md라는 파일을 만든다 - 주인님의 가훈을 작성한다
- 이상입니다
my-project/
├── CLAUDE.md ← 여기에 가훈을
├── src/
├── package.json
└── ...
Claude Code는 다음 세션부터 자동으로 이 파일을 읽어 들이고, 가훈에 따라 동작합니다.
가훈은 키워 나가는 것
처음부터 완벽한 가훈을 쓸 필요는 없습니다.
집사와 작업을 거듭하면서 “매번 말하고 있네"라고 느끼는 것을 하나씩 CLAUDE.md에 추가해 가는——그것이 집사를 진정한 의미에서 “키워 나가는” 것입니다.
주인님과 집사 사이의 무언의 이해는 이렇게 쌓여 갑니다.
집사의 정리
- CLAUDE.md는 프로젝트 루트에 두는 “가훈” 파일
- 매번 설명하지 않아도 집사가 자동으로 그 지시에 따름
- 모바일 사용자에게 특히 효과적——본론만 말하면 됨
- 완벽을 목표로 하지 말고 조금씩 키워 나가기
주인님, 집사에게 가훈을 전수해 주시기 바랍니다. 그렇게 하면, 말씀을 나누기 전부터 집사는 주인님의 기대에 부응할 수 있는 존재가 됩니다.
다음 회에서는 “기록과 컨텍스트의 관리 방법"에 대해 이야기드리겠습니다.
Claush 공식 사이트에서 집사를 당신의 iPhone으로.