2026. 05. 18. / TECH · 5 min read
Claude Code에서 Skill과 Agent, 뭐가 다를까
둘 다 Claude를 확장하는 도구지만, 쓰임새는 완전히 다르다
Claude Code를 쓰다 보면 Skill과 Agent라는 개념이 자주 등장합니다.
비슷해 보이지만 역할이 완전히 다릅니다. 언제 어떤 걸 써야 하는지 정리해봤습니다.
Skill: Claude에게 주는 업무 매뉴얼
스킬은 Claude에게 "이런 상황에서는 이렇게 해"라고 알려주는 마크다운 문서입니다.
.claude/skills/ 폴더에 저장된 .md 파일이 스킬의 실체입니다.
Skill("skill-name")을 호출하면 해당 파일이 현재 대화의 컨텍스트에 로드됩니다.
스킬은 현재 대화 안에서 실행됩니다 — 별도 프로세스나 새 인스턴스 없이.
슬래시 커맨드(/review, /ship, /qa)가 스킬을 호출하는 방식입니다.
복잡한 작업의 순서와 규칙을 파일로 정의해두고, 필요할 때 불러쓰는 것입니다.
# 예: /new-blog-post 스킬 파일
## Step 1: 키워드 확인
## Step 2: 뉴스 검색
## Step 3: 기사 선택
...
이렇게 워크플로우를 정의해두면 Claude는 그 절차를 따라 실행합니다.
Agent: 독립된 Claude를 새로 하나 띄우는 것
에이전트는 Agent() 도구로 호출하는 서브 Claude 인스턴스입니다.
현재 대화를 전혀 모르는 채 시작합니다 — 배경 설명 없이 보내면 맥락을 파악하지 못합니다. 백그라운드에서 병렬 실행이 가능하고, 전용 타입도 있습니다.
| 타입 | 용도 |
|---|---|
Explore | 코드베이스 탐색, 파일/심볼 검색 |
Plan | 구현 전략 설계 및 아키텍처 검토 |
general-purpose | 복잡한 멀티스텝 작업 |
claude-code-guide | Claude Code API/CLI 관련 질문 |
에이전트는 작업이 끝나면 단 한 번의 메시지로 결과를 돌려줍니다.
핵심 차이 한눈에 보기
| 특성 | Skill | Agent |
|---|---|---|
| 실행 위치 | 현재 대화 내 | 독립 서브 인스턴스 |
| 컨텍스트 | 공유됨 | 처음부터 시작 |
| 병렬 실행 | 불가 | 가능 |
| 사용 방법 | Skill("name") | Agent({...}) |
| 결과 반환 | 없음 (직접 실행) | 메시지 1개 |
| 주요 용도 | 워크플로우 템플릿 | 독립 작업 위임 |
언제 뭘 쓸까
Skill을 쓸 때:
- 반복되는 작업을 표준화할 때 (블로그 작성, PR 리뷰, 배포 등)
- 현재 대화 컨텍스트가 필요한 작업일 때
- 순서가 중요한 단계별 작업일 때
Agent를 쓸 때:
- 여러 독립 작업을 동시에 처리할 때
- 메인 컨텍스트 창을 보호하고 싶을 때 (대규모 코드 탐색 등)
- 독립적인 판단이 필요한 검증, 리뷰 작업일 때
같이 쓸 수도 있습니다.
스킬이 내부에서 에이전트를 디스패치하는 패턴이 실제로 흔합니다 — 스킬이 "어떻게 할지"를 정의하고, 에이전트가 "실제로 실행"하는 역할 분담입니다.
Skill은 Claude에게 건네는 매뉴얼이고, Agent는 새 직원 한 명을 고용하는 것입니다.
매뉴얼만 있으면 내가 직접 처리하고, 일이 많거나 독립적이면 직원을 따로 씁니다.
