카파시 가이드라인|카파시 코딩 원칙

AI 코딩 도구가 자주 저지르는 실수를 네 가지 원칙으로 줄여주는 규칙 파일입니다. ① 코드 전에 가정 먼저 말하기, ② 요청한 것만 최소한으로 짜기, ③ 필요한 줄만 건드리기, ④ 검증 가능한 목표로 쪼개기. 원칙마다 안 좋은 예·좋은 예를 실제 코드로 보여주는 EXAMPLES.md 가 함께 들어 있어 효과를 바로 체감할 수 있습니다.

도도리 AI연구소 · 최종 수정 2026년 10월 4일 · CC BY-NC 4.0

개발 워크플로 분야 · 바이브코딩·만들기 용도 · 개발자용입니다.

karpathy-guidelines 스킬 설치 한 줄

Claude Code 용 명령입니다. Claude Code 는 터미널뿐 아니라 데스크톱 앱(Mac·Windows), 웹(claude.ai/code), VS Code·JetBrains 확장으로도 씁니다. 어디서 쓰시든 명령을 넣는 자리에 붙여 넣으시면 됩니다. 터미널로 쓰시면 그 터미널이고, 앱·웹·확장으로 쓰시면 그 안의 명령 입력 칸입니다. 헷갈리기 쉬운 곳은 하나입니다. 대화만 하는 Claude 앱의 채팅창은 Claude Code 가 아니라서 여기에 붙여 넣으면 동작하지 않습니다. 터미널로 쓰실 때만 Node.js 가 따로 필요하며, node -v 를 쳐서 버전이 나오면 준비된 것입니다.

뒤의 두 가지는 붙여 두시는 편이 좋습니다. -g 는 계정 전체에 넣는다는 뜻으로, 없으면 지금 열려 있는 폴더에만 깔려 다른 곳에서는 스킬이 보이지 않습니다. -a claude-code 는 Claude Code 에만 넣는다는 뜻입니다. 이걸 빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간 Failed to install 이 뜨는데, 실제로는 설치가 된 상태라 헷갈립니다.

karpathy-guidelines 스킬 설치 절차 전체

위 한 줄에서 막히셨다면 여기를 보십시오. 터미널로 쓰시는 분을 위해 터미널 여는 법부터 확인 명령까지 순서대로 적어 두었습니다. 데스크톱 앱·웹·편집기 확장으로 쓰시면 터미널 여는 단계는 건너뛰고 명령 입력 칸에 같은 줄을 넣으시면 됩니다.

# andrej-karpathy-skills 설치

## 0. 어디에 붙여 넣나

Claude Code 를 쓰는 방법이 네 가지입니다. 어느 쪽이든 됩니다.

  터미널           macOS 는 터미널, Windows 는 PowerShell
  데스크톱 앱       Mac · Windows 용 Claude Code 앱
  웹              claude.ai/code
  편집기 확장       VS Code · JetBrains

명령을 넣는 자리에 아래 한 줄을 붙여 넣으시면 됩니다. 터미널로
쓰시면 그 터미널이고, 앱·웹·확장으로 쓰시면 그 안의 명령 입력 칸입니다.

헷갈리기 쉬운 곳이 하나 있습니다. 대화만 하는 Claude 앱의 채팅창은
Claude Code 가 아닙니다. 거기에 붙여 넣으면 Claude 가 명령을 글로
읽고 설명만 해 줍니다.

터미널로 쓰실 때만 Node.js 가 따로 필요합니다. node -v 를 쳐서
v20.1.2 처럼 버전이 나오면 준비된 것입니다. "찾을 수 없습니다" 가
나오면 nodejs.org 에서 LTS 버전을 먼저 설치하십시오.
(앱·웹·확장에는 이미 들어 있습니다.)

  macOS    Spotlight(Command + 스페이스)에서 "터미널" 을 여십시오
  Windows  시작 메뉴에서 "PowerShell" 을 여십시오

## 1. 넣기

