Claude Code를 AI OS로: Skills, Hooks, 서브에이전트 & MCP 2026

대부분의 사람들은 Claude Code를 AI 코딩 어시스턴트로 생각합니다. 그것은 macOS를 "텍스트 에디터"라고 부르는 것과 같습니다.

2026년의 Claude Code는 AI 운영 체제로 더 잘 이해됩니다 — 한 번 구성하면 실행하는 모든 워크플로를 증폭시키는 플랫폼입니다. 아키텍처에는 네 가지 컴포넌트가 있습니다: Skills, Hooks, 서브에이전트, MCP. 함께 사용하면 자동완성이 있는 채팅 인터페이스와는 질적으로 다른 것을 형성합니다.

이 가이드는 각 컴포넌트, 어떻게 서로를 보완하는지, 그리고 처음부터 자신만의 AI OS를 구축하는 방법을 설명합니다.

네 기둥: 멘탈 모델

설정 전에, 각 컴포넌트가 무엇을 하고 언제 실제로 필요한지에 대한 지도입니다:

컴포넌트	역할	사용 시점
Skills	Claude의 장기 메모리와 전문성	항상 — 기본
Hooks	이벤트에 자동으로 실행되는 반사 작용	품질 게이트와 감사 추적용
MCP	외부 시스템에 대한 실시간 연결	Claude가 라이브 데이터가 필요할 때
서브에이전트	병렬, 격리된 Claude 세션	대규모 또는 독립적인 작업용

이렇게 생각하세요: Skills는 AI의 교육, Hooks는 반사 작용, MCP는 감각, 서브에이전트는 손입니다.

기둥 1: Skills — 장기 메모리

Skills는 Claude에게 특정 상황에서 어떻게 동작해야 하는지를 알려주는 Markdown 파일입니다. ~/.claude/skills/ (전역) 또는 .claude/skills/ (프로젝트별)에 넣으면 Claude가 컨텍스트에 따라 관련 파일을 자동으로 로드합니다.

# Skill을 전역으로 설치
mkdir -p ~/.claude/skills/
cp -r downloaded-skill/ ~/.claude/skills/skill-name/

# 또는 하나의 프로젝트에만 설치
mkdir -p .claude/skills/
cp -r downloaded-skill/ .claude/skills/skill-name/

각 Skill에는 Claude가 언제 로드할지를 제어하는 frontmatter가 있는 SKILL.md 파일이 있습니다:

---
name: code-reviewer
description: 코드 변경, 풀 리퀘스트를 리뷰하거나 코드 품질을 평가할 때 사용
---

# 코드 리뷰 가이드라인
[전체 지침 — 관련 있을 때만 로드됨]

아키텍처가 영리합니다: Claude는 세션 시작 시 모든 frontmatter를 스캔합니다 (Skill당 약 20-50 토큰), 그런 다음 작업이 일치할 때만 전체 내용을 로드합니다. 50개 Skills의 라이브러리는 약 2,000 토큰의 오버헤드를 추가합니다 — 장황한 CLAUDE.md 하나보다 훨씬 적습니다.

개발자를 위한 강력한 시작 세트:

• superpowers — 다른 Skills와 서브에이전트를 오케스트레이션하는 메타 Skill
• skill-creator — 새 Skills를 빌드하고 반복하는 데 도움
• mcp-builder — 새 MCP 서버 통합 스캐폴딩
• webapp-testing — 자동화된 브라우저 테스팅 워크플로

기둥 2: Hooks — 자동 반사 작용

Hooks는 Claude Code가 특정 이벤트에서 자동으로 실행하는 셸 명령입니다. ~/.claude/settings.json에서 구성되며 Claude가 무엇을 하든 관계없이 실행됩니다 — 협상 불가능한 규칙에 이상적입니다.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "cd $CLAUDE_PROJECT_DIR && npx tsc --noEmit 2>&1 | head -20"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo \"[$(date)] $CLAUDE_TOOL_INPUT\" >> ~/.claude/logs/bash-audit.log"
          }
        ]
      }
    ]
  }
}

주요 Hook 이벤트:

• PreToolUse — Claude가 도구를 사용하기 전 실행 (안전 검사, 감사 로그)
• PostToolUse — 도구 완료 후 실행 (린팅, 타입 검사, 테스트 실행)
• SessionStart — 새 세션 시작 시 실행 (컨텍스트 로드, 환경 확인)
• SessionEnd — 종료 시 실행 (정리, 요약)

위의 PostToolUse Hook은 모든 파일 편집 후 TypeScript 타입 검사를 실행합니다. Claude가 출력을 즉시 보고 인라인으로 오류를 수정할 수 있습니다 — 수동 tsc 실행 없이, "타입 확인을 잊었다" 사건 없이.

Hook이 Skills보다 가지는 핵심 이점: 무조건적으로 실행됩니다. 프로덕션 경로에서 rm -rf를 차단하는 Hook은 "삭제에 주의하세요"라는 Skill 지침보다 더 신뢰할 수 있습니다. 중요한 규칙은 Hook이어야 합니다.

기둥 3: MCP — 실시간 연결

MCP (Model Context Protocol)는 Claude에게 외부 시스템에 대한 라이브 접근을 제공합니다. Skills는 Claude가 정적으로 아는 것을 인코딩합니다; MCP는 Claude가 동적으로 알아야 할 것을 전달합니다 — 현재 데이터베이스 상태, 열린 PR, API 응답.

