파일 하나로 클로드 똑똑하게 만들기

두 줄 다 끝나고 화면에 Successfully installed plugin(플러그인 설치 성공)이라는 문구가 보이면 끝이에요. scope: user는 내 컴퓨터의 모든 프로젝트에 들어갔다는 뜻이에요.

설치가 됐는지 다시 보고 싶으면 입력 칸에 /plugin을 치세요. 설치된 플러그인 목록에 andrej-karpathy-skills가 보이고, 그 안에 karpathy-guidelines라는 스킬이 들어 있어요.

꼭 알아 둘 점: 이 길은 코드 일에서만 불려요

이 플러그인이 넣는 건 늘 읽히는 규칙 파일이 아니에요. 스킬 하나예요. 스킬은 클로드가 필요할 때 골라 꺼내 쓰는 설명서예요. 이 스킬의 설명에는 “코드를 쓰거나, 검토하거나, 고칠 때 쓴다”라고 적혀 있어요.

그래서 코딩 일을 시킬 때는 클로드가 이 스킬을 꺼내 쓸 수 있어요. 하지만 글쓰기나 기획처럼 코딩이 아닌 대화에서는 안 불릴 수 있어요. 어떤 대화에서든 늘 원칙을 지키게 하려면 아래 두 번째 길로 가세요.

모든 대화에 늘 적용하는 길: 규칙 파일로 두기

그런데 플러그인 길은 코딩이 아닌 대화를 놓칠 수 있어요. 그래서 규칙 파일 원문을 내 프로젝트 폴더의 CLAUDE.md에 붙여 두면, 그 폴더에서 여는 모든 대화에 원칙이 늘 깔려요.

1. 원문 열기. 저장소의 CLAUDE.md 원문을 열고 내용을 전부 복사해요.

2. 내 폴더에 파일이 있는지 보기. 클로드 코드를 여는 폴더에 CLAUDE.md가 이미 있는지 확인해요.

3. 없으면 새로 만들기. 그 폴더에 CLAUDE.md라는 이름으로 새 텍스트 파일을 만들고, 복사한 내용을 붙여 넣고 저장해요.

4. 이미 있으면 합치기. 원래 파일을 지우고 바꾸지 마세요. 원래 내용 아래에 복사한 내용을 붙여 넣어요. 원문 첫머리에도 “필요에 따라 프로젝트 지시와 합쳐 쓰라(Merge with project-specific instructions as needed)“라고 적혀 있어요.

다음에 그 폴더에서 클로드 코드를 열면 클로드가 이 원칙을 읽고 대화를 시작해요.

원칙 4개, 원문과 한국어 풀이

설치는 끝났어요. 그럼 이제 파일 안을 볼 차례예요. 규칙 파일에는 원칙 4개가 들어 있어요. 각각 클로드가 자주 하는 실수 하나씩을 막아요.

아래 표는 원칙마다 원문 첫 줄과 한국어 풀이, 그리고 그 원칙이 막는 실수를 나란히 둔 거예요.

표 아래로 원칙마다 원문에서 눈여겨볼 줄을 하나씩 더 풀어요.

1. 먼저 생각하고 하기. 원문은 “State your assumptions explicitly. If uncertain, ask.”라고 해요. 일을 시작하기 전에 무엇을 가정했는지 먼저 말하고, 확실하지 않으면 물어보라는 뜻이에요. 뜻이 여러 가지로 읽히면 혼자 고르지 말고 보여 주고, 더 쉬운 방법이 있으면 그렇다고 말하라고도 적혀 있어요.

2. 단순하게. 원문에는 200줄을 썼는데 50줄로 될 것 같으면 다시 쓰라는 줄이 있어요. 시키지 않은 기능은 넣지 않고, 한 번만 쓸 걸 복잡한 틀로 짜지 않아요. 스스로 “숙련된 사람이 보면 너무 복잡하다고 할까?” 묻고, 그렇다면 줄이라고 해요.

3. 필요한 곳만 고치기. 원문은 고친 줄 하나하나가 내가 한 요청으로 바로 이어져야 한다고 해요. 옆의 멀쩡한 부분을 “더 낫게” 바꾸지 않고, 원래 쓰던 방식을 따르고, 상관없는 문제는 말만 하고 지우지 않아요.

4. 목표로 확인하기. 원문은 “고쳐 줘”를 “문제가 다시 나오는지 시험해 보고, 안 나오게 만들기”로 바꾸라는 예를 들어요. 여러 단계 일이면 단계마다 무엇으로 확인할지 짧은 계획부터 세우게 해요.

맨 위 한 줄: 속도보다 조심

원문 맨 위에는 이 원칙들이 속도보다 조심 쪽으로 기울어 있으니, 아주 쉬운 일엔 알아서 판단하라는 줄이 있어요. 그래서 간단한 일에선 클로드가 묻는 게 늘어 조금 느려질 수 있어요.

막힐 때와 되돌리기

클로드가 대답을 안 해요. 클로드 코드에 로그인이 안 돼 있으면 Not logged in과 Please run /login이라는 문구가 떠요. 입력 칸에 /login을 치고 안내대로 로그인하세요.

글쓰기 대화에서는 원칙을 안 지키는 것 같아요. 플러그인 길은 코드 일에서만 불릴 수 있어요. 늘 적용하려면 규칙 파일 길로 가세요.

원래 있던 규칙이 사라졌어요. 파일을 덮어쓴 거예요. 원래 내용을 다시 넣고, 원칙은 그 아래에 합쳐 붙이세요.

되돌리고 싶어요. 플러그인은 입력 칸에 /plugin을 쳐서 목록에서 지우면 돼요. 규칙 파일 길은 CLAUDE.md에 붙인 부분만 지우면 돼요.

다음 한 걸음

원칙 4개가 익숙해지면 내 일에 맞는 규칙 한 줄을 더해 보세요. 예를 들어 “답은 짧게, 결론부터”처럼요. 규칙 파일 맨 아래에 한 줄 적으면 다음 대화부터 클로드가 읽어요.

한 장 요약

저장해 두고 필요할 때 보세요.

참고한 곳

• multica-ai/andrej-karpathy-skills 저장소: 규칙 파일과 플러그인이 있는 곳, 설치 명령의 출처
• CLAUDE.md 원문: 원칙 4개와 “속도보다 조심” 줄의 원문
• GitHub 저장소 정보: 별 숫자의 출처, 2026년 9월 29일 확인
• 클로드 코드 공식 안내: 클로드 코드 설치와 로그인
• Unsplash 사진: 유리벽 메모지 너머로 노트북 작업하는 사람 사진, Vitaly Gariev, Unsplash 라이선스