npx skills add multica-ai/andrej-karpathy-skills -g -a claude-code

  성공하면 이 한 줄이 나옵니다.
  Installed 1 skill → ~/.claude/skills/...

  -g 는 계정 전체에 넣는다는 뜻입니다(~/.claude/skills).
  어느 폴더에서 Claude Code 를 열든 쓸 수 있습니다.
  빼면 지금 열려 있는 폴더에만 깔려서(./.claude/skills), 다른 데서
  열면 스킬이 안 보입니다. "깔았는데 안 보인다" 는 대개 이것입니다.

  -a claude-code 는 Claude Code 에만 넣는다는 뜻입니다.
  빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간
  "Failed to install" 이 뜹니다. 실제로는 설치가 끝난 상태인데
  실패한 것처럼 보여 여기서 멈추기 쉽습니다.

  저장소에 스킬이 여러 개면 어느 것을 넣을지 물어봅니다.
  미리 보시려면 --list 를 붙이십시오.

  npx skills add multica-ai/andrej-karpathy-skills --list

## 2. Claude Code 를 다시 시작합니다

이미 열어 두셨다면 끝내고 다시 여십시오.
실행 중인 세션은 시작할 때 읽은 목록을 그대로 씁니다.

  터미널이면 claude 를 끝내고 다시 실행합니다.
  데스크톱 앱·웹·편집기 확장이면 그 세션을 새로 엽니다.
  대화만 하는 Claude 앱은 해당되지 않습니다 — 스킬이 들어가지 않습니다.

## 3. 확인

npx skills list -g

  전역으로 넣은 스킬이 이름과 경로와 함께 나옵니다.
  -g 를 빼면 지금 폴더의 스킬만 보이므로 "없다" 고 나올 수 있습니다.

## 4. 쓰기

"카파시 코딩 원칙" 관련 작업을 시켜 보십시오.
스킬이 붙었다면 알아서 불러 씁니다.

이렇게 시켜 보세요

넣고 나서 바로 던져 볼 수 있는 지시문입니다. 누르면 복사됩니다.

karpathy-guidelines 스킬 사용법

처음 세 번은 이 순서로 시키십시오. 지시문을 누르면 복사됩니다.

1. 작업 시작 전에 가정부터 확인해줘

   나오는 것코드를 짜기 전에 자기가 전제한 것을 먼저 적습니다. 어느 파일을 고칠지, 어떤 입력을 가정했는지, 무엇을 모르는지.

   다음가정이 틀렸으면 그 자리에서 바로잡고 나서 시킵니다. "이 코드 수정을 최소 변경으로 다시 해줘".

2. 버그 재현 테스트를 먼저 작성한 뒤 수정해줘

   나오는 것실패하는 테스트가 먼저 나오고, 그다음 수정, 그다음 통과 확인 순서로 옵니다.

   다음바뀐 줄 수를 세어 보십시오. 요청한 범위 밖의 줄이 바뀌었으면 "요청한 기능만 추가하고 다른 코드는 건드리지 마" 를 붙여 다시 시킵니다.

3. 이 구현이 과하게 복잡한지 점검해줘

   나오는 것없어도 되는 추상화와 딸려 온 기능을 짚습니다. 원칙마다 EXAMPLES.md 의 좋은 예와 나쁜 예를 근거로 답합니다.

   다음한 줄 수정이나 새 파일 작성에는 이 규칙을 빼십시오. 신중함을 우선하는 규칙이라 단순한 일에는 느려집니다.

알아 둘 것

karpathy-guidelines 스킬 안 될 때 확인할 것

이름과 달리 카파시 본인이 만든 것이 아닙니다

그가 올린 글을 커뮤니티가 정리한 것이라, 공식 견해로 인용하면 안 됩니다.

속도보다 신중함을 우선합니다

단순한 작업에는 오히려 불필요하게 느릴 수 있습니다. 복잡한 수정·리뷰 작업에만 켜두는 것이 실용적입니다.

언제 쓰고, 언제 안 쓰나

고쳐 달라고 한 것보다 더 많이 바뀌어 오는 일이 잦다면 여기서 차이가 납니다. 간단한 한 줄 수정이나 새 파일 작성에는 없어도 충분합니다.

비슷한 것 중에 왜 이걸

같은 분야에 절차를 강제하는 것들이 있습니다. superpowers 는 기획부터 테스트까지 방법론 전체를 얹고, ecc 는 계획·테스트·구현·검토·검증·기억 순서를 강제하며, planning-with-files 는 파일 세 개를 두고 매 턴 갱신하게 합니다. 이건 그런 것이 아니라 규칙 파일 하나입니다. 순서를 바꾸지 않고 네 원칙만 얹습니다. 이미 자기 방식이 있는 사람도 그 방식을 버리지 않고 쓸 수 있습니다. 반대로 진행 순서 자체가 없어서 문제라면 이걸로는 안 되고 위의 셋 중 하나가 맞습니다. 결이 가장 가까운 것은 ponytail 입니다. 그쪽은 코드를 쓰기 전에 밟을 사다리 일곱 칸을 정해 두고 먼저 걸리는 칸에서 멈추게 합니다. 판단 기준이 더 기계적이라 결과가 고르고, 이건 네 원칙을 얹어 사람이 판단할 여지를 남깁니다.

