클로드 코드 고급 기능: 스킬·서브에이전트·훅·MCP·자동화 총정리

📅 2026년 10월 21일 · 집중 연구 · 클로드 코드 A to Z 3편 · 2026년 10월 공식 문서 기준

클로드 코드 고급 기능: 스킬·서브에이전트·훅·MCP·플러그인·자동화

💡 한 줄 요약: 고급 기능의 핵심은 ‘한 번 잘 만든 방법을 계속 재사용하고, 사람이 없어도 돌아가게 하는 것’입니다. 스킬은 작업 설명서, 서브에이전트는 분업, 훅은 자동 규칙, MCP는 외부 연결, 플러그인은 묶음 배포, -p와 SDK는 무인 자동화입니다.

📚 클로드 코드 A to Z 시리즈 (전 5편)

1편 · 입문: 클로드 코드 사용법, 설치부터 첫 작업까지
2편 · 핵심 기능: CLAUDE.md·권한 모드·계획 모드·되돌리기
3편 · 고급 기능: 스킬·서브에이전트·훅·MCP·플러그인·자동화 ← 지금 읽는 글
4편 · 활용 사례: 무엇을 만들 수 있나 + 실제 구현 기록
5편 · 수익화: 클로드 코드로 돈을 버는 7가지 길과 함정

📋 이 글에서 알 수 있는 것

스킬·서브에이전트·훅·MCP·플러그인은 각각 무엇이고 어떻게 다를까?
직접 스킬과 서브에이전트를 만드는 방법은?
‘저장할 때마다 자동 검사’ 같은 규칙은 어떻게 거나?
사람 없이 클로드 코드를 돌리는 방법(-p·GitHub Actions·예약 작업·SDK)은?
어떤 상황에 어떤 기능을 고르면 될까?

클로드 코드 고급 기능은 이름이 어려워 보이지만, 모두 ‘반복을 줄이는 장치’라는 공통점이 있습니다. 1·2편이 클로드와 일대일로 대화하며 일하는 법이었다면, 3편은 클로드에게 업무 매뉴얼을 쥐여 주고(스킬), 조수를 붙여 주고(서브에이전트), 규칙을 자동으로 지키게 하고(훅), 다른 서비스와 연결하고(MCP), 이것들을 묶어서 남에게 나눠 주고(플러그인), 마지막으로 사람이 자리에 없어도 일하게 만드는(자동화) 방법입니다. 공식 문서도 클로드 코드 고급 기능을 ‘확장(extensions)’이라는 하나의 지도로 설명합니다.

🧭 클로드 코드 고급 기능 한눈에 보기

기능	한 줄 정의	비유	만드는 곳
스킬(Skill)	특정 작업의 방법을 적은 설명서. 필요할 때 자동으로 불러오거나 /이름으로 실행	업무 매뉴얼	.claude/skills/이름/SKILL.md
서브에이전트	별도 대화창(컨텍스트)에서 일하고 결과만 보고하는 조수	전문 외주 직원	.claude/agents/이름.md
훅(Hook)	특정 순간(파일 수정 후 등)에 반드시 실행되는 명령	자동 체크리스트	.claude/settings.json
MCP	외부 서비스(노션·슬랙·DB 등)와 연결하는 표준 규격	만능 어댑터	.mcp.json 또는 claude mcp add
플러그인	스킬·에이전트·훅·MCP를 묶어 한 번에 설치하는 꾸러미	앱 스토어 앱	/plugin, 마켓플레이스
헤드리스(-p)·SDK	대화창 없이 프로그램·서버에서 클로드 코드를 실행	자동 판매기	터미널·코드

🔎 쉽게 말하면: 식당으로 치면, 스킬은 ‘레시피 카드’, 서브에이전트는 ‘설거지 담당 직원’, 훅은 ‘문 닫기 전 가스 밸브 확인’ 같은 철칙, MCP는 ‘배달 앱과 연결된 주문 단말기’, 플러그인은 ‘프랜차이즈 운영 세트’, 헤드리스·SDK는 ‘무인 주문 키오스크’입니다.

📘 1. 스킬: 업무 매뉴얼을 만들어 재사용하기

