클로드 코드 MCP·Skills·Hooks·Sub-agents, 4가지 중 뭘 골라야 할까?

"AI가 왜 이것밖에 못 하지?" 이 답답함의 정체

클로드 코드(Claude Code)를 처음 써보면 솔직히 놀랍습니다. 터미널에서 자연어로 명령을 내리면 코드를 직접 고치고, 테스트를 돌리고, 파일까지 정리해 주니까요.

그런데 좀 쓰다 보면 어느 순간 이런 질문들이 생깁니다.

"왜 슬랙 메시지는 못 읽지?", "왜 우리 팀 코딩 규칙을 자꾸 까먹지?", "왜 어제 잡은 실수를 오늘 또 하지?"

이 답답함의 원인은 모델이 멍청해서가 아닙니다. 클로드 코드가 '기본 상태'에서는 여러분의 업무 환경에 맞게 세팅되어 있지 않기 때문입니다.

앤트로픽(Anthropic)에서 클로드 코드를 직접 개발하는 엔지니어 데이지 홀만(Daisy Hollman)은 이렇게 말했어요. "에이전트를 코드베이스에 맞추는 가장 빠른 방법은 더 똑똑한 모델이 아니라 더 빡빡한 피드백 루프입니다."

오늘은 클로드 코드를 진짜 내 것으로 만드는 4가지 커스텀 도구, MCP, Skills, Hooks, Sub-agents를 언제 어떻게 구분해서 써야 하는지 실무 관점에서 정리해 드릴게요.

클로드 코드, 그냥 코딩 도구가 아닙니다

클로드 코드는 에이전틱(Agentic) 코딩 도구입니다. '에이전틱'이라는 말이 낯설 수 있는데, AI가 단순히 답변만 하는 게 아니라 실제로 행동을 취한다는 뜻이에요. 코드를 읽고, 수정하고, 터미널 명령어를 실행하고, 결과를 확인하는 루프를 스스로 돌립니다.

기존 깃허브 코파일럿(GitHub Copilot)이 "코드 자동완성 도구"라면, 클로드 코드는 "업무를 통째로 처리하는 AI 동료"에 가깝습니다.

성장세도 놀라운데요, 2026년 2월 기준으로 공개 깃허브(GitHub) 커밋의 4%, 하루 약 13만 5천 건이 클로드 코드로 작성된다는 통계가 있습니다. 앤트로픽 내부 코드의 90%는 이미 AI가 작성하고 있다고 해요. 리서치 프리뷰 이후 13개월 만에 42,896배 성장한 수치입니다. 숫자가 좀 비현실적으로 느껴질 정도죠.

그런데 이 강력한 도구가 제 실력을 발휘하려면 반드시 커스텀 세팅이 필요합니다.

커스텀이 필요한 3가지 근본 이유

클로드 코드를 있는 그대로 쓰면 왜 아쉬울까요? 문제는 세 가지입니다.

첫째는 접근(Access) 문제입니다. 여러분의 업무 맥락은 터미널 안에만 있지 않습니다. 의사결정은 슬랙에서 이루어지고, 디자인 문서는 피그마(Figma)에 있고, 이슈 관리는 지라(Jira)에 있습니다. 사람은 창을 전환하며 이 정보들을 종합하지만, 클로드는 알려주지 않으면 접근 자체가 안 됩니다.

둘째는 지식(Knowledge) 문제입니다. "우리 팀은 함수명을 영어 동사로 시작한다", "고객을 '사용자'가 아니라 '고객사'라고 부른다" 같은 암묵적인 규칙들을 클로드는 모릅니다. 파인튜닝(Fine-tuning)으로 해결하려 하면 오히려 환각(Hallucination) 현상이 늘어나서 역효과가 납니다.

셋째는 피드백 루프(Feedback loop) 문제입니다. "절대 이렇게 하지 마"라고만 강요하는 방식으로는 실수를 막기 어렵습니다. 사람도 빨간 밑줄이 그어져야 다시 한번 확인하는 것처럼, AI에게도 적절한 자동 개입이 필요합니다.

컨텍스트 윈도우를 모르면 비용이 새어 나갑니다

커스텀 도구를 고르기 전에 반드시 이해해야 할 개념이 있어요. 바로 컨텍스트 윈도우(Context Window)입니다.

컨텍스트 윈도우란 AI가 한 번의 세션에서 기억할 수 있는 정보의 양입니다. 사람으로 치면 단기 기억 용량이라고 보면 돼요. 최신 모델도 이 용량에는 한계가 있어서, 코드베이스와 사내 문서 전체를 한꺼번에 넣을 수는 없습니다.

더 중요한 건 비용 구조입니다. 컨텍스트 윈도우 앞쪽 내용을 수정하면, 뒤쪽 내용을 다시 처리하느라 약 10배 더 비싼 비용이 발생합니다.

실제로 200k 토큰 컨텍스트 윈도우를 가진 모델이라도, MCP 서버를 너무 많이 활성화하면 실제 사용 가능한 영역이 70k 수준으로 줄어들 수 있다는 사례도 있습니다. 전략이 필요한 이유가 여기 있어요.

