3. CLAUDE.md로 나와 내 일을 알려주는 법

3. CLAUDE.md로 나와 내 일을 알려주는 법

매번 같은 설명을 하고 있다면

‘나는 이런 일을 하고, 이 자료는 이런 목적으로 쓰고, 결과는 이런 방식으로 봐야 해.’

AI와 일을 시작할 때 필요한 설명입니다. 그런데 비슷한 일을 할 때마다 같은 이야기를 다시 한다면 번거롭습니다. 앞에서 고쳤던 부분을 다음 작업에서 또 고치게 되기도 합니다.

앞 글에서는 자료와 판단, 결과를 쌓아가는 폴더 구조를 이야기했습니다. 자료가 어디 있는지 알면 찾기 편합니다. 여기에 그 자료로 일할 때 무엇을 중요하게 보는지도 알려주면 좋겠죠.

저는 이런 반복되는 맥락과 업무 기준을 안내 파일로 남겨 사용합니다. Claude Code에서 그 역할을 하는 파일이 CLAUDE.md입니다.

CLAUDE.md란 무엇인가요?

Claude Code가 작업할 때 참고하는 안내 문서입니다. 특별한 코드를 쓰는 파일은 아닙니다. 앞 글에서 본 Markdown으로 역할과 기준을 적습니다.

예를 들어 ‘행사 안내문을 만들어줘’라는 요청을 받았을 때, 어떤 행사를 맡는 사람인지, 누구에게 전달할 문서인지, 아직 정하지 않은 내용을 어떻게 표시해야 하는지가 함께 전달되면 작업의 출발점이 달라집니다.

다만 직업을 적었다고 제 경험과 노하우를 전부 알게 되는 것은 아닙니다. 이름이나 역할만으로 예산과 고객의 사정까지 알 수도 없고요. 다음에도 참고했으면 하는 맥락과 판단을 구체적으로 남기는 것입니다.

무엇을 알려주면 될까요?

처음에는 세 가지 질문으로 시작하면 됩니다. 복잡한 규칙집을 먼저 만들 필요는 없습니다.

1. 나는 누구인가?

직함보다 어떤 역할을 맡고 있는지가 중요합니다. 직접 운영을 결정하는 사람인지, 자료를 모아 누군가에게 보고하는 사람인지에 따라 필요한 결과도 달라집니다.

‘마케팅 담당자’라고만 설명하는 것과 ‘매장 운영자에게 이번 프로모션을 설명하고 실행을 조율한다’고 하는 것은 전달되는 맥락이 다릅니다.

2. 무슨 일을 하나?

자주 하는 일과 그 결과를 누가 어디에 쓰는지 이야기합니다. 안내문을 만드는지, 운영 보고서를 만드는지, 고객에게 제안하는지. 같은 자료여도 목적에 따라 읽어야 할 부분과 결과의 형태가 달라집니다.

3. 어떻게 일하나?

문장 길이나 말투도 여기에 들어갑니다. 하지만 그것만은 아닙니다. 어떤 것을 확인하고, 무엇을 근거로 판단하고, 모르는 내용이 있을 때 어떻게 처리해야 하는지도 업무 방식입니다.

수업에서도 프로필을 알려주는 데서 멈추지 않습니다. 사실을 말할 때 근거를 어떻게 다룰지, 일이 잘못됐을 때 무엇을 확인할지 같은 기준을 함께 이야기합니다. 저도 AI와 일하다 같은 문제가 반복돼 기준을 보태고 고쳐왔습니다.

대화하면서 만들면 됩니다

이 세 가지를 혼자 완벽하게 정리할 필요는 없습니다. Claude Code에게 필요한 내용을 물어보고 정리하도록 맡기면 됩니다.

이 작업 공간에서 나와 일할 때 참고할 안내를 만들고 싶어.
내 역할, 주로 하는 일, 결과를 볼 때 중요하게 생각하는 기준을 질문해줘.
내가 답한 내용 중 다음에도 필요한 것만 정리하고,
어디에 남기면 좋을지 먼저 제안해줘. 이미 있는 안내와 겹치는지도 봐줘.

질문을 받으면 아는 만큼 답합니다. 실제로 있었던 일을 예로 들어도 좋습니다. ‘지난번에 자료에 없는 일정을 확정해서 적었는데, 그런 건 확인할 사항으로 남겨야 해’처럼요.