스킬은 폴더 하나에 SKILL.md 파일을 넣어 만듭니다. 위쪽 머리말(frontmatter)에 이름과 설명을 적고, 아래에 작업 방법을 적습니다. 클로드는 평소에는 설명 한 줄만 보고 있다가, 지금 작업과 관련 있다고 판단하면 본문을 불러옵니다. 그래서 CLAUDE.md처럼 항상 컨텍스트를 차지하지 않습니다. 직접 /blog-draft처럼 이름으로 실행할 수도 있습니다.

---
name: blog-draft
description: 블로그 글 초안을 정해진 구조로 작성할 때 사용
---
# 블로그 초안 작성 순서
1. 주제와 관련된 최신 자료를 3곳 이상 찾는다
2. 제목은 40자 안팎, 핵심 키워드를 앞에
3. 도입 → 본문 3단락 → 자주 묻는 질문 3개 → 참고 자료 순서
4. 숫자에는 기준 날짜와 출처를 붙인다
5. 완성 후 글자 수를 세어 보고한다

저장 위치	적용 범위
~/.claude/skills/이름/SKILL.md	모든 프로젝트에서 본인이 사용
.claude/skills/이름/SKILL.md	이 프로젝트(팀과 공유 가능)
플러그인 안	플러그인을 설치한 모든 사람

💡 초보자 팁: 같은 설명을 대화창에 세 번 이상 붙여 넣었다면 스킬로 만들 때입니다. 스킬 폴더에는 서식 파일이나 스크립트를 함께 넣어 둘 수 있어, ‘엑셀 보고서 만들기’ 같은 작업도 매번 같은 품질로 반복할 수 있습니다.

👥 2. 서브에이전트: 일을 나눠 맡기기

서브에이전트는 자기만의 컨텍스트 창에서 일하고 요약만 돌려주는 조수입니다. 파일 수십 개를 뒤지는 조사를 메인 대화에서 하면 컨텍스트가 금방 차지만, 서브에이전트에게 맡기면 메인 대화는 깨끗하게 유지됩니다. 역할마다 쓸 수 있는 도구와 모델을 제한할 수도 있습니다. /agents로 만들거나, 파일을 직접 작성합니다.

---
name: fact-checker
description: 글 속 숫자·날짜·출처를 검증할 때 사용. 글을 쓴 뒤 반드시 호출
tools: Read, Grep, WebSearch, WebFetch
model: sonnet
---
너는 사실 확인 담당이다. 글에 나온 모든 숫자와 날짜를
원 출처에서 다시 찾아 맞는지 확인하고,
틀린 줄·확인 불가인 줄을 표로 보고한다. 글은 직접 고치지 않는다.

공식 문서가 권하는 활용법은 ‘쓰는 사람과 검토하는 사람 분리’입니다. 한 대화에서 코드를 쓰면 자기 코드에 관대해지기 쉬우므로, 깨끗한 컨텍스트의 서브에이전트(또는 별도 대화)에게 검토를 맡기면 놓친 문제를 더 잘 찾습니다.

🪝 3. 훅: 반드시 지켜야 할 규칙 자동화

CLAUDE.md의 규칙은 ‘권고’라서 클로드가 가끔 잊을 수 있습니다. 반면 훅은 정해진 순간에 반드시 실행되는 명령입니다. 예를 들어 “파일을 고칠 때마다 자동 정렬(포맷) 실행”, “.env 파일 수정 시도는 차단”, “작업이 끝나면 알림 보내기”를 걸 수 있습니다.

주요 시점(이벤트)	언제	활용 예
PreToolUse	도구 실행 직전	위험한 명령·보호 파일 수정 차단(종료 코드 2면 차단)
PostToolUse	도구 실행 직후	파일 수정 후 자동 포맷·린트
UserPromptSubmit	사용자가 지시를 보낼 때	지시에 날짜·규칙 자동 첨부
Notification	클로드가 허락·입력을 기다릴 때	데스크톱·휴대폰 알림
Stop	클로드가 응답을 마칠 때	테스트 자동 실행, 완료 알림
SessionStart	대화를 시작·재개할 때	최신 작업 상태를 자동으로 알려 주기

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write \"$CLAUDE_PROJECT_DIR\"" }
        ]
      }
    ]
  }
}

