Karpathy의 65줄 CLAUDE.md — 15만 스타 AI 코딩 스킬, 뭐가 특별할까

 

"바이브코딩(Vibe Coding)"이라는 단어를 만든 사람, 기억하시죠? 안드레 카파시(Andrej Karpathy)입니다. OpenAI·테슬라를 거친 AI계의 롤모델이죠. 그런데 2026년 초, 그가 AI 코딩 에이전트의 고질병을 잡는 단 65줄짜리 파일을 공개했습니다. 놀랍게도 GitHub에서 15만 개 이상의 스타를 받았어요. 이름하여 andrej-karpathy-skills. 왜 이렇게 뜨거운지 정리합니다.

📌 30초 요약

✓ Karpathy가 관찰한 AI 코딩 함정을 담은 65줄 CLAUDE.md (2026.1 공개)
✓ GitHub 15만+ 스타 — AI 코딩 스킬 중 압도적 1위 인기
✓ 핵심 3원칙: 가정 표면화 · 추측성 추상화 금지 · 수술적 변경
💡 CLAUDE.md·AGENTS.md·SKILL.md 어디에든 복붙 가능

이 스킬이 뭔가요?

한 줄로: "AI 코딩 에이전트(Claude Code 등)가 흔히 저지르는 실수를 막아주는 가이드라인 파일"입니다. Karpathy가 실제로 AI와 코딩하며 관찰한 LLM의 문제점(pitfalls)을 짧고 강력한 규칙으로 압축했어요. 리포는 multica-ai/andrej-karpathy-skills에, 단 65줄짜리 CLAUDE.md 하나로 들어 있습니다.

재미있는 건 코드가 아니라 '말(명령)'이라는 점. 복잡한 플러그인이 아니라, 에이전트에게 "이렇게 행동해라"라고 적어둔 짧은 문서예요. 그 65줄이 AI의 코딩 태도를 확 바꿔버리는 거죠.

"AI는 묻지도 않고 잘못된 가정을 하거나, 몇 줄이면 끝날 코드를 수천 줄로 부풀린다. Karpathy는 이 고질병을 잡는 최소한의 규칙을 찾았다."

— 여러 매체의 공통 평가

왜 화제일까 — 매력 3가지

① Karpathy가 만들었다	바이브코딩 창시자·AI 롤모델의 실전 관찰. 권위와 신뢰가 다르죠.
② 65줄의 단순함	복잡한 도구 없이 복붙 한 번. 누구나 바로 적용. 진입장벽 0.
③ 15만+ 스타 검증	전 세계 개발자가 "이게 통한다"고 투표한 셈. 검증된 스킬.

핵심 — 3가지 원칙

① 가정 표면화 (Surface assumptions)

코딩을 시작하기 전에 "내가 이렇게 가정한다"를 먼저 드러내게 합니다. AI가 혼자 결정하고 밀어붙이는 걸 막죠.

② 추측성 추상화 금지 (No speculative abstraction)

"나중에 쓸 것 같아서" 미리 구조를 잡는 걸 막습니다. 지금 필요한 것만 짓게 해 코드 팽창을 잡아요.

③ 수술적 변경 (Surgical changes)

최소한의, 정확히 필요한 부분만 손대게 합니다. 한 번에 전체를 갈아엎는 '대공사' 본능을 억제하죠.

배경 — 카파시가 짚은 AI 코딩 고질병

왜 이 3원칙이 필요할까요? Karpathy가 본 AI 코딩의 고질병 때문이에요.

⚠️ 코드 팽창 — 몇 줄이면 될 걸 수천 줄로 늘림
⚠️ 추측성 코딩 — 안 물어보고 혼자 가정해 진행
⚠️ 침묵 실패 — 10번 중 7번만 성공, 실패를 숨김
⚠️ 과잉 추상화 — 필요도 없은 구조를 미리 지음

바이브코딩을 편하게 즐기려다 보면 이 함정에 빠지기 쉬워요. Karpathy의 65줄은 "이 늪에 빠지지 말고 이렇게 코딩해라"는 최소 가이드라인인 셈이죠.

어떻게 쓰나요?

복붙 한 번이면 끝

▸ Claude Code — 프로젝트 루트의 CLAUDE.md에 내용을 붙여넣기
▸ Codex — AGENTS.md 또는 커스텀 인스트럭션
▸ 에이전트 스킬 — SKILL.md 구조로 설치하는 버전도 포크 다수
→ 어느 쪽이든 규칙만 복붙하면, 그 다음부터 에이전트가 이 원칙을 지키며 코딩해요.

바이브코딩과의 관계

카파시가 "바이브코딩"이라는 말로 AI에게 코딩을 맡기는 시대를 열었죠. 하지만 자유를 주면 AI가 길을 잃기도 해요. 이 스킬은 그 "자유의 역설"에 대한 카파시 본인의 답입니다 — 자유는 주되, 최소한의 안전가이드라인은 걸어두자. 바이브코딩을 '통제된 즐거움'으로 만드는 도구예요.

참고로 카파시는 또 다른 공식 리포 autoresearch에서 AI 에이전트가 스스로 LLM 훈련 실험을 벌이게 하는 연구도 진행 중입니다. "AI가 코딩하고 연구하는 시대"를 직접 실험하는 거죠.

자주 묻는 질문 (FAQ)

Q. CLAUDE.md가 뭔가요?

Claude Code가 프로젝트에서 지켜야 할 규칙을 적어두는 파일이에요. 여기에 카파시의 65줄을 넣으면, AI가 그 원칙을 따라 코딩합니다.

Q. 코드를 안 짜도 되나요?

아닙니다. 이건 코드가 아니라 에이전트에게 내릴 '지시문'이에요. 복붙만 하면 됩니다.

Q. Cursor·Copilot에서도 되나요?

원칙은 같으니, 각 도구의 '규칙/인스트럭션' 자리에 맞춰 넣으면 됩니다. 공식 포크/어댑터도 다수 존재해요.

Q. 65줄이 정말 효과 있나요?

15만 명 이상이 스타를 줬다는 건 그만큼 통했다는 방증이에요. 다만 프로젝트 성향에 맞게 일부는 수정해 쓰는 걸 권합니다.

마치며

카파시의 65줄은 "AI 코딩의 최소한의 훈육"입니다. 바이브코딩의 자유를 누리면서도, 코드 팽창·추측성 코딩·침묵 실패라는 늪에 빠지지 않게 해줘요. 그리고 그게 복붙 한 번으로 된다는 게 묘미죠.

AI에게 코딩을 맡기신다면 — 오늘 당장 프로젝트에 65줄을 한 번 넣어보세요. AI의 태도가 눈에 띄게 달라지는 걸 느낄 거예요 🙌 여러분만의 커스텀 규칙은 어떤가요? 댓글로 공유해 주세요.

---

※ 본 글은 2026년 7월 기준 공식 리포지토리·보도를 바탕으로 작성했습니다. 주요 출처: multica-ai/andrej-karpathy-skills (GitHub)·karpathy/autoresearch, Medium·Trendshift 분석, Claude Skill 마켓플레이스. 스타 수·정확한 65줄 내용은 리포 버전에 따라 달라질 수 있으니 공식 리포에서 직접 확인하세요.