AI가 정리한 내용을 보고 제가 말한 뜻과 맞는지 확인합니다. 제가 답하지 않은 역할이나 목표를 추측해서 넣지는 않았는지, 지금 하는 일에만 필요한 내용을 모든 업무에 적용하려 하지는 않는지 보는 겁니다. 그다음 합의한 내용을 적절한 위치에 만들게 하면 됩니다.

처음부터 새 파일을 만들기보다, 지금 참고하는 안내가 있는지도 확인하는 이유입니다. 같은 기준이 여러 곳에 다르게 적혀 있으면 다음에 무엇을 고쳐야 할지 헷갈립니다.

실제 파일 안에는 이렇게 적습니다

앞 글의 행사 준비를 이어서 보겠습니다. 아래는 가상의 행사 업무를 설명하려고 새로 만든 최소 예시입니다. 제 개인 안내 파일이나 캠프 자료를 그대로 옮긴 것이 아닙니다.

# 행사 준비 업무 안내

## 담당 역할과 목적
- 나는 행사 준비 담당자다.
- 참가자가 보고 행동할 수 있는 운영 안내를 만든다.

## 참고할 자료
- 받은 요청과 지난 행사 회고는 자료 폴더에 있다.
- 이번에 합의한 운영 방식은 판단 폴더에서 확인한다.

## 일하는 기준
- 확정한 내용과 아직 확인할 내용을 나눠서 쓴다.
- 자료에 없는 시간과 비용은 추측해 확정하지 말고 질문한다.

#와 ##는 제목과 구분이고, - 아래에는 AI가 참고할 내용을 적었습니다. 프로그램을 실행하는 명령이 아니라 읽고 적용할 업무 안내입니다.

‘담당 역할과 목적’은 누구를 위해 무엇을 만드는지, ‘참고할 자료’는 필요한 정보를 어디서 찾을지 알려줍니다. ‘일하는 기준’은 그 자료를 결과로 만들 때 어떤 판단을 적용할지 정합니다.

예를 들어 마지막 줄이 있으면, 안내문을 쓰다가 미정인 시간을 발견했을 때 질문하도록 방향을 줄 수 있습니다. ‘나중에 정해도 되는 내용은 초안에서 확인할 사항으로 남긴다’로 바꾸면, 초안을 먼저 받고 미정 사항을 따로 검토하는 방식으로 요청할 수도 있겠죠.

이것은 기준을 바꿨을 때 기대하는 동작의 차이입니다. 실제 결과가 그렇게 나왔는지는 써보면서 확인해야 합니다. 안내에 적은 문장만으로 오류가 없어지는 것은 아닙니다.

어디에 남겨야 할까요?

같은 내용이라도 적용할 범위가 다릅니다.

안내의 범위 대표 위치 적을 내용
사용자 공통 ~/.claude/CLAUDE.md 여러 작업에서 쓰는 개인 선호
프로젝트 작업 폴더의 CLAUDE.md 또는 .claude/CLAUDE.md 그 일의 목적과 자료, 업무 기준
하위 폴더 해당 폴더의 CLAUDE.md 그 영역에서만 필요한 추가 안내

~는 사용자 홈 폴더를 가리킵니다. 이 표는 파일의 위치와 역할을 설명하는 것이지, 경로를 외워 직접 입력하라는 뜻은 아닙니다. AI와 내용을 정하고 어디에 둘지 확인하면 됩니다.

‘짧게 설명해줘’ 같은 개인 선호와 ‘이번 행사 안내에서 미정인 시간은 이렇게 표시해줘’라는 기준은 범위가 다릅니다. 특정 프로젝트의 고객이나 조건을 사용자 공통 안내에 넣으면 다른 일을 할 때도 섞일 수 있습니다.

시작 위치와 그 위 폴더의 안내는 시작할 때 함께 읽힙니다. 하위 폴더의 안내는 그 안의 파일을 읽거나 쓰거나 편집할 때 추가로 읽힙니다. 아래 안내가 위 안내를 지우는 방식은 아니므로 서로 모순되지 않게 정리해야 합니다. 안내의 위치와 적용 범위

안내, 업무 자료, 자동 기억은 다릅니다

CLAUDE.md에 ‘지난 행사 회고를 확인한다’고 적는 것과 회고 파일의 내용을 실제로 읽는 것은 다릅니다.