~/.claude/mcp.json에서 서버를 구성하세요:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres",
               "postgresql://localhost/mydb"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem",
               "/path/to/your/project"]
    }
  }
}

연결되면 Claude가 데이터 이슈를 디버깅하면서 데이터베이스를 쿼리하고, 코드 리뷰하면서 관련 PR을 확인하고, 내부 문서 서버에서 API 문서를 읽을 수 있습니다.

mcp-builder Skill은 커스텀 내부 서비스를 연결하기 전에 설치할 가치가 있습니다 — 보일러플레이트를 스캐폴딩하고 일반적인 설정에 대한 인증 패턴을 처리합니다.

기둥 4: 서브에이전트 — 병렬 실행

서브에이전트는 Claude가 독립적인 작업을 처리하기 위해 새로운 격리된 세션을 생성할 수 있게 합니다. Skills 내에서 Agent 도구를 통해 호출되며, 자체 컨텍스트 윈도우로 실행되어 무거운 작업이 메인 세션을 오염시키지 않습니다.

코드 리뷰 Skill의 실제 예시:

대규모 풀 리퀘스트(>20 파일)를 리뷰할 때:

1. 독립적인 리뷰 도메인 식별: 보안, 성능, 스타일
2. Agent 도구를 사용하여 세 개의 병렬 서브에이전트 생성:
   - 보안 리뷰: 취약점, 인젝션 위험, 인증 우회 확인
   - 성능 리뷰: N+1 쿼리, 불필요한 리렌더링, 메모리 누수 확인
   - 스타일 리뷰: 네이밍, 구조, 테스트 커버리지 확인
3. 각 서브에이전트는 관련 파일에만 접근
4. 세 결과를 수집하고 통합 리뷰로 합성

superpowers 컬렉션에는 서브에이전트 오케스트레이션을 중심으로 구축된 여러 Skills가 포함되어 있습니다 — 팬아웃 리서치, 병렬 코드 생성, 멀티 에이전트 디버깅과 같은 패턴의 좋은 참고 자료입니다.

서브에이전트의 주요 사용 사례:

• 컨텍스트 격리: 대화 이력을 오염시키지 않고 깊은 리서치가 필요한 작업
• 병렬성: 동시에 실행할 수 있는 독립적인 하위 작업
• 전문화: 부모와 다른 Skills로 구성된 서브에이전트

완전한 개발자 설정

TypeScript 웹 프로젝트에서 네 기둥이 결합된 모습:

~/.claude/                         # 전역 설정
├── CLAUDE.md                      # 당신이 누구인지, 선호도
├── skills/
│   ├── superpowers/               # 서브에이전트 오케스트레이션
│   ├── skill-creator/             # 새 Skills 빌드
│   └── code-reviewer/             # PR 리뷰 워크플로
├── settings.json                  # Hooks: 편집 후 tsc, bash 감사 로그
└── mcp.json                       # GitHub + 데이터베이스 MCP 서버

.claude/                           # 프로젝트별 설정
├── CLAUDE.md                      # 이 프로젝트: 기술 스택, 주요 담당자
└── skills/
    ├── project-conventions/       # 이 코드베이스의 특정 규칙
    └── deployment/                # 배포 스크립트와 체크리스트

이 설정으로:

• Claude가 상기시키지 않아도 규칙을 알고 있습니다 (Skills)
• 모든 편집 후 타입 오류가 플래그됩니다 (Hooks)
• Claude가 디버깅 시 데이터베이스를 쿼리할 수 있습니다 (MCP)
• 대규모 리뷰가 컨텍스트를 부풀리지 않고 병렬로 실행됩니다 (서브에이전트)

권장 진행 순서

네 가지 컴포넌트가 즉시 모두 필요하지는 않습니다. 투자에 따라 보상이 확장됩니다:

1주차 — Skills만. claudeskills.info를 탐색하고, 워크플로에 맞는 3-5개를 설치하세요. 이것만으로도 Claude가 작업을 처리하는 방식이 눈에 띄게 달라집니다.

2주차 — 가장 중요한 품질 검사(TypeScript, ESLint, 또는 테스트 실행기)를 위한 PostToolUse Hook 하나를 추가하세요.

3주차 — MCP 서버 하나를 연결하세요. GitHub이 가장 쉬운 시작점이며 코드 리뷰 워크플로에 즉시 유용합니다.

2달째 — 작업이 하나의 컨텍스트에 비해 너무 크거나 병렬 실행이 도움이 될 때 서브에이전트 패턴을 추가하세요.

더 큰 그림

Claude Code는 점점 개발자가 전체 스택과 상호작용하는 인터페이스가 되고 있습니다 — 코드 에디터뿐만 아니라 CI 파이프라인, 데이터베이스, 배포 프로세스, 문서까지.

AI OS라는 프레이밍은 비유가 아닙니다. Skills, Hooks, MCP, 서브에이전트가 올바르게 구성되었을 때 일어나는 일의 설명입니다: Claude가 호출하는 도구처럼 느껴지는 것을 멈추고, 프로젝트를 알고, 자동으로 표준을 적용하며, 데이터에 라이브 접근 권한을 가진 협력자처럼 느껴지기 시작합니다.

이 모든 것이 오늘 사용 가능합니다. claudeskills.info에서 시작하여 먼저 워크플로에 맞는 Skills를 찾으세요.