스킬과 다른 조정 방법들

스킬 하나로 모든 걸 해결하려 들면 오히려 일이 꼬입니다.

• 늘 지켜야 할 규칙을 스킬에 넣으면, 정작 필요한 순간에 안 불려 올 수 있습니다.
• 파일을 저장할 때마다 할 일을 스킬에 맡기면, 매번 직접 요청해야 합니다.
• 외부 데이터베이스에 연결하는 일을 스킬로 흉내 내려 하면, 애초에 통로가 없습니다.

Claude Code가 조정 방법을 여러 개 둔 건, 문제마다 결이 다르기 때문입니다. 다음 세 가지 축만 잡으면 선택이 쉬워집니다 — 항상 vs 필요할 때, 같은 자리 vs 따로, 요청 vs 이벤트.

먼저 영상을 보세요. 영어가 어렵다면 아래 한국어를 같이 읽으면 됩니다. 자동 번역과 달리, 낯선 용어를 풀어서 옮겼습니다.

영상 대본 — 영어 영상을 보며 같이 읽으세요 (타임스탬프 기준).

Claude Code를 조정하는 방법은 다섯 가지입니다. 이름만 보면 헷갈리지만, ‘언제·어떻게 작동하는지’가 다릅니다. 아래에서 상황을 하나 골라 [실행]하면, 그 일에 가장 맞는 도구가 켜지고 이유가 나옵니다.

결정 라우터 — 상황을 고르면 맞는 조정 방법이 점등됩니다.

CLAUDE.md는 모든 대화에 항상 들어옵니다. 프로젝트 표준을 한 번 적어 두면, 새 대화를 시작할 때마다 자동으로 따라붙습니다. 예를 들면 이런 파일입니다. (원문은 영어입니다.)

1
2
3
4
5
6

# Project Standards
Always apply these in this project.

- Use TypeScript strict mode.
- Never modify the database schema directly.
- Match the existing folder structure and naming.

반면 스킬은 필요할 때만 들어옵니다. pr-review 스킬은 PR 리뷰를 요청할 때 발동하고, 새 코드를 짤 때는 가만히 폴더에 있습니다. 아래에서 요청을 골라, 무엇이 컨텍스트Claude가 한 대화에서 한 번에 다루는 정보의 양. 가득 찰수록 효율이 떨어집니다.에 떠 있는지 직접 확인해 보세요.

항상 vs 필요할 때 — 요청에 따라 컨텍스트에 올라오는 것이 달라집니다.

• CLAUDE.md — 프로젝트 전체에 늘 적용할 표준·제약·코딩 스타일.
• 스킬 — 가끔만 필요한 전문지식, 매번 두면 거치적거릴 자세한 절차.

스킬은 지금 대화와 같은 컨텍스트에 지식을 더합니다. 스킬이 발동하면 그 지침이 지금 대화에 합류하고, 대화 내내 함께 유지됩니다.

서브에이전트본 대화와 분리된 별도 공간에서 작업을 따로 처리하고 결과만 돌려주는 도우미.는 다릅니다. 일을 받아 분리된 별도 공간에서 따로 처리한 뒤, 결과만 본 대화로 돌려줍니다. 둘이 어떻게 다른지 그림으로 보면 이렇습니다.

스킬은 같은 컨텍스트에 합류, 서브에이전트는 격리된 별도 공간.

그래서 서브에이전트는 다음일 때 씁니다.

• 작업을 분리된 공간에 위임하고 싶을 때.
• 본 대화와 다른 도구 권한이 필요할 때.
• 위임한 일과 내 대화를 격리하고 싶을 때.

반대로 그 전문지식이 지금 대화에 계속 남아 있어야 한다면, 스킬이 맞습니다.

훅정해진 사건(파일 저장 등)이 일어나면 자동으로 실행되는 동작.은 ‘사건(이벤트)’이 일어날 때 발동합니다. 파일을 저장할 때마다 검사 도구를 돌리거나, 특정 도구 호출 직전에 입력을 검증하는 식이죠. 무엇을 요청했는지는 상관없습니다 — 그 사건이 일어나면 자동으로 돕니다.

반면 스킬은 ‘요청’에 발동합니다. 내가 무엇을 어떻게 요청하는지(말투)에 맞춰 켜집니다. 둘이 어떻게 다른지, 아래에서 직접 일으켜 보세요.

트리거 비교 — 이벤트를 일으키거나, 요청을 보내 보세요.

• 훅 — 파일 저장마다 할 동작, 특정 도구 호출 전 검증, Claude 동작에 딸린 자동 부수 작업.
• 스킬 — Claude가 요청을 다루는 방식에 영향을 주는 지식, 판단에 작용하는 지침.

지금까지 본 다섯은 경쟁 관계가 아니라 역할 분담입니다. 한 프로젝트 안에서 보통 이렇게 함께 쓰입니다.

한 프로젝트 안의 다섯 역할 — 각자 잘하는 일이 따로 있습니다.

정답을 먼저 떠올려 본 뒤 골라 보세요. 맞히면 설명이 나옵니다.