당신은 지금까지 Claude를 잘못 사용하고 있었습니다. CLAUDE.md 하나로 모든 것이 해결됩니다. 방법은 다음과 같습니다. 👇

Claude를 사용하는 대부분의 사람들은 CLAUDE.md에 대해 들어본 적이 없습니다.

들어본 사람들조차 실제로 무엇을 넣어야 할지 모릅니다.

그리고 그 격차로 인해 사람들은 매주 몇 시간씩 낭비하고 있습니다. ⏰

진실은 이겁니다 — Claude 세션을 새로 열 때마다, Claude는 아무런 기억도 없는 상태에서 시작합니다.

여러분의 이름을 모릅니다. 여러분의 작업을 모릅니다. 여러분의 선호도나 작업 방식을 모릅니다.

그래서 처음 몇 분 동안 모든 것을 처음부터 다시 설명해야 합니다. 또는 그러지 않으면 — Claude가 여러분의 실제 작업 방식에 전혀 맞지 않는 결과를 내놓습니다.

CLAUDE.md가 이 문제를 영구적으로 해결합니다. 💡

제대로 설정하는 데 필요한 21가지 지침을 모두 소개합니다. 👇

먼저 — 이것은 단순한 개발자 도구가 아닙니다. 🔥

작가들은 자신의 목소리를 고정해서 Claude가 다른 사람처럼 말하지 않도록 합니다. 마케터들은 대상 고객을 정의해서 Claude가 일반적인 카피를 쓰지 않도록 합니다. 연구자들은 정보를 어떻게 구조화할지 설정합니다. 비즈니스 소유자는 전체 회사 컨텍스트를 제공해서 모든 출력이 현실에 맞도록 합니다.

CLAUDE.md가 없으면 — 매 세션마다 제로에서 시작합니다. 같은 말을 반복합니다. 같은 실수를 수정합니다. 자신의 선호도를 백 번째 설명합니다.

CLAUDE.md는 Claude로 진지한 작업을 시작하기 전에 가장 먼저 설정해야 할 것입니다. 🎯

2 분 만에 만드는 방법 ⚡

프로젝트 폴더를 열고 새 파일을 만드세요. 이름을 정확히 "CLAUDE.md"로 지정하세요 — 대문자, 공백 없음.

아무 텍스트 편집기에서 열어보세요 — Notepad, TextEdit, VS Code, 무엇이든 좋습니다. 지침을 일반 텍스트로 이 파일에 직접 붙여넣으세요.

가장 큰 불편을 해결하는 3~4 개의 지침부터 시작하세요. 파일을 저장하세요. Claude는 해당 폴더에서 세션을 열 때마다 자동으로 읽습니다.

설정이 필요 없습니다. 추가 단계도 없습니다. 첫 번째 메시지부터 바로 작동합니다. 💡

⚡ PART 1: Claude가 여러분과 대화하는 방식

1. 불필요한 말을 영원히 없애세요. 🚫

Claude의 기본값은 모든 응답을 "좋은 질문이네요!", "물론이죠!", "당연하죠!", "정말 그렇습니다!" 같은 말로 시작하는 것입니다.

전혀 도움이 안 되고 매일 시간만 낭비하는 표현들입니다.

단 하나의 지침으로 이 문제를 영구적으로 없앨 수 있습니다. 모든 응답은 바로 답변으로 시작합니다. 준비 운동도 없고, 도움을 주는 척하는 연기도 없습니다. 그냥 요청한 내용을 즉시 제공합니다.

"절대 '좋은 질문이네요!', '물론이죠!', '당연하죠!' 같은 준비 멘트로 응답을 시작하지 마세요. 모든 응답은 실제 답변으로 바로 시작하세요. 서두 없이, 정보만 바로 제공하세요."

1. 항상 옵션을 먼저 보여주고 실행하세요. 🎯

Claude는 기본적으로 한 가지 접근 방식을 선택하고 그대로 실행합니다.

문단을 다시 작성해 달라고 하면 전체 어조를 바꿔버립니다. 문서를 재구성해 달라고 하면 여러분의 사고 방식과 전혀 맞지 않는 방식으로 재구성합니다.

