Claude Code 맞춤화 가이드: CLAUDE.md, Slash 명령어, Subagent, Skill 완전 해부

Claude Code(2026년 기준)의 프로젝트 자동화 및 컨텍스트 관리 방식은 네 가지 핵심 수단(CLAUDE.md, Slash 명령, Subagent, Skills)으로 요약할 수 있습니다. 이 글은 각 방식을 실제 개발 시나리오(Dexie.js 기반 운동 기록 앱)에서 어떻게 활용할 수 있는지 시간순으로 비교하며, 각각의 장단점과 언제 어떤 도구를 써야 할지 직관적으로 안내합니다. 핵심 결론: 문서 검색이나 방대한 정보 정리는 Subagent를, 명확한 단발성 워크플로우는 Slash 명령을, 자동화된 풍부한 능력 패키징은 Skill을, 항상 프로젝트 전역에 적용하고 싶은 규칙은 CLAUDE.md를 활용하세요!

---

1. 문제의 정의와 글의 흐름

Claude Code는 각 라이브러리의 최신 문서를 완전히 기억하진 못합니다. 따라서 여러분이 "Dexie.js의 최신 사용법"을 물으면, 구식 코드를 제안해 버릴 수 있습니다.

"Claude가 지속적으로 오래된 패턴만 제안하고, liveQuery() 같은 핵심 기능을 깜빡해요."

저자는 Dexie.js 공식 문서를 자동으로 참조하도록 Claude Code에 컨텍스트를 주입하는 4가지 방법(⚡️CLIUDE.md, Slash명령, Subagent, Skill)을 제시합니다. 각 방식의 실제 적용 예시와 장단점, 적합 상황을 상세히 비교합니다.

---

2. CLAUDE.md: 자동 로딩되는 프로젝트 메모리카드

개념 및 특징

CLAUDE.md는 프로젝트 루트 및 서브디렉토리에 둘 수 있는 Markdown 파일로, Claude Code가 모든 대화 세션 시작 시 무조건 읽습니다. 즉, 프로젝트의 '기본 규칙서'나 '메모리 카드'와 같습니다.

"CLAUDE.md: 모든 대화 시작 시 Claude가 읽는 프로젝트 지침 모음."

• CLAUDE.md는 여러 계층(루트, 서브폴더)에 둘 수 있고, 해당 폴더에 접근할 때마다 관련된 CLAUDE.md가 자동 컨텍스트에 추가됩니다.

예시:

• tests/CLAUDE.md: 테스트 규칙
• src/db/CLAUDE.md: DB 규칙
• src/components/CLAUDE.md: 컴포넌트 아키텍처

Dexie.js용 예시

# CLAUDE.md
## Database
Dexie.js 사용 시:
1. https://dexie.org/llms.txt 문서 인덱스를 먼저 받아라
2. react 데이터바인딩은 liveQuery()로
3. 레포지토리 패턴(src/db/) 준수
4. 중복 키로 인한 ConstraintError는 항상 핸들할 것

실제 작동 방식과 한계

Claude는 매 세션마다 "DB 코드 작성 전 Dexie 문서를 먼저 확인하라"고 기억합니다.
단점은 긴 세션에서는 컨텍스트가 밀려 초기 지침을 잊거나 우선순위가 뒤로 밀릴 수 있다는 점입니다.

장단점 정리

• ✅ 제로 유지비, Git공유, 항상 자동로드
• ❌ 세션 길어질수록 '컨텍스트 드리프트(망각)' 발생, 강제력 없음, 대화와 메모리창이 경쟁

---

3. Slash 명령어: 명확한 수동 트리거 워크플로우

개념 및 특징

Slash 명령어는 /command-name 형태로 CLI에서 직접 실행하는 "저장된 프롬프트"입니다. 매크로나 단축키처럼 반복 업무를 빠르게 호출할 때 유용합니다.
특정 명령어는 자동으로도(설명이 상황과 매치될 때) 실행됩니다.

"/dexie-help 명령으로 Dexie.js 최신 문서 기반 안내를 받을 수 있다!"

중첩된 워크플로우나 서브에이전트 병렬구동, 리서치 문서 자동생성을 매크로처럼 구성할 수도 있습니다.

Dexie.js Slash 명령 예시

description: Get Dexie.js guidance with current documentation
allowed-tools: Read, Grep, Glob, WebFetch
---
1. https://dexie.org/llms.txt 문서 인덱스 fetch
2. 질문에 따라 관련 문서 fetch, 답변 작성

복합 예시: 리서치 명령

/research "문제"를 입력하면:

• 웹문서검색 에이전트
• Stack Overflow 에이전트
• 코드베이스 익스플로러 에이전트
  등을 병렬로 실행 -> 정보를 모으고, 마크다운 리포트를 자동 저장합니다.

"여러 리서치 에이전트를 한 번에 병렬로 타스크로 띄우세요."
"문제 분석, 주요 해법, 코드베이스 내 패턴, 추천 접근법, 참고 소스 — 마크다운으로 정리!"

