Claude Code를 매일 쓰는 사람의 노하우: Claude.md, Skills, Subagents, Plugins, MCP 총정리

들어가며

Claude Code를 한두 번 써본 분들은 많지만, 하루 종일 메인 IDE처럼 쓰는 사람들의 셋업이 어떤지 궁금하셨던 적 있을 거예요. 이번에 정리된 "Claude Code as a Daily Driver" 글이 딱 그 지점을 다루는데요, 핵심은 Claude Code에 들어있는 다섯 가지 기능 — Claude.md, Skills, Subagents, Plugins, MCP — 을 어떻게 조합해야 "한 번 잘 세팅해두면 알아서 일해주는" 상태가 되는지에 대한 이야기예요.

Claude.md: 프로젝트의 "읽어줘.md"

가장 먼저 손대야 하는 건 CLAUDE.md 파일이에요. 이게 뭐냐면, 프로젝트 루트나 홈 디렉토리에 두는 일종의 상시 컨텍스트 메모예요. Claude Code가 작업을 시작할 때 자동으로 읽어가는 파일이라, 여기에 "우리 프로젝트는 패키지 매니저로 pnpm을 쓴다", "테스트는 vitest 사용", "커밋 메시지는 한글로 작성" 같은 규칙을 적어두면 매번 같은 설명을 안 해도 돼요.

실전 팁은 너무 길게 쓰지 않는 것입니다. CLAUDE.md는 매 요청마다 컨텍스트로 들어가기 때문에, 너무 장황하면 토큰을 잡아먹어요. "이 파일을 보지 않으면 절대 모를 정보"만 추려서 적는 게 좋아요. 코드를 읽으면 바로 알 수 있는 내용(폴더 구조, 패키지 의존성)은 적지 말고, 대신 "왜 이렇게 짰는지", "건드리면 안 되는 영역은 어디인지" 같은 맥락을 넣으세요.

Skills: 재사용 가능한 "능력 모듈"

Skills는 비교적 최근에 추가된 기능인데, 반복되는 작업 패턴을 모듈로 묶어두는 개념이에요. 예를 들어 "PR 설명 작성하기", "릴리스 노트 생성하기", "DB 마이그레이션 스크립트 검토하기" 같은 자주 쓰는 워크플로우를 Skill로 정의해두면, 매번 프롬프트를 길게 쓰지 않아도 일관된 결과를 얻을 수 있어요.

Subagents: 일을 쪼개서 위임하기

Subagent는 "부하 직원"이라고 생각하면 쉬워요. 메인 에이전트가 큰 작업을 받으면, 그 작업을 더 작은 단위로 쪼개서 별도의 컨텍스트를 가진 서브에이전트에게 맡기는 거예요. 이렇게 하면 두 가지 이점이 있어요. 첫째, 메인 컨텍스트가 깨끗하게 유지돼요. 서브에이전트가 코드를 한참 뒤져서 정보를 가져와도 메인 대화창에는 "결과 요약"만 돌려주거든요. 둘째, 병렬 처리가 가능해요. 여러 파일을 동시에 분석하거나, 여러 후보를 동시에 검토할 때 속도가 확 빨라집니다.

실무에서 가장 많이 쓰는 패턴은 "코드 탐색용 서브에이전트" 예요. "이 코드베이스에서 결제 관련 로직이 어디 있는지 찾아줘" 같은 작업을 서브에이전트에 맡기면, 메인 컨텍스트를 오염시키지 않고 깔끔하게 답만 받을 수 있어요.

Plugins와 MCP: 외부 세계와 연결하기

Plugin은 Claude Code의 기능을 확장하는 모듈이고, MCP(Model Context Protocol)는 한 단계 더 큰 그림이에요. MCP는 AI 모델이 외부 도구·데이터에 접근하는 방식을 표준화한 프로토콜이거든요. Anthropic이 만들고 오픈소스로 공개한 후, 지금은 GitHub, Slack, Notion, Linear, Google Drive 등 수많은 서비스가 MCP 서버를 제공하고 있어요.

MCP가 강력한 이유는 "한 번 설정하면 어디서나 쓸 수 있다"는 점이에요. Slack MCP를 붙여두면 Claude Code에서 "어제 #engineering 채널에서 나온 버그 리포트 정리해줘" 같은 요청이 가능해요. Linear MCP를 붙이면 이슈 생성·코멘트·상태 변경을 자연어로 시킬 수 있고요.

다섯 기능을 어떻게 조합할까

저자가 강조하는 핵심은 "한꺼번에 다 깔지 말라"예요. CLAUDE.md부터 시작해서 한 달쯤 써본 뒤, 자주 반복되는 패턴이 보이면 그제서야 Skill로 묶고, 컨텍스트가 자주 터지면 Subagent를 도입하고, 외부 데이터가 필요해지면 MCP를 붙이는 식으로 점진적으로 쌓아 올리는 게 가장 안정적이라는 거예요.

한국 개발자에게 주는 시사점

국내에서도 Claude Code 채택이 빠르게 늘고 있어요. 특히 사내 위키, Jira, GitLab을 MCP로 묶으면 신입 온보딩이나 코드 리뷰 자동화에 큰 도움이 됩니다. 처음에는 CLAUDE.md 한 장으로 시작해서, 팀 단위로 Skill 세트를 공유하는 형태로 발전시키는 걸 추천드려요.

마무리

한 줄 정리: Claude Code의 진짜 힘은 단일 기능이 아니라 다섯 가지를 조합한 워크플로우에서 나옵니다. 도구를 깔기 전에, "내가 매일 반복하는 일이 뭔지"부터 적어보세요.

여러분의 CLAUDE.md에는 어떤 내용이 들어가 있나요? 혹시 가장 자주 쓰는 MCP 서버가 있다면 공유해주시면 좋겠어요.