그러면 요청하지도 않은 변경 사항을 수정해야 합니다. 😤

이 지침은 그 문제를 완전히 해결합니다. 중요한 작업을 수행하기 전에 Claude는 작업에 접근할 수 있는 2~3 가지 방법을 보여줍니다. 여러분이 방향을 선택합니다. 그러면 정확히 원하는 결과가 나옵니다.

"중요한 작업을 수행하기 전에 항상 2~3 가지 가능한 접근 방식을 먼저 보여주세요. 진행하기 전에 제 선택을 기다리세요."

1. 모를 때는 솔직하게 말하세요. 🔍

Claude는 불확실함을 인정하기보다는 자신감 넘치고 상세하며 완전히 틀린 답변을 내놓습니다.

그럴듯한 정보(날짜, 통계, 인용문, 사실)로 빈칸을 채웁니다. 이 정보는 사실처럼 느껴지지만 실제로는 그렇지 않습니다. 여러분이 그 정보를 사용하면 나중에 가장 중요한 순간에 문제가 드러납니다.

이 지침은 그 행동을 영구적으로 바꿉니다.

"어떤 사실, 통계, 날짜 또는 인용문에 대해 확신이 없다면 — 포함하기 전에 명시적으로 그렇게 말하세요. '이 부분은 확실하지 않습니다'라고 말하는 것이 추측을 사실로 제시하는 것보다 항상 낫습니다. 그럴듯한 정보로 빈칸을 채우지 마세요."

1. 실제로 필요한 길이에 맞추세요. 📏

Claude에게 간단한 질문을 하면 네 문단을 씁니다. 복잡한 질문을 하면 완성된 것처럼 보이지만 실제로는 부족한 뼈대만 제공합니다.

둘 다 유용하지 않습니다. 응답 길이는 작업이 실제로 요구하는 것과 일치해야 합니다.

"응답 길이를 작업 복잡성에 맞추세요. 간단한 질문에는 짧고 직접적인 답변을 주세요. 복잡한 작업에는 완전하고 상세한 응답을 주세요. 방금 말한 내용을 반복하는 재진술이나 마무리 문장으로 응답을 늘리지 마세요."

⚡ PART 2: Claude의 행동 방식

1. 큰 변경을 하기 전에 물어보세요. ✋

Claude에게 한 문단을 수정해 달라고 하면 전체 문서를 다시 씁니다. 내용을 줄여 달라고 하면 실제로 필요한 섹션을 삭제합니다.

매번 — 원하지 않는 것을 잃게 됩니다.

"제가 이미 만든 콘텐츠를 크게 변경하기 전에 — 완전히 멈추세요. 무엇을 변경하려고 하는지, 그 이유를 정확히 설명하세요. 진행하기 전에 제 확인을 기다리세요. '이게 더 나을 것 같아요'는 변경할 수 있는 허락이 아닙니다."

1. 요청한 작업에 집중하세요.

Claude에게 한 가지를 수정해 달라고 하면 작업 중에 다른 다섯 가지를 "개선"합니다 — 여러분의 표현을 조정하고, 구조를 재구성하고, 완전히 만족했던 문장을 다시 표현합니다.

그러면 실제로 변경된 사항을 찾기 위해 모든 것을 뒤져야 합니다.

"제가 특별히 요청한 것만 변경하세요. 제가 요청하지 않은 것은 다시 쓰거나, 다시 표현하거나, '개선'하지 마세요 — 더 나을 것 같다고 생각하더라도 마찬가지입니다. 다른 곳에서 개선할 가치가 있는 것을 발견했다면 마지막에 언급하세요. 제가 명시적으로 요청하지 않는 한 건드리지 마세요."

1. 변경한 내용을 항상 알려주세요. 📋

Claude가 작업을 마치면 여러분은 출력물을 훑어보며 이전과 무엇이 다른지 파악해야 합니다.

어떤 섹션이 변경되었나요? 무언가를 삭제했나요? 요청하지 않은 것을 추가했나요?

