Andrej Karpathy Skills — AI 코딩 도우미에게 '생각하고 코딩하라'고 가르치는 설정 파일

Andrej Karpathy는 X(구 트위터)에 올린 글에서 현 AI 코딩 도우미의 세 가지 치명적 문제를 지적했다:

1. 추측하고 달린다 — AI는 확실하지 않은 가정을 스스로 확인하지 않고 그냥 코딩을 진행한다. 혼란스러워도 질문하지 않고, 불일치를 발견해도 말하지 않는다. "여러 해석이 가능한데 그냥 이걸로 갈게" 식의 태도가 문제다. 2. 불필요하게 복잡하게 만든다 — 단순하게 끝낼 일을 추상화·설정 가능성·미래 대비라는 이름으로 1000줄로 불린다. 필요 없는 에러 처리, 사용되지 않을 함수, 조기 최적화가 판친다. 50줄이면 될 코드를 200줄로 짜는 식이다. 3. 건드리지 말아야 할 것을 건드린다 — 요청과 무관한 주석·코드를 '개선' 명목으로 마음대로 바꾼다. 남의 코드 스타일을 자기 방식으로 고쳐서 diff(변경 내역)를 불필요하게 키운다.

이 CLAUDE.md 파일은 이 세 문제를 네 가지 원칙으로 교정한다: 생각하고 코딩하기(Think Before Coding)로 추측을 멈추고 질문하게 하고, 단순함 우선(Simplicity First)으로 최소 코드만 짜게 하고, 수술적 변경(Surgical Changes)으로 요청과 무관한 수정을 금지한다. 그리고 목표 기반 실행(Goal-Driven Execution)으로 "이걸 해" 대신 "이 기준을 만족시켜"라는 방식으로 지시해 AI가 스스로 반복·검증하며 작업을 마치도록 유도한다. Karpathy의 표현을 빌리면 "무엇을 할지 말하지 말고, 성공 기준을 주고 지켜봐라"는 접근법이다.

이 도구를 직접 쓰려면 반드시 '개발자'여야 한다. Claude Code를 설치하고 터미널(검은 화면에 명령어 입력하는 창)을 다룰 수 있어야 하며, AI가 내놓은 코드를 읽고 검토할 수 있는 코딩 지식도 필요하다. 이 파일은 '코딩을 더 잘하는 AI'를 만드는 설정일 뿐, 코딩 자체를 없애 주는 도구가 아니다. 코딩 모르는 사람이 이 파일 하나로 AI에게 앱을 만들어 달라고 할 수는 없다.

비개발자에게 추천하는 현실적인 접근:

• 이 도구 자체는 몰라도 된다. 지금 당장 매일 쓸 일은 없다. ChatGPT나 Claude.ai로 문서 작성·요약·번역·아이디어 구체화를 먼저 익히는 게 생산적이다.
• 하지만 개념은 알아두면 좋다. AI가 '추측하고 달리는' 문제는 코딩뿐 아니라 모든 AI 작업에서 발생한다. AI가 확실치 않은 내용을 마치 사실인 양 말할 때가 많고, 모르면 모른다고 말하기보다 그럴듯하게 지어내는 경향이 있다. 이 도구의 첫 번째 원칙('생각하고 코딩하기')은 "모르면 질문하라"는 것인데, 이 태도를 모든 AI 작업에 적용하면 더 믿을 수 있는 결과를 얻을 수 있다.
• 만약 코딩을 막 시작해 보고 싶다면? Claude Code는 숙련자용이다. 대신 ChatGPT(무료)나 Claude.ai(무료)에서 "이런 기능의 코드를 파이썬으로 짜 줘"라고 자연어로 요청하고, 결과를 복사해서 실행해 보는 것부터 시작하라. 코딩을 배우는 중이라면 GitHub Copilot(월 10달러)이 VS Code 편집기 안에서 더 친절한 도움을 준다.