https://korobopolly.github.io/tags/%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-%EC%84%A4%EC%A0%95/Recent content in 프로젝트 설정 on Korobopolly's Dev BlogHugokoMon, 16 Feb 2026 13:01:00 +0900https://korobopolly.github.io/posts/claude-code-claude-md/Mon, 16 Feb 2026 13:01:00 +0900https://korobopolly.github.io/posts/claude-code-claude-md/<h2 id="claudemd란">CLAUDE.md란?</h2> <p>CLAUDE.md는 Claude Code에게 프로젝트별 컨텍스트와 작업 지침을 전달하는 특수한 마크다운 파일입니다. 이 파일을 프로젝트 루트에 두면 Claude Code가 세션 시작 시 자동으로 읽어들여 프로젝트의 규칙, 코딩 스타일, 아키텍처 결정사항 등을 이해하고 작업에 반영합니다.</p> <p>전역 설정 파일인 <code>~/.claude/CLAUDE.md</code>와 달리, 프로젝트 루트의 <code>CLAUDE.md</code>는 해당 프로젝트에만 적용되며 팀원 간 공유가 가능하여 일관된 개발 경험을 제공합니다.</p> <h2 id="claudemd의-주요-역할">CLAUDE.md의 주요 역할</h2> <h3 id="1-프로젝트-컨텍스트-제공">1. 프로젝트 컨텍스트 제공</h3> <p>Claude Code에게 프로젝트의 목적, 기술 스택, 디렉토리 구조 등을 명시적으로 알려줄 수 있습니다.</p>