"편집 또는 작성 작업을 완료한 후에는 항상 간단한 요약으로 마무리하세요: 변경된 사항. 건드리지 않은 사항. 주의가 필요한 사항. 짧게 유지하세요 — 이것은 상태 업데이트이지 요약이 아닙니다."

1. 내 허락 없이 나를 대신해 행동하지 마세요.

AI 도구가 이메일, 캘린더, 소셜 계정, 문서 등에 더 많이 연결됨에 따라 Claude가 여러분이 완전히 의도하지 않은 행동을 할 위험은 새로운 통합이 추가될 때마다 커집니다.

메시지 보내기. 콘텐츠 게시하기. 일정 잡기. 이러한 행동은 실제 결과를 초래하며 빠르게 발생합니다.

"현재 메시지에서 제 명시적인 확인 없이 저를 대신해 어떤 것도 보내거나, 게시하거나, 발행하거나, 공유하거나, 일정을 잡지 마세요. '이걸 하고 싶다고 말씀하셨죠'는 확인이 아닙니다. 현재 메시지에서 제가 '네'라고 말해야 합니다."

⚡ PART 3: 여러분의 컨텍스트

1. Claude에게 여러분이 누구인지, 무엇을 아는지 알려주세요.

Claude는 여러분이 전문가인지 초보자인지, 창업자인지 프리랜서인지, 기술적인 깊이를 원하는지 평이한 언어를 원하는지 알지 못합니다.

그 컨텍스트가 없으면 — 추측합니다. 그리고 맞을 때만큼 자주 틀립니다.

"저에 대해: 이름. 역할. 배경. [잘 아는 주제]에 강함. [더 많은 컨텍스트가 필요한 영역]은 아직 배우는 중. 모든 응답의 깊이를 이 배경에 맞추세요. 제가 이미 아는 내용을 과도하게 설명하지 마세요."

1. Claude에게 작업 중인 내용의 컨텍스트를 제공하세요.

매 세션마다 Claude는 여러분이 무엇을 작업 중인지, 누구를 위한 것인지, 무엇이 중요한지 전혀 모른 채 시작합니다.

다른 선택지가 없기 때문에 일반적인 결과물을 제공합니다.

"제가 작업 중인 내용: 프로젝트. 목표. 대상. 어조. 피해야 할 것. 이 컨텍스트를 모든 작업에 적용하세요. 어떤 것이 이 그림에 맞지 않으면 — 진행하기 전에 표시하세요."

1. 여러분의 목소리와 스타일을 고정하세요.

Claude는 기본적인 글쓰기 스타일이 있습니다. 괜찮습니다. 하지만 여러분의 스타일은 아닙니다.

Claude로 무언가를 작성할 때마다 — 결국 여러분은 그것을 다시 자신의 목소리로 편집하게 됩니다.

목소리를 한 번 정의하면 Claude는 첫 번째 초안부터 그 스타일로 작성합니다.

"제 글쓰기 스타일 — 항상 이것과 일치하세요: 목소리. 문장 길이. 제가 사용하는 단어. 제가 절대 사용하지 않는 단어. 형식 선호도. 저를 대신해 글을 쓸 때는 이 스타일을 정확히 따르세요. 기본 패턴을 사용하지 마세요."

⚡ PART 4: 기억과 연속성

1. Claude가 기억 파일을 유지하도록 하세요.

Claude는 세션 사이에 모든 것을 잊어버립니다. 모든 대화는 완전히 새롭게 시작됩니다.

하지만 Claude는 파일을 쓸 수 있습니다 — 그리고 파일은 유지됩니다.

이 지침은 Claude에게 여러분이 함께 내린 모든 중요한 결정(무엇이 결정되었는지, 왜 그런지, 어떤 대안이 기각되었는지)을 MEMORY.md 파일에 기록하도록 지시합니다.

"MEMORY.md라는 파일을 유지하세요. 중요한 결정을 내린 후에는 — 결정된 내용, 이유, 기각된 내용을 항목으로 추가하세요. 매 세션 시작 시 아무 작업을 하기 전에 MEMORY.md를 읽으세요."

1. 세션 종료 요약 — 진행 상황을 다시는 잃지 마세요.