⚠️ 주의: 훅은 사용자 컴퓨터 권한으로 그대로 실행됩니다. 남이 만든 훅이나 플러그인은 내용을 확인한 뒤 설치하세요. /hooks에서 현재 걸린 훅을 볼 수 있습니다.

🔌 4. MCP: 외부 서비스와 연결하기

MCP(Model Context Protocol)는 AI가 외부 도구와 대화하는 공통 규격입니다. 노션 문서 읽기, 구글 드라이브 검색, 슬랙 메시지 보내기, 데이터베이스 조회, 브라우저 조작 등을 클로드 코드 안에서 할 수 있게 해 줍니다. 터미널에서 한 줄로 추가합니다.

# 원격(HTTP) MCP 서버 추가 예시: 노션 연결(공식 문서 예시)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 등록된 서버 보기
claude mcp list

범위(scope)	저장 위치	쓰임
local(기본)	~/.claude.json(이 프로젝트에만 적용)	개인 테스트용 연결
project	.mcp.json(팀과 공유)	팀 전체가 같은 도구 사용
user	~/.claude.json(모든 프로젝트에 적용)	어디서나 쓰는 개인 도구

로그인이 필요한 서비스는 클로드 안에서 /mcp를 입력해 인증합니다. 연결된 MCP가 많을수록 도구 설명이 컨텍스트를 차지하므로, 실제로 쓰는 것만 켜 두는 것이 좋습니다.

🧩 5. 플러그인: 꾸러미로 설치·배포하기

플러그인은 스킬·서브에이전트·훅·MCP 설정을 하나로 묶은 꾸러미입니다. /plugin을 입력하면 공식 마켓플레이스에서 찾아 설치할 수 있고, 회사나 개인이 만든 마켓플레이스(GitHub 저장소 등)를 추가할 수도 있습니다.

/plugin                                  # 플러그인 찾기·관리 화면
/plugin marketplace add 소유자/저장소       # 마켓플레이스 추가
/plugin install commit-commands@claude-plugins-official  # 공식 마켓 예시

이 구조는 5편 수익화와도 연결됩니다. 잘 만든 스킬·플러그인은 팀 표준 도구가 되고, 외부에 공유하거나 교육 자료로 쓸 수 있는 ‘제품’이 됩니다.

🤖 6. 사람 없이 돌리기: 헤드리스·GitHub·예약·SDK

① 헤드리스 모드: claude -p

-p를 붙이면 대화창 없이 한 번 실행하고 결과만 출력합니다. 스크립트나 다른 프로그램 안에서 쓸 수 있고, 결과를 JSON으로 받을 수도 있습니다. 4편의 실제 구현도 이 방식으로 했습니다.

claude -p "이 폴더의 TODO 주석을 모두 찾아 표로 정리해 줘" \
  --allowedTools "Read,Grep" \
  --output-format json

옵션	의미
`--output-format text\|json\|stream-json`	결과 형식(json에는 비용·턴 수 등 정보 포함)
`--allowedTools`	묻지 않고 허용할 도구 목록
`--permission-mode`	권한 모드 지정(acceptEdits 등)
`--continue / --resume`	이전 대화 이어서 실행
`--bare`	CLAUDE.md·훅·MCP 등 자동 불러오기를 건너뛰고 빠르게 시작(CI 권장, 구독 로그인 대신 API 키 필요)
`--max-budget-usd`	비용 상한(달러)에 닿으면 멈춤

② GitHub Actions: 이슈에 @claude

클로드 안에서 /install-github-app을 실행하면 GitHub 앱과 설정 파일이 준비됩니다. 이후 이슈나 PR 댓글에 @claude 이 버그 고쳐 줘라고 쓰면 클로드가 코드를 고쳐 PR을 올립니다. 공식 액션 이름은 anthropics/claude-code-action@v1입니다. 단, GitHub Actions 실행 시간 비용과 API 사용량이 따로 듭니다.

③ 예약 작업과 반복 실행

‘매일 아침 9시에 의존성 업데이트 점검’처럼 정해진 시간에 작업을 실행하는 방법은 네 가지입니다. 컴퓨터가 꺼져 있어도 도는 클라우드 예약 작업(claude.ai/code/routines), 로컬 파일이 필요한 작업용 데스크톱 앱 예약 작업, 저장소 이벤트에 맞춘 GitHub Actions, 그리고 대화가 열려 있는 동안 일정 간격으로 같은 작업을 반복하는 /loop 명령입니다.

