2026년 6월 11일

클로드코드, AI에 일 시키는 3단계 — CLAUDE.md·Skill·Hook 한 장 정리

클로드코드에 일 시키는 3단계 — CLAUDE.md(지침)·Skill(레시피)·Hook(강제) AI한테 규칙을 적어줘도 자꾸 안 지킨다면, 방법이 하나뿐이라서예요. 클로드코드는 일을 시키는 층이 세 개예요 — 지침·레시피·강제. 오늘은 이 셋을 어떻게 나눠 쓰는지 정리합니다.

지난 글에서 **"CLAUDE.md에 적은 규칙은 약 70%만 지켜진다"**는 이야기를 했어요. 절대 어기면 안 되는 규칙은 '훅(hook)'으로 강제하라고요. 그런데 그 글을 읽고 이런 생각이 들 수 있어요. "그럼 CLAUDE.md랑 훅, 두 개만 있으면 되는 거야?"

사실은 그 사이에 한 층이 더 있어요. 클로드코드가 AI에게 일을 시키는 방법은 강제력이 다른 세 개의 층으로 되어 있거든요. 이걸 구분해서 쓰는 게, 고수와 초보를 가르는 가장 큰 차이예요. 오늘은 그 3층을 한 장으로 정리할게요.

왜 'CLAUDE.md 하나'로는 부족할까

CLAUDE.md 하나에 모든 규칙을 몰아넣으면 길어지고 안 지켜진다

많은 분이 클로드코드를 처음 쓸 때, 모든 규칙을 CLAUDE.md 하나에 몰아넣어요. 브랜드 톤, 금지 표현, 작업 순서, 발행 절차까지 전부요. 그러다 보면 두 가지 문제가 생겨요.

하나, 파일이 너무 길어져요. 규칙이 100줄을 넘어가면, AI가 매번 그걸 다 읽고 다 지키기 어려워져요. 앞에서 말한 "70%만 지켜진다"가 여기서 나와요.

둘, 상황마다 필요한 게 달라요. "블로그 쓸 때만 필요한 절차"를 항상 깔아두면 낭비고, "절대 어기면 안 되는 규칙"을 권고 수준 지침으로만 두면 위험해요.

그래서 클로드코드는 일을 성격에 따라 세 층으로 나눠요.

항상 깔려 있어야 하는 규칙 → CLAUDE.md (지침)
특정 작업을 할 때만 꺼내는 절차 → Skill (레시피)
무슨 일이 있어도 지켜야 하는 규칙 → Hook (강제)

하나씩 볼게요.

1층 — CLAUDE.md = 항상 깔리는 '상시 지침'

CLAUDE.md는 항상 배경에 깔리는 상시 브리핑 — 신입에게 준 회사 안내서

CLAUDE.md는 작업을 시작할 때 AI가 항상 먼저 읽는 배경 브리핑이에요. 신입 직원에게 첫날 건네는 "우리 회사는 이렇게 일해요" 안내서라고 보면 돼요.

여기엔 항상 깔려 있어야 하는 것들이 들어가요.

우리 브랜드는 누구를 대상으로 하는지 (타겟·페르소나)
말투는 어떤지 (친근한 ~요체, 전문 용어 자제 등)
절대 쓰면 안 되는 표현은 무엇인지

장점은 항상 작동한다는 거예요. 무슨 작업을 하든 이 배경 위에서 움직이니까요. 단점은 앞에서 말했듯 강제력이 약하다는 점이에요. 안내서를 받았다고 신입이 100% 다 지키지는 않잖아요. AI도 똑같아서, 중요한 규칙도 가끔 놓쳐요. 분명한 지침이긴 한데, 강제는 아니에요 — "읽고 따라줘"라고 권하는 수준이죠.

그러니 CLAUDE.md엔 **"항상 알고 있어야 하지만, 한두 번 어긋나도 치명적이지 않은 것"**을 넣는 게 맞아요. 반대로 한 번도 어기면 안 되는 규칙은 여기 두면 안 돼요. 그건 3층(Hook)의 몫이에요.

2층 — Skill = 필요할 때 꺼내는 '작업 레시피' (선택)

Skill은 특정 작업을 할 때만 꺼내는 레시피 카드 — 절차를 한 묶음으로

여기가 오늘의 핵심이에요. **Skill(스킬)**은 **특정 작업을 할 때만 꺼내 쓰는 '레시피 카드'**예요.