개발 워크플로 도구를 고를 때

CI/CD, 이슈 트래커, 브랜치 관리를 연결하는 도구입니다. 토큰 권한 범위를 필요한 저장소로만 좁힐 수 있는지, 실패했을 때 로그를 어디서 확인하는지 먼저 확인하세요.

원본 보기

스킬의 실제 내용은 SKILL.md 파일 하나에 들어 있습니다. 넣기 전에 한 번 읽어 보시는 것을 권합니다. 스킬은 Claude 에게 그대로 들어가는 지시문이라, 무엇을 시키는지 확인하지 않고 쓰면 의도치 않은 동작을 할 수 있습니다.

GitHub 에서 multica-ai/andrej-karpathy-skills 열기

이 작업에 쓰는 장비 제휴 링크

오래 붙어 앉아 쓰는 스킬입니다.

모니터암화면 높이와 각도를 손으로 조절합니다. 받침대 자리가 비워집니다.카멜마운트 폴타입 이지밸런스 싱글 스탠드 모니터암 MSS2P, 블랙, 1개 60,090원보기 ↗노트북 거치대화면을 눈높이로 올립니다. 알루미늄, 접이식.애니클리어 프리미엄 알루미늄 노트북 거치대 받침대 AP-1 15,760원보기 ↗모니터 라이트화면 위만 비추고 화면에 반사가 없습니다.엘레센스 2in1 모니터 조명 백라이트바 스크린바 보조등, 1개, E1132 76,900원보기 ↗손목 받침쉴 때 손목을 놓는 젤 쿠션입니다.제로썬 마우스손목받침대 키보드손목받침대 젤리 에어셀 팜레스트 쿠션 게이밍, 1개, 블랙 마우스 손목 받침대 16,000원보기 ↗

이 페이지는 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다. 이용자가 내는 금액은 달라지지 않습니다.

별점과 댓글

이 스킬을 써 보신 분의 별점(5점 만점)과 한마디입니다. 작성자는 아이디 앞 3자만 보입니다(예: wor****). 읽는 데는 제한이 없고, 남기는 것은 로그인한 회원만 됩니다. 한 사람이 한 번이며 다시 쓰면 앞의 것을 덮어씁니다.

자주 묻는 것

카파시 스킬(andrej-karpathy-skills)은 어떻게 설치합니까?

npx skills add multica-ai/andrej-karpathy-skills 한 줄입니다. 규칙 파일이라 설치 뒤에는 따로 부르지 않아도 적용됩니다.

andrej-karpathy-skills 사용법은 어떻게 됩니까?

따로 부르지 않습니다. 규칙 파일이라 설치하면 바로 적용됩니다. 확인하려면 "작업 시작 전에 가정부터 확인해줘" 라고 시켜 보십시오. 코드를 짜기 전에 어느 파일을 고칠지, 무엇을 가정했는지 먼저 적으면 들어간 것입니다. 버그 수정은 "버그 재현 테스트를 먼저 작성한 뒤 수정해줘" 로 시킵니다.

카파시 가이드라인은 무엇을 막아 줍니까?

네 가지 원칙으로 AI 코딩 도구의 잦은 실수를 줄입니다. 코드 전에 가정을 먼저 말하기, 요청한 것만 최소한으로 짜기, 필요한 줄만 건드리기, 검증 가능한 목표로 쪼개기입니다. 원칙마다 안 좋은 예와 좋은 예를 실제 코드로 보여 줍니다.

안드레 카파시가 직접 만든 것입니까?

아닙니다. 그가 올린 글을 커뮤니티가 정리한 것입니다. 공식 견해로 인용하시면 안 됩니다.

항상 켜 두어도 됩니까?

단순한 작업에는 오히려 느려집니다. 속도보다 신중함을 우선하기 때문입니다. 복잡한 수정이나 코드 리뷰에만 켜 두시는 편이 실용적입니다.

함께 보면 좋은 스킬

어느 것부터 깔지 모르겠다면 클로드 스킬 추천 15개를 보십시오. 67개를 직접 깔아 보고 골랐습니다.