④ Agent SDK: 에이전트 제품 직접 만들기

Agent SDK는 클로드 코드를 움직이는 같은 엔진(도구 사용, 에이전트 루프, 컨텍스트 관리)을 파이썬·타입스크립트 라이브러리로 제공합니다. 고객 지원 봇, 문서 정리 에이전트처럼 다른 사람이 쓰는 서비스를 만들 때 씁니다.

# 파이썬 설치: pip install claude-agent-sdk
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for msg in query(
        prompt="reports 폴더의 CSV를 읽고 월별 합계를 요약해 줘",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Glob", "Bash"]),
    ):
        print(msg)

asyncio.run(main())

⚠️ 주의: 공식 문서에 따르면 SDK로 만든 서비스를 다른 사람에게 제공할 때는 API 키 인증을 써야 하며, 사전 승인 없이 Claude.ai 로그인이나 구독 한도를 쓰게 할 수 없습니다. 제품 이름에 ‘Claude Code’를 쓰는 것도 금지되고, ‘○○ Powered by Claude’ 같은 표현은 허용됩니다.

⚡ 7. 병렬 작업: 여러 클로드를 동시에

큰 작업은 여러 클로드에게 동시에 맡길 수 있습니다. Git의 워크트리(worktree) 기능으로 같은 저장소를 폴더 여러 개로 펼쳐 각각 다른 클로드를 실행하면 서로 파일을 덮어쓰지 않습니다. 데스크톱 앱과 웹에서는 여러 작업을 나란히 띄우는 기능이 기본으로 제공되고, 대량의 비슷한 변경을 여러 에이전트에 나눠 처리하는 /batch 명령도 있습니다.

# 클로드 코드 내장 방식(공식 문서): 이름만 주면 워크트리를 만들어 시작
claude --worktree feature-login

# Git 명령으로 직접 만들기
git worktree add ../app-login -b feature-login
cd ../app-login && claude

AI 연산을 많이 쓰는 작업이 늘수록 그 뒤의 데이터센터·전력·자금 수요도 커집니다. AI 기업들이 빚을 내 연산 설비를 늘리는 위험은 AI 회사채 금리와 신용 스프레드 해설에서 숫자로 확인할 수 있습니다.

🗂️ 무엇을 언제 쓰나: 클로드 코드 고급 기능 선택 가이드

이런 상황이면	이 기능	이유
모든 대화에 항상 적용할 사실·규칙	CLAUDE.md	시작할 때마다 자동으로 읽힘
가끔 쓰는 작업 방법·서식	스킬	필요할 때만 불러와 컨텍스트 절약
많이 읽어야 하는 조사, 독립 검토	서브에이전트	메인 대화를 깨끗하게 유지
예외 없이 지켜야 하는 규칙	훅	AI 판단과 무관하게 항상 실행
외부 서비스 데이터·조작	MCP	표준 연결로 도구 추가
팀·외부에 묶어서 공유	플러그인	한 번에 설치·업데이트
정해진 시간·이벤트에 자동 실행	-p, GitHub Actions, 예약 작업	사람 없이 실행
다른 사람이 쓰는 서비스 제작	Agent SDK	제품에 에이전트 엔진 내장

🌍 연결 지도: 고급 기능이 만드는 경제 효과

① 기능 — 스킬·훅·자동화로 ‘한 번 만든 업무 방식’을 무한 반복

⬇

② 1차 영향 — 반복 업무의 사람 시간이 줄고, 품질 편차가 줄어듦

⬇

③ 2차 영향 — 업무 노하우가 스킬·플러그인이라는 ‘파일’로 바뀌어 거래·공유 가능

⬇

④ 영향 분야 — 외주 개발, 사내 자동화, 교육 시장, AI 연산 수요

⬇

⑤ 생활 — 1인 사업자도 팀 수준의 자동화 도구를 갖는 시대

⚖️ 반대 의견과 위험 요인