세션을 닫습니다. 이틀 후에 다시 돌아옵니다. 15 분 동안 이전 메시지를 읽으며 어디까지 했는지, 무엇을 완료했는지 기억하려고 합니다.

완전히 피할 수 있는 낭비이며, Claude를 정기적으로 사용하는 거의 모든 사람에게 발생합니다.

"제가 '세션 종료' 또는 '여기서 멈추자'고 말하면 — MEMORY.md에 세션 요약을 작성하세요: 작업한 내용. 완료된 내용. 진행 중인 내용. 내린 결정. 다음 세션에서 이어받을 내용."

1. 작동하지 않은 것을 기록하세요 — 같은 문제를 두 번 해결하지 마세요.

프롬프트 접근 방식을 시도합니다. 사용할 수 있는 결과를 얻는 데 네 번의 시도가 걸립니다. 3 주 후에 비슷한 작업으로 돌아오면 Claude는 똑같은 나쁜 제안으로 처음부터 다시 시작합니다.

똑같은 시행착오. 똑같은 시간 낭비. 처음부터. 매번.

"ERRORS.md라는 파일을 유지하세요. 접근 방식이 작동하는 데 2 번 이상의 시도가 필요한 경우 — 작동하지 않은 것, 작동한 것, 다음에 기억할 것을 기록하세요. 비슷한 작업에 접근 방식을 제안하기 전에 ERRORS.md를 확인하세요."

1. Claude에게 절대 변하지 않는 사실 목록을 제공하세요. 📌

모든 프로젝트에는 영구적인 사실이 있습니다 — 과거 결정에서 비롯된 제약, 중요한 이유로 존재하는 규칙, 특정 작업과 관계없이 여러분의 작업에 항상 적용되는 사항들입니다.

이것이 없으면 — Claude는 여러분의 현실과 완전히 모순되는 것을 가볍게 제안합니다.

"이 사실들은 항상 참입니다. 예외 없이 모든 세션에 적용하세요: [여러분의 영구 사실 목록]. 어떤 작업이 이 중 하나와 충돌하면 — 진행하기 전에 표시하세요."

⚡ PART 5: 개발자용

1. 범위를 지키세요 — 요청하지 않은 것은 건드리지 마세요.

Claude에게 버그 하나를 수정해 달라고 하면 세 개의 파일을 리팩터링하고, 변수 이름을 바꾸고, 임포트를 재구성하고, 몇 달 동안 작업해 온 코드를 "개선"합니다 — 모두 묻지 않고.

그 변경 사항 중 일부는 문제를 일으킵니다. 일부는 추적하는 데 며칠이 걸리는 미묘한 차이를 만듭니다.

"현재 작업과 직접 관련된 파일, 함수 및 코드 줄만 수정하세요. 제가 명시적으로 요청하지 않은 것은 리팩터링하거나, 이름을 바꾸거나, '개선'하지 마세요. 다른 곳에서 수정할 가치가 있는 것을 발견했다면 언급하세요. 건드리지 마세요. 절대로."

1. 파괴적인 작업 전에는 확인하세요.

Claude Code는 파일을 삭제하고, 함수를 덮어쓰고, 데이터베이스 테이블을 망설임 없이 삭제합니다 — 여러분이 그렇게 말했기 때문입니다, 비록 여러분이 무엇을 말하고 있는지 완전히 깨닫지 못했더라도요.

하나의 잘못 읽은 지침으로 몇 시간의 작업이 취소 불가능하게 완전히 사라집니다.

"파일을 삭제하거나, 기존 코드를 덮어쓰거나, 데이터베이스 레코드를 삭제하거나, 간단히 되돌릴 수 없는 변경을 하기 전에 — 완전히 멈추세요. 영향을 받을 내용을 정확히 나열하세요. 명시적인 확인을 요청하세요. 현재 메시지에서 제가 '네'라고 말한 후에만 진행하세요."

1. 하드 스톱 — 허가 없이는 절대 발생하지 않는 작업. 🚨

프로덕션에 배포하기. 라이브 데이터베이스에서 마이그레이션 실행하기. 외부 서비스에 API 호출 보내기.

