CLAUDE.md는 무엇을 적어 두는 파일일까?

새 대화를 열 때마다 “조사 결과는 정보 폴더에 넣고, 파일명에는 날짜를 붙여 줘”를 다시 입력한다. 업무 폴더까지 만들어 뒀는데, 왜 AI는 내 작업 방식을 모를까?

 

폴더는 마련했지만 일하는 방법을 알려 주지는 않았기 때문이다. Claude Code에는 반복해서 전달할 업무 지침을 적어 두는 파일, CLAUDE.md가 있다.

 

 📌 한눈에 보기 

 

CLAUDE.md에 공통 정보와 업무별 규칙을 남기면 같은 설명을 반복하는 수고가 줄어든다

 

✓  지침 파일에 반복해서 쓸 업무 규칙을 적는다

✓  공통 사용자 정보와 업무별 규칙을 나눈다

✓  새 대화의 결과에서 지침이 반영됐는지 살핀다

 

이 글에서 답할 질문

Q1. CLAUDE.md는 무엇이고 어떻게 동작할까

Q2. 공통 정보와 업무 규칙은 어디에 나눠 적을까

Q3. 적어 둔 규칙이 반영됐는지 어떻게 확인할까

 

 

Q1. CLAUDE.md는 무엇이고 어떻게 동작할까?

 

CLAUDE.md는 Claude Code가 요청을 처리할 때 참고할 사용자 정보와 업무 규칙을 적는 텍스트 파일이다.

 

빈 업무 폴더만으로는 결과를 어디에 저장할지, 파일 이름을 어떻게 붙일지 알 수 없다. 이런 규칙을 파일에 적어 두면 Claude Code가 요청과 함께 참고한다.

 

새 담당자에게 업무 폴더와 함께 건네는 인수인계 메모를 떠올리면 쉽다. 메모에는 일하는 방법이 담겨 있고 실제 작업은 담당자가 한다.

 

여기서 메모가 CLAUDE.md, 담당자가 Claude Code다. 지침 파일은 모델을 새로 훈련하거나 과거 대화 전체를 기억시키지 않는다.

 

작업 공간과 지침, 이를 읽는 도구를 구분하면 구조가 보인다.

 

ℹ️ 용어

작업 폴더: 이번 업무의 관련 파일을 모아 두는 공간이다.

프로젝트 CLAUDE.md: 해당 업무의 목적과 처리 규칙을 적는 파일이다.

전역 CLAUDE.md: 여러 프로젝트에서 공통으로 참고할 사용자 정보를 적는 파일이다.

Claude Code: 지침을 참고하면서 사용자의 요청을 처리하는 도구다.

 

커피를 조사해 파일로 남기는 요청이라면 다음 순서다.

 

①  업무 폴더 선택 — 커피 조사 결과를 모을 작업 폴더를 선택한다

②  지침 저장 — 폴더 안의 CLAUDE.md에 “조사 결과는 정보 폴더에 저장하고 파일명에 날짜를 넣는다”라고 적고 저장한다

③  새 대화 시작 — 지침을 저장한 뒤 같은 폴더에서 새 대화를 연다

④  작업 요청 — “역삼역 근처 커피를 조사해서 파일로 만들어”라고 요청한다

⑤  결과 확인 — 결과가 정보 폴더에 있는지, 파일명에 날짜가 붙었는지 살핀다

 

요청에는 조사할 대상만 담았다. 저장 방법은 지침 파일에 남아 있으므로 매번 같은 문장을 덧붙일 수고를 줄인다.

 

이번 요청과 반복해서 쓸 지침은 맡는 일이 다르다.

 

구분	담는 내용	커피 조사 예시
대화의 요청	지금 처리할 일	역삼역 근처 커피 조사
CLAUDE.md	반복 적용할 업무 규칙	저장 폴더와 날짜 파일명

 

 한 줄 정리 

CLAUDE.md는 Claude Code에 건네는 반복 업무의 인수인계 메모다

 

 

Q2. 공통 정보와 업무 규칙은 어디에 나눠 적을까?

 

여러 업무에 공통인 정보는 전역 파일에, 해당 업무에서만 쓸 규칙은 프로젝트 파일에 적는다.

 

마케팅 폴더와 기획 폴더에 같은 자기소개를 복사해 뒀다고 가정해 보자. 직무나 담당 업무가 바뀌면 두 파일을 찾아 고쳐야 한다.

 

공통 정보를 전역 지침 한곳에 모아 두면 여러 파일을 고칠 필요가 없다.

 

가령 전역 파일에는 “나는 개발자이며 사무실은 역삼동에 있다”를 적는다. 커피 조사 프로젝트에는 “조사 결과는 정보 폴더에 넣고 날짜를 붙인다”를 적는 식이다.

 

어느 파일에 넣을지 헷갈릴 때는 적용 범위를 먼저 따져 본다.

 

💡 TIP

이 문장이 다른 업무에도 필요한가? 그렇다면 전역에, 이 업무에서만 필요하다면 프로젝트에 둔다.

 

 한 줄 정리 

CLAUDE.md를 나누는 기준은 다른 업무에도 필요한 정보인가다

 

 

Q3. 적어 둔 규칙이 반영됐는지 어떻게 확인할까?

 

지침을 저장하고 새 대화에서 작업을 요청한 뒤, 결과를 적어 둔 규칙과 대조한다.

 

커피 조사 예시라면 저장 규칙을 요청에 다시 붙이지 않고 조사 작업만 요청해 본다. 같은 문장을 또 입력하면 파일의 지침이 쓰였는지 구분하기 어렵다.

 

결과 파일이 정보 폴더 안에 있는지, 파일명에 날짜가 들어갔는지 살핀다.

 

파일을 만들어 줬다는 답만 읽고 끝내지 말고 실제 위치와 이름을 본다. 원하는 규칙이 구체적일수록 결과와 맞춰 볼 기준도 또렷해진다.

 

저장 형식과 내용은 확인할 대상이 다르다.

 

⚠️ 주의

지정한 폴더와 파일명이 맞아도 조사 내용이 정확하다는 뜻은 아니다. 카페 정보가 맞는지는 별도로 살펴야 한다.

 

 한 줄 정리 

CLAUDE.md의 반영 여부는 적어 둔 규칙과 실제 결과를 대조해 확인한다

 

 

오늘부터 바로 써먹기

 

반복해서 입력하던 지침 하나부터 파일로 옮겨 본다.

 

☐  자주 반복하는 업무 지침 하나를 프로젝트 CLAUDE.md에 적는다

☐  여러 프로젝트에 중복된 자기소개는 전역 CLAUDE.md로 모은다

☐  새 대화에서 작업 하나를 요청하고 결과 파일을 지침과 대조한다

 

CLAUDE.md에 반복되는 설명을 남겨 두면, 다음 요청은 지금 처리할 일에 집중할 수 있다.

 

 

출처

 

• 영상: 임대표의 AI오피스, 「AI가 내 업무를 모르는 진짜 이유」 (2026-10-02)