Claude Code를 일상 도구로 쓰기: Claude.md, Skills, Subagents, Plugins, MCP

Claude Code의 생산성은 단순한 프롬프트 작성을 넘어 메모리, 커스텀 명령, 병렬 세션, 프로젝트 설정을 어떻게 누적하고 검증하느냐에 따라 결정됩니다. 핵심은 Claude가 스스로 결과를 검증할 수 있는 환경을 구축하는 것입니다.

.claude 디렉터리를 활용한 계층형 설정 .claude/ 디렉터리는 프로젝트와 전역 범위를 나누어 관리하는 계층형 설정 시스템 역할을 합니다.

• 프로젝트 범위: 저장소 내 .claude/에 설정하며, Git에 커밋하여 팀과 공유합니다.
• 전역 범위: ~/.claude/에 위치하며, 로컬 머신의 모든 프로젝트에 적용되는 개인 선호도를 담습니다.

주요 구성 요소 및 역할

• CLAUDE.md: 매 세션 로드되는 지침 파일입니다. 짧고 명확하게 유지해야 하며, 빌드 명령과 검증 순서에 집중하는 것이 좋습니다.
• Skills: /name으로 호출 가능한 재사용 가능한 전문 프롬프트입니다.
• Subagents: 별도 컨텍스트에서 리뷰, 디버깅, 마이그레이션을 수행하는 에이전트입니다.
• Rules: 특정 경로에만 적용되는 주제별 지침을 정의할 수 있습니다.
• MCP (Model Context Protocol): 프로젝트 팀이 공유하는 외부 도구 및 데이터 연결 설정입니다.

효율적인 워크플로우: 탐색 → 계획 → 구현 Claude를 단순한 페어 프로그래머가 아닌 위임받은 엔지니어처럼 다루는 것이 중요합니다.

• 계획 모드 활용: Shift+Tab을 통해 계획 모드로 진입하여 설계 문서를 작성하고, 구현 전 검토 과정을 거칩니다.
• 검증 중심 운영: Claude가 실수했을 때 "Update CLAUDE.md so you do not repeat this"라고 지시하여, 실수를 방지하는 규칙을 자동으로 누적시킵니다.
• 정확한 참조: 모호한 지시 대신 @file_path와 같이 파일을 직접 지정하거나 파이프를 통해 에러 로그를 전달하는 방식이 효과적입니다.