CLAUDE.md 라는 파일이 GitHub Trending 1위를 기록했습니다.
별 82,000개. 포크 7,800개.
이 모든 것은 Andrej Karpathy 에서 시작되었습니다. 전 Tesla AI 디렉터이자 OpenAI 공동 창립자입니다. 그는 Claude Code 가 실패하는 4가지 행동 패턴을 발견하고 이를 단 하나의 파일에 기록했습니다.
한 개발자가 이 4가지 규칙을 가져와 확장하고 파일을 공개했습니다. 그리고 바이럴이 되었죠.
그 이유는 코딩 정확도가 65%에서 94%로 향상되었기 때문입니다.
Claude Code 를 매일 사용하는 대부분의 개발자는 이 설정을 한 번도 해본 적이 없습니다. 매 세션마다 처음부터 시작하고 있습니다. 같은 컨텍스트를 반복해서 설명하고, 원치 않는 범위 변경을 정리하고, 아무도 요청하지 않은 리팩토링을 되돌리고 있습니다.
이것이 바로 그 전체 파일입니다.
대부분의 개발자가 놓친 설정
Claude Code 를 열 때마다 아무것도 없는 상태에서 시작합니다.
스택, 개발 표준, 프로젝트 컨텍스트, 이미 시도해본 것, 세 세션 전에 명시적으로 하지 않기로 결정한 것 등을 전혀 알지 못합니다.
그래서 추측합니다. 그리고 추측할 때, 요청하지 않은 코드를 리팩토링합니다. 기존 아키텍처를 망가뜨리는 프레임워크를 제안합니다. 묻지도 않고 파일을 삭제합니다. 이미 내린 결정과 모순되는 행동을 합니다.
CLAUDE.md 는 프로젝트 루트에 넣는 일반 텍스트 파일입니다. Claude Code 는 매 세션 시작 시 자동으로 이 파일을 읽습니다.
한 번 설정하면 반복적인 설명이 필요 없습니다. 세 가지 유형의 값비싼 실수를 한 번에 해결할 수 있습니다.
1 / 3 | 기본값: 반복 설명에 낭비하는 주당 $375
평균 개발자는 하루 30분을 Claude 에게 컨텍스트를 다시 설명하는 데 사용합니다.
스택, 코딩 표준, 프로젝트 배경, 이미 시도해본 것. 이 모든 것은 한 번만 기록해두고 매번 Claude 가 읽도록 하지 않으면 세션 간에 유지되지 않습니다.
하루 30분, 시간당 $150 개발자 단가 기준: 주당 $375. 개발자 1인당입니다.
5명 팀 기준: 주당 $1,875 가 사라집니다.
이 7가지 규칙은 CLAUDE.md 파일 상단에 위치해야 합니다.
→ 불필요한 내용 제거:
→ 작업에 맞게 길이 조절:
→ 실행 전에 옵션 먼저 제시:
→ 비용이 발생하기 전에 불확실성 인정:
→ 나의 정체성과 알고 있는 것:
→ 현재 프로젝트 컨텍스트:
→ 톤 고정:
하루 컨텍스트 재설명 시간: 30분 시간당 $150 개발자 단가: 하루 $75 주당: 개발자 1인당 $375/week 5명 팀: $1,875/week 이 섹션 CLAUDE.md 설정 시간: 총 45분
피해야 할 실수: CLAUDE.md 를 처음부터 작성하지 마세요. 먼저 이 프롬프트를 사용한 후 출력 결과를 편집하세요:
2 / 3 | 행동: 승인받지 않은 시간당 $150 짜리 변경 사항
Claude 에게 함수 하나를 수정해달라고 요청합니다.
그런데 Claude 는 세 개의 파일을 리팩토링하고, 변수명을 바꾸고, import 문을 재구성하고, 공들여 작성한 주석을 다시 씁니다.
모두 묻지 않고요.
원치 않는 변경 사항을 검토하고 되돌리는 데 1시간: $150. 주 3회: 주당 $450. 개발자 1인당입니다.
5명 팀 기준: 주당 $2,250 을 아무도 승인하지 않은 변경 사항을 정리하는 데 사용합니다.
이 7가지 규칙은 CLAUDE.md 의 행동 섹션에 위치해야 합니다.
→ 범위 내에서 작업:
→ 큰 변경 전에는 질문:
→ 파괴적인 작업 전에는 확인:
→ 프로덕션 단계에서는 절대 금지:
→ 변경 사항 항상 표시:
→ 명시적 확인 없이는 절대 실행 금지:
→ 코드를 작성하기 전에 먼저 생각:
원치 않는 범위 변경 되돌리는데 주 1시간: 주당 $150 작업 후 수동 diff 확인하는데 주 30분: 주당 $75 개발자 1인당 행동 관련 낭비 합계: 주당 $225 5명 팀: $1,125/week CLAUDE.md 행동 섹션 설정 시간: 30분
3 / 3 | 메모리 + 스택: Claude Code 를 실제로 안정적으로 만드는 설정
Claude 는 세션 간에 모든 것을 잊어버립니다.
내린 모든 결정, 실패한 모든 접근 방식, 6개월 전에 Prisma 대신 Drizzle 을 선택한 이유, 특정 고객 요구 사항 때문에 존재하는 제약 조건까지.
모두 잊어버립니다. 그리고는 이미 배제했던 것을 정확히 제안합니다.
이 섹션은 현재 존재하는 것 중 Claude 에게 가장 진정한 메모리에 가까운 기능을 제공합니다. 그리고 기술 스택을 고정하여 기존 아키텍처를 망가뜨리는 도구를 제안하지 못하도록 합니다.
→ MEMORY.md 결정 로그:
→ 세션 종료 요약:
→ ERRORS.md 실패 로그:
→ 영구 사실 목록:
→ 기술 스택 고정:
→ 어려운 결정을 위한 확장 사고:
→ 바이럴이 된 4가지 규칙:
Karpathy 는 Claude Code 가 실패하는 4가지 행동을 발견했습니다. 한 개발자가 이를 4줄로 요약했습니다. 코딩 정확도가 65%에서 94%로 향상되었습니다.
잊혀진 결정과 잘못된 제안에서 회복하는 데 주 2시간: 개발자 1인당 주당 $300 잘못된 스택 추천 및 호환되지 않는 도구: 주당 $75 개발자 1인당 메모리 관련 낭비 합계: 주당 $375 5명 팀: $1,875/week MEMORY.md + ERRORS.md + 스택 설정 시간: 20분
결론
전체 계산은 다음과 같습니다.
매 세션 컨텍스트 재설명: 주당 $375 승인되지 않은 변경 사항 되돌리기: 주당 $225 잊혀진 결정 복구: 주당 $375 개발자 1인당 총 낭비: 주당 $975
5명 개발자 팀: 주당 $4,875 연간: $253,500
CLAUDE.md 설정 시간: 총 2시간 Karpathy 의 4가지 규칙만으로: 코딩 정확도 65% → 94%
하나의 일반 텍스트 파일. 21가지 규칙. 2시간의 작업.
이 설정을 한 개발자들은 결정을 기억하고, 범위 내에서 작업하며, 파괴적인 작업 전에 확인하고, 아키텍처를 망가뜨리는 프레임워크를 절대 제안하지 않는 버전의 Claude 와 함께 작업하고 있습니다.
설정하지 않은 개발자들은 자신의 반복에 주당 $975 를 낭비하고 있습니다.
추신: Karpathy 의 4가지 규칙부터 시작하세요. 그 4개만요. 지금 바로 프로젝트 루트에 CLAUDE.md 라는 새 파일을 만들고 붙여넣으세요. 2분이면 됩니다. 무엇이 부족한지 파악되면 일주일에 하나씩 나머지를 추가하세요.
이 글이 묻히기 전에 북마크하세요. 도움이 되셨다면, 필요로 하는 한 사람에게 공유해주세요.
