B-5 확장 — MCP · 스킬

개념한 문장

무엇을 어디에 담을 것인가

규칙을 주는 방법은 하나가 아닙니다. 항상 알아야 할 사실, 가끔 필요한 절차, 반드시 지켜야 할 통제는 각각 다른 곳에 담아야 합니다.

도구	담는 것	로드 시점	강제력
CLAUDE.md	항상 알아야 할 사실	세션 시작 시 항상	맥락 — 확률적
스킬	절차적 작업	호출될 때만	맥락 — 확률적
훅	반드시 지킬 통제	도구 호출 시 자동	코드 — 100% 확정

MCP외부 도구 연결

MCP는 Claude를 외부 시스템에 연결하는 표준입니다. 손으로 복사·붙여넣던 데이터를 Claude가 직접 읽고 씁니다.

claude mcp add --transport http github-docs https://code.claude.com/docs/mcp

claude mcp list

주의MCP 서버 도구는 권한 요청 없이 실행될 수 있습니다. 신뢰하는 서버만 추가하세요.

스킬절차 분리

테스트 실패 분석·배포 순서 같은 절차는 스킬로 옮깁니다. 메인 문맥엔 메타 10줄만 올라가고, 상세는 호출될 때만 로드됩니다.

---
name: test-fix
description: 테스트 실패 로그가 보이거나 "테스트 고쳐줘"라고 할 때 호출.
             실패 원인을 분석하고, 수정 후 재실행까지 직접 수행한다.
---
(상세 절차 — 호출될 때만 로드된다)

디스크립션이 핵심단순히 "테스트 수정"이라고 적으면 자동 호출되지 않습니다. 어떤 상황에서 불러야 하는지를 상세히 적어야 합니다.

훅확정 통제

LLM은 확률적이라 마크다운 규칙만으로는 100% 보장되지 않습니다. 훅은 코드로 도구 호출을 검사·차단합니다.

비유자판기에 500원을 넣으면 100% 커피가 나옵니다. 훅은 확률에 의존하지 않는 통제입니다.

쓰는 예	동작
.env 수정 차단	edit/write 시도 → 훅이 검사 → 차단
편집 후 자동 포맷	파일 수정 후 → lint·format 자동 실행

성능 주의훅은 파일 수정 때마다 실행됩니다. 무분별하게 추가하면 느려집니다 — 꼭 필요한 곳에만.

클로드코드 시작하기트랙 B · 개발자