Claude Code 당신의 새로운 AI 팀원

Claude Code의 핵심 확장 기능인 스킬(Skills), 서브에이전트(Subagents), 훅(Hooks)은 에이전트 루프 내에서 각기 다른 역할을 수행하며, 목적, 실행 방식, 컨텍스트 관리 측면에서 명확한 차이가 있습니다. 요청하신 대로 강조 스타일을 제거하여 다시 정리해 드립니다.

### 1. 기능별 핵심 역할 및 특징

스킬 (Skills): 재사용 가능한 지식 및 워크플로우
* 정의: 스킬은 Claude가 필요할 때 불러와서 사용할 수 있는 지식, 절차, 또는 워크플로우를 정의한 마크다운 파일입니다. /deploy나 /review와 같이 사용자가 직접 호출하거나, 작업 내용에 따라 Claude가 자동으로 로드하여 사용할 수 있습니다.
* 목적: API 문서나 코딩 컨벤션 같은 참조 자료를 제공하거나, 배포 및 코드 리뷰와 같은 반복적인 작업을 수행하도록 지시하는 데 사용됩니다.
* 컨텍스트: 세션 시작 시 설명(description)만 로드되며, 실제 사용될 때 전체 내용이 컨텍스트에 로드되므로 컨텍스트 비용이 효율적입니다.,

서브에이전트 (Subagents): 격리된 환경의 전문 작업자
* 정의: 서브에이전트는 메인 세션과 분리된 자체 컨텍스트 윈도우(context window)를 가진 독립적인 실행 단위입니다. 메인 에이전트가 작업을 위임하면, 서브에이전트가 작업을 수행한 뒤 요약된 결과만을 메인 세션으로 반환합니다.
* 목적: 수많은 파일을 읽어야 하는 리서치 작업이나 복잡한 구현 등 메인 세션의 컨텍스트를 오염시키지 않고 집중적인 작업을 수행해야 할 때 적합합니다.
* 컨텍스트: 메인 대화와 완전히 격리된 새로운 컨텍스트에서 실행되므로, 메인 세션의 토큰 한도를 절약할 수 있습니다.,

훅 (Hooks): 결정론적 자동화 스크립트
* 정의: 훅은 특정 이벤트(파일 편집, 도구 사용, 세션 시작 등) 발생 시 자동으로 실행되는 쉘 스크립트(Shell commands)입니다. LLM(거대언어모델)의 추론을 거치지 않고 규칙에 따라 즉각적이고 결정론적으로 실행됩니다.
* 목적: 파일 편집 후 린트(Lint) 실행, 커밋 전 테스트 강제, 특정 파일 수정 차단 등 프로젝트 규칙을 강제하거나 반복적인 작업을 자동화하는 데 사용됩니다.
* 컨텍스트: 외부 스크립트로 실행되므로 기본적으로 Claude의 컨텍스트를 소모하지 않습니다.,

### 2. 비교 요약

* 스킬
* 역할: 지식, 지침, 워크플로우 정의
* 실행 주체: Claude(필요시) 또는 사용자(/명령어)
* 컨텍스트 관리: 필요할 때 메인 컨텍스트에 로드됨
* 주요 사용 사례: API 스타일 가이드, 배포 절차, 코드 리뷰 체크리스트

* 서브에이전트
* 역할: 작업 위임 및 격리된 실행
* 실행 주체: Claude가 위임(Delegate)
* 컨텍스트 관리: 독립된 컨텍스트 사용, 결과만 요약 반환
* 주요 사용 사례: 광범위한 파일 탐색, 병렬 리서치, 특정 도구 제한이 필요한 작업

* 훅
* 역할: 이벤트 기반 자동화 스크립트
* 실행 주체: 시스템 이벤트(편집, 도구 사용 등)
* 컨텍스트 관리: 컨텍스트 비용 없음(외부 실행)
* 주요 사용 사례: 자동 포맷팅(Prettier), 민감한 파일 수정 차단, 알림 전송

### 3. 기능 선택 가이드

스킬 대 서브에이전트
Claude에게 작업을 어떻게 수행해야 하는지 지침을 주거나 자주 쓰는 절차를 정의하려면 스킬을 사용하세요. 작업이 너무 방대하여 메인 대화의 문맥을 꽉 채울 것 같거나, 메인 대화와 분리하여 결과를 요약받고 싶다면 서브에이전트를 사용하세요.

스킬 대 훅
LLM의 판단과 유연성이 필요한 작업(예: 이 코드를 우리 팀 스타일대로 리팩토링해줘)은 스킬이 적합합니다. LLM의 판단 없이 무조건 실행되어야 하는 규칙(예: 파일 저장 시마다 무조건 포맷터 실행)은 훅이 적합합니다.

이 세 가지 기능은 상호 배타적이지 않으며 조합하여 사용할 수 있습니다. 예를 들어, 스킬을 사용하여 특정 작업을 정의하고, 그 작업 내에서 서브에이전트를 호출하여 격리된 환경에서 실행하게 하거나, 파일 수정이 일어날 때 훅을 통해 검증을 수행할 수 있습니다.