[Claude 입문 5/6] Claude Code + CLAUDE.md — 더 깊이 쓰기
x3C!-- 시리즈 상단 배너 -->
x3C!-- 히어로 헤더 -->
x3C!-- 본문 -->
이번 화 목차
AI와 제대로 일하려면 '기억'이 있어야 합니다
지금까지 Claude와 대화해 보셨다면 한 가지 불편함을 느끼셨을 겁니다. 어제 했던 이야기, 지난주에 정리한 아이디어, 내가 좋아하는 문체와 말투— 새 대화창을 열면 Claude는 아무것도 기억하지 못합니다.
마치 매일 아침 출근할 때마다 처음 만나는 새 동료에게 "저는 이런 사람이고, 우리 팀은 이런 일을 해요"라고 처음부터 다시 설명해야 하는 상황과 같습니다.
Claude는 각 대화를 독립적인 세션으로 처리합니다. 이는 개인정보 보호 설계상의 선택이기도 하고, 모든 이전 대화를 불러오면 처리 비용이 기하급수적으로 늘기 때문이기도 합니다. 하지만 방법이 있습니다. 바로 CLAUDE.md와 Claude Code입니다.
이번 화에서는 채팅창을 넘어서는 Claude의 '진짜 작업 도구'를 알아봅니다. 코딩을 전혀 모르셔도 됩니다. 블로그를 운영하거나, 유튜브 스크립트를 쓰거나, 가계부를 정리하거나, 소설을 연재하는 분들 모두에게 유용한 내용입니다.
Chat과 Claude Code, 무엇이 다를까요?
Claude에는 두 가지 '작업 공간'이 있습니다. 우리가 평소에 쓰는 Chat(채팅창)과, 훨씬 강력한 Claude Code입니다. 둘의 차이를 한 줄로 요약하면 이렇습니다.
Chat은 지금 이 대화창 안에서만 기억하고, Code는 폴더 전체를 읽고 파일을 직접 만들거나 고칩니다.
| 구분 | Claude Chat | Claude Code |
|---|---|---|
| 접근 방법 | 웹 브라우저 / 데스크탑 채팅창 | 데스크탑 Code 탭 / 터미널(CLI) |
| 기억 범위 | 현재 대화창 안에서만 | CLAUDE.md로 세션 간 유지 |
| 파일 접근 | 직접 첨부한 파일만 | 프로젝트 폴더 전체 직접 접근 |
| 작업 규모 | 간단한 코드, 아이디어 검증 | 복잡한 프로젝트, 지속적 작업 |
| 파일 수정 | 결과물을 복사해서 직접 붙여넣기 | 파일 생성·수정·삭제 직접 실행 |
| 잘 맞는 상황 | 빠른 질문, 아이디어 정리, 번역 | 연재 글 관리, 자동화, 프로젝트 작업 |
| 추천 사용자 | 가볍게 시작하는 모든 분 | 반복·지속 작업이 필요한 분 |
Chat에서 짠 코드는 왜 복붙하면 안 돌까요?
Claude를 쓰다 보면 이런 경험을 합니다. Chat에서 "이런 엑셀 수식 만들어줘", "파이썬 코드 짜줘"라고 해서 결과를 복사해 붙여 넣으면 오류가 나는 경우가 있습니다. Claude가 거짓말한 게 아닙니다.
Chat의 Claude는 내 컴퓨터 환경이 어떤지, 파일이 어디 있는지, 어떤 프로그램이 설치되어 있는지 전혀 모릅니다. 눈 감고 지도 없이 길 안내를 하는 것과 같습니다. Claude Code는 폴더를 직접 보면서 작업하기 때문에 훨씬 정확합니다.
처음엔 Chat으로 아이디어를 빠르게 정리합니다. 작업이 커지면 Code로 옮깁니다. 마무리할 때 "지금까지 진행한 내용 CLAUDE.md로 정리해줘"라고 하면 다음 세션을 위한 인수인계서가 완성됩니다.
코딩 몰라도 됩니다 — 이런 상황에 써보세요
"Claude Code"라는 이름 때문에 개발자 전용 도구라고 생각하기 쉽습니다. 그런데 실제로 코딩과 전혀 관계없는 작업에 훨씬 강력합니다.
블로그 연재 관리
지금까지 쓴 글의 목록, 내 글쓰기 스타일, 다음 편 계획을 CLAUDE.md에 담아두면 매번 설명할 필요 없이 연재를 이어갑니다.
유튜브 스크립트 제작
채널 컨셉, 구독자 타깃, 자주 쓰는 오프닝 형식을 기록해두면 매 영상마다 일관된 스크립트를 빠르게 뽑을 수 있습니다.
소설 / 웹소설 연재
등장인물 설정, 세계관, 지금까지의 줄거리 요약을 담아두면 100화가 넘어도 설정이 흔들리지 않습니다.
가계부 자동화
지출 분류 기준, 저축 목표, 반복 항목 처리 규칙을 기억하게 해두면 매월 가계부 정리를 Claude가 도와줍니다.
발표 자료 제작
아이디어를 정리한 파일을 읽고 발표용 파워포인트로 변환합니다. 서브에이전트들이 역할을 나눠 작업해 훨씬 높은 퀄리티가 나옵니다.
웹툰 / 창작 작업
캐릭터 설정, 회차별 시놉시스, 작화 지시 문구 템플릿을 관리하면 창작의 일관성을 유지할 수 있습니다.
비주얼 결과물(슬라이드 디자인, 인포그래픽 등)은 현재 베타로 출시된 Claude Design이 더 완성도 높은 결과를 냅니다. Code는 내용 구성과 구조 작업에 더 강합니다.
CLAUDE.md — AI에게 나를 설명하는 인수인계서
회사에서 업무를 인수인계할 때 어떻게 하나요? 새로 오는 동료가 빠르게 적응할 수 있도록 "우리 팀이 하는 일, 현재 진행 중인 프로젝트, 주의해야 할 사항"을 문서로 정리해 줍니다.
CLAUDE.md는 그 인수인계서를 AI를 위해 쓴 것입니다. Claude Code가 프로젝트 폴더를 열 때 가장 먼저 이 파일을 읽습니다. 여기에 내가 누구인지, 이 프로젝트가 무엇인지, 어떤 규칙을 지켜야 하는지 적어두면 세션이 새로 시작되어도 Claude는 처음부터 상황을 파악하고 작업을 이어갑니다.
"AI가 코드를 짜는 시대에, 코드의 인수인계는 AI 에이전트가 받는다." AI가 바뀌어도, 세션이 초기화되어도 같은 인수인계서를 읽고 이어서 작업할 수 있습니다.
CLAUDE.md에는 무엇을 담을까요?
다음은 블로그 운영자를 위한 CLAUDE.md 예시입니다.
x3C!-- 코드 블록 예시 --># 내 블로그 프로젝트 인수인계서
## 블로그 소개
- 채널명: 30대 주부의 살림 기록
- 독자: 20~40대 주부, 초보 살림꾼
- 포스팅 주기: 주 2회 (화, 금)
## 내 글쓰기 스타일
- 반말 사용 (친근한 언니처럼)
- 단락은 3~4줄 이내로 짧게
- 꼭 실제 경험담을 포함
- 마지막은 독자 질문으로 마무리
## 현재 진행 중인 시리즈
- [1편 완료] 냉장고 정리 기초편
- [2편 완료] 양념장 보관법
- [3편 작성 중] 국거리 소분하기
- [4편 예정] 냉동실 활용 팁
## 다음 할 일
- 3편 마무리 후 인스타그램 요약 카드 제작
- 시리즈 전편 링크 연결
# 이 파일은 Claude Code가 프로젝트를 시작할 때 가장 먼저 읽습니다.여러 명이 함께 작업하는 프로젝트라면 CLAUDE.md를 Git에 올려서 공유할 수 있습니다. 팀원 중 누가 Claude Code를 열어도 동일한 인수인계서를 읽고 일관된 작업을 이어갑니다.
CLAUDE.md 직접 만들어보기
CLAUDE.md를 직접 처음부터 쓸 필요는 없습니다. Claude에게 부탁하면 됩니다. 두 가지 방법이 있습니다.
-
방법 1: 기존 프로젝트 폴더에서 생성
Claude Code를 열고 작업 폴더를 지정한 후, 아래 프롬프트를 입력합니다. Claude가 폴더 내 파일들을 훑어보고 자동으로 CLAUDE.md를 작성해줍니다.
-
방법 2: Chat 대화 내용을 CLAUDE.md로 변환
Chat에서 아이디어를 충분히 정리한 후, 대화 마지막에 아래 프롬프트를 입력합니다. 그 결과물을 작업 폴더에 CLAUDE.md로 저장합니다.
CLAUDE.md에 꼭 들어가야 하는 항목
프로젝트 목적
이 프로젝트가 무엇인지 한 줄로 명확하게. "30대 주부의 살림 블로그 운영" 처럼 구체적으로.
나의 스타일 규칙
글쓰기 톤, 자주 쓰는 형식, 피해야 할 표현 등. Claude가 내 목소리를 흉내 낼 수 있도록.
현재 진행 상태
어디까지 됐고 무엇이 남았는지. 시리즈물이라면 편수와 완료/진행/예정 상태.
다음 할 일
다음 세션에서 Claude가 바로 시작할 수 있도록 구체적인 다음 작업을 기록.
주의 사항
건드리면 안 되는 파일, 바꾸면 안 되는 설정, 실수하기 쉬운 부분.
실행 명령 (선택)
코드 프로젝트라면 "npm start", "python main.py" 같은 실행 명령. 일반 프로젝트는 없어도 됨.
설정 최적화 — 나에게 맞게 세팅하기
Claude는 쓰는 사람에 따라 천차만별로 다르게 행동해야 합니다. 요리 블로거와 주식 투자자는 같은 Claude를 써도 다른 방식으로 답변을 받아야 합니다. 설정 메뉴에서 Claude를 '나의 AI'로 만들 수 있습니다.
꼭 챙겨야 할 설정 4가지
① Claude 지침 (Instructions)
Claude에게 "나는 이런 사람이고, 이렇게 답해줘"라고 미리 알려주는 공간입니다. 모든 대화에 자동으로 적용됩니다.
② 기억 생성 (Memory)
채팅 기록에서 중요한 정보를 자동으로 기억하게 설정할 수 있습니다. "내가 채식주의자라는 것", "내 생일이 3월 5일이라는 것"처럼 한 번 말하면 이후 대화에서도 계속 기억합니다. 이것이 바로 컨텍스트 엔지니어링의 핵심입니다.
처음 Claude를 쓸 때 "나에 대해 알아야 할 것들을 정리할게"라고 말하고 직업, 사는 지역, 관심사, 선호하는 답변 형식을 알려주세요. Claude가 기억으로 저장할지 물어보거나 자동으로 저장합니다.
③ 아티팩트 (Artifacts)
긴 코드, 긴 문서, 표 등을 별도 패널로 분리해서 보여주는 기능입니다. 대화창과 결과물을 나란히 보면서 실시간으로 수정하고, 다운로드하거나 공유할 수 있습니다. 블로그 초안이나 긴 문서를 작성할 때 특히 유용합니다.
④ 로컬 MCP (개발자용)
개발자를 위한 고급 설정입니다. 로컬 컴퓨터에 설치된 도구나 서버를 Claude에 연결하는 기능입니다. 일반 사용자는 나중에 알아보셔도 됩니다.
플러그인 — 반복 작업을 설치형 도구로
매번 같은 작업을 할 때마다 긴 설명을 반복해야 한다면 불편합니다. "블로그 글을 리뷰할 때는 맞춤법, 문체, SEO 키워드, 독자 친화성을 기준으로 봐줘" 라고 매번 입력하는 대신, 이것을 하나의 명령어로 만들 수 있다면 어떨까요?
바로 그것이 플러그인입니다.
스킬(절차서)이 "이렇게 해라"를 정의한다면, 플러그인은 그 스킬과 관련 도구들을 하나의 패키지로 묶어 설치해두고 단 한 줄로 실행하게 만든 것입니다.
플러그인이 없을 때 vs 있을 때
단 한 줄로 동일한 작업이 실행됩니다. 반복 업무를 자동화하는 강력한 방법입니다.
이런 플러그인들을 만들 수 있습니다
/blog:draft
키워드만 주면 내 글쓰기 스타일로 블로그 초안을 생성합니다.
/sns:convert
블로그 글을 인스타그램, 트위터, 카카오채널 형식으로 각각 변환합니다.
/youtube:script
내 채널 스타일에 맞는 유튜브 스크립트를 완성된 형태로 작성합니다.
/email:reply
받은 이메일 내용을 붙여넣으면 내 이름과 직책으로 답장 초안을 작성합니다.
핵심 정리 & 다음 화 예고
5화 핵심 요약
- Chat은 대화 중심, Code는 프로젝트 중심. Chat에서 아이디어를 정리하고, 복잡해지면 Code로 이동하는 것이 최적의 흐름입니다.
- Claude Code는 코딩 도구가 아닙니다. 블로그, 소설, 유튜브, 가계부 등 반복적이고 지속적인 모든 작업에 강합니다.
- CLAUDE.md는 AI 인수인계서. 세션이 바뀌어도 나를 기억하게 하는 가장 강력한 방법이며, "지금까지 진행한 내용 CLAUDE.md로 정리해줘" 한 마디로 만들 수 있습니다.
- 설정의 Claude 지침을 꼭 채우세요. 한국어로 답하게 하고, 내 직업과 관심사를 알려주는 것만으로도 Claude의 답변 품질이 크게 달라집니다.
- 플러그인으로 반복을 없애세요. 매번 긴 설명 대신
/blog:review같은 단 한 줄로 복잡한 작업을 실행할 수 있습니다.
실천 과제
- Claude 설정에 들어가 '지침(Instructions)' 항목에 나를 소개하는 문장을 3줄 이상 입력해보세요.
- 지금 진행 중인 프로젝트나 관심사가 있다면, Chat에서 아이디어를 정리하고 마지막에 "CLAUDE.md로 정리해줘"라고 해보세요.
- 내가 자주 하는 반복 작업을 하나 떠올리고, 그것을 플러그인으로 만들면 어떤 명령어가 어울릴지 생각해보세요.
마지막 6화에서는 Claude를 진짜 잘 쓰는 사람들이 공통적으로 하는 것, 프롬프트 엔지니어링의 핵심 기법을 다룹니다. 역할 부여, 예시 제시, 단계별 사고 유도 등 같은 질문도 더 좋은 답을 받아내는 방법을 알아봅니다.
x3C!-- 푸터 -->