[AI] Claude Code 확장 구조 이해하기

Built-in Tools, Skills, MCP, Hooks, Subagents

Claude Code는 단순한 코드 생성 도구가 아니라, CLI 환경에서 실제 작업을 수행하는 에이전트형 도구를 지향한다. 기본 제공되는 내장 도구만으로도 파일 시스템 접근, 셸 명령 실행, 코드 생성과 같은 작업을 수행할 수 있지만, 실무 환경에서 요구되는 복잡한 워크플로우를 모두 커버하기에는 한계가 있다. 이를 보완하기 위해 Claude Code는 여러 단계의 확장 메커니즘을 제공하며, 이들은 하나의 에이전트 루프 위에 계층적으로 구성되어 있다.

이 문서에서는 Claude Code의 확장 구조를 내장 도구 → Skills → MCP → Hooks → Subagents 순서로 설명하고, 각 구성 요소가 어떤 역할을 수행하는지 정리한다.

Claude Code의 가장 하위 레이어는 내장 도구(Built-in Tools) 이다. 내장 도구는 Claude Code 설치 직후 바로 사용할 수 있는 기본 기능으로, 로컬 환경에서 에이전트가 직접 작업을 수행할 수 있도록 한다. 파일을 읽고 쓰거나, 터미널 명령을 실행하고, 그 결과를 해석하는 기능이 여기에 포함된다. 이 레이어는 “AI가 로컬 시스템과 상호작용할 수 있는 최소한의 실행 환경”을 제공하는 역할을 한다. 단순한 스크립트 작성이나 반복 작업 자동화에는 충분하지만, 작업 방식이나 사고 흐름까지 제어하기에는 제한적이다.

이 한계를 보완하는 다음 단계가 Skills다. Skills는 특정 작업을 수행하기 위한 절차적 지식을 Claude Code에 주입하는 방식으로 동작한다. 단순히 결과를 생성하도록 지시하는 것이 아니라, 어떤 순서로 생각하고 어떤 기준으로 판단해야 하는지를 명시한다는 점이 핵심이다. 예를 들어 테스트 주도 개발(TDD)을 강제하거나, 일관된 UI 디자인 시스템을 생성하거나, 문서 작성 규칙을 따르도록 만드는 것이 가능하다. Skills를 적용하면 Claude Code는 요청을 즉시 구현으로 옮기기보다, 설계 → 계획 → 검증 → 구현이라는 엔지니어링 프로세스를 따르게 된다. 이는 Claude Code를 단순한 코드 생성 도구가 아니라, 특정 역할을 수행하는 엔지니어에 가깝게 만든다.

Skills가 “어떻게 일할 것인가”를 정의하는 레이어라면, MCP(Model Context Protocol) 는 “무엇을 참고할 수 있는가”를 확장하는 레이어다. 기존 LLM은 대화 컨텍스트 외부의 정보를 직접 알 수 없기 때문에, 외부 시스템의 상태를 활용하려면 사람이 직접 정보를 전달해야 했다. MCP는 이 문제를 해결하기 위해, 모델과 외부 서비스 사이의 컨텍스트 교환 방식을 표준화한다. Claude Code는 MCP 서버를 통해 Kubernetes 클러스터 상태, 클라우드 리소스 정보, GitHub 데이터, 로그나 메트릭과 같은 외부 데이터를 요청할 수 있으며, MCP 서버는 이를 적절한 권한과 보안 통제 하에 조회해 구조화된 형태로 반환한다. 이 구조 덕분에 모델은 외부 시스템에 직접 접근하지 않으면서도, 실시간에 가까운 맥락을 기반으로 판단할 수 있다.

그 위에 위치하는 확장 요소가 Hooks다. Hooks는 특정 작업이나 이벤트를 트리거로 삼아, 후속 작업을 자동으로 실행하는 메커니즘이다. 예를 들어 코드 생성이 끝난 뒤 자동으로 린트나 테스트를 실행하거나, 테스트 결과에 따라 다음 단계를 이어서 수행하도록 구성할 수 있다. Hooks는 개별 작업을 연결해 하나의 흐름으로 만들며, 반복적인 수작업을 줄이고 워크플로우의 연속성을 확보하는 데 사용된다. 이 단계부터 Claude Code는 단발성 요청 처리보다는, “작업 흐름을 관리하는 에이전트”의 성격을 띠게 된다.

가장 상위 개념에 해당하는 것이 Subagents다. Subagents는 하나의 에이전트가 모든 작업을 처리하는 대신, 작업을 분리해 위임할 수 있도록 하는 구조다. 메인 에이전트가 전체 흐름을 조율하고, 각 Subagent는 테스트 작성, UI 구성, 문서화 등 특정 역할에 집중한다. 이를 통해 작업을 병렬로 처리할 수 있으며, 복잡한 프로젝트에서도 맥락 충돌 없이 역할 기반 협업이 가능해진다. Subagents는 내부적으로 독립적인 컨텍스트를 유지하면서도, 메인 에이전트와 결과를 공유한다.

이 다섯 가지 확장 요소는 서로 독립적인 기능이 아니라, 하나의 에이전트 루프 위에 계층적으로 쌓여 있다. 내장 도구가 실행 기반을 제공하고, Skills가 사고 방식을 규정하며, MCP가 외부 맥락을 연결하고, Hooks가 작업 흐름을 자동화하며, Subagents가 역할 분담과 병렬 처리를 가능하게 한다. 이 구조를 이해하면 Claude Code를 단순한 CLI AI 도구가 아니라, 실제 개발·운영 프로세스를 주도할 수 있는 에이전트 플랫폼으로 활용할 수 있다.

실무 관점에서 이 확장 구조의 의미는 분명하다. Claude Code는 단순히 “코드를 대신 써주는 도구”가 아니라, 외부 시스템의 상태를 이해하고, 정의된 프로세스를 따라 사고하며, 다음 행동을 스스로 이어가는 형태로 진화할 수 있다. 이러한 확장을 적절히 조합하면, AI를 개인 생산성 도구를 넘어 팀 단위 엔지니어링 워크플로우의 일부로 통합하는 것도 충분히 가능하다.