Claude Code를 일상 도구로: Claude.md, Skills, Subagents, Plugins, MCPs 활용법

Who Should Read

Claude Code를 도입했지만 기본 사용에 그치고 있는 개발자. 팀 프로젝트에서 AI 코딩 워크플로우를 체계화하고 싶은 엔지니어.

Core Mechanics

• Claude.md 파일은 프로젝트 루트에 두는 컨텍스트 파일로, Claude Code가 코드베이스 구조·코딩 컨벤션·팀 규칙을 자동으로 읽어들이게 만드는 핵심 설정파일임.
• Skills는 반복적으로 쓰는 작업 패턴(예: PR 작성, 테스트 생성)을 재사용 가능한 단위로 정의해두는 기능으로, 매번 같은 프롬프트를 타이핑하는 수고를 없애줌.
• Subagents는 Claude Code 안에서 독립적인 하위 작업을 병렬로 처리하는 구조로, 큰 태스크를 여러 에이전트가 나눠 처리하게 위임할 수 있음.
• Plugins는 Claude Code의 기능을 확장하는 방식으로, 특정 도메인(예: DB 마이그레이션, 배포 스크립트)에 특화된 동작을 추가할 수 있음.
• MCP(Model Context Protocol)는 외부 서비스(GitHub, Jira, Slack 등)를 Claude Code에 연결하는 표준 프로토콜로, 도구 호출을 통해 실제 시스템과 상호작용 가능하게 함.
• 이 다섯 가지 레이어를 조합하면 단순 코드 자동완성을 넘어 프로젝트 전체 워크플로우를 AI가 주도하는 'Daily Driver' 환경을 구성할 수 있음.

Evidence

• 논문 본문이 제공되지 않아 정량적 벤치마크 수치를 확인할 수 없음. 제목 및 구조 기반으로 실용 가이드 성격의 논문으로 판단.
• Claude.md, Skills, Subagents, Plugins, MCPs 5가지 핵심 컴포넌트를 체계적으로 다루는 구성으로, Anthropic의 Claude Code 공식 기능 스택을 망라하는 내용으로 추정됨.

How to Apply

• 프로젝트 루트에 CLAUDE.md 파일을 만들고, 코딩 스타일·디렉토리 구조·자주 쓰는 명령어를 적어두면 Claude Code가 매 세션마다 컨텍스트를 자동으로 파악함.
• 반복적으로 수행하는 작업(예: '이 함수에 대한 단위 테스트 작성')을 Skill로 등록해두면, 팀원 모두가 동일한 품질의 AI 지원을 일관되게 받을 수 있음.
• GitHub, Jira 같은 외부 시스템을 MCP로 연결하면 Claude Code가 이슈를 직접 읽고 커밋 메시지를 자동 생성하거나 PR을 열 수 있는 풀 사이클 자동화가 가능함.

Code Example

# CLAUDE.md 예시

## 프로젝트 개요
- Next.js 14 App Router 기반 SaaS 프로젝트
- TypeScript strict 모드 사용
- 테스트: Vitest + Testing Library

## 코딩 컨벤션
- 컴포넌트는 함수형만 사용, default export 금지
- API 라우트는 `/app/api/` 하위에 위치
- 에러 처리는 Result 타입 패턴 사용

## 자주 쓰는 명령어
- `pnpm dev` : 개발 서버
- `pnpm test` : 전체 테스트
- `pnpm db:migrate` : DB 마이그레이션

## MCP 연결 설정 (.claude/settings.json)
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-token>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    }
  }
}

Terminology

관련 논문

• ctx – 로컬 머신의 코딩 에이전트 히스토리를 검색하는 CLI 도구

  Claude Code, Cursor, Codex 등 코딩 에이전트가 이전 세션의 논의·결정·실패 시도를 잊지 않도록 SQLite로 인덱싱해 재사용할 수 있게 해주는 오픈소스 CLI 도구다.

• Micro-Agent: Model API 내부 협업으로 Frontier 모델을 이기는 방법 (vLLM Semantic Router)

  vLLM 팀이 단일 모델 API 호출 뒤에서 여러 모델이 협업하는 'Micro-Agent' 개념을 공개했습니다. 별도의 에이전트 코드 없이 라우터 레이어에서 모델 조합을 실행해 GPT-4급 결과를 더 저렴하게 낼 수 있다는 아이디어입니다.

• Ornith-1.0: 에이전틱 코딩을 위한 자기 개선형 오픈소스 모델

  Gemma 4와 Qwen 3.5를 기반으로 파인튜닝한 코딩 특화 오픈소스 모델로, RL(강화학습)을 통해 스캐폴드(에이전트 실행 구조)까지 함께 최적화하는 방식을 주장하지만, 커뮤니티에서는 벤치마크 과최적화에 불과하다는 의심을 받고 있다.

• Tool-Augmented Agent에서의 Entity Binding 실패 분석

  AI 에이전트가 올바른 도구를 선택해도 잘못된 대상에 실행하는 'Entity Binding 실패' 문제를 정의하고, 이를 막는 실행 정책을 평가한 논문.

• Herdr: 터미널에서 여러 AI Agent를 한 번에 관리하는 Agent Multiplexer

  여러 AI 코딩 에이전트(Claude, Codex 등)를 하나의 터미널에서 동시에 실행·관리할 수 있는 Rust 기반 오픈소스 툴로, tmux처럼 세션이 유지되고 SSH로 원격 접속도 가능해 멀티 에이전트 워크플로우를 크게 단순화해준다.

• Ornith-1.0: 스스로 Scaffold를 생성하는 Agentic Coding LLM

  모델이 문제 풀이 전략(scaffold)을 직접 생성하고 개선하는 자기강화 학습 프레임워크를 적용한 오픈소스 코딩 특화 LLM으로, 9B 소형 모델부터 397B 대형 모델까지 라인업을 갖추고 SWE-Bench 등 주요 벤치마크에서 Claude Opus 4.7을 능가하는 성능을 보여줬다.

Related Resources

• https://docs.anthropic.com/en/docs/claude-code
• https://github.com/anthropics/claude-code
• https://modelcontextprotocol.io