요리에 비유하면 쉬워요. 주방의 기본 원칙("위생을 지킨다")은 항상 깔린 규칙(CLAUDE.md)이에요. 하지만 **"김치찌개 끓이는 법"**은 김치찌개를 만들 때만 펼치는 레시피죠. 평소엔 접어두고, 그 요리를 할 때만 꺼내요. 그게 Skill이에요.

예를 들어 저는 **"네이버 블로그 발행"**이라는 Skill을 만들어 뒀어요. 거기엔 이런 절차가 한 묶음으로 들어 있어요.

SEO를 위해 도입부에 어떤 키워드를 넣는지
소제목(H2)을 몇 개, 어떤 흐름으로 배치하는지
FAQ를 어디에 넣는지
본문 끝에 어떤 CTA 블록을 붙이는지

블로그를 쓸 때 "블로그 발행 레시피로 써줘" 한마디면, AI가 이 절차를 통째로 불러와서 그대로 따라요. 매번 처음부터 설명할 필요가 없어요. 이게 Skill의 힘이에요.

CLAUDE.md와 뭐가 다르냐면 — 평소엔 안 깔려 있다가, 그 작업을 할 때만 호출돼요. 그래서 '선택'이에요. 블로그 쓸 때 카드뉴스 레시피는 필요 없으니까, 각 작업에 맞는 레시피만 꺼내 쓰는 거죠. 덕분에 CLAUDE.md를 길게 만들지 않고도, 작업별 디테일을 정교하게 챙길 수 있어요.

3층 — Hook = 어길 수 없는 '자동 강제' (100%)

Hook은 코드로 박힌 자동 관문 — 조건이 안 맞으면 아예 통과 못 한다

마지막은 지난 글에서 다룬 **훅(Hook)**이에요. 상시 지침(CLAUDE.md)도, 작업 레시피(Skill)도 아닌, 무조건 작동하는 자동 강제예요.

훅은 **"AI가 특정 행동을 하기 직전이나 직후에 자동으로 실행되는 검사"**예요. 마트 출구의 자동 도난 방지 게이트를 떠올리면 돼요. 계산을 안 한 물건이 있으면, 직원이 따로 신경 쓰지 않아도 게이트가 알아서 울려요. 어길 수가 없어요.

저는 **"발행 직전 금지어 검사"**를 훅으로 걸어 뒀어요. 콘텐츠를 저장하려는 순간, 본문에 쓰면 안 되는 표현이 들어 있으면 자동으로 잡혀서 멈춰요. 제가 매번 "금지어 확인해줘"라고 시키지 않아도, 기계적으로 100% 걸러져요.

그래서 훅엔 **"단 한 번도 어기면 안 되는 것"**만 넣어요. 자주 걸면 작업이 번거로워지니까, 정말 치명적인 규칙 한두 개에만 써요.

한눈에 비교 — 지침 · 레시피 · 강제

CLAUDE.md·Skill·Hook 3층 비교표 — 강제력과 작동 시점의 차이

세 층을 한 표로 정리하면 이래요.

층	성격	강제력	언제 작동하나	마케터 예시
CLAUDE.md	상시 지침	약 70% (권고)	항상 배경에 깔림	브랜드 톤·금지 표현·타겟 페르소나
Skill	작업 레시피 (선택)	호출하면 100%	그 작업을 할 때만	"블로그 발행" "카드뉴스 제작" 절차
Hook	자동 강제 (코드)	무조건 100%	특정 행동 직전·직후 자동	발행 전 금지어 자동 검사

핵심은 강제력의 차이예요. 위로 갈수록 부드럽고 항상 깔려 있고, 아래로 갈수록 강하고 좁게 작동해요. **"이 규칙은 얼마나 꼭 지켜져야 하나?"**를 기준으로 세 층에 나눠 담으면 돼요.

알고만 있으면 되는 것 → CLAUDE.md
작업할 때 순서대로 따라야 하는 것 → Skill
절대 어기면 안 되는 것 → Hook

마케터는 이렇게 조합해요 — 블로그 한 편 쓰는 과정

3층을 조합한 콘텐츠 발행 워크플로우 — 상시 지침·레시피·자동 검사

말로만 들으면 추상적이니, 제가 블로그 한 편을 쓰는 과정에 셋이 어떻게 같이 작동하는지 보여드릴게요.