변하지 않는 팀 규칙이나 프로젝트 맥락은 앞단에 안정적으로 두고, 실제 작업 내용은 뒤쪽에 붙이는 방식으로 구성해야 합니다. "쓰지 않는 것에는 비용을 내지 마라"는 원칙이 여기서 가장 중요합니다.

MCP: 외부 세계와 연결하는 표준 규격

이제 본론입니다. MCP(모델 컨텍스트 프로토콜)는 AI와 외부 시스템을 연결하는 표준 규격입니다. USB-C처럼, 어떤 서비스든 이 규격에 맞추면 클로드와 연결할 수 있어요.

슬랙 메시지 읽기, 지라 이슈 생성, 깃허브 PR 관리, 데이터베이스 쿼리 같은 외부 시스템 연동이 필요할 때 빛을 발합니다. OAuth 인증도 지원해서 보안이 중요한 엔터프라이즈 환경에서도 쓸 수 있어요.

다만 오해하지 말아야 할 점이 있어요. 내가 이미 로컬 컴퓨터에서 쓸 수 있는 명령어(CLI)가 있다면, 굳이 MCP로 포장할 필요가 없습니다. MCP가 진짜 필요한 순간은 슬랙, 지라, 깃허브처럼 외부 서비스와 연동해야 할 때, 또는 팀 외부에 배포할 도구를 만들 때입니다.

한 가지 실전 팁을 드리자면, 설정 파일에 20~30개 MCP 서버를 등록해두더라도 실제로 활성화하는 것은 10개 이하, 활성 도구는 80개 이하로 유지하는 게 좋습니다. 등록만 해두고 실제로 안 쓰는 서버도 컨텍스트를 잡아먹기 때문이에요.

Skills: 상황별로 불러오는 지식 파일

Skills는 마크다운(.md) 파일로 작성하는 지식 문서입니다. "이런 상황에서는 이렇게 해줘"라는 지침을 자연어로 써두면, 클로드가 해당 상황에서 이 파일을 읽고 행동합니다.

만들기가 매우 쉽다는 게 장점입니다. 예를 들어 커밋 전 변경 사항 요약 스킬이라면, git diff HEAD 명령어를 실행하고 변경 내용을 2~3줄로 요약하라는 지침만 파일에 써두면 됩니다.

2025년 12월 앤트로픽이 공개한 에이전트 스킬 오픈 스탠다드(Agent Skills Open Standard) 이후, 동일한 SKILL.md 파일이 클로드 코드(Claude Code), 오픈AI 코덱스 CLI(OpenAI Codex CLI), 구글 안티그래비티(Google Antigravity) 등 여러 에이전트에서 호환되도록 발전했어요.

단점은 스킬이 너무 많아지면 관리가 어려워진다는 것입니다. 클로드가 "지금 어떤 스킬을 써야 하지?"를 판단하기 위해 모든 설명을 로드하는 비용이 생깁니다. 스킬 파일의 설명(description)을 정확하고 간결하게 써두는 게 핵심이에요.

Hooks: 토큰 0원으로 작동하는 자동 감시자

4가지 도구 중에서 가장 강력하게 추천되는 것이 Hooks입니다. 에이전트 루프에서 특정 이벤트가 발생했을 때, 로컬 컴퓨터에서 명령어를 자동 실행하고 그 결과를 컨텍스트에 넣을지 결정하는 방식입니다.

핵심 장점은 토큰을 전혀 쓰지 않는다는 점이에요. 예를 들어 파일 수정이 일어날 때마다 자동으로 코드 포맷터(Prettier)를 돌리거나, 클로드가 작업을 마쳤을 때 맥(Mac) 데스크톱에 알림을 보내도록 설정할 수 있습니다.

"항상 실행되어야 하는 작업에는 프롬프트가 아니라 Hooks를 사용하라"는 것이 클로드 코드 공식 가이드의 원칙입니다. 이 자동화 규칙들이 AI 입장에서 빨간 밑줄처럼 작동해서 실수를 잡아줘요. AI에게 돈을 한 푼도 안 내면서 피드백 루프를 만드는 방법은 Hooks가 유일합니다.

Sub-agents: 독립된 전문가를 팀으로 운영하기

서브 에이전트(Sub-agents)는 특정 역할에 특화된 별도의 AI 인스턴스입니다. "코드 리뷰어", "보안 검사자", "문서 작성자"처럼 역할을 나눠서 각자 독립된 컨텍스트 윈도우에서 일합니다.

메인 AI와 분리된 컨텍스트에서 작동하기 때문에, 메인 루프의 소중한 컨텍스트를 낭비하지 않습니다. 여러 작업을 병렬로 처리할 수 있어 속도도 빠릅니다.