클로드 코드 고급 기능을 쓸수록 보안 위험도 커집니다. MCP와 플러그인은 외부 코드를 실행하거나 외부 데이터를 읽어 오므로, 악의적인 지시가 숨어 있는 문서(프롬프트 인젝션)나 검증되지 않은 플러그인이 문제를 일으킬 수 있습니다. 믿을 수 있는 출처만 쓰고, 권한을 최소로 주는 것이 원칙입니다.

자동화는 비용도 자동으로 늘립니다. 헤드리스·GitHub Actions·예약 작업은 사람이 보지 않는 사이에도 사용량을 씁니다. --max-budget-usd 같은 예산 상한과 사용량 확인 습관이 필요합니다.

✅ 클로드 코드 고급 기능을 읽는 포인트

포인트	설명
작게 시작	스킬 하나, 훅 하나부터 만들어 효과를 확인
항상 vs 가끔	항상은 CLAUDE.md, 가끔은 스킬, 반드시는 훅
분업으로 컨텍스트 절약	조사·검토는 서브에이전트에게
연결은 최소한	MCP·플러그인은 실제로 쓰는 것만
무인 자동화는 제한과 함께	도구 목록·턴 수·예산 한도를 정해 두기

📘 함께 알면 좋은 용어

MCP(Model Context Protocol): AI 앱과 외부 도구·데이터를 연결하는 공개 표준. 한 번 만든 MCP 서버를 여러 AI 도구에서 쓸 수 있습니다.

헤드리스(Headless): 사람이 보는 화면 없이 명령만으로 실행하는 방식. 자동화 스크립트와 서버에서 씁니다.

워크트리(Worktree): Git 저장소 하나를 여러 폴더로 동시에 펼쳐 각각 다른 작업을 하는 기능.

❓ 자주 묻는 질문

Q1. 스킬과 CLAUDE.md는 무엇이 다른가요?
CLAUDE.md는 모든 대화에서 항상 읽히는 기본 규칙이고, 스킬은 관련 작업을 할 때만 불러오는 작업 설명서입니다. 가끔 쓰는 긴 절차는 스킬로 만드는 것이 컨텍스트를 아끼는 방법입니다.

Q2. MCP는 어떻게 추가하나요?
터미널에서 claude mcp add --transport http 이름 주소 형식으로 추가하고, 로그인이 필요한 서비스는 클로드 안에서 /mcp로 인증합니다. 팀과 공유하려면 project 범위로 추가해 .mcp.json에 저장합니다.

Q3. 클로드 코드를 자동으로 실행할 수 있나요?
claude -p 명령으로 대화창 없이 실행할 수 있고, GitHub Actions에서 @claude로 호출하거나 웹·데스크톱 앱의 예약 작업으로 정해진 시간에 실행할 수 있습니다. 직접 서비스를 만들 때는 Agent SDK를 씁니다.

➡️ 4편 예고: 그래서 무엇을 만들 수 있을까? 난이도별 아이디어 20가지와 바로 쓸 수 있는 지시문, 그리고 프롬프트 하나로 계산기 웹앱을 만들고 테스트까지 통과시킨 실제 구현 기록(소요 시간·비용 포함)을 공개합니다.

📚 함께 읽으면 좋은 글

AI 연산 계약으로 본 스페이스X 실적 — 자동화가 늘수록 커지는 AI 연산 수요가 실제 기업 실적에서 어떻게 나타나는지 볼 수 있습니다.

참고 자료

Claude Code 공식 문서 – 확장 기능 개요 · Claude Code 공식 문서 – 스킬 · Claude Code 공식 문서 – 서브에이전트 · Claude Code 공식 문서 – 훅 가이드 · Claude Code 공식 문서 – MCP · Claude Code 공식 문서 – 플러그인 · Claude Code 공식 문서 – 프로그래밍 방식 실행(-p) · Claude Code 공식 문서 – GitHub Actions · Claude Agent SDK 개요

⚠️ 이 글은 2026년 10월 기준 Anthropic 공식 문서와 공개 보도를 바탕으로 정리한 정보 제공용 콘텐츠입니다. 기능·요금·명령어는 업데이트로 바뀔 수 있으니 실제 사용 전 공식 문서를 확인하세요. 특정 상품의 구매나 투자를 권유하지 않습니다.