Code+Vivo studio blog

개발공통 · November 01, 2026 · 5분 읽기

CLAUDE.md란? AI 코딩을 위한 프로젝트 지침서 만들기

CLAUDE.md는 Claude Code가 프로젝트를 작업할 때 참고하는 지침 파일입니다. 프로젝트의 개발 환경, 코딩 규칙, 폴더 구조, 작업 시 주의사항 등을 미리 작성해 두면 AI에게 매번 같은 내용을 설명할 필요가 없습니다. VS Code에서 Claude Code를 활용한다면 알아두면 좋은 파일입니다.

  1. CLAUDE.md 파일이란?

CLAUDE.md는 Claude Code에게 프로젝트의 기본 규칙과 작업 방향을 전달하는 Markdown 문서입니다.

예를 들어 홈페이지를 개발할 때 다음과 같은 내용을 설정할 수 있습니다.

사용 기술: Next.js, TypeScript, Tailwind CSS

디자인 규칙: 깔끔하고 모던한 디자인

코딩 규칙: 기존 코드 구조 유지

작업 원칙: 불필요한 파일 수정 금지

응답 언어: 모든 설명은 한국어로 작성

Claude Code는 작업을 시작할 때 관련 CLAUDE.md 파일을 읽고 지침으로 활용합니다.

  1. CLAUDE.md 파일 생성 방법

VS Code에서 프로젝트의 최상위 폴더에 다음 이름으로 파일을 생성합니다.

CLAUDE.md

파일 이름은 CLAUDE.md로 작성해야 합니다.

Claude Code 터미널에서 다음 명령어를 실행해 초기 지침 파일을 생성하거나 기존 파일을 개선할 수도 있습니다.

/init

  1. CLAUDE.md 작성 예시

아래는 Next.js 홈페이지 개발을 위한 간단한 예시입니다.

프로젝트 개발 지침

개발 환경

코딩 규칙

디자인 규칙

AI 응답 규칙

  1. CLAUDE.md 파일의 장점

① 반복 설명 최소화

매번 개발 환경이나 코딩 규칙을 설명할 필요가 없습니다.

② 일관된 코드 작성

프로젝트 전체에서 동일한 개발 규칙을 유지하는 데 도움이 됩니다.

③ 불필요한 수정 방지

AI가 기존 디자인이나 코드 구조를 임의로 변경하는 상황을 줄일 수 있습니다.

④ 프로젝트 관리 효율 향상

새로운 대화에서도 프로젝트의 기본 규칙을 전달할 수 있습니다.

  1. CLAUDE.md와 PRD.md의 차이

구분

CLAUDE.md

PRD.md

목적

AI 작업 지침

제품 요구사항 정의

주요 내용

코딩 규칙, 개발 환경

기능, 목표, 사용자 요구

역할

어떻게 개발할 것인가

무엇을 개발할 것인가

PRD.md는 만들고자 하는 프로그램의 요구사항을 정리하는 문서이고, CLAUDE.md는 AI가 작업할 때 지켜야 할 규칙을 정리하는 문서입니다.

두 파일을 함께 활용하면 AI 코딩 작업을 더욱 체계적으로 진행할 수 있습니다.

마무리

CLAUDE.md는 AI 코딩을 시작할 때 만들어두면 유용한 프로젝트 지침서입니다.

특히 Claude Code를 이용해 홈페이지를 지속적으로 수정하고 개선한다면 개발 규칙과 주의사항을 명확히 정리해 두는 것이 좋습니다.

단, CLAUDE.md가 AI의 모든 행동을 완벽하게 통제하는 것은 아닙니다. 중요한 작업 결과는 직접 확인하고, 프로젝트가 변경되면 지침 파일도 함께 업데이트해야 합니다