(CLAUDE.md·항상) AI는 배경에서 우리 브랜드 톤과 금지 표현을 이미 알고 있어요. 따로 말 안 해도요.
(Skill·호출) "블로그 발행 레시피로 써줘" 하면, SEO 도입부 → 소제목 흐름 → FAQ → CTA까지 정해진 절차대로 초안이 나와요.
(Hook·자동) 저장하려는 순간, 금지어 검사가 자동으로 돌아요. 걸리는 게 있으면 멈추고 알려줘요.

세 층이 각자 자리에서 작동하니까, 저는 **"방향 주고 골라내고 결정하는 일"**에만 집중하면 돼요. 매번 규칙을 설명하지 않아도, 시스템이 알아서 받쳐줘요.

오늘 1단계 — 내 규칙을 세 칸에 나눠보기

지금 AI에게 매번 반복해서 설명하는 규칙들을 떠올려보세요.
그리고 세 칸에 나눠보세요:

[항상]  알고만 있으면 되는 것      → CLAUDE.md 후보
[작업]  그 일 할 때 순서대로 따를 것 → Skill 후보
[절대]  한 번도 어기면 안 되는 것    → Hook 후보

가장 자주 설명하는 '작업 절차' 하나를 Skill로 만들어보는 게
첫 출발로 제일 좋아요.

딱 하나만 정리해보세요. 그 한 번이, 매번 같은 설명을 반복하던 일에서 벗어나는 시작이에요.

자주 묻는 질문 (FAQ)

Q1. CLAUDE.md, Skill, Hook 중 뭐부터 만들어야 하나요? CLAUDE.md → Skill → Hook 순서를 추천해요. 먼저 항상 깔릴 기본 규칙(브랜드 톤·금지어)을 CLAUDE.md에 적고, 자주 반복하는 작업이 보이면 그걸 Skill로 묶어요. 마지막으로 "이건 절대 안 돼" 싶은 규칙 한두 개만 Hook으로 강제하면 돼요. 처음부터 셋 다 만들 필요는 없어요.

Q2. Skill과 CLAUDE.md의 차이가 헷갈려요. 작동 시점이 달라요. CLAUDE.md는 항상 배경에 깔려 있고, Skill은 그 작업을 할 때만 꺼내 써요. "말투" 같은 건 항상 필요하니 CLAUDE.md, "블로그 발행 절차"는 블로그 쓸 때만 필요하니 Skill이에요. 모든 걸 CLAUDE.md에 넣으면 파일만 길어지고 잘 안 지켜져요.

Q3. 저는 코딩을 못 하는데 Hook도 만들 수 있나요? Hook은 약간의 설정이 필요해서 셋 중 가장 손이 가요. 하지만 "이런 검사를 발행 전에 자동으로 돌리고 싶어"라고 클로드코드에게 설명하면, 설정 파일을 대신 만들어줘요. 직접 코드를 짜는 게 아니라, 원하는 걸 말로 설명하고 AI가 구성하게 하는 거예요.

Q4. 마케터한테 이 3층이 정말 필요한가요? 규칙을 매번 반복 설명하고 있다면 필요해요. "또 말투가 틀렸네", "또 금지어가 들어갔네"를 반복한다면, 그건 사람이 매번 잡을 게 아니라 시스템에 한 번 심어둘 일이거든요. 3층으로 나눠 담으면, 같은 설명을 반복하는 시간이 확 줄어요.

마무리 — 규칙도 '성격'에 맞게 담는 거예요

클로드코드를 잘 쓰는 사람과 못 쓰는 사람의 차이는, 규칙을 얼마나 많이 적었느냐가 아니에요. 규칙을 성격에 맞는 자리에 나눠 담았느냐예요.

알고만 있으면 되는 건 항상 깔리는 규칙(CLAUDE.md)으로, 작업할 때 따라야 할 절차는 레시피(Skill)로, 절대 어기면 안 되는 건 자동 강제(Hook)로. 이 세 칸에 나눠 담으면, AI는 훨씬 안정적으로 움직이고 나는 판단에만 집중할 수 있어요.

오늘 딱 하나만 해보세요. 매번 반복해서 설명하는 작업 절차 하나를, Skill로 묶어보는 것. 그게 "매번 설명하는 사람"에서 "한 번 세팅하고 결정하는 사람"으로 넘어가는 첫 걸음이에요.