바이브 코딩 →

CLAUDE.mdCLAUDE.md

CLAUDE.md는 새 직원에게 건네는 업무 인수인계 노트 같은 것 — Claude Code가 작업을 시작할 때 가장 먼저 읽는 규칙·지침 문서로, 프로젝트 설명과 지켜야 할 약속을 적어 둬요.

CLAUDE.md는 새로 온 직원에게 첫날 건네는 인수인계 노트와 같아요. '우리 회사는 이런 일을 하고, 이 폴더에는 이게 있고, 이건 절대 하지 마세요'가 적혀 있으면 직원이 매번 묻지 않아도 일을 이어 갈 수 있죠. Claude Code도 대화를 새로 시작할 때마다 기억이 비어 있어서, 이 파일을 먼저 읽고 프로젝트의 규칙과 맥락을 파악해요.

강의에서는 두 가지 장면에서 써요. 첫째, 프로젝트를 깃허브 저장소에 올릴 때 CLAUDE.md(클로드용)와 agent.md(코덱스·커서 같은 다른 도구용)를 함께 만들어 두면 어떤 환경에서 열어도 작업을 이어 갈 수 있어요. 둘째, 모든 프로젝트에 공통으로 적용되는 전역 지침이에요. 전역 지침이 내 PC에만 있으면 VPS의 AI는 다른 규칙을 보게 되므로, 저장소의 공유 폴더로 옮겨 PC와 VPS가 같은 지침과 메모리를 보게 만들어요.

무엇을 적어야 하냐는 질문에는 '매번 반복해서 말하게 되는 것'을 적으라고 답할 수 있어요. 프로젝트 목적, 폴더 구조, 쓰는 도구, 답변 언어, 하면 안 되는 일, 검증 순서 같은 것이요. 반대로 너무 길게 쓰면 AI가 중요한 규칙을 놓치고 컨텍스트도 많이 차지하니 핵심만 짧게 유지하는 게 좋아요. 대화 중 한 번 말한 지시는 압축되면 사라질 수 있지만, CLAUDE.md에 적은 규칙은 다음 대화에서도 계속 적용된다는 점이 가장 큰 차이예요.

💡 대표 예시

  • 저장소 업로드 — CLAUDE.md와 agent.md를 함께 만들어 같이 올린다
  • 전역 지침 공유 — 지침을 깃허브 공유 폴더로 옮겨 PC·VPS가 함께 본다
  • 반복 지시 정리 — '답변은 한국어로' 같은 규칙을 파일에 적어 둔다
  • 금지 사항 — '배포 전 빌드 확인 필수'를 CLAUDE.md에 추가한다
  • 다이어트 — 너무 길어진 지침에서 안 쓰는 규칙을 지운다

🔗 관련 용어

에이전트 명세 파일

에이전트 명세 파일 (agent.md)은 에이전트 (Agent)에게 건네는 '직원 입사 안내서' 같은 것 — 이름·역할·쓸 수 있는 도구·말투까지 한 파일에 적어두면 에이전트가 그 설명서대로 행동한다.

클로드 코드

클로드 코드(Claude Code)는 내 컴퓨터에 들어와 일하는 AI 개발자 같은 것 — Anthropic이 만든 AI 코딩 도구로, 말로 지시하면 파일을 읽고 코드를 고치고 명령어를 실행해 작업을 끝까지 진행해요.

컨텍스트 압축(/compact)

컨텍스트 압축(Context Compaction)은 꽉 찬 회의록을 핵심 요약 한 장으로 줄이는 것 — AI와의 긴 대화를 요약해 컨텍스트 공간을 비우고 작업을 이어 가게 하는 기능이에요.

마크다운

마크다운 (Markdown)은 글에 붙이는 간단한 서식 기호 같은 것 — #, *, - 같은 기호만으로 제목·굵게·목록을 표시하는 가벼운 글쓰기 형식이에요.

메모리 파일

메모리 파일 (memory.md)은 AI 에이전트 (Agent)의 '업무 인수인계 노트' 같은 것 — 대화가 끊겨도 내 이름·습관·진행 중인 프로젝트를 파일에 적어두면 에이전트가 다음에 만났을 때 처음 만난 사람처럼 굴지 않는다.

시스템 프롬프트

시스템 프롬프트 (System Prompt)는 직원이 출근하자마자 읽는 업무 매뉴얼 같은 것 — 대화가 시작되기 전에 AI의 역할·말투·규칙을 미리 정해 두는 기본 지시문이에요.

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.