클로드 코드가 코드 엉망으로 짤 때, 카르파티 원칙 한 장으로 고치는 법
클로드 코드가 쓸데없이 추상화를 늘리고, 확인 없이 가정대로 코드를 짜서 망가뜨리는 문제를 겪고 계신가요? 안드레이 카르파티가 지적한 LLM 코딩 함정 4가지를 단일 CLAUDE.md 파일에 담아, 생각→단순함→최소 변경→목표 중심 실행 원칙으로 바로잡습니다. 이 자료는 설치부터 커서 적용까지 전 과정을 3가지 옵션으로 안내합니다.
클로드 코드를 쓰다 보면 100줄이면 될 코드를 1000줄로 늘여놓거나, 물어보지도 않고 제멋대로 파일을 고쳐 버리는 바람에 되돌리느라 시간을 뺏깁니다. 안드레이 카르파티가 X에서 꼬집은 이 4가지 고질병을, 21.8만 개 스타를 받은 단일 설정 파일로 한 번에 잡는 방법을 정리했습니다.
카르파티가 짚은 LLM 코딩 4대 함정은 무엇인가요
클로드 코드가 멋대로 코드를 꼬아버릴 때마다 카르파티가 짚은 LLM 코딩 4대 함정을 한 장짜리 CLAUDE.md로 막아냅니다. multica-ai/andrej-karpathy-skills 저장소는 21.8만 개 스타를 모은 검증된 가이드라인입니다.
카르파티는 LLM이 잘못된 가정을 검증 없이 밀고 나가고, 혼동을 방치한 채 명확히 묻지 않으며, 과도한 추상화로 100줄이면 될 일을 1,000줄로 부풀리고, 무관한 코드까지 건드려 버리는 네 가지 패턴을 지적했습니다. 이 저장소는 이를 네 가지 원칙 — Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution — 으로 대응시킵니다.
| 원칙 | 해결하는 함정 |
|---|---|
| Think Before Coding | 잘못된 가정·숨은 혼동·트레이드오프 누락 |
| Simplicity First | 과도한 추상화·코드 비대화 |
| Surgical Changes | 무관한 코드 변경·주석 훼손 |
| Goal-Driven Execution | 지시 대신 성공 기준 제시 |
프로젝트별 적용(Option B)
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md -o CLAUDE.mdcurl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md카르파티 말대로 "LLM은 구체적 성공 기준만 주면 루프를 돌며 알아서 해결한다"는 점을 Goal-Driven Execution 원칙에 담았습니다. 지시 대신 성공 기준을 던져보세요.
한 장 CLAUDE.md가 이 문제를 어떻게 풀까요
multica-ai/andrej-karpathy-skills 저장소는 한 장 CLAUDE.md 파일만으로 Claude Code의 행동을 개선하도록 만든 프로젝트예요. 현재 21.8만 개의 스타와 21,968개의 포크를 보유하고 있으며, 9개월 전(2026년 1월)에 처음 만들고 6개월 전(2026년 4월)에 마지막 업데이트했어요. 이 파일은 Andrej Karpathy가 제시한 LLM 코딩 함정 4가지를 직접 해결하도록 설계되었습니다.
네 가지 원칙—Think Before Coding, Simplicity First, Surgical Changes, Goal‑Driven Execution—은 각각 다음과 같은 문제에 대응합니다. "잘못된 가정"이나 "숨은 혼란"은 Think Before Coding이 잡아주고, "코드와 API 과도 복잡화"는 Simplicity First가 방지합니다. "무관한 부분까지 수정하는" 행동은 Surgical Changes가 억제하며, 목표가 명확하지 않을 때 발생하는 무분별한 루프는 Goal‑Driven Execution이 목표 기준으로 끊어줍니다.
| 원칙 | 대응하는 함정 |
|---|---|
| Think Before Coding | 잘못된 가정·숨은 혼란·트레이드오프 누락 |
| Simplicity First | 과도 복잡·불필요한 추상화·코드 부피 확대 |
| Surgical Changes | 무관한 코드·주석 변경·부수효과 |
| Goal‑Driven Execution | 목표 미설정·불필요 루프·실패 기준 부재 |
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/m
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/m설치 3가지 옵션으로 지금 바로 적용하기
Claude Code와 Cursor에서 카르파티 원칙을 적용하려면 세 가지 옵션이 있어요. 플러그인 설치, 프로젝트별 CLAUDE.md 추가, 그리고 Cursor 규칙 파일 사용이죠. 각각 1분 안에 적용할 수 있어 편리합니다.
Option A – Claude Code 플러그인 (추천)≈1분
Claude Code 안에서 마켓플레이스를 추가하고 플러그인을 설치하면 가이드라인이 전 프로젝트에 적용됩니다.
Option B – CLAUDE.md (프로젝트별)≈1분
새 프로젝트라면
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/m로 파일을 받아 루트에 놓고, 기존 프로젝트는 같은 명령어로 파일을 추가하면 됩니다.Option C – Cursor 규칙 파일≈1분
.cursor/rules/karpathy-guidelines.mdc파일을 프로젝트에 복사하고, Cursor 설정에서 규칙을 활성화하면 동일한 원칙이 적용됩니다.
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/m| 옵션 | 설명 |
|---|---|
| 플러그인 | 전체 프로젝트에 자동 적용 |
| CLAUDE.md | 프로젝트마다 파일 하나만 추가 |
| Cursor 규칙 | Cursor 전용 규칙 적용 |
실전 전·후 비교: 과한 추상화 vs 수술적 변경
Claude Code가 과도한 추상화로 코드를 얽히게 할 때, 카르파티 원칙을 적용하면 얼마나 달라지는지 직접 비교해 볼 수 있어요. 원칙을 적용하기 전에는 1000줄이 넘는 복잡한 구현이 흔했지만, 원칙을 적용한 뒤에는 핵심 로직만 100줄 내외로 압축됩니다.
또한, 가독성과 변경 범위도 크게 개선됩니다. 원칙 적용 전에는 코드가 난해하고, 사소한 수정에도 전체 파일을 건드려야 했지만, 적용 후에는 명확한 구조와 최소한의 수정으로 원하는 부분만 손쉽게 바꿀 수 있어요.
| 항목 | 원칙 적용 전 | 원칙 적용 후 |
|---|---|---|
| 코드량 | ~1000줄(과다) | ~100줄(간결) |
| 가독성 | 낮음 | 높음 |
| 변경 범위 | 광범위(다수 파일) | 제한적(핵심 부분만) |
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/mOption A: Claude Code 플러그인 설치
Claude Code 내부 마켓플레이스를 열고 플러그인을 추가하면 모든 프로젝트에 가이드라인이 적용돼요.
Option B: 프로젝트별 CLAUDE.md 추가
새 프로젝트는 루트에 CLAUDE.md 파일을 만들고, 기존 프로젝트는 파일을 추가하면 바로 적용됩니다.
- ⭐ 21.8만 개의 스타
- 📂 21,968개의 포크
- 🗓️ 9개월 전(2026년 1월) 최초 생성
- 🗓️ 6개월 전(2026년 4월) 마지막 업데이트
핵심 인사이트
주의할 점: 플러그인·로컬 파일·커서 동시 적용 시 충돌 피하기
카르파티 원칙을 프로젝트에 들여올 때 Claude Code 플러그인, 개별 저장소의 CLAUDE.md, 그리고 커서(Cursor) 전용 룰 파일(.cursor/rules/karpathy-guidelines.mdc)을 함께 활용할 수 있어요. 하지만 여러 방식을 동시에 사용하다 보면 규칙 적용 우선순위가 엉키거나 버전 차이가 생길 수 있어 주의가 필요해요.
| 적용 방식 | 적용 범위 및 파일 위치 | 특징 |
|---|---|---|
| Claude Code 플러그인 | 전체 프로젝트 공통 적용 | 마켓플레이스 등록 후 전역 스킬로 동작해요 |
| 프로젝트별 CLAUDE.md | 해당 저장소 루트의 CLAUDE.md | 프로젝트 단위로 덮어쓰거나 덧붙여서 관리해요 |
| Cursor 전용 룰 | .cursor/rules/karpathy-guidelines.mdc | Cursor 에디터 실행 시 해당 프로젝트에 맞춰 동작해요 |
팀 작업 전 확인하는 3가지 체크리스트
저장소를 여럿이 협업하거나 다양한 도구에서 동시에 다룰 때는 아래 세 가지 점검 항목을 반드시 맞춰두는 것이 안전해요.
정리: 오늘부터 클로드 코드에게 '성공 기준만 주고 지켜보기'
Claude Code가 코드를 엉망으로 짤 때, 성공 기준만 주고 지켜보는 습관을 들이면 큰 변화를 만들 수 있어요. 이 방법은 multica-ai/andrej-karpathy-skills 저장소의 한 장짜리 CLAUDE.md 파일에 담긴 카르파티 원칙을 그대로 적용하는 것이 핵심입니다. 이 저장소는 현재 21.8만 개의 스타와 21,968개의 포크를 보유하고 있으며, 9개월 전(2026년 1월)에 처음 만들어진 뒤 6개월 전(2026년 4월)에 마지막 업데이트되었습니다.
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/m| Principle | Addresses |
|---|---|
| Think Before Coding | Wrong assumptions, hidden confusion, missing tradeoffs |
| Simplicity First | Overcomplication, bloated abstractions |
| Surgical Changes | Orthogonal edits, touching code unintentionally |
| Goal‑Driven Execution | Loop until success criteria are met |
왜 성공 기준만 주나요?
Andrej Karpathy는 LLM이 목표를 명확히 제시받으면 스스로 탐색하고 반복한다는 점을 강조합니다. 구체적인 작업 지시 대신 ‘성공 기준’을 제시하면 모델이 불필요한 가정을 줄이고, 필요한 부분만 집중해 코드를 수정하게 됩니다.
- 성공 기준을 한 문장으로 정의하기
- CLAUDE.md 파일을 프로젝트에 배치하기
- 플러그인 또는 로컬 파일 중 하나만 선택해 적용하기
- 매일 루프 결과를 기록하고 개선점 메모하기