뉴스 · 수정:

Karpathy의 65줄 CLAUDE.md — 왜 10만 스타를 받았나

65 Lines 16x Smarter — Karpathy CLAUDE.md

텍스트 파일 하나. 코드 없음. 65줄. GitHub 합산 스타 22만 개를 넘겼다.

2026년 1월 27일, Forrest Chang이 파일 하나를 올렸다. 전날 Andrej Karpathy가 X에 올린 관찰을 정리한 것이었다. 그게 전부다. 그런데 개발자들이 폭발했다.

2026년 1월 26일, Karpathy가 X에 올린 글:

“Claude Code로 에이전트 코딩을 몇 주 해봤는데, LLM이 반복적으로 저지르는 실수 패턴이 보인다.”

Andrej Karpathy가 누구인가?

OpenAI 공동창업자이자 Tesla AI 디렉터 출신의 AI 연구자다. 딥러닝 분야에서 전 세계적으로 가장 많이 인용되는 인물 중 하나로, Stanford에서 AI를 가르쳤고 직접 만든 유튜브 강의 시리즈는 수백만 명이 봤다. 그의 X 글 하나가 개발자 커뮤니티를 흔드는 건 드문 일이 아니다.

65줄짜리 파일이 10만 스타를 받은 이유는?

핵심만 담은 65줄 파일이 10만 스타를 받은 이유는, 대부분의 개발자가 느끼던 과도한 CLAUDE.md 복잡성에 대한 반발이 폭발했기 때문이다.

Karpathy의 관찰을 본 Forrest Chang이라는 개발자가 핵심만 추려 GitHub에 올렸다. 이름은 CLAUDE.md, 내용은 65줄이었다.

결과는 개인 계정 91,000스타, 조직 미러(multica-ai) 132,000스타, 합산 22만 스타 이상. X에서는 “드디어 누군가 정리해줬다”는 반응이 폭발했다. GitHub 역사상 파일 하나짜리 repo로는 가장 빠른 성장 속도 중 하나로 꼽힌다. 게시 2주 만에 5만 스타를 넘겼고 이후에도 계속 올랐다 — 이 수치는 독립 검증 없이 커뮤니티에서 통용되는 수치다.

Karpathy 본인은 이 repo를 공식 지지한 적이 없다. Chang이 Karpathy의 X 글을 기반으로 독자 제작한 것이며, Karpathy 이름은 출처를 명시하기 위해 붙었다.

CLAUDE.md가 뭔가?

프로젝트 루트에 두는 텍스트 파일이다. Claude Code가 실행될 때 이 파일을 읽어 system prompt에 자동으로 주입한다.

시스템 구조로 보면 이렇다:

  • Claude Code는 매 세션 시작 시 CLAUDE.md를 읽어 대화의 최상단 system role에 삽입한다
  • 이후 모든 메시지는 CLAUDE.md 내용 + 대화 이력 + 코드 컨텍스트를 합산한 상태에서 처리된다
  • 즉, CLAUDE.md는 항상 context window를 차지한다 — 대화가 시작되는 순간부터

LLM의 context window는 한정된 자원으로, Claude Sonnet 기준 약 200K token이다. CLAUDE.md가 길수록 실제 코드와 대화에 할당되는 토큰이 줄어드는데, 규칙을 많이 써서 AI를 똑똑하게 만들려다 오히려 AI가 더 멍청해지는 구조다.

Karpathy의 4가지 원칙은 무엇인가?

4가지 원칙은 코딩 전 사고, 단순함 우선, 외과적 변경, 목표 기반 실행이다.

  1. 코딩 전에 생각하기 — 바로 코드 짜지 말고, 먼저 이해하고 계획 세우기
  2. 단순함 우선 — 요청한 것만 만들기. 요청하지 않은 기능 추가 금지
  3. 외과적 변경 — 건드려야 할 코드만 건드리기. 주변 코드 함부로 고치지 않기
  4. 목표 기반 실행 — 성공 조건을 먼저 정의하고, 그걸 기준으로 완료 판단

왜 짧은 CLAUDE.md가 더 잘 작동하나?

짧은 CLAUDE.md가 더 잘 작동하는 이유는 context window가 한정된 자원이기 때문이다 — 파일이 길수록 실제 코딩에 쓸 수 있는 공간이 줄어든다.

/compact 명령어로 대화를 압축하고 나면 Claude가 갑자기 멍청해진 것 같다는 느낌을 받는 경우가 있는데, 중요한 맥락이 같이 압축됐기 때문이다. 긴 규칙보다 핵심 원칙 몇 줄이 실제로 더 많이 지켜진다.

CLAUDE.md를 직접 써보려면?

원본 repo: github.com/multica-ai/andrej-karpathy-skills

Mac / Linux:

git clone https://github.com/multica-ai/andrej-karpathy-skills.git

Windows (PowerShell / CMD):

git clone https://github.com/multica-ai/andrej-karpathy-skills.git

repo 전체가 필요 없다면 CLAUDE.md 파일 내용만 복사해 본인 프로젝트 루트에 붙여 넣어도 된다. Claude Code를 쓴다면 다음 세션부터 바로 적용된다.