대부분의 사람들이 Claude Code를 사용할 때 AI가 작업을 시작하기 전에 항상 읽는 파일 하나를 간과하고 있습니다.
그 파일의 이름은 "CLAUDE.md"입니다.
Anthropic의 공식 문서에는 명확히 명시되어 있습니다: 폴더에 CLAUDE.md 파일이 존재하면, Claude Code는 요청하지 않아도 작업을 시작하기 전에 항상 이 파일을 로드합니다.
즉, 여기에 작성하는 내용이 AI의 초기 행동을 100% 바꿉니다. 매번 프롬프트를 다시 입력해야 하는 반면, CLAUDE.md는 한 번 작성하면 모든 대화에서 작동합니다.
그 효과는 차원이 다릅니다.
반대로, 이 파일을 정리하지 않으면 아무리 프롬프트를 다듬어도 효과는 거의 없습니다. AI는 매번 엇나가고, 매번 전제를 다시 설명해야 하며, 같은 작업이라도 날마다 품질이 달라집니다. 원인은 모델이나 프롬프트 기술이 아니라 바로 이 파일입니다.
오늘은 CLAUDE.md에 "무엇을, 어떻게 작성해야 하는지"를 복사해서 바로 쓸 수 있는 예제와 함께 공개하겠습니다.
성과가 안 나오는 사람들에게 CLAUDE.md는 그저 "메모장"일 뿐입니다
솔직히 말하면, 저도 처음에는 어려움을 겪었습니다.
한동안 X에서는 "폴더 내용이 중요하다"거나 "CLAUDE.md가 중요하다"는 글들이 많았습니다. 그래서 보고 제 폴더를 열어봤습니다.
내용은 엉망이었습니다.
무엇이 어디 있는지 몰랐습니다. 비슷한 데이터가 여기저기 흩어져 있었습니다. AI는 필요한 지식을 찾지 못했고, 매번 출력물이 제가 원하는 답이 아니었습니다.
CLAUDE.md도 마찬가지였습니다. 무엇을 어디에 저장할지에 대한 규칙이 정해져 있지 않았습니다. CLAUDE.md가 무엇인지조차 제대로 이해하지 못했습니다. 그래서 생각나는 대로 위에서부터 지침을 계속 추가했습니다.
결국 300~400줄이 되었습니다. 200줄을 훌쩍 넘겼습니다.
CLAUDE.md는 최대 200줄로 유지하는 것이 좋습니다.
너무 긴 CLAUDE.md는 "AI가 무엇이 중요한지 모르는 긴 글"이 됩니다.
이 상태에서 AI는 매번 전체 파일을 다시 읽고 "그래서 이 작업에 어떤 부분이 적용되지?"라고 추측하려고 합니다. 추측이 개입되면 일관성은 당연히 사라집니다.
CLAUDE.md는 "메모장"이 아닙니다. AI가 매번 참조하는 "판단을 위한 지도"입니다. 이 인식을 바꾸는 것이 절반의 성공입니다.
CLAUDE.md에는 이 5가지만 작성하세요
복잡하게 할 필요가 없습니다. 강력한 명령 센터에는 반드시 이 다섯 가지 요소가 포함됩니다:
- ① 우선순위 규칙: 모든 출력 전에 따라야 할 최우선 선언
- ② 키워드 → 위치 라우팅 테이블: 어떤 작업이 어디로 가는지
- ③ 위치 결정 트리: 테이블에 없는 항목을 판단하는 방법
- ④ 작업 처리: 해야 할 일을 어떻게, 어디에 기록할지
- ⑤ 기밀 정보 처리: 공유해서는 안 되는 것의 경계 설정
이 다섯 가지가 갖춰지면 AI는 "추측"을 멈추고 "참조"하기 시작합니다. 불일치의 근본 원인이 사라집니다.
이제 각각을 실제 예제와 함께 작성하는 방법을 살펴보겠습니다.
설정 ① 맨 위에 "우선순위 규칙" 선언
가장 먼저 작성할 것은 AI의 초기 동작을 고정하는 선언입니다. "생각하기 전에, 먼저 아래 규칙을 따라라"라는 경고입니다.
▼ 작성 예시
우선순위: 출력하거나 저장하기 전에, 항상 아래 규칙을 먼저 확인한 후 행동하세요. 위치는 아래 "키워드 테이블"과 "결정 트리"를 사용하여 결정해야 합니다. 스스로 결정할 수 없으면 임의로 진행하지 말고 질문하세요.
이것만 맨 위에 배치해도 AI는 "그냥 손만 움직이는" 것을 멈춥니다. 행동하기 전에 매번 규칙을 확인하기 시작합니다. 이렇게 시작점이 고정됩니다.
설정 ② "키워드 → 위치" 매핑 테이블 포함
다음으로 가장 효과적인 것은 작업 분배 테이블입니다. "이런 요청이 오면 여기에 넣어라/여길 봐라"를 키워드로 연결합니다.
▼ 작성 예시
키워드 → 위치 ・블로그/기사 → Publishing/Blog/ ・지출/영수증 → Accounting/Vouchers/ ・회의록/MTG 메모 → Records/Minutes/
핵심은 평소에 사용하는 단어 그대로 작성하는 것입니다. AI는 테이블의 단어를 보고 망설임 없이 위치를 선택할 수 있습니다.
분배 축의 팁은 "업무"보다 "기능(작업)"으로 자르는 것입니다. 이렇게 하면 업무나 제품이 늘어나도 테이블이 깨지지 않습니다.
설정 ③ 길을 잃었을 때를 위한 "결정 트리" 포함 ← 이것이 가장 효과적입니다
다섯 가지 중에서 이것이 가장 큰 영향을 미칩니다. 테이블에 없거나 모호한 것을 처리하는 방법입니다.
인간과 AI 모두 길을 잃으면 멈춥니다. 길을 잃었기 때문에 엇나가는 것입니다. 따라서 망설일 여지를 없애면 됩니다. 위에서부터 YES/NO 경로를 따르게 하면 됩니다.
▼ 작성 예시
저장하기 전에 다음 단계를 순서대로 따르세요: Q1. 기밀 정보(API 키/비밀번호)인가요? → YES: .env로 이동. 종료. Q2. 외부에서 방금 다운로드한 원시 데이터인가요? → YES: Assets/로 이동. Q3. 어떤 작업인가요? → Publishing / Sales / Accounting / Records 중 하나로 이동. → 끝까지 단일 위치를 결정할 수 없으면 진행하지 말고 정확히 2개의 질문을 하세요.
그렇다면 결정 트리를 추가하기 전후에 행동이 어떻게 바뀔까요? 구체적으로 두 가지 측면에서 바뀝니다.
변화 1: 같은 요청에 대해 매번 같은 작업을 수행합니다.
Claude Code는 확률에 기반하여 작동합니다. 채팅이 바뀌면 이전 대화를 기억하지 못합니다. 따라서 결정 트리가 없으면 같은 "회의록 저장" 요청에도 변동이 생깁니다.
결정 트리가 없을 때:
- 1번째 → Meeting/에 저장
- 2번째 → Memo/Minutes/에 저장
- 3번째 → 왠지 Assets 폴더에 저장
결정 트리가 있을 때:
- 매번 같은 경로를 따릅니다: Q1→Q2→Q3 → 항상 같은 장소
행동이 "확률적 변동"에서 "고정된 절차"로 바뀝니다. 재현성이 생기면 그 위에 구축할 수 있습니다.
변화 2: 길을 잃었을 때 과신하여 실수하는 것을 멈춥니다.
가장 무서운 AI 행동은 "자신 있게 틀리는 것"입니다. 예를 들어, 비디오 녹화본과 그로 만든 회의록을 같은 곳에 던져 넣는 것과 같습니다.
- 추측해서 강제로 진행 → ❌
- 멈추고 2개의 질문으로 확인 → ✓
마지막 줄이 미묘하게 효과적입니다. "결정할 수 없으면 서두르지 말고 질문하라"고 적는 것만으로도 엉뚱한 결과물의 대량 생산을 구조적으로 줄일 수 있습니다.
AI는 똑똑할수록 완전한 자유보다 "템플릿"이 주어졌을 때 더 잘 수행합니다.
설정 ④ & ⑤ 작업 처리 및 기밀 유지
나머지 두 가지는 짧게 쓸 수 있습니다. 하지만 반드시 작성해야 합니다.
④ 작업을 "어디에, 어떻게 남길지"를 고정합니다. 이것이 없으면 할 일이 대화할 때마다 흩어집니다.
▼ 작성 예시
작업 처리 ・모든 할 일은 단일 "tasks.md" 파일에 통합합니다. ・완료되면 삭제하지 말고 "완료됨"으로 이동하고 1줄 결과를 남깁니다.
⑤ 기밀 정보의 경계를 명확히 작성합니다. 사고 예방을 위한 생명줄입니다.
▼ 작성 예시
기밀 정보 ・API 키/비밀번호는 .env에만 작성합니다. ・채팅, 코드, 기록에 절대 붙여넣지 마세요.
이 두 가지로 작업은 흩어지지 않고, 나가면 안 되는 것은 안에 머물게 됩니다. 두 개의 방어막 역할을 합니다.
CLAUDE.md를 "200줄 미만"으로 유지하세요. 넘으면 다른 파일로 옮기세요.
모든 것을 CLAUDE.md에 쓰면 점점 길어진다는 것을 눈치챈 분들도 계실 겁니다.
맞습니다. 이것이 중요합니다. CLAUDE.md를 너무 길게 만들면 오히려 효과가 떨어집니다. AI가 매번 처음부터 끝까지 읽기 때문에 너무 길면 "무엇이 중요한지"에 대한 감각이 희석됩니다.
가이드라인은 200줄 미만입니다.
맞지 않으면 상세 규칙을 별도 파일(예: "rules_detail.md")로 옮기세요. 그런 다음 CLAUDE.md 맨 위에 "언제 읽을지"에 대한 지침을 추가하세요.
▼ 작성 예시 (맨 위 선언에 한 줄만 추가)
우선순위: 출력/저장하기 전에 항상 아래 규칙을 따르세요. 블로그 게시물을 작성할 때만 "rules_detail.md"를 읽으세요.
여기서 핵심은 "항상 읽어라"가 아니라 "...할 때만"과 같은 조건을 추가하는 것입니다. 이렇게 하면 AI는 관련 없는 작업에는 그 파일을 열지 않지만, 필요한 작업에는 "CLAUDE.md → rules_detail.md" 순서로 이동합니다.
이렇게 하면 본체는 가볍게 유지하면서 원하는 만큼 상세 규칙을 추가할 수 있습니다. 핵심은 온디맨드 호출 시스템으로 만드는 것입니다.
CLAUDE.md는 "입구이자 지휘관"이고, 상세 내용은 "호출되는 별도 파일"입니다. 이 역할 분담을 기억하면 규칙이 아무리 늘어나도 무너지지 않습니다.
솔직히 말하면, 한 번에 완전히 달라지지는 않습니다
솔직히 말하겠습니다.
저는 300~400줄의 엉망을 5개의 블록으로 재구성했습니다. 그 후 처음 느낀 것은 "극적인 변화"가 아니었습니다.
처음에는 그냥 길을 잃지 않게 되었다는 것뿐이었습니다.
세상은 한 번에 바뀌지 않습니다. 점진적으로 효과가 나타납니다. 같은 요청에 같은 움직임을 반환하고, 엉뚱한 결과물이 줄어들고, 지식이 축적됩니다. 어느새 완전히 다른 존재처럼 움직이게 됩니다. 그런 식입니다.
화려한 마법을 기대한다면 실망할 수도 있습니다. 하지만 재현성은 분명히 쌓입니다.
요약: 모든 것을 하는 것이 귀찮은 분들을 위해
너무 복잡하게 생각하지 마세요. 오늘 해야 할 일은 CLAUDE.md를 열거나(없으면 만드는 것)입니다. 그게 전부입니다.
모든 것을 하는 것이 귀찮은 분들을 위해 예상 시간과 함께 우선순위 목록을 제공합니다:
- 처음 5분: ③ 결정 트리 3가지 질문 작성 (가장 큰 효과)
- +7분: ① 우선순위 규칙 및 ② 라우팅 테이블 추가
- +3분: ④ 작업 및 ⑤ 기밀 정보 경계 추가
총 15분입니다. 이렇게 하면 ①→②→③→④→⑤ 순서로 정리됩니다. 200줄을 초과할 것 같으면 상세 내용을 별도 파일로 옮기고 맨 위에서 읽도록 하면 됩니다. 그게 전부입니다.
과도하게 채울 필요 없습니다. 그냥 정리하면 됩니다. 이것만으로도 어제 사용하던 동일한 Claude Code가 완전히 다른 것처럼 움직이기 시작할 것입니다.
Claude Code의 성능을 향상시키려는 사람들은 항상 프롬프트 기술을 찾습니다. 하지만 진정한 레버리지는 더 상류에 있습니다. AI가 매번 가장 먼저 읽는 단 하나의 파일입니다.
상위 5%와 나머지 95%의 차이는 재능이나 프롬프트 기술이 아닙니다. 단지 하나의 CLAUDE.md 파일을 정리했는지, 아니면 내버려두었는지의 차이일 뿐입니다.
이 글의 결정 트리 3가지 질문을 복사하여 붙여넣는 것부터 시작하세요.
마지막으로
마지막으로 한 가지 고백을 하겠습니다.
제가 평소에 내놓는 Slides는 모두 AI가 만든 것입니다. 더 이상 제가 손으로 만든 Slides는 하나도 없습니다.
그리고 오늘, 저는 그와 똑같은 품질로 만들 수 있는 AI를 무료로 제공합니다.
여기까지 읽으셨다면 아마 이미 눈치채셨을 것입니다. 이 글에서 제가 계속 이야기해온 것은 한 가지로 귀결됩니다:
"AI가 길을 잃지 않게 하라."
AI는 능력이 낮아서 실패하는 것이 아닙니다. 길을 잃었기 때문에 실패하는 것입니다.
컨텍스트를 제공하세요. 지침을 설계하세요. AI가 헤맬 여지를 남기지 마세요. 즉, 비서처럼 키우는 것입니다. 이 글에서는 Claude Code로 그렇게 했습니다.
제가 지금 배포하려는 것은 ChatGPT GPTs입니다. 혼동하지 마시기 바랍니다: 본문은 Claude Code에 관한 것이었고, 이것은 ChatGPT GPTs입니다. 도구는 다릅니다.
하지만 근본은 같습니다. 필요한 것은 기술이 아닙니다. AI가 길을 잃지 않게 하는 설계일 뿐입니다.
이 GPTs는 "Slides 제작"이라는 단일 영역에서 그 철학을 극한까지 밀어붙인 완성품입니다. 저는 이미 컨텍스트를 설계하는 모든 작업을 끝마쳤습니다.
보장합니다. 여러분이 해야 할 일은 주제를 입력하는 것뿐입니다. 그 후에는 철저히 설계된 GPTs가 망설임 없이 Slides를 뱉어냅니다.
이 GPTs를 처음 소개한 글은 400,000 노출을 기록했습니다. 그만큼 많은 사람들이 "이건 다르다"고 반응했다는 뜻입니다.
https://x.com/masaki_aihack/status/2068646555524223366
그리고 한정된 기간 동안만, 이 GPTs를 포함한 "20가지 보너스" 번들을 무료로 제공합니다.
받는 방법은 간단합니다. 아래 LINE 오픈챗에 참여하는 것으로 시작하세요.
솔직히 말하면, 이 GPTs는 한 번에 완성되지 않았습니다. 50번 이상 실패했습니다. "누구나 사용할 수 있는" 수준에 도달하는 데 일주일이 걸렸습니다. 그 매뉴얼을 그대로 제공합니다.
한 번 더 말씀드립니다. 필요한 것은 기술이 아닙니다. AI가 길을 잃지 않게 하는 독창성일 뿐입니다.
오늘, Slides 제작의 피로에서 벗어나시는 것은 어떠신가요?
