단일 CLAUDE.md 파일이 GitHub Trending 1위에 올랐습니다. 82,000개의 스타와 7,800개의 포크를 기록했습니다. Claude를 사용하는 대부분의 사람들은 이 파일에 대해 들어본 적도 없습니다. 들어봤더라도 실제로 무엇을 넣어야 할지 모릅니다. 이 격차 때문에 사람들은 매주 몇 시간씩 낭비하고 있습니다. 새로운 Claude 세션을 열 때마다 기억이 전혀 없습니다. 당신의 이름, 당신의 작업, 당신의 선호도, 또는 당신이 원하는 작업 방식을 모릅니다. 처음 몇 분 동안 모든 것을 다시 설명하거나, 그렇지 않으면 Claude가 당신의 실제 작업 방식에 맞지 않는 결과를 제공합니다. CLAUDE.md는 이 문제를 영구적으로 해결합니다.
왜 모든 사람에게 중요한지 - 개발자만이 아님
대부분의 사람들은 CLAUDE.md가 개발자 도구라고 생각합니다. 하지만 그렇지 않습니다. 이는 모든 세션 시작 시 Claude가 자동으로 읽는 지시사항 파일이며, Claude를 정기적으로 사용하는 모든 사람에게 유용합니다. 작가들은 이를 사용하여 자신의 목소리와 톤을 고정시켜 Claude가 다른 사람처럼 들리지 않게 합니다. 마케터들은 이를 사용하여 타겟 독자를 정의해 Claude가 일반적인 카피를 작성하지 않게 합니다. 연구원들은 이를 사용하여 정보가 구성되기를 원하는 방식을 설정합니다. 비즈니스 소유자들은 이를 사용하여 회사의 전체 맥락을 Claude에게 제공해 모든 출력이 자신의 현실에 맞게 합니다. CLAUDE.md 없이는 매 세션을 0에서 시작합니다. 같은 말을 반복하고, 같은 실수를 고치고, 선호도를 백 번째로 다시 설명합니다. CLAUDE.md는 Claude로 하는 어떤 심각한 작업 전에 설정해야 할 첫 번째 것입니다. 목적이 무엇이든 상관없습니다.
파일 생성 방법 - 2분 소요
- 프로젝트 폴더를 열고 새 파일을 만듭니다. 정확히 “CLAUDE.md”로 이름을 지정하세요 - 대문자, 공백 없음. 그냥 .md 확장자를 가진 일반 텍스트 파일입니다.
- 메모장, TextEdit, VS Code 등 어떤 텍스트 편집기에서나 열 수 있습니다. 일반 텍스트로 지시사항을 이 파일에 직접 붙여넣습니다.
- 이 글에서 관련 있는 지시사항을 복사하여 붙여넣습니다. 21개 모두 필요하지 않습니다. 가장 큰 불만을 해결해주는 3~4개부터 시작하세요.
- 파일을 저장합니다. Claude Code는 해당 폴더에서 세션을 열 때마다 자동으로 읽습니다. 추가 설정 없이, 추가 단계 없이 - 첫 메시지부터 바로 작동합니다.
Claude와의 대화 방식
1 - 군더더기 제거 Claude의 기본 설정은 모든 응답을 “좋은 질문입니다!”, “물론이죠!”, “확실히!”, “절대적으로!”와 같은 문구로 시작하는 것입니다. 이는 아무것도 추가하지 않고 시간만 낭비합니다. 매일 몇 시간씩 Claude를 사용할 때, 이 마찰은 복리로 쌓입니다. 하나의 지시사항으로 이를 영구적으로 제거할 수 있습니다. 모든 응답은 바로 답변으로 시작합니다. 웜업 없이, 도움이 되는 척하지 않고 - 그냥 요청한 것을 즉시 제공합니다.
"좋은 질문입니다!", "물론이죠!", "확실히!", "절대적으로!", "물론!" 또는 유사한 웜업 문구로 응답을 시작하지 마세요.
모든 응답을 실제 답변으로 시작하세요.
서론 없이, 질문에 대한 인정 없이.
그냥 정보만.2 - 행동하기 전에 항상 옵션 보여주기 Claude는 기본적으로 하나의 접근 방식을 선택하고 그대로 밀어붙입니다. 문단 하나를 다시 써달라고 하면 전체 톤을 바꿔버립니다. 문서를 재구성해달라고 하면 당신의 사고방식과 맞지 않는 방식으로 재구성합니다. 이제 당신은 요청하지 않은 것을 고치고 있습니다. 이 지시사항은 그 역학을 완전히 바꿉니다. 중요한 작업 전에 Claude는 작업에 접근할 수 있는 2~3가지 방법을 보여줍니다. 당신이 맞는 방향을 선택합니다. 그 이후의 작업은 실제로 당신이 원했던 것입니다.
2. 행동하기 전에 항상 옵션 보여주기
Claude는 기본적으로 하나의 접근 방식을 선택하고 그대로 밀어붙입니다. 문단 하나를 다시 써달라고 하면 전체 톤을 바꿔버립니다. 문서를 재구성해달라고 하면 당신의 사고방식과 맞지 않는 방식으로 재구성합니다. 이제 당신은 요청하지 않은 것을 고치고 있습니다.
이 지시사항은 그 역학을 완전히 바꿉니다. 중요한 작업 전에 Claude는 작업에 접근할 수 있는 2~3가지 방법을 보여줍니다. 당신이 맞는 방향을 선택합니다. 그 이후의 작업은 실제로 당신이 원했던 것입니다.3 - 모를 때는 정직하게 말하기 Claude는 불확실성을 인정하기 전에 자신감 있고 상세하지만 완전히 틀린 답변을 제공합니다. 그럴듯하게 들리지만 사실이 아닌 정보, 날짜, 통계, 인용구, 사실들로 빈칸을 채웁니다. 당신이 그 정보를 사용하면, 가장 중요한 순간에 문제가 드러납니다. 이 단 하나의 지시사항이 그 행동을 바꿉니다. Claude는 자신감 있는 응답 속에 숨기기보다 답변하기 전에 불확실성을 표시합니다. 응답 맨 위에 “이 부분은 확실하지 않습니다”라고 하는 것이, 존재하지 않는 기초 위에 무언가를 쌓는 것보다 낫습니다.
어떤 사실, 통계, 날짜, 인용구, 정보 조각에 대해 확신이 없다면, 그것을 포함하기 전에 명시적으로 말하세요.
"이 부분은 확실하지 않습니다"는 추측을 사실로 제시하는 것보다 항상 낫습니다.
지식의 빈칸을 그럴듯하게 들리는 정보로 채우지 마세요.
의심스러울 때는 그렇게 말하세요.4 - 실제 필요에 맞게 길이 조절하기 Claude에게 간단한 질문을 하면 네 문단을 씁니다. 복잡한 것을 써달라고 하면 겉보기에 완전해 보이지만 실제로는 그렇지 않은 골격을 제공합니다. 둘 다 쓸모없습니다. 응답 길이는 작업이 실제로 요구하는 바에 맞아야 합니다. 답변이 짧을 때는 짧게, 작업에 깊이가 필요할 때는 상세하게. 이 지시사항은 그 관계를 보정합니다. 간단한 질문에 더 이상 장황한 내용을 덧붙이지 않고, 실제 내용이 필요한 작업에서 얕은 출력을 하지 않습니다.
응답 길이를 작업 복잡도에 맞추세요.
간단한 질문은 직접적이고 짧은 답변을 받습니다.
복잡한 작업은 전체적이고 상세한 응답을 받습니다.
진정한 깊이가 필요한 작업을 절대 압축하거나 요약하지 마세요.
질문을 다시 진술하거나 방금 한 말을 반복하는 문장으로 응답을 채우지 마세요.Claude의 행동 방식
5 - 큰 변경 전에는 먼저 물어보기 Claude에게 한 문단만 고쳐달라고 하면 전체 문서를 다시 씁니다. 줄이거나 짧게 해달라고 하면 필요한 섹션을 삭제합니다. 톤을 조정해달라고 하면 구조까지 바꿉니다. 매번, 원하지 않는 것을 잃고, 기억이나 이전 버전에서 다시 복구해야 합니다. 이 지시사항은 모든 중요한 변경을 체크포인트로 만듭니다. Claude는 멈추고, 정확히 무엇을 바꿀지 말하고, 어떤 것도 건드리기 전에 당신의 확인을 기다립니다. 그 이후의 작업은 당신이 동의한 작업입니다.
이미 만든 콘텐츠를 크게 변경하는 모든 작업(섹션 다시 쓰기, 문단 삭제, 흐름 재구성, 톤 변경) 전에 완전히 멈추세요.
정확히 무엇을 바꿀지, 왜 바꿀지 설명하세요.
진행하기 전에 내 확인을 기다리세요.
"이게 더 나을 것 같다"는 변경할 권한가 아닙니다.6 - 요청받은 것에 집중하기 Claude에게 한 가지를 고쳐달라고 하면, 들어가 있는 동안 다른 다섯 가지도 “개선”합니다. 문구를 조정하고, 구조를 재구성하고, 만족했던 문장을 다시 씁니다. 때로는 그 변경이 개선이기도 합니다. 하지만 종종 그렇지 않습니다. 그리고 이제 무엇이 실제로 변경되었는지 찾기 위해 모든 것을 훑어봐야 합니다. 이 지시사항은 Claude를 제자리에 둡니다. 요청받은 것을 고치세요. 나머지는 정확히 그대로 두세요. 다른 곳에서 개선할 만한 것이 보이면 언급하되, 요청받지 않고는 건드리지 마세요.
내가 특별히 바꾸라고 요청한 것만 변경하세요.
내가 묻지 않은 것은, 더 나을 것이라고 생각하더라도, 다시 쓰거나, 다시 말하거나, 재구조화하거나 "개선"하지 마세요.
다른 곳에서 개선할 만한 것을 발견하면 응답 끝에 언급하세요.
내가 명시적으로 요청하지 않는 한 건드리지 마세요.7 - 변경한 내용 항상 알려주기 Claude가 작업을 마치면, 이전에 있던 것과 무엇이 다른지 파악하려고 출력을 훑어봐야 합니다. 어떤 섹션이 변경되었나? 뭔가 잘라냈나? 요청하지 않은 것을 추가했나? 요약 없이는 매번 수동으로 diff를 보고 있습니다. 이 지시사항은 Claude가 모든 작업을 간략한 요약과 함께 마치게 합니다: 무엇이 변경되었는지, 무엇이 그대로인지, 주의가 필요한 것이 있는지. 당신은 자신의 작업을 통제할 수 있습니다.
편집이나 작성 작업을 완료한 후에는 항상 간략한 요약으로 끝내세요:
- 변경된 것: [설명]
- 그대로 둔 것: [관련이 있다면]
- 주의가 필요한 것: [결정이나 검토가 필요한 것]
짧게 유지하세요. 이건 상태 업데이트이지, 방금 한 모든 것을 요약하는 것이 아닙니다.8 - 묻지 않고 내 대신 행동하지 않기 AI 도구가 이메일, 캘린더, 소셜 계정, 문서에 더 많이 연결됨에 따라, Claude가 완전히 의도하지 않은 행동을 할 위험이 모든 새로운 통합과 함께 커집니다. 메시지 보내기. 콘텐츠 게시. 문서 공유. 일정 잡기. 이러한 행동에는 실질적인 결과가 있으며 빠르게 일어납니다. 이 지시사항은 단단한 벽을 만듭니다. Claude가 무엇을 원한다고 생각하든, 외부적 결과가 있는 행동은 그 특정 순간에 당신이 명시적으로 “예”라고 말하지 않는 한 일어나지 않습니다.
현재 메시지에서 내 명시적인 확인 없이 내 대신 이메일을 보내거나, 게시하거나, 발행하거나, 공유하거나, 일정을 잡지 마세요.
다음을 포함합니다:
- 이메일
- 소셜 미디어 게시물
- 캘린더 초대
- 문서 공유
- 이 대화 밖의 무언가에 영향을 미치는 모든 행동
"이것을 하고 싶다고 언급하셨죠"는 확인이 아닙니다.
현재 메시지에서 내가 "예"라고 말해야 합니다.당신의 맥락
9 - Claude에게 당신이 누구인지, 무엇을 아는지 알려주기 Claude는 당신이 전문가인지 초보자인지, 창업자인지 프리랜서인지, 기술적 깊이를 원하는지 평이한 언어를 원하는지 알지 못합니다. 그 맥락 없이는 추측하고, 맞을 때만큼 틀릴 때도 많습니다. 때로는 몇 년 동안 알고 있던 것을 설명하고, 때로는 실제로 필요한 맥락을 건너뜁니다.
당신이 누구인지에 대한 한 문단이 그 시점부터 Claude가 제공하는 모든 응답을 보정합니다. 당신을 낯선 사람처럼 대하는 것을 멈추고, 실제로 당신을 아는 사람처럼 대화하기 시작합니다.
나에 대해:
- 이름: [당신의 이름]
- 역할: [하는 일, 작가, 창업자, 마케터, 연구원 등]
- 배경: [관련 경험이나 지식 수준]
- 강점: [잘 아는 주제나 영역, 여기서는 기본을 건너뛰세요]
- 배우는 중: [더 많은 맥락과 설명이 필요한 영역]
모든 응답의 깊이를 이 배경에 맞추세요. 이미 아는 것을 과도하게 설명하지 마세요. 필요한 맥락을 건너뛰지 마세요.10 - 작업 중인 내용의 맥락 제공하기 매 세션, Claude는 당신이 무엇을 작업 중인지, 누구를 위한 것인지, 무엇이 실제로 중요한지 전혀 모른 채 시작합니다. 선택의 여지 없이 일반적인 출력을 제공합니다. 타겟 독자를 모릅니다. 목표를 모릅니다. 모든 결정에 영향을 미치는 제약 조건을 모릅니다.
짧은 맥락 문단 하나가 모든 것을 바꿉니다. 제안이 일반적이지 않고 실제 상황에 맞게 됩니다. Claude는 누구를 위해 쓰는지, 어떤 톤이 맞는지, 당신에게 구체적으로 어떤 트레이드오프가 중요한지 알게 됩니다.
내가 작업 중인 것:
- 프로젝트: [이것이 무엇인지 한 문장으로 설명]
- 목표: [성공의 모습]
- 타겟 독자: [누구를 위한 것이며 그들이关心하는 것]
- 톤: [글쓰기나 출력이 어떻게 느껴져야 하는지, 캐주얼, 전문적, 직접적, 대화체 등]
- 피해야 할 것: [맞지 않는 것, 전문 용어, 특정 주제, 특정 스타일]
이 맥락을 모든 작업에 적용하세요. 이 그림에 맞지 않는 것이 있으면 진행하기 전에 표시하세요.11 - 당신의 목소리와 스타일 고정하기 Claude에는 기본 글쓰기 스타일이 있습니다. 괜찮습니다. 하지만 당신의 것이 아닙니다. 특정 구문을 사용하고, 문장을 특정 방식으로 구성하며, 실제로 소통하는 방식과 맞지 않는 톤을 가지고 있습니다. Claude를 사용하여 무언가를 쓸 때마다, 결국 당신의 목소리로 다시 편집합니다. CLAUDE.md에서 한 번 목소리를 정의하면 Claude는 초안부터 그 목소리로 씁니다. 편집이 줄어듭니다. 당신의 목소리처럼 실제로 들리는 출력이 더 많아집니다.
내 글쓰기 스타일, 항상 이것을 일치시키세요:
- 목소리: [예: 직접적, 대화체, 자신감 있는, 군더더기 없는]
- 문장 길이: [예: 짧고 강렬한 / 길고 상세한 / 혼합]
- 내가 사용하는 단어: [나처럼 들리는 구문이나 어휘]
- 내가 절대 사용하지 않는 단어: [내 스타일에 맞지 않는 단어나 구문]
- 형식 선호: [예: 문단만 / 불릿 포인트 / 헤더 / 헤더 없음]
내 대신 무언가를 쓸 때, 정확히 이 스타일을 일치시키세요. 당신만의 패턴으로 기본 설정하지 마세요.기억과 연속성
12 - Claude가 메모리 파일을 유지하게 하기 Claude는 세션 간에 모든 것을 잊습니다. 모든 대화는 새로 시작합니다. 하지만 Claude는 파일을 쓸 수 있고, 파일은 지속됩니다. 이 지시사항은 Claude에게 함께 내리는 모든 중요한 결정을 기록하는 MEMORY.md 파일을 유지하라고 말합니다: 무엇이 결정되었는지, 왜 그랬는지, 어떤 대안이 고려되고 거부되었는지. 각 세션 시작 시 Claude는 그 파일을 읽습니다. 갑자기 두 달 전에 왜 그런 선택을 했는지 알게 됩니다. 이미 시도한 것을 다시 제안하는 것을 멈춥니다. 결정을 바탕으로 쌓아 올리지, 모순되지 않습니다.
MEMORY.md라는 파일을 유지하세요. 방향, 형식, 콘텐츠, 접근 방식, 전략에 대한 중요한 결정이 있을 때마다 항목을 추가하세요:
## [날짜], [결정]
**결정된 것:** [내린 선택]
**이유:** [추론]
**거부된 것:** [고려되었지만 제외된 대안과 이유]
모든 세션 시작 시, 아무것도 하기 전에 MEMORY.md를 읽으세요. 로그된 결정을 먼저 표시하지 않고는 절대 모순되지 마세요.13 - 세션 종료 요약, 진행 상황을 절대 잃지 않기 세션을 닫습니다. 이틀 후 돌아옵니다. 어디까지 진행되었는지, 무엇을 마쳤는지, 무엇을 하던 중이었는지 기억하려고 15분 동안 이전 메시지를 읽습니다. 이는 Claude를 정기적으로 사용하는 거의 모든 사람에게 일어나는 완전히 피할 수 있는 낭비입니다.
이 지시사항은 Claude가 마무리하기 전에 MEMORY.md에 세션 요약을 쓰게 합니다. 다음 세션은 전체 맥락으로 시작합니다. 처음부터 아무것도 재구성하지 않고 정확히 멈춘 곳에서 다시 시작합니다.
내가 "세션 종료", "마무리 중", "여기서 멈추자"라고 말하면, MEMORY.md에 세션 요약을 쓰세요:
## 세션 요약, [날짜]
**작업한 것:** [집중한 것]
**완료된 것:** [마친 것]
**진행 중인 것:** [시작했지만 끝나지 않은 것]
**내린 결정:** [이 세션의 주요 선택]
**다음 세션:** [먼저 시작할 것과 기억해야 할 중요한 맥락]14 - 작동하지 않은 것을 기록하고, 같은 문제를 두 번 풀지 않기 콘텐츠 조각에 대한 프롬프트 접근 방식을 시도합니다. 사용 가능한 것을 얻으려면 4번의 시도가 필요합니다. 3주 후, 비슷한 작업으로 돌아오면 Claude는 처음부터 같은 나쁜 제안을 합니다. 같은 시행착오, 처음부터 같은 시간 낭비.
오류 로그가 그 루프를 끊습니다. 작동하지 않은 모든 접근 방식이 기록됩니다. 시도한 것, 왜 작동하지 않았는지, 마침내 무엇이 작동했는지. 다음 번 Claude는 먼저 로그를 확인하고 작동하는 것으로 알려진 것만 건너뜁니다.
ERRORS.md라는 파일을 유지하세요. 접근 방식이 작동하기까지 2번 이상 시도가 필요할 때마다 기록하세요:
## [작업 유형 또는 설명]
**작동하지 않은 것:** [실패한 접근 방식과 이유]
**작동한 것:** [마침내 성공한 접근 방식]
**다음을 위한 참고:** [비슷한 작업을 위해 기억할 만한 것]
로그된 작업과 유사한 작업에 접근 방식을 제안하기 전에 ERRORS.md를 확인하세요. 작업이 로그된 실패와 일치하면 그렇게 말하고 작동한 것으로 건너뛰세요.15 - 절대 변하지 않는 사실 목록 제공하기 모든 프로젝트에는 영구적인 사실이 있습니다: 과거 결정에서 비롯된 제약 조건, 중요한 이유로 존재하는 규칙, 특정 작업과 관계없이 작업에 항상 사실인 것들. 이 지시사항 없이는 Claude는 이러한 사실이 존재한다는 것을 모르고, 이에 모순되는 것을 무심코 제안하고, 이유가 있어 한 작업을 되돌리고, 백 번째로 같은 맥락을 설명하도록 요구합니다.
이 블록은 모든 세션, 모든 작업, 모든 출력에 적용되는 영구적인 기초를 Claude에게 제공합니다. 같은 말을 반복하는 것을 멈춥니다. Claude는 일반적인 버전이 아니라 당신의 실제 현실 내에서 작동합니다.
이 사실들은 항상 참입니다. 예외 없이 모든 세션과 모든 작업에 적용하세요:
- [영구적 사실 #1, 예: "내 타겟 독자는 기술적 배경이 없습니다"]
- [영구적 사실 #2, 예: "모든 콘텐츠는 전문적 맥락에 적합해야 합니다"]
- [영구적 사실 #3, 예: "출처 없이는 절대 주장을 하지 않습니다"]
- [영구적 사실 #4, 예: "브랜드 목소리는 항상 따뜻하며, 결코 기업적이지 않습니다"]
이 중 하나와 충돌하는 작업이 있으면 진행하기 전에 표시하세요. 내게 말하지 않고 제약 조건을 우회하지 마세요.개발자를 위한 설정
아래 지시사항은 코드를 작성, 검토 또는 관리하기 위해 Claude Code를 사용하는 사람들을 위한 것입니다. 해당되지 않는다면 위의 모든 것이면 충분합니다. 해당된다면, 이 6가지 규칙이 Claude가 유용한 코딩 도우미인 것과 코드베이스의 통제되지 않은 대포인 것의 차이입니다.
16 - 범위 내에 머물기, 요청받지 않은 것은 절대 건드리지 않기 Claude에게 버그 하나를 고쳐달라고 하면 세 개의 파일을 리팩토링하고, 변수 이름을 바꾸고, 가져오기를 재구성하고, 몇 달 동안 작업해온 코드를 “개선”합니다. 모두 묻지 않고. 그 변경 중 일부는 문제를 일으킵니다. 일부는 추적하는 데 며칠이 걸리는 미묘한 차이를 도입합니다.
이는 Claude Code를 사용하는 모든 사람에게 가장 중요한 규칙 중 하나입니다. 범위 제어는 정밀한 도구와 코드베이스의 통제되지 않은 대포의 차이입니다.
현재 작업과 직접적이고 구체적으로 관련된 파일, 함수, 코드 줄만 수정하세요.
내가 명시적으로 바꾸라고 요청하지 않은 것은 리팩토링, 이름 바꾸기, 재구성, 재포맷 또는 "개선"하지 마세요.
다른 곳에서 고칠 만한 것을 발견하면 메모로 언급하세요.
절대 건드리지 마세요. 절대.17 - 파괴적인 작업 전 확인하기 Claude Code는 터미널에서 파일 시스템에 접근하여 실행됩니다. 오해한 지시가 있더라도, 당신이 완전히 깨닫지 못했더라도 파일을 삭제하고, 함수를 덮어쓰고, 데이터베이스 테이블을 삭제합니다. 잘못 읽은 지시 하나로 실행 취소할 수 없는 몇 시간의 작업이 사라집니다.
이 규칙은 모든 파괴적인 행동을 체크포인트로 바꿉니다. Claude는 멈추고, 정확히 무엇에 영향을 미칠지 보여주고, 어떤 것도 건드리기 전에 당신의 명시적인 “예”를 기다립니다.
파일을 삭제하거나, 기존 코드를 덮어쓰거나, 데이터베이스 레코드를 삭제하거나, 종속성을 제거하거나, 사소하게 되돌릴 수 없는 변경을 하기 전에 완전히 멈추세요. 정확히 무엇에 영향을 미칠지 나열하세요. 확인을 명시적으로 요청하세요. 현재 메시지에서 내가 "예"라고 말한 후에만 진행하세요.18 - 하드 스톱, 명시적 권한 없이는 절대 발생하지 않는 행동들 프로덕션에 배포하기. 라이브 데이터베이스에서 마이그레이션 실행하기. 외부 서비스에 API 호출 보내기. 이것들은 “조심하세요” 상황이 아니라, 당신이 의식적으로 방에 있고 의도적으로 “예”라고 말해야 하는 상황입니다. 이 규칙은 그러한 행동 주위에 영구적인 벽을 만듭니다.
다음 행동은 예외 없이 실행 전 세션 내에서 명시적인 확인이 필요합니다:
- 어떤 환경(스테이징, 프로덕션 등)에도 배포하거나 푸시하기
- 어떤 데이터베이스에서든 마이그레이션이나 스키마 변경 실행
- 이메일, 메시지, 외부 API 호출 보내기
- 되돌릴 수 없는 외부 부작용이 있는 명령 실행
"이전에 이 이야기를 했죠"는 확인이 아닙니다. 현재 메시지에서 내가 "예"라고 말해야 합니다.19 - 기술 스택 고정하기 정의된 스택 없이, Claude는 가장 인기 있다고 생각하는 프레임워크, 가장 자주 본 라이브러리, 기본값으로 설정된 패키지 관리자를 제안할 것입니다. 때로는 괜찮습니다. 하지만 종종 당신이 사용하는 것이 아니고, 당신의 팀이 아는 것이 아니며, 이미 구축한 것과 호환되지 않습니다.
스택을 한 번 정의하면 Claude는 원하지 않는 것을 제안하는 것을 멈춥니다. 작성하는 모든 것이 실제로 구축 중인 시스템에 맞습니다.
기술 스택, 항상 이것들을 사용하고, 내가 요청하지 않는 한 대안을 제안하지 마세요:
- 언어: [목록]
- 프레임워크: [목록]
- 패키지 관리자: [npm / yarn / pip / cargo 등]
- 데이터베이스: [목록]
- 테스트: [테스트 프레임워크]
- 린팅 / 포맷팅: [도구]
스택의 무언가가 잘못된 도구처럼 보이면 표시하되, 내가 다르게 말하지 않는 한 그대로 사용하세요.20 - 정확히 무엇이 변경되었는지 항상 보여주기 Claude가 작업을 마치면, 무엇이 다른지 파악하려고 출력을 훑어봐야 합니다. 어떤 파일이 변경되었나? 다른 것을 건드렸나? 미완성 상태로 남겨두었나? 파일 수준 요약 없이는 Claude에게 무언가를 시킬 때마다 매번 수동으로 diff를 보고 있습니다.
코딩 작업을 완료한 후에는 항상 다음으로 끝내세요:
- 변경된 파일: [건드린 모든 파일 목록]
- 수정된 것: [파일당 한 줄]
- 의도적으로 건드리지 않은 파일: [관련이 있다면]
- 후속 조치 필요: [주의나 결정이 필요한 것]
짧게 유지하세요. 이건 상태 업데이트이지, 요약이 아닙니다.21 - Andrej Karpathy의 CLAUDE.md를 바이럴시킨 4가지 규칙 테슬라의 전 AI 디렉터이자 OpenAI의 창립 멤버인 Andrej Karpathy는 Claude Code가 코딩 작업에서 실패하게 만드는 4가지 특정 행동을 식별했습니다. 한 개발자가 이를 단일 CLAUDE.md 파일에 4가지 지시사항으로 정리했습니다. 그 파일은 GitHub Trending 1위에 올랐고 코딩 정확도를 65%에서 94%로 향상시켰습니다.
이것들은 4가지 규칙입니다. 다른 것이 무엇이든, 모든 개발자의 CLAUDE.md에 추가할 가치가 있습니다.
1. 묻고, 추측하지 마세요. 무언가가 불분명하거나 구체화되지 않았다면, 한 줄도 쓰기 전에 물어보세요. 의도, 아키텍처, 요구사항에 대해 침묵하는 가정을 절대 하지 마세요.
2. 가장 간단한 솔루션 먼저. 항상 작동할 수 있는 가장 간단한 것을 구현하세요. 명시적으로 요청받지 않은 추상화, 계층, 유연성을 추가하지 마세요.
3. 관련 없는 코드를 건드리지 마세요. 파일이나 함수가 현재 작업의 직접적인 부분이 아니라면, 개선할 수 있다고 생각하더라도 수정하지 마세요.
4. 불확실성을 명시적으로 표시하세요. 접근 방식, 라이브러리 동작, 기술적 세부사항에 대해 자신이 없다면 진행하기 전에 그렇게 말하세요. 확신하지만 확실하지 않은 것은 격차를 인정하는 것보다 더 큰 피해를 줍니다.CLAUDE.md는 단순한 개발자 도구가 아닙니다. 이는 Claude를 진지하게 사용하는 모든 사람이 첫 번째 실제 세션 전에 설정해야 할 영구적인 지시사항 파일입니다. 지시사항 1-4는 Claude가 소통하는 방식을 고칩니다. 지시사항 5-8은 승인하지 않은 것을 변경하는 것을 막습니다. 지시사항 9-11은 실제 작업에 맞는 출력을 생성할 맥락을 제공합니다. 지시사항 12-15는 현재 존재하는 가장 가까운 진짜 기억에 가까운 것을 제공합니다. 지시사항 16-21은 Claude Code가 예측 불가능한 것이 아닌 정밀한 도구처럼 행동하길 원하는 개발자를 위한 것입니다. 파일을 만드세요. 지시사항 3개를 붙여넣으세요. 가면서 더 추가하세요.
@AnatoliKopadze를 팔로우하여 AI와 함께하는 작업 방식을 실제로 바꾸는 더 많은 시스템을 확인하세요.