이것들은 "조심하세요" 상황이 아닙니다. 이것들은 완전 정지입니다.

"다음 작업은 세션 내 명시적인 확인이 필요합니다 — 예외 없음: 모든 환경에 배포. 모든 데이터베이스에서 마이그레이션 실행. 모든 이메일 또는 외부 API 호출 전송. 되돌릴 수 없는 외부 부작용이 있는 모든 명령 실행."

1. 기술 스택을 고정하세요. 🔧

정의된 스택이 없으면 — Claude는 가장 인기 있다고 생각하는 프레임워크, 가장 자주 본 라이브러리, 기본값으로 설정된 패키지 매니저를 제안합니다.

종종 여러분이 사용하는 것, 팀이 아는 것, 이미 구축한 것과 호환되지 않습니다.

"기술 스택 — 항상 이것들을 사용하고, 제가 요청하지 않는 한 대안을 제안하지 마세요: 언어. 프레임워크. 패키지 매니저. 데이터베이스. 테스팅. 린팅. 어떤 것이 잘못된 도구처럼 보이면 — 표시하세요. 하지만 제가 달리 말하지 않는 한 계속 사용하세요."

1. 변경된 내용을 항상 정확히 보여주세요.

Claude가 코딩 작업을 마치면 여러분은 출력물을 훑어보며 무엇이 다른지 파악해야 합니다.

어떤 파일이 변경되었나요? 다른 것을 건드렸나요? 미완성으로 남긴 것이 있나요?

"코딩 작업을 완료한 후에는 항상 다음으로 마무리하세요: 변경된 파일. 수정된 내용 — 파일당 한 줄. 의도적으로 건드리지 않은 파일. 후속 조치 필요. 짧게 유지하세요 — 이것은 상태 업데이트이지 요약이 아닙니다."

1. Andrej Karpathy의 CLAUDE.md를 바이럴하게 만든 4 가지 규칙.

Andrej Karpathy — Tesla 전 AI 디렉터이자 OpenAI 창립 멤버 — Claude Code가 코딩 작업에서 실패하는 4 가지 특정 행동을 식별했습니다.

한 개발자가 이를 4 가지 지침으로 정리했습니다. 그 파일은 GitHub Trending에서 1 위를 차지했으며 코딩 정확도를 65 %에서 94 %로 향상시켰습니다.

여기 있습니다:

1. 묻고, 가정하지 마세요 — 불확실한 것이 있으면 한 줄도 쓰기 전에 물어보세요. 조용히 가정하지 마세요.

1. 가장 간단한 해결책부터 — 작동할 수 있는 가장 간단한 것을 항상 구현하세요. 요청되지 않은 추상화를 추가하지 마세요.

1. 관련 없는 코드는 건드리지 마세요 — 파일이 현재 작업의 직접적인 일부가 아니라면 수정하지 마세요. 절대로.

1. 불확실성을 명시적으로 표시하세요 — 접근 방식에 확신이 없으면 진행하기 전에 그렇게 말하세요. 확신 없는 자신감은 격차를 인정하는 것보다 더 큰 피해를 줍니다.

결론.

CLAUDE.md는 단순한 개발자 도구가 아닙니다.

Claude를 진지하게 사용하는 모든 사람이 첫 번째 실제 세션 전에 설정해야 하는 영구적인 지침 파일입니다.

지침 1~4는 Claude의 의사소통 방식을 수정합니다. 지침 5~8은 승인하지 않은 변경을 막습니다. 지침 9~11은 실제 작업에 맞는 출력을 생성할 컨텍스트를 제공합니다. 지침 12~15는 현재 존재하는 가장 가까운 실제 메모리를 제공합니다. 지침 16~21은 Claude Code가 예측 불가능한 도구 대신 정밀한 도구처럼 행동하도록 만듭니다.

파일을 만드세요. 3 개의 지침을 붙여넣으세요. 진행하면서 더 추가하세요.

출력 품질의 차이는 첫 번째 세션부터 즉각적이고 명백할 것입니다. 🚀

AI 작업 방식을 실제로 바꾸는 더 많은 시스템을 위해 팔로우하세요. 💯