장단점 정리

• ✅ 명확한 수동 실행, 인자 그대로 넘길 수 있음, 터미널 자동완성, 설정 간편
• ❌ 직접 명령어 입력해야 함, 세션 간 지식 유지 안 됨(1회성), 오토트리거는 설명 매치에 의존

---

4. Subagent: 독립 컨텍스트 고수준 전문가

개념 및 특징

Subagent는 독립된 AI '전문가' 인스턴스로, 전체 업무 단위를 위임할 때 활용합니다.
문서 다수 호출 등으로 메인대화 컨텍스트가 과부하될 위험이 있을 때 매우 탁월합니다.

"Subagent: 별도의 Claude 인스턴스가 독립적으로 일 처리 후 결과만 메인 대화에 돌려준다."

💡 특히 Plan 모드일 때 자동으로 Explore형 Subagent가 리포지토리 스캔, 정보 요약을 맡고 메인 세션은 쾌적하게 유지됩니다.

비동기로도 가능해서 메인 세션 입력을 이어가며 Subagent 작업이 끝나길 기다릴 수 있습니다.

Dexie.js Subagent 예시

dexie-specialist.md로 지정:

• 역할, 지침, 타입스크립트/레포지토리 패턴/반응성 패턴 등 모든 팀 규칙 내장
• 모든 Dexie 관련 질문 전 반드시 https://dexie.org/llms.txt 문서 인덱스를 fetch하도록 규정
• 각 업무(스키마 디자인, 쿼리, liveQuery, 에러 핸들링 등) 별로 최신 문서 참고

사용 예

"어떻게 인덱스를 추가하나요?"
Claude는 "Dexie 업무"인 걸 감지, dexie-specialist Subagent에게 위임
Subagent가 필요한 문서만 읽고 정리된 결과만 메인 창에 올려둠

장단점 정리

• ✅ 자동 감지 및 위임, 메인 컨텍스트 오염 최소, 다양한 모델/도구제한 가능
• ❌ 별도 에이전트라 설정 및 관리가 복잡, 실시간 대화는 곤란, 결과만 요약 전달

---

5. Skill: 지원 파일까지 포함한 리치 능력 패키지 (자동 감지)

개념 및 특징

Skill은 여러 참조문서, 스크립트, 템플릿 등도 영역별로 포함하는 구조화된 '능력 모듈'입니다.
Claude가 상황에 맞게 자동으로 인식/적용하는 방식이라, Slash명령과 달리 수동 실행 /...은 불가합니다.

"Skill은 설명 기반 자동감지로 메인 대화에서 곧장 풍부한 워크플로우를 적용한다!"

구성 예시:

• .claude/skills/dexie-expert/ 내
  • SKILL.md, PATTERNS.md, MIGRATIONS.md, scripts/validate-schema.ts 등 포함 가능

Claude가 보는 Skill 구조

"Claude야, 적용 가능한 <available_skills>를 보여줘!"
Claude는 아래처럼 명확하게 현재 인식중인 Skill 목록을 노출할 수 있습니다.

<available_skills>
  <skill>
    <name>dexie-expert</name>
    <description>Dexie.js DB 구현, 쿼리, 라이브쿼리, 마이그레이션 등</description>
  </skill>
  ...
</available_skills>

Skill 내 Subagent 연동

Skill 내 작업에서 필요할 땐,

"Task 도구로 Subagent 생성, 패키지/환경파일 읽고 보고해라"
와 같이 Subagent와 결합된 복합 작업도 패키지화할 수 있습니다.

장단점 정리

• ✅ 자동 감지, 지원파일/템플릿 등 풍부한 구성, 라이브 대화 내 적용, 복합 워크플로우 패키징
• ❌ 실행 여부는 Claude 판정, 세팅 복잡, CLI 수동실행 불가(/... 명령 아님), 메인 컨텍스트 공간 일부 소모

Slash 명령 vs Skill: 차이는 UX + 패키징!

• Slash 명령: 터미널 직접 수동실행
• Skill: 자동감지, 지원파일 묶음 적용

---

6. 언제 무엇을 써야할까?

아래는 각 도구의 능력 비교:

---

7. 결론

• 복잡한 문서 참조, 대량 컨텍스트 작업 → Subagent (특히 'Explore' 타입)
• 명확히 반복할 필요가 있고, 수동 실행 편한 워크플로우 → Slash 명령
• 참고파일/스크립트 기반 자동화 패키징, Claude가 추천해주길 원한다면 → Skill
• 항상 적용할 규칙, 전사 공유규정 → CLAUDE.md

Claude Code를 강력한 협업 AI 비서로 만드는 가장 중요한 진입점은 '적재적소에 맞는 맞춤화 방법'을 고르는 것입니다. 💡
이 가이드를 바탕으로 여러분의 프로젝트 생산성을 극대화해보세요! 🚀