클로드 코드가 멍청할 때

깃허브 별 22만 개 CLAUDE.md 파일 하나로 고치기

단계 2개따라 하기 약 5분

한눈에 보기

1모든 프로젝트에 한 번에 — 플러그인으로 설치추천 · 한 번 깔면 끝›2이 프로젝트에만 — CLAUDE.md 파일 넣기작업 폴더에 파일 하나›3막히면자주 나오는 것›

간단한 걸 복잡하게 만들고, 시키지도 않은 코드까지 고치고, 안 끝났는데 다 됐다고 하고… 클로드 코드의 이런 버릇을 규칙 파일 하나로 잡아 줘요.

안드레 카파시(전 테슬라 AI 총괄, 오픈AI 공동창업자)가 짚은 'AI 코딩 실수'를 바탕으로 만든 CLAUDE.md 파일이에요. 깃허브 별 21만 9천 개(2026-10-13 기준).

깃허브 주소
github.com/multica-ai/andrej-karpathy-skills

이 파일에 들어 있는 규칙 4개

코딩 전에 먼저 생각하기 — 모르면 추측하지 말고 물어봐요. 방법이 여러 개면 골라서 몰래 하지 않고 보여 줘요.
단순하게 — 부탁한 것만, 꼭 필요한 만큼만 짜요. 200줄을 50줄로 줄일 수 있으면 다시 써요.
시킨 곳만 고치기 — 옆 코드를 멋대로 "개선"하지 않아요. 바뀐 줄은 전부 부탁한 내용과 이어져야 해요.
목표를 정하고 검증하기 — "다 됐어요" 전에 성공 기준을 정하고 직접 확인해요.

준비물

클로드 코드(Claude Code)가 설치돼 있으면 돼요. 아직 없다면 자료실 #017 맨 위 설치 안내를 보세요.

모든 프로젝트에 한 번에 — 플러그인으로 설치추천 · 한 번 깔면 끝

github.com/multica-ai/andrej-karpathy-skills

클로드 코드를 열고 아래 문장을 그대로 붙여 넣으세요.

https://github.com/multica-ai/andrej-karpathy-skills — 이 카파시 규칙을 클로드 코드 플러그인으로 설치해 주세요. 모든 프로젝트에서 쓸 수 있게요. 다 되면 잘 깔렸는지 확인해 주세요.

직접 명령어로 하고 싶다면

클로드 코드 안에서 아래 두 줄을 한 줄씩 치세요. 첫 줄이 저장소를 등록하고, 둘째 줄이 설치해요.

> /plugin marketplace add forrestchang/andrej-karpathy-skills

> /plugin install andrej-karpathy-skills@karpathy-skills

클로드 코드를 새로 켜고 /plugin 을 쳤을 때 andrej-karpathy-skills 가 보이면 성공이에요.

이렇게 되면 성공 — 다음부터 일을 시키면, 애매한 건 먼저 물어보고 시킨 곳만 고친 뒤 "확인해 봤어요"라고 답해요.

이 프로젝트에만 — CLAUDE.md 파일 넣기작업 폴더에 파일 하나

특정 폴더에서만 쓰고 싶다면, 그 폴더에서 클로드 코드를 열고 이렇게 말하세요.

https://github.com/multica-ai/andrej-karpathy-skills — 여기 있는 CLAUDE.md 내용을 이 작업 폴더의 CLAUDE.md 에 넣어 주세요. 이미 CLAUDE.md 가 있으면 지우지 말고 맨 아래에 이어 붙여 주세요.

직접 명령어로 하고 싶다면

작업 폴더에서 PowerShell(윈도우 명령어 창)에 붙여 넣으세요. CLAUDE.md 가 없을 때만 쓰세요.

$ irm https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md -OutFile CLAUDE.md

이렇게 되면 성공 — 폴더에 CLAUDE.md 파일이 생기고, 안에 "1. Think Before Coding" 부터 "4. Goal-Driven Execution" 까지 4개 규칙이 보여요.

이미 쓰던 CLAUDE.md 가 있다면 명령어로 덮어쓰지 마세요. 원래 내용이 사라져요. 위 문장처럼 클로드에게 "이어 붙여 달라"고 하는 게 안전해요.

막히면자주 나오는 것

그래도 다 됐다고 우겨요 — 일을 시킬 때 "끝나면 직접 실행해서 확인한 결과를 보여 줘"라고 한 줄 붙이면 4번 규칙이 더 잘 지켜져요.

규칙이 영어인데 괜찮나요? — 네, 클로드는 영어 규칙도 그대로 지키고 한국어로 답해요. 한국어로 바꾸고 싶으면 "CLAUDE.md 를 한국어로 바꿔 줘"라고 하세요.

되돌리고 싶으면 클로드에게 "카파시 규칙 플러그인 지워 주세요" 또는 "CLAUDE.md 에서 카파시 규칙 부분만 빼 주세요"라고 하면 돼요.

AI 공부방 오픈카카오톡 · 막히면 같이 공부해요

입장하기 ‹ 다른 자료 보러 가기

트렌드코어 스킬공유자료실 · 무료