스킬

Karpathy 가이드: CLAUDE.md 한 장으로 Claude Code가 코드를 고치기 전에 신중하게 하게 하기

Claude Code의 흔한 코딩 함정을 줄이려는 사람에게 맞지만, 가이드는 속도보다 신중함을 중시하므로 단순 오타나 한 줄 수정에는 전체 절차가 필요 없다.

Official source · andrej-karpathy-skills

Install

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

누구에게 맞나

주로 Claude Code에서 저장소를 고치고, LLM이 자주 빠지는 코딩 함정을 줄이고 싶다면 이 자료가 더 맞다. Claude Code 행동을 개선하기 위한 CLAUDE.md이며, 출처는 Andrej Karpathy가 LLM 코딩 함정을 관찰한 내용이다.

https://x.com/karpathy/status/2015883857489522876

페이지에는 네 가지 원칙이 같은 파일에 있고 이 문제들에 바로 대응한다고 적혀 있다. 확보된 페이지 본문에는 그 네 가지의 이름이나 본문이 없으므로, 스스로 이름을 붙이거나 구호 세트를 만들지 마라. 이미 Claude Code를 쓰고 플러그인 설치를 받아들일 사람이 대상이다. 게시물만 읽고 로컬 Claude Code 설정을 바꿀 생각이 없다면 위 링크로 충분하다.

3분 만에 첫 시도 마치기

공식 권장 설치는 연속 두 단계이며, 한 단계라도 빠지면 설치가 끝난 것이 아니다. 먼저 Claude Code에서 실행한다.

/plugin marketplace add forrestchang/andrej-karpathy-skills

바로 이어서 플러그인을 설치한다.

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

이것은 Claude Code 플러그인 설정을 바꾸는 작업이며 읽기 전용 조회가 아니다. 실행 전에 지금이 기록하려는 Claude Code 환경인지 확인하고 두 단계를 모두 끝낸다. marketplace만 추가하고 install은 하지 마라.

설치 후에는 바로 저장소를 크게 고치지 말고 먼저 대조한다. 사소하지 않은 변경 의도를 하나 고르고, Claude Code에게 어떻게 고칠지, 어떤 파일을 건드릴지 먼저 설명하게 한 뒤, 당신이 동의한 다음에야 코드를 쓰게 한다. 성공 신호는 「속도보다 신중」이다. 먼저 설명하고 나서 손대며, 큰 패치를 바로 펼치지 않는다. 관련 없는 모듈을 리팩터하기 시작하면 먼저 멈춰라.

사용 사례

사례 1: 사소하지 않은 코딩 작업. 가이드가 있는 이유는 LLM 코딩 함정 앞에서 Claude Code의 행동을 개선하기 위해서다. 작업을 「먼저 CLAUDE.md를 대조한 뒤 고친다」로 한정하라. 확보된 페이지 본문에는 그 네 원칙의 제목이 없으므로, 스스로 만든 원칙 이름으로 실행하라고 시킬 수 없다. 시킬 수 있는 것은 이 파일 하나를 읽고 변경 범위를 내는 것이다. 확인은 두 가지: 이 가이드를 읽었는지, 파일을 고치기 전에 범위를 냈는지.

사례 2: 엄격한 절차를 전부 올릴지 판단하기. 페이지는 이 가이드가 속도보다 신중함 쪽이라고 명시한다. 사소한 작업(간단한 철자, 한눈에 보이는 한 줄 수정)은 스스로 판단하며, 매번 전체 세트를 올릴 필요는 없다. 분명한 오타 하나만 고칠 때는 「이건 사소한 수정이니 절차를 넓히지 마라」고 분명히 말하라. 「분명함」의 자동 규칙도, 예외가 되는 파일 종류도 적혀 있지 않다. 따라서 경계는 당신이 그 자리에서 판단한다. Agent가 오타 수정을 리팩터로 올리면 이미 이 사례를 떠난 것이다.

사용 경계

이것은 Claude Code용 CLAUDE.md이지 범용 편집기 규칙 팩이 아니다. 다른 제품용으로 이름을 바꿔 쓰는 단계는 페이지에 없다. 네 원칙은 같은 파일에 있지만, 확보된 페이지 본문은 「네 가지가 있고 이 문제들에 대응한다」에서 멈추며 원칙 목록은 없다. 이름을 보태지 말고, 파일 속 원문을 이미 인용한 척하지 마라.

권장 설치는 위의 marketplace add 다음 plugin install이다. 두 단계 모두 해야 한다. 다른 설치 도구를 나란히 두지 마라. 출처 관찰은 Karpathy의 게시물에 있고, 가이드 자체는 파생 용법이므로 그 게시물의 맥락을 대체하지 못한다.

첫 정지는 「먼저 설명한 뒤 고친다」이다. 현재 작업을 넘는 리팩터, 일괄 재배치, 새 추상화 추가는 먼저 바꿀 파일과 이유를 적게 하고 당신이 확인한 뒤에 계속한다. 사소한 수정은 절차를 스스로 낮춰, 철자 하나 때문에 전체 세트를 타지 않게 한다.