CLAUDE.md로 규칙 기억시키기 | AI 교육 · 클로드 6회
오늘 배울 것: 매번 하던 당부를 CLAUDE.md 파일에 적어 두고, Claude Code가 그 파일을 읽었는지 확인한다.
왜 필요한가
Claude Code를 켤 때마다 같은 말을 하고 있다면 이 회가 필요하다. "평서체로 써 줘", "성경은 개역개정으로 인용해 줘", "광고는 세 줄을 넘기지 마." Claude Code는 새로 켤 때마다 빈 대화에서 시작한다. 그래서 공식 문서도 CLAUDE.md를 "다시 설명하게 될 것을 적어 두는 곳"으로 소개한다. 폴더에 CLAUDE.md라는 글 파일을 두면, Claude Code가 켤 때마다 이 파일을 먼저 읽는다.
어디에 두나
- 폴더 전용: 작업 폴더 안의
CLAUDE.md. 그 폴더나 그 안의 하위 폴더에서 켤 때 읽힌다. 설교 폴더와 상담 폴더에 서로 다른 규칙을 둘 수 있다. - 나 전용: 홈 폴더의
~/.claude/CLAUDE.md. 어느 폴더에서 켜든 읽힌다. 말투처럼 어디서나 같은 당부는 여기에 둔다.
따라 하기
- 연습 폴더에서
claude를 켠다. - 가장 쉬운 방법은 Claude에게 적어 달라고 하는 것이다.
아래 규칙을 이 폴더의 CLAUDE.md에 추가해 줘. - 글은 평서체(-다)로 쓴다. - 성경 인용은 개역개정 표기를 따른다. - 광고 문구는 세 줄을 넘기지 않는다. - 교인 실명은 쓰지 않는다.
통째로 복사해 붙여 넣어도 되고, 직접 칠 때는 줄 끝에서 Shift + Enter로 줄을 바꾼다. 파일을 만드는 일이라 허락 창이 뜨면 Yes를 고른다.
- 직접 고치고 싶으면
/memory를 친다. 내 CLAUDE.md와 폴더 CLAUDE.md 목록이 나오고, 하나를 고르면 편집기에서 열린다. 아직 없는 파일을 고르면 새로 만들어 연다. /exit로 나왔다가 다시claude를 켠다./context를 치고 Memory files 목록에 CLAUDE.md가 있는지 본다. 있으면 읽힌 것이다.- 확인 삼아 부탁해 본다.
@광고.txt 이 문구를 다시 써 줘
평서체와 세 줄 규칙을 지키는지 본다.
코드 프로젝트라면 /init으로 시작해도 된다. Claude가 폴더를 살펴 CLAUDE.md 초안을 만들어 주고, 이미 있으면 덮어쓰지 않고 고칠 점을 제안한다.
잘 쓰는 요령
공식 문서가 권하는 기준이다. 한 파일은 200줄 아래로 짧게 쓴다. "정리해서 써 줘"보다 "세 줄을 넘기지 않는다"처럼 지켰는지 확인할 수 있게 쓴다. 제목과 목록으로 묶는다. 서로 부딪히는 규칙은 지운다. 둘이 부딪히면 Claude가 아무거나 하나를 고를 수 있다.
자주 막히는 곳
- "기억해 줘"라고 했는데 CLAUDE.md에 없다. "기억해 줘"는 Claude가 스스로 쓰는 자동 메모리로 간다. CLAUDE.md에 넣으려면 "CLAUDE.md에 추가해 줘"라고 분명히 말한다.
- 규칙을 안 지킨다. 먼저
/context로 파일이 읽혔는지 본다. 읽혔는데도 어긋나면 규칙을 더 구체적으로 고친다. CLAUDE.md는 부탁이지 잠금장치가 아니다. 꼭 막아야 할 일은 5회의 권한 설정으로 막는다. - 편집기가 터미널 안에서 열려 낯설다. 이럴 땐 2단계처럼 Claude에게 적어 달라고 하는 편이 쉽다.
CLAUDE.md에는 교인 이름이나 상담 내용을 적지 않는다. 켤 때마다 읽히는 파일이다.
오늘의 과제
내가 Claude에게 가장 자주 되풀이하는 당부 세 가지를 골라 연습 폴더의 CLAUDE.md에 넣는다. 다시 켜서 /context로 확인하고, 규칙이 지켜지는지 부탁 하나로 시험한다.
다음 회 예고
7회에서는 슬래시 명령어를 모아 본다. /만 쳐도 나오는 명령 목록, 대화를 비우는 /clear, 지난 대화를 이어 가는 방법을 익힌다.
댓글