이 글에서 다룰 내용
Claude Code에게 메모를 전달하며 '안내문 작성을 부탁한다'고 요청하면, 메모에 적혀있지 않은 내용까지 문장에 포함되는 경우가 있습니다. 필자가 특별한 규칙을 정하지 않고 시도했을 때는, 메모에 없는 '연도'가 날짜에 추가되었고, 메모에 없는 문의처 한 문장이 마지막에 붙었습니다(아래 '비교' 섹션).
이 모든 내용은 자연스러운 문장이라 다시 읽어도 알아차리기 어렵습니다.
본 글에서는 CLAUDE.md 파일에 5가지 규칙을 작성하여, 다음 세 가지를 Claude Code가 지키도록 합니다.
- 재료(자료)에 적혀있지 않은 내용은 추측으로 채우지 않고, 【미확인】이라고 표기하기
- 자료들끼리 상충되는 부분은 어느 한쪽을 선택하지 않고 양쪽 모두 작성하며, 【상이점】이라고 표기하기
- 답변 마지막에 【미확인】과 【상이점】 목록을 반환하기
사용하는 것은 CLAUDE.md 파일 단 하나뿐입니다. 서브 에이전트(역할을 지정한 별도의 어시스턴트)는 만들지 않습니다. 가지고 있는 폴더만으로 5분 정도 만에 시도해 볼 수 있습니다.
용어 설명
- CLAUDE.md: 프로젝트의 가장 상단에 위치시키며, Claude Code에게 규칙을 작성하는 파일입니다. 대화를 시작할 때 로드됩니다.
- 재료 (Materials): 문장을 작성하는 근거가 되는 정보입니다. 이 글에서는 요청하는 문장과 읽으라고 지시한 파일을 의미합니다.
- 추측으로 채우기: 재료에 적혀있지 않은 내용을 그럴듯한 내용으로 보충하여 쓰는 것입니다.
배치할 파일 구조
빈 폴더(예: my-project)를 만들고, 다음 3개의 파일과 빈 out/ 폴더를 배치합니다.
my-project/
├─ CLAUDE.md
├─ memo.md ← 스터디 모임 메모 (장소와 정원이 적혀있지 않음)
...
# 프로젝트 규칙
## 알 수 없는 내용에 대한 규칙
- 문장을 작성할 때 사용하는 사실은 요청된 문장과 읽으라고 지시한 파일에 쓰여 있는 것만으로 한다.
...
# 스터디 모임 메모
- 주제: 스프레드시트 소프트웨어 함수 사용법
- 날짜: 12월 4일(금)
...
# 담당자 간의 교환 내용 (사본)
- 스터디 모임 시작은 15시부터이다. 마무리는 16시 그대로다.
memo.md에는 일부러 장소와 정원을 적지 않았습니다. chat.md의 시작 시간도 의도적으로 메모와 다르게 설정했습니다.
한 줄씩 해설하기
| 줄 | 작성한 이유 |
|---|
| 사용하는 사실은 재료만 | '어디까지가 재료인지'를 먼저 정합니다. 요청 문장과 읽으라고 지시한 파일 2가지로 한정합니다 |
| ... | |
시도해 보기
my-project 폴더에서 Claude Code를 실행하고, 다음 세 가지를 요청합니다. 하나씩 요청할 때마다 새로운 대화를 시작해주세요(필자는 그렇게 시도했습니다).
시도 1: 재료에 없는 것을 요청하기
memo.md를 기반으로 스터디 모임 안내문을 작성하여 out/에 저장해 주세요. 날짜, 장소, 정원, 신청 방법을 포함해 주세요.
필자가 확인한 바로는, 안내문이 out/에 저장되었으며, 장소와 정원 부분에 【미확인: 개최 장소(메모에 기재 없음)】 같은 표식이 들어갔습니다. 날짜와 신청 방법은 메모대로였습니다. 답변 마지막에는 【미확인】 목록이 붙어 있었고, 장소/정원 외에도 메모에 연도가 적혀있지 않은 것, 접수 폼의 위치(URL 등)를 알 수 없다는 내용도 나열되었습니다.
연도까지 【미확인】으로 표시되는 것은 규칙대로 움직이는 것입니다. 신경 쓰이는 경우, 메모에 연도를 적어둡니다. 필자가 memo.md의 날짜를 '2026년 12월 4일(금)'로 설정하고 한 번 시도했을 때는, 연도가 【미확인】 목록에 나오지 않았습니다(장소/정원/접수 폼 위치는 그대로 【미확인】이었습니다).
시도 2: 상충되는 재료를 전달하기
memo.md와 chat.md를 기반으로 스터디 모임의 날짜와 시간을 한 줄로 작성하여 out/에 저장해 주세요.
필자가 확인한 바로는, 다음과 같은 한 줄이 저장되었습니다.
스터디 모임 날짜 및 시간: 12월 4일(금) 14시 또는 15시~16시【상이점: 시작 시간이 memo.md에서는 14시, chat.md에서는 15시다】
답변에서도 '어느 한쪽에 결정하지 않고 양쪽 모두 작성했다. 어느 것이 최신인지 파일만으로는 알 수 없으므로 담당자에게 확인을 요청한다'는 설명이 있었고, 마지막 목록의 【상이점】에 시작 시간이 포함되었습니다.
시도 3: 재료가 갖춰져 있을 때 요청하기
memo.md를 기반으로 스터디 모임 주제와 마감 시간을 한 줄로 작성하여 out/에 저장해 주세요.
필자의 확인에 따르면, "스터디 주제는 '스프레드시트 소프트웨어 함수 사용법'이고, 종료 시간은 16시입니다."라는 한 줄이 저장되었고, 목록에는 【미확인】도 없고 【불일치】도 없었습니다. 자료가 갖춰져 있다면 표시는 붙지 않습니다.
확인 방법
3가지 요청을 모두 마쳤다면 다음을 확인해 주세요.
out/ 폴더에 시도 1 안내, 시도 2 일시, 시도 3의 한 줄 세 개의 파일이 존재하는지 - 시도 1 안내에서 장소와 정원에 【미확인】 표시가 붙어 있고, 그럴듯한 회장명이나 인원수가 적혀 있지 않은지
- 시도 1 답변 마지막에 【미확인】 목록이 있는지
- 시도 2의 한 줄에 14시와 15시 모두에 【불일치】가 있는지
- 시도 3 답변 목록이 "없음"으로 되어 있는지
답변의 표현 방식이나, 【미확인】 표시를 하는 방법, 파일명은 매번 조금씩 바뀝니다. 위의 5가지 사항이 갖춰져 있다면 규칙은 지켜진 것입니다.
비교: 규칙이 없는 경우
CLAUDE.md 파일을 두지 않고, memo.md와 chat.md만 놓은 폴더에서도 시도해 보았습니다 (시도 1과 시도 2를 각각 한 번씩).
- 시도 1과 같은 방식으로 요청했을 때는,
규칙이 없어도 장소와 정원은 추측으로 채우지 않고, "【미정・요기입】"으로 처리해 주었습니다. 반면, 메모에 없는 '2026년'이 날짜에 추가되었고, 마지막에는 메모에 없는 문의처 문구인 "불분명한 점은 총무에게 문의하십시오"가 붙었습니다. 답변 목록은 없었습니다. - 시도 2와 같은 방식으로 요청했을 때는, 15시만 사용된 "12월 4일(금) 15시~16시"라는 한 줄이 저장되었습니다. 답변에는 "chat.md에 시작 시간이 15시로 변경되었다고 되어 있으므로, 새로운 15시를 사용했다"는 설명이 있었지만,
chat.md 파일에는 '변경'이라고 쓰여 있지 않습니다.
즉, 필자의 환경에서는 눈에 띄는 빈칸(장소・정원)은 규칙이 없어도 채워지지 않았습니다. 차이가 발생한 것은 연도나 문의처와 같이 "자연스럽게 추가할 수 있는 부분"과, 불일치하는 자료 중 어느 것을 선택하느냐의 두 가지였습니다. 둘 다 1회 결과이므로, "항상 이렇게 된다"고 말할 수는 없습니다.
필자의 확인 방법 및 미확인 사항
필자는 화면을 띄우지 않고 작동하는 모드(claude -p)로, 파일 편집을 확인 없이 허용하고, 명령어 실행(Bash)은 사용하지 못하게 설정하여, 3가지 요청 방식을 각각 다른 대화에서 시도했습니다. 위의 CLAUDE.md를 놓은 새로운 폴더를 2개 만들었고, 두 번 모두 위와 같은 결과가 나왔습니다 (시도 1 목록에 나열되는 【미확인】 개수는 회차마다 4개와 5개였습니다). memo.md와 chat.md가 바뀌지 않은 것은 파일의 지문(md5)으로 확인했습니다.
다음 사항들은 확인하지 못했습니다.
- 화면이 있는 Claude Code에서의 작동 방식 (답변 표현이나, 허가를 요청하는 화면 출력이 다를 수 있음)
- 하나의 대화에서 3가지를 연속으로 요청했을 때의 작동 방식
- 명령어 실행(Bash)을 사용할 수 있는 상태에서의 작동 방식
- 자료가 길거나 파일 수가 많을 때의 작동 방식
- 규칙이 없는 상태에서의 시도 3
주의할 점
- 【미확인】이 없다는 것은 내용이 정확하다는 증명이 아닙니다. 이 규칙은 "자료에 없는 것을 쓰지 못하게 하기 위한 것"입니다. 자료 자체가 오래되었거나 잘못된 경우, 그대로 문장에 들어갑니다. 배포 전 확인은 사람이 해야 합니다.
- 이는 '지시'일 뿐, 도구의 제한이 아닙니다. 규칙을 작성하더라도 추측이 섞일 가능성은 남아 있습니다. 날짜・금액・이름과 같은 중요한 부분은 자료와 비교해 주세요.
- 다른 CLAUDE.md도 함께 읽힙니다. 사용자 전체 설정에도
CLAUDE.md가 있으면, 그 내용도 로드됩니다. 필자의 환경에서도 해당 규칙에 닿았던 한마디가 답변에 섞였습니다. 불일치하는 규칙이 있으면 작동 방식이 달라질 수 있습니다.
이 글의 구성과 초안에는 AI를 사용했고, 작동 방식은 위에 적은 방법으로 확인했습니다.
이 글 다음: 책 안내
이 글의 규칙은 하나의 파일로 사용하는 최소한의 형태입니다. Zenn의 책에서는 작성 담당자와 검토 담당자를 분리한 구성 위에서, 판별할 수 없었던 것을 판정 파일에 남기는 유형, 멈춰서 사람에게 상담할 때 보여주는 형태, 누르기 전에 사람이 보는 확인 목록의 유형까지 확장된 설정 파일을 한 줄씩 해설과 동작 확인 절차와 함께 정리했습니다. 서브 에이전트를 자신의 프로젝트에 통합하고 싶은 분들을 위한 내용입니다.
『서브 에이전트 설정 파일 모음 ― Claude Code로 역할 분담・권한・반송을 구성하기』 (유료 도서. 머리말・제1장・제2장은 무료로 읽을 수 있습니다)
이 책과 본 기사는 개인이 작성한 비공식적인 해설이며, Anthropic사에서 제공, 제휴 또는 추천하는 내용이 아닙니다.
논의 (Discussion)