안내는 어떻게 일할지, 업무 자료는 무엇을 바탕으로 판단할지를 알려줍니다. 회고와 이번 요청, 도구로 확인한 결과가 실제로 읽혀야 현재 작업의 판단에 쓰일 수 있습니다. 이런 대화와 읽어온 정보가 들어가는 작업 공간을 현재 ‘맥락’이라고 생각하면 됩니다. 용량에도 한계가 있어 모든 과거 자료가 늘 들어 있는 것은 아닙니다. 현재 맥락의 구성

Claude Code에는 별도로 자동 기억 기능도 있습니다. 사용 중 알아낸 선호나 수정 사항을 로컬 파일로 남기는 기능입니다. 기본적으로 같은 프로젝트의 기억을 관리하며, 다른 컴퓨터로 자동 공유되는 것은 아닙니다.

자동 기억의 MEMORY.md는 무엇이 어디에 저장돼 있는지 가리키는 인덱스 역할을 합니다. 시작할 때 읽는 범위는 처음 200줄 또는 25KB 중 먼저 도달하는 쪽까지이고, 자세한 기억 파일은 필요할 때 읽습니다. 모든 대화를 통째로 영구 학습하는 기능과는 다릅니다. 자동 기억의 동작

자동 기억이 있다고 업무 자료나 확인한 기준을 남길 필요가 없어지는 건 아닙니다. 다음에 그대로 써도 되는 판단인지, 지금도 맞는지 살펴보는 일은 계속 필요합니다.

정말 참고하고 있는지 확인합니다

파일을 만들었다면 내용뿐 아니라 적용 여부도 봐야 합니다.

Claude Code 대화 안에서 /context를 입력하면 시작할 때 읽힌 안내 파일을 확인할 수 있습니다. /memory는 안내와 기억 파일의 위치를 보고 열거나 자동 기억을 관리할 때 사용합니다. 없는 파일의 위치도 목록에 보일 수 있으므로, 목록에 있다는 것과 실제로 읽혔다는 것을 같게 보면 안 됩니다. 하위 폴더 안내는 해당 영역에서 작업할 때 추가로 읽히는 점도 함께 생각하면 됩니다. 기억 파일 확인과 관리

안내 내용을 바꾼 뒤에는 그 작업 폴더에서 새 대화를 열어 적용된 파일을 확인하고, 평소 하던 일을 맡겨보세요. 위 가상 예시라면 미정인 시간을 어떻게 처리했는지 결과에서 확인하는 겁니다.

기준을 읽었어도 결과가 어긋날 수 있습니다. 그때는 필요한 자료를 못 읽은 건지, 기준이 모호한 건지, 다른 안내와 충돌한 건지 함께 살펴봅니다. CLAUDE.md는 모델이 참고하는 맥락이며 강제 설정은 아닙니다. 구체적인 기준 쓰기

쓰면서 고치는 안내

한 번 만들고 완성하는 문서라고 생각하지 않아도 됩니다.

실제 일을 함께 하고 결과를 본 뒤, 다음에도 쓸 판단을 정리합니다. 비슷한 일을 하면서 맞지 않는 부분이 나오면 다시 고칩니다. 이미 달라진 목표나 도구, 더 이상 하지 않는 일은 덜어내고요.

기준이 많아지는 것보다, 지금 하는 일에 필요한 기준이 분명한 게 좋습니다. 매번 설명하던 내용 중 무엇을 남기면 다음 일이 편해지는지 보면서 다듬으면 됩니다.

이제 자료를 모아두는 공간과, 그 자료로 일할 때 참고할 안내를 살펴봤습니다. 다음은 컴퓨터 밖에 있는 업무 자료입니다.

다음으로는 메일과 일정 같은 Google 서비스를 연결하면 어떤 일이 달라지는지 보겠습니다. 아직 이 연결을 설정한 것은 아닙니다. 먼저 어떤 업무에 쓸 수 있는지 보고 연결 과정으로 이어가겠습니다.

이 글은 기존 번호로 3편이고, 위 추천 글은 15편입니다. 지금 따라가는 학습 순서와 사이트의 발행 순서는 다릅니다.

Subscribe to 비개발자를 위한 Claude Code | 일을 잘하기 위한 AI Workspace

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.
[email protected]
Subscribe