Andrej Karpathy가 정리한 'CLAUDE.md 4대 원칙'이 GitHub에서 화제가 되며 AI의 코드 작성 정확도를 90% 이상으로 끌어올렸다

📄전체 원문· trafilatura에 의해 자동 추출됨Gemini 翻譯1754 자

AI를 얌전하게 만드는 신의 Prompt가 공개되었습니다! 최근 GitHub에서 `CLAUDE.md`라는 파일이 트렌드 1위를 차지했습니다. 전 OpenAI AI 디렉터 Andrej Karpathy의 관찰을 바탕으로 추출된 이 '4대 코딩 원칙'은 마치 AI에게 시니어 엔지니어의 영혼을 심어준 것과 같습니다. 프로젝트 루트 디렉토리에 넣기만 하면 Claude Code와 같은 AI 도구의 코드 정확도가 65%에서 90% 이상으로 급상승하며, AI가 마음대로 코드를 수정하거나 과도하게 엔지니어링하는 고질적인 문제를 근본적으로 해결합니다. (관련 내용: Claude Code, /goals 명령어 신규 출시: 실행과 평가를 분리하여 AI 에이전트의 게으름과 거짓말 방지) (배경 보충: OpenAI 창립 멤버 Andrej Karpathy, Anthropic 합류 발표: LLM 연구 개발의 최전선으로 복귀) Claude Code, Cursor 등 AI 보조 개발 도구가 보편화됨에 따라 많은 개발자가 공통적인 고충을 겪고 있습니다. AI는 빠르게 작성하지만 종종 '똑똑한 척'하며 근거 없는 가정을 하거나 과도하게 설계하고, 심지어 멀쩡한 코드를 마음대로 수정하기도 합니다. 하지만 이 문제에 대한 궁극적인 해결책이 나왔습니다. 유명 AI 전문가이자 전 OpenAI AI 디렉터 Andrej Karpathy는 최근 대규모 언어 모델(LLM)이 코딩할 때 흔히 발생하는 실패 패턴을 심층 분석했습니다. 이후 Forrest Chang 등 개발자들이 그 핵심 이념을 `CLAUDE.md`라는 간단한 파일로 정리했습니다. 이 프로젝트(forrestchang/andrej-karpathy-skills)는 최근 GitHub 트렌드 1위에 오르며 수십만 개의 Stars를 기록했습니다. 많은 개발자가 실사용 후, 이 파일을 도입한 뒤 AI가 출력하는 코드의 정확도가 기존 65% 수준에서 90% 이상으로 대폭 향상되었다고 놀라운 후기를 전하고 있습니다. `CLAUDE.md`의 '4대 황금 원칙' 공개 이 마법 같은 `CLAUDE.md` 파일은 본질적으로 AI에게 '시니어 엔지니어 수칙'을 장착해 주는 것입니다. 프로젝트 루트 디렉토리에 배치되면 Claude Code가 이를 자동으로 읽어 전체 세션의 최고 행동 지침으로 삼습니다. 핵심은 다음 4가지 철칙입니다. - 1. 코딩 전 생각하기 (Think Before Coding): "가정하지 마라. 혼란을 숨기지 마라. 트레이드오프를 명확히 하라." AI가 자신의 가정을 명확히 진술하도록 강제합니다. 불확실한 요구사항이 있거나 여러 해결책이 존재할 경우, AI는 묵묵히 추측하여 작성하는 대신 반드시 멈추고 사용자에게 질문해야 합니다. 불합리한 요구에 대해서는 AI에게 '푸시백(push back)'할 권한도 부여됩니다. - 2. 단순함 우선 (Simplicity First): "문제를 해결할 수 있는 '최소한의 코드'만 작성하라. 추측하지 마라." AI가 마음대로 '살을 붙이는' 행위를 엄격히 금지합니다. 미래에 발생할 가능성이 없는 시나리오를 위해 방어적 코드를 작성하거나, 단일 작업을 위해 복잡한 추상화 구조를 만드는 것을 허용하지 않습니다. 원칙은 간단합니다. 50줄로 해결할 수 있는 문제를 200줄로 작성하지 마십시오. - 3. 정밀한 외과 수술식 수정 (Surgical Changes): "수정해야 할 곳만 건드려라. 자신이 어지럽힌 코드만 정리하라." 많은 개발자가 가장 좋아하는 원칙입니다. 이 원칙은 AI가 특정 Bug를 수정할 때 '덤으로' 주변 코드, 주석, 서식을 리팩토링하거나 변경하는 것을 엄격히 금지합니다. 모든 코드 변경은 사용자의 명확한 요구사항으로 직접 추적 가능해야 합니다. - 4. 목표 지향적 실행 (Goal-Driven Execution): "성공 기준을 정의하라. 달성할 때까지 반복 검증하라." 모호한 작업을 검증 가능한 구체적인 목표로 전환하도록 요구합니다. 예를 들어 'Bug 수정' 명령을 받으면 AI의 표준 동작은 반드시 다음과 같아야 합니다. Bug를 재현할 수 있는 테스트 작성 ➔ 코드 수정 ➔ 테스트 통과, 이 과정을 통해 엄격한 검증 루프를 형성합니다. 왜 이 Prompt가 이렇게

데이터 상태✓ 전체 내용 추출 완료원문 읽기 (動區 BlockTempo)

🔍과거 유사 사건· 키워드 + 종목 매칭6 건

2026-05-14

Claude가 코딩하면서 미친 듯이 실수하고 모르는 척한다? Andrej Karpathy의 12가지 규칙을 개조하여 오류율을 41%에서 3%로 줄여드립니다

유사도 220%關鍵字 andrej/karpathy/claude同分類 zh

2026-05-26

Claude Code가 Uber에서 두 달 만에 연간 예산을 다 태운 후, COO는 직설적으로 말했다: Token 소비와 유용한 출력 사이에는 정비례 관계가 존재하지 않는다

유사도 170%關鍵字 code/claude同分類 zh

2026-05-24

우리 30명 규모의 회사를 전부 Claude Code로 AI화했는데, 결과적으로 "인간이 해야 할 일이 이전보다 더 많아졌다"

유사도 170%關鍵字 code/claude同分類 zh

2026-05-24