대부분의 Claude 사용자는 CLAUDE.md에 대해 들어본 적이 없습니다.
들어본 사람들조차 실제로 무엇을 넣어야 할지 모릅니다.
그리고 그 간극 때문에 사람들은 매주 몇 시간씩 낭비하고 있습니다. ⏰
진실은 이겁니다 — Claude 세션을 새로 열 때마다, Claude는 기억이 제로인 상태로 시작합니다.
당신의 이름을 모릅니다. 당신의 작업을 모릅니다. 당신의 선호도나 업무 방식을 전혀 모릅니다.
그래서 첫 몇 분을 처음부터 모든 것을 다시 설명하는 데 씁니다. 또는 설명하지 않으면 — Claude는 당신의 실제 작업 방식과 전혀 맞지 않는 결과를 내놓습니다.
CLAUDE.md는 이 문제를 영구적으로 해결합니다. 💡
제대로 설정하는 데 필요한 21 개의 지침은 다음과 같습니다. 👇
첫째 — 이건 단순한 개발자 도구가 아닙니다. 🔥
작가들은 자신의 스타일을 고정해서 Claude가 다른 사람처럼 말하지 않게 합니다. 마케터들은 대상 고객을 정의해서 Claude가 일반적인 문구를 쓰지 않게 합니다. 연구자들은 정보를 어떻게 구조화할지 설정합니다. 사업주들은 회사 전체 맥락을 Claude에 제공해서 모든 결과물이 현실에 맞게 나오도록 합니다.
CLAUDE.md 없이 — 매 세션을 제로에서 시작합니다. 같은 말을 반복합니다. 같은 실수를 고칩니다. 선호도를 백 번째 설명합니다.
CLAUDE.md는 Claude로 진지한 작업을 하기 전에 가장 먼저 설정해야 할 것입니다. 🎯
2 분 만에 만드는 방법 ⚡
프로젝트 폴더를 열고 새 파일을 만드세요. 이름을 정확히 "CLAUDE.md"로 지정하세요 — 대문자, 공백 없음.
아무 텍스트 편집기(Notepad, TextEdit, VS Code 등)에서 여세요. 지침을 일반 텍스트로 이 파일에 직접 붙여넣으세요.
가장 큰 불편을 해결할 3~4 개의 지침부터 시작하세요. 파일을 저장하세요. Claude는 해당 폴더에서 세션을 열 때마다 자동으로 읽습니다.
설정이 필요 없습니다. 추가 단계도 없습니다. 첫 메시지부터 바로 작동합니다. 💡
⚡ 파트 1: Claude가 당신과 대화하는 방식
- 군더더기를 영원히 없애세요. 🚫
Claude의 기본값은 모든 응답을 "좋은 질문이네요!", "물론이죠!", "확실합니다!", "절대 그렇습니다!"로 시작하는 것입니다.
전혀 도움이 안 되고 매일 시간을 낭비하게 하는 표현들입니다.
하나의 지침으로 이 문제를 영구히 제거하세요. 모든 응답은 바로 답변으로 시작됩니다. 준비 과정도, 도움을 주려는 쇼도 없습니다. 그냥 당신이 요청한 것 — 즉시 제공됩니다.
"절대 '좋은 질문이네요!', '물론이죠!', '확실합니다!' 같은 채우기 표현으로 응답을 시작하지 마세요. 모든 응답은 실제 답변으로 시작하세요. 서문 없이. 정보만 바로 제공하세요."
- 행동하기 전에 항상 옵션을 보여주세요. 🎯
Claude는 기본적으로 하나의 접근 방식을 선택하고 그대로 실행합니다.
문단 하나를 다시 쓰라고 하면 글 전체의 어조를 바꿔버립니다. 문서 구조를 변경하라고 하면 당신의 사고 방식과 전혀 맞지 않는 방식으로 재구성합니다.
그러면 당신은 요청하지 않은 것을 고치느라 짜증이 납니다. 😤
이 지침이 완전히 해결합니다. 중요한 작업 전에 Claude는 작업을 처리할 수 있는 2~3 가지 방법을 먼저 보여줍니다. 당신이 방향을 선택합니다. 그 다음에는 정확히 원하는 결과가 나옵니다.
"중요한 작업을 하기 전에 항상 2~3 가지 접근 방식을 먼저 보여주세요. 진행하기 전에 제 선택을 기다려주세요."
- 모를 때는 솔직히 말하세요. 🔍
Claude는 확신이 없을 때보다 자신감 있고 상세하며 완전히 틀린 답변을 먼저 내놓습니다.
그럴듯해 보이는 정보(날짜, 통계, 인용문, 사실)로 빈틈을 채웁니다 — 사실처럼 느껴지지만 실제로는 그렇지 않습니다. 그 정보를 사용했다가 나중에 가장 중요한 순간에 문제가 드러납니다.
이 지침은 그 행동을 영구히 바꿉니다.
"어떤 사실, 통계, 날짜 또는 인용문에 확신이 없으면 — 포함하기 전에 명시적으로 말하세요. '이 점은 확실하지 않습니다'라고 말하는 것이 추측을 사실로 제시하는 것보다 항상 낫습니다. 그럴듯한 정보로 빈틈을 채우지 마세요."
- 실제 필요한 길이에 맞추세요. 📏
간단한 질문을 하면 Claude가 네 문단을 씁니다. 복잡한 질문을 하면 완전해 보이지만 실제로는 부실한 뼈대만 제공합니다.
둘 다 유용하지 않습니다. 응답 길이는 작업이 실제로 요구하는 것과 일치해야 합니다.
"응답 길이를 작업 복잡성에 맞추세요. 간단한 질문에는 짧고 직접적인 답변을 주세요. 복잡한 작업에는 완전하고 상세한 응답을 주세요. 방금 말한 것을 반복하는 재진술이나 마무리 문장으로 응답을 늘리지 마세요."
⚡ 파트 2: Claude가 행동하는 방식
- 큰 변경을 하기 전에 물어보세요. ✋
문단 하나를 고치라고 했는데 Claude가 문서 전체를 다시 써버립니다. 내용을 줄이라고 했는데 실제로 필요한 부분을 삭제합니다.
매번 — 당신이 잃고 싶지 않은 것을 잃게 됩니다.
"제가 이미 만든 콘텐츠를 크게 변경하는 작업을 하기 전에 — 완전히 멈추세요. 무엇을 변경하려는지, 왜 변경하려는지 정확히 설명하세요. 진행하기 전에 제 확인을 기다리세요. '이게 더 나을 것 같아요'는 변경 허가가 아닙니다."
- 요청한 작업에 집중하세요. 🎯
한 가지를 고치라고 했는데 Claude가 그 과정에서 다른 다섯 가지를 '개선'합니다 — 당신의 표현을 조정하고, 구조를 재구성하고, 완전히 만족했던 문장을 다시 표현합니다.
이제 실제로 무엇이 바뀌었는지 찾기 위해 모든 것을 살펴봐야 합니다. 😤
"제가 특별히 요청한 것만 변경하세요. 제가 요청하지 않은 것은 다시 쓰거나, 다시 표현하거나, '개선'하지 마세요 — 당신이 더 낫다고 생각하더라도요. 다른 곳에 개선할 점이 있으면 마지막에 언급하세요. 제가 명시적으로 요청하지 않는 한 건드리지 마세요."
- 변경한 내용을 항상 알려주세요. 📋
Claude가 작업을 마치면 당신은 결과물을 훑어보며 이전과 무엇이 다른지 파악해야 합니다.
어느 부분이 변경되었나요? 무언가 잘랐나요? 요청하지 않은 것을 추가했나요?
"편집이나 작성 작업을 완료한 후에는 항상 간단한 요약으로 마무리하세요: 변경된 내용. 건드리지 않은 내용. 주의가 필요한 사항. 짧게 유지하세요 — 요약이지 재정리가 아닙니다."
- 내 동의 없이 내 대신 행동하지 마세요. 🚨
AI 도구가 이메일, 캘린더, 소셜 계정, 문서 등에 더 많이 연결될수록 — Claude가 당신이 완전히 의도하지 않은 행동을 할 위험은 새로운 통합이 생길 때마다 커집니다.
메시지 보내기. 콘텐츠 게시하기. 일정 잡기. 이런 행동들은 실제 결과를 초래하며 빠르게 진행됩니다.
"제 명시적 확인 없이 제 대신 어떤 것도 보내거나, 게시하거나, 발행하거나, 공유하거나, 일정을 잡지 마세요. '이걸 하고 싶다고 말씀하셨죠'는 확인이 아닙니다. 현재 메시지에서 제가 '예'라고 말해야 합니다."
⚡ 파트 3: 당신의 맥락
- 당신이 누구인지, 무엇을 아는지 Claude에게 알려주세요. 👤
Claude는 당신이 전문가인지 초보자인지, 창업자인지 프리랜서인지, 기술적 깊이를 원하는지 평이한 언어를 원하는지 모릅니다.
그 맥락이 없으면 — 추측합니다. 그리고 맞을 때만큼 자주 틀립니다.
"저에 대해: 이름. 역할. 배경. 잘 아는 분야 [당신이 잘 아는 주제]. 배우고 있는 분야 [더 많은 맥락이 필요한 영역]. 모든 응답의 깊이를 이 배경에 맞게 조정하세요. 제가 이미 아는 것을 과도하게 설명하지 마세요."
- 작업 중인 내용의 맥락을 Claude에 제공하세요. 📌
매 세션마다 Claude는 당신이 무엇을 작업 중인지, 누구를 위한 것인지, 실제로 무엇이 중요한지 전혀 모른 채 시작합니다.
그래서 선택의 여지 없이 일반적인 결과물을 제공합니다.
"제가 작업 중인 것: 프로젝트. 목표. 대상. 어조. 피해야 할 것. 이 맥락을 모든 작업에 적용하세요. 어떤 것이 이 그림에 맞지 않으면 — 진행하기 전에 표시하세요."
- 당신의 스타일과 어조를 고정하세요. ✍️
Claude는 기본 작성 스타일이 있습니다. 괜찮습니다. 하지만 당신의 스타일은 아닙니다.
Claude로 무언가를 쓸 때마다 — 결국 당신은 그것을 다시 당신의 스타일로 편집하게 됩니다.
스타일을 한 번 정의하면 Claude가 첫 초안부터 그 스타일로 씁니다.
"제 작성 스타일 — 항상 이것과 일치해야 합니다: 어조. 문장 길이. 제가 사용하는 단어. 제가 절대 사용하지 않는 단어. 형식 선호도. 제 대신 무언가를 쓸 때는 이 스타일에 정확히 맞추세요. 당신의 기본 패턴으로 돌아가지 마세요."
⚡ 파트 4: 기억과 연속성
- Claude가 기억 파일을 유지하게 하세요. 🧠
Claude는 세션 사이에 모든 것을 잊습니다. 모든 대화는 완전히 새롭게 시작됩니다.
하지만 Claude는 파일을 쓸 수 있습니다 — 그리고 파일은 유지됩니다.
이 지침은 Claude가 당신과 함께 내린 모든 중요한 결정(무엇을 결정했는지, 왜 결정했는지, 어떤 대안이 기각되었는지)을 기록하는 MEMORY.md 파일을 유지하도록 지시합니다.
"MEMORY.md 파일을 유지하세요. 중요한 결정 후에는 — 결정된 내용, 이유, 기각된 내용을 항목으로 추가하세요. 모든 세션을 시작할 때 어떤 작업보다 먼저 MEMORY.md를 읽으세요."
- 세션 종료 요약 — 진행 상황을 다시 잃지 마세요. 📝
세션을 닫습니다. 이틀 후에 돌아옵니다. 어디까지 했고 무엇을 끝냈는지 기억하려고 오래된 메시지를 15 분 동안 읽습니다.
완전히 피할 수 있는 낭비이며, Claude를 정기적으로 사용하는 거의 모든 사람에게 발생합니다.
"'세션 종료'나 '여기서 멈추자'고 말하면 — MEMORY.md에 세션 요약을 작성하세요: 작업한 내용. 완료된 내용. 진행 중인 내용. 내린 결정. 다음 세션에서 이어받을 내용."
- 실패한 것을 기록하세요 — 같은 문제를 두 번 해결하지 마세요. 🔄
프롬프트 방식을 시도합니다. 사용할 수 있는 결과를 얻는 데 4 번의 시도가 걸립니다. 3 주 후에 비슷한 작업으로 돌아오면 Claude는 똑같은 나쁜 제안으로 처음부터 시작합니다.
똑같은 시행착오. 똑같은 시간 낭비. 처음부터. 매번.
"ERRORS.md 파일을 유지하세요. 어떤 접근 방식이 2 번 이상의 시도가 필요한 경우 — 무엇이 효과가 없었는지, 무엇이 효과가 있었는지, 다음에 기억할 점을 기록하세요. 비슷한 작업에 접근 방식을 제안하기 전에 ERRORS.md를 확인하세요."
- Claude에 절대 변하지 않는 사실 목록을 제공하세요. 📌
모든 프로젝트에는 영구적인 사실이 있습니다 — 과거 결정에서 비롯된 제약, 중요한 이유로 존재하는 규칙, 특정 작업과 관계없이 당신의 작업에 항상 적용되는 것들입니다.
이것이 없으면 — Claude는 당신의 현실과 완전히 모순되는 제안을 무심코 합니다.
"이 사실들은 항상 참입니다. 예외 없이 모든 세션에 적용하세요: [당신의 영구적인 사실들]. 어떤 작업이 이 중 하나와 충돌하면 — 진행하기 전에 표시하세요."
⚡ 파트 5: 개발자용
- 범위 내에 머물러라 — 요청받지 않은 것은 건드리지 마세요. 🔒
버그 하나를 고치라고 했는데 Claude가 세 개의 파일을 리팩터링하고, 변수 이름을 바꾸고, import를 재구성하고, 몇 달 동안 작업해 온 코드를 '개선'합니다 — 모두 묻지 않고.
그 중 일부 변경은 문제를 일으킵니다. 일부는 추적하는 데 며칠이 걸리는 미묘한 차이를 도입합니다.
"현재 작업과 직접 관련된 파일, 함수, 코드 줄만 수정하세요. 제가 명시적으로 요청하지 않은 것은 리팩터링하거나, 이름을 바꾸거나, '개선'하지 마세요. 다른 곳에 고칠 만한 점이 있으면 언급하세요. 건드리지 마세요. 절대."
- 파괴적인 작업 전에 반드시 확인하세요. ⚠️
Claude Code는 망설임 없이 파일을 삭제하고, 함수를 덮어쓰고, 데이터베이스 테이블을 드롭합니다 — 당신이 그렇게 말했기 때문이며, 당신이 말한 내용을 완전히 인지하지 못했더라도 마찬가지입니다.
지시를 한 번 잘못 읽으면 몇 시간의 작업이 취소 불가능하게 사라집니다.
"파일을 삭제하거나, 기존 코드를 덮어쓰거나, 데이터베이스 레코드를 드롭하거나, 간단히 되돌릴 수 없는 변경을 하기 전에 — 완전히 멈추세요. 영향을 받을 것을 정확히 나열하세요. 명시적 확인을 요청하세요. 현재 메시지에서 제가 '예'라고 말한 후에만 진행하세요."
- 하드 스톱 — 허가 없이 절대 발생하지 않아야 할 작업. 🚨
프로덕션에 배포하기. 라이브 데이터베이스에서 마이그레이션 실행하기. 외부 서비스에 API 호출 보내기.
이것들은 '조심하세요' 상황이 아닙니다. 완전한 중단입니다.
"다음 작업은 실행 전에 세션 내에서 명시적 확인이 필요합니다 — 예외 없음: 모든 환경에 배포. 모든 데이터베이스에 마이그레이션 실행. 모든 이메일 또는 외부 API 호출 전송. 돌이킬 수 없는 외부 부작용이 있는 모든 명령 실행."
- 기술 스택을 고정하세요. 🔧
정의된 스택이 없으면 — Claude는 자신이 가장 인기 있다고 생각하는 프레임워크, 가장 자주 본 라이브러리, 기본으로 사용하는 패키지 매니저를 제안합니다.
대개 당신이 사용하는 것, 당신 팀이 아는 것, 당신이 이미 구축한 것과 호환되지 않습니다.
"기술 스택 — 항상 이것들을 사용하고, 제가 요청하지 않는 한 대안을 제안하지 마세요: 언어. 프레임워크. 패키지 매니저. 데이터베이스. 테스트. 린팅. 어떤 것이 잘못된 도구처럼 보이면 — 표시하세요. 하지만 제가 달리 말하지 않는 한 계속 사용하세요."
- 정확히 무엇이 변경되었는지 항상 보여주세요. 📊
Claude가 코딩 작업을 마치면 당신은 결과물을 훑어보며 무엇이 다른지 파악해야 합니다.
어떤 파일이 변경되었나요? 다른 것도 건드렸나요? 미완으로 남은 것이 있나요?
"코딩 작업을 완료한 후에는 항상 다음으로 마무리하세요: 변경된 파일. 수정된 내용 — 파일당 한 줄. 의도적으로 건드리지 않은 파일. 후속 조치 필요. 짧게 유지하세요 — 상태 업데이트이지 재정리가 아닙니다."
- Andrej Karpathy의 CLAUDE.md를 바이럴하게 만든 4 가지 규칙. 🔥
Andrej Karpathy — Tesla 전 AI 디렉터, OpenAI 창립 멤버 — Claude Code가 코딩 작업에서 실패하게 만드는 4 가지 특정 행동을 식별했습니다.
한 개발자가 이를 4 개의 지침으로 정리했습니다. 그 파일은 GitHub Trending에서 1 위를 차지했고 코딩 정확도를 65%에서 94%로 향상시켰습니다. 😱
다음과 같습니다:
- 가정하지 말고 물어보세요 — 불확실한 것이 있으면 한 줄도 작성하기 전에 물어보세요. 절대 조용히 가정하지 마세요.
- 가장 간단한 해결책 먼저 — 항상 작동할 수 있는 가장 간단한 것을 구현하세요. 요청되지 않은 추상화를 추가하지 마세요.
- 관련 없는 코드는 건드리지 마세요 — 파일이 현재 작업의 직접적인 일부가 아니라면 수정하지 마세요. 절대.
- 불확실성을 명시적으로 표시하세요 — 접근 방식에 자신이 없으면 진행하기 전에 말하세요. 확신 없는 자신감은 약점을 인정하는 것보다 더 큰 피해를 줍니다.
결론. 💎
CLAUDE.md는 단순한 개발자 도구가 아닙니다.
Claude를 진지하게 사용하는 모든 사람이 첫 번째 실제 세션 전에 설정해야 하는 영구적인 지침 파일입니다.
지침 1-4는 Claude의 의사소통 방식을 고칩니다. 지침 5-8은 당신이 승인하지 않은 것을 변경하지 못하게 합니다. 지침 9-11은 실제 작업에 맞는 결과물을 생성할 맥락을 제공합니다. 지침 12-15는 현재 존재하는 가장 가까운 진정한 기억을 제공합니다. 지침 16-21은 Claude Code를 예측 불가능한 도구 대신 정밀한 도구처럼 행동하게 만듭니다.
파일을 만드세요. 3 개의 지침을 붙여넣으세요. 진행하면서 더 추가하세요.
출력 품질의 차이는 첫 번째 세션부터 즉각적이고 분명할 것입니다. 🚀
AI와 협업하는 방식을 실제로 바꾸는 더 많은 시스템을 위해 팔로우하세요. 💯