실무 팁을 하나 드리자면, 자동 위임보다 "@에이전트명"으로 명시적으로 호출하는 방식을 추천합니다. 클로드가 어떤 서브 에이전트를 써야 할지 자동으로 판단하는 기능이 있긴 하지만, 원하는 대로 작동하지 않을 때가 있거든요. description 필드에 "PROACTIVELY use"나 "MUST use" 같은 키워드를 넣으면 자동 위임 정확도가 높아집니다.

하이퍼리즘(Hyperithm) 개발팀 사례에서는 SubAgent를 통한 전문화된 에이전트 생성과 Hook을 통한 보안 강화를 결합해 개발 프로세스의 효율성과 안정성을 크게 끌어올렸다는 결과를 공개하기도 했어요.

CLAUDE.md에 모든 걸 넣으면 안 되는 이유

클로드 코드를 처음 쓰면 자연스럽게 CLAUDE.md 파일에 모든 규칙과 맥락을 집어넣게 됩니다. 간단해 보이고 관리하기 쉬워 보이기 때문이에요.

하지만 여기에 치명적인 함정이 있습니다. CLAUDE.md는 매 세션마다 무조건 로드됩니다. 한국어 이메일 작성 규칙을 써뒀는데, 지금 하는 작업이 영문 코드 리뷰라면? 그 규칙은 이번 세션과 전혀 관계없지만 이미 토큰 비용을 지불한 겁니다.

클로드 코드를 만든 엔지니어들도 "CLAUDE.md는 매우 비싼 추상인데, 저렴해 보인다"고 직접 말했어요. 파일 하나라서 스케일되는 것처럼 보일 뿐이라고요.

원칙은 이렇습니다. "언제나 필요한 것"만 CLAUDE.md에 넣고, "특정 상황에서만 필요한 것"은 Skills나 Sub-agents로 분리하세요. 항상 켜져 있는 라디오에는 꼭 필요한 채널만 틀어놔야 합니다.

4가지를 실무에서 어떻게 조합할까

4가지 도구는 서로 배타적이지 않습니다. 실무에서는 이렇게 조합해서 씁니다.

스타트업 개발팀 기준으로 예를 들면, 슬랙과 깃허브 연동은 MCP로 처리하고, 코딩 컨벤션과 커밋 메시지 규칙은 Skills로 작성합니다. 파일 저장 시 자동 포맷팅과 테스트 실행은 Hooks에 맡기고, 코드 리뷰와 보안 검사는 각각 Sub-agent로 분리합니다.

이 구조의 핵심 아이디어는 비동기(Asynchrony)와 병렬성(Parallelism)입니다. 컴퓨터 앞을 떠나 커피를 마시는 동안에도 에이전트가 일을 계속하고, 여러 작업이 동시에 진행되는 구조를 만드는 거예요.

국내 스타트업 히로인스(Heroins) 사례에서는 클로드 코드와 스펙 주도 개발(SDD)을 결합해 2~3주 걸리던 작업을 1주일로 단축했다는 결과가 발표되기도 했습니다.

에이전트 경제가 온다, 앞으로 어떻게 바뀔까

클로드 코드를 둘러싼 생태계는 빠르게 변하고 있습니다. 실제로 클로드 코드와 사용자 간의 관계도 시간이 갈수록 진화합니다. 처음 50회 세션에서는 자동 승인율이 약 20%에 불과하지만, 750회 이상 사용하면 40%를 넘어선다는 연구 결과도 있어요. 쓸수록 서로를 더 신뢰하게 되는 구조입니다.

동시에 클로드 코드는 이제 단순 코딩 도구를 넘어 일반 컴퓨터 자동화 도구로 진화하고 있습니다. 코드를 짜는 것만이 아니라, 파일을 정리하고, 문서를 만들고, 외부 서비스와 연동하는 모든 반복 업무를 처리하는 방향으로 나아가고 있어요.

앞으로 개발자의 역할은 코드를 직접 짜는 것에서, 어떤 에이전트에게 어떤 권한과 지식을 줄 것인가를 설계하는 방향으로 이동할 겁니다. AI를 쓰는 사람과 AI를 세팅하는 사람 사이의 격차는 앞으로 더 벌어질 것이고요.

마무리: 3가지 원칙만 기억하세요

클로드 코드 커스텀이 복잡하게 느껴진다면, 딱 세 가지만 기억하면 됩니다.

첫째, 접근 권한을 주세요. 슬랙, 피그마, 지라 등 실제 업무 환경에 클로드가 들어올 수 있게 연결하세요. MCP가 그 역할을 합니다.

둘째, 컨텍스트를 아껴 쓰세요. 항상 필요한 것만 CLAUDE.md에 넣고, 나머지는 Skills나 Sub-agents로 분리하세요. 쓰지 않는 것에 토큰 비용을 내지 마세요.

셋째, 비용이 없는 자동화는 Hooks로 하세요. 토큰 0원으로 피드백 루프를 만드는 가장 강력한 방법입니다.

AI를 단순히 쓰는 것과 자기 업무에 맞게 세팅하는 것은 완전히 다른 게임입니다. 오늘 소개한 4가지 도구로, 클로드 코드를 진짜 나만의 AI 동료로 만들어 보세요.