ADU FIELD DOSSIER · CLAUDE CODE

Claude 세컨드 브레인 2.0
같은 설명을 줄이는
기억 설정 가이드

기본 지도부터 폴더별 규칙·반복 절차·자동 기억까지.
빈 폴더에서 만들고 새 세션에서 확인하는 완전 가이드입니다.

AUTHOR아듀 (ADU)
DATE2026-11-03 기준
SCOPE로컬 Claude Code · 초보자용 실습
01

같은 설명을 반복하지 않는 구조

Claude Code에 기억을 남기려면 대화에서 나온 규칙을 파일로 옮겨야 합니다. 파일마다 읽는 시점을 다르게 정하면 필요한 지식만 꺼내 쓰기 편해집니다.

새 대화를 열 때마다 폴더 위치와 문체를 다시 설명한 적이 있나요? “앞으로 이렇게 해줘”라는 대화만으로는 다음 세션에서 같은 지침을 읽는다고 보장할 수 없습니다. 오래 쓸 규칙과 교정 내용을 파일에 남기고, 그 파일을 실제로 읽는지 확인해야 합니다.

이 가이드에서는 기억을 네 계층으로 나눠 설명합니다. 공식 문서의 큰 구분은 ‘사용자가 쓰는 지침’과 ‘Claude가 쓰는 자동 기억’입니다. 여기에 조건부 규칙과 스킬을 함께 배치한 실용적인 정리법입니다.

저장할 곳읽는 시점넣을 내용
CLAUDE.md
기본 지도
세션 시작답변 언어·공통 원칙·현재 우선순위
.claude/rules/
폴더별 규칙
경로가 맞는 파일을 다룰 때
paths가 없는 규칙은 시작 시
인물 카드 항목·초안 문체
Skills
반복 작업 설명서
직접 부르거나 관련 작업으로 판단할 때 본문 로드주간 점검처럼 순서가 있는 작업
Auto memory
자동 기억
시작할 때 색인 일부
세부 파일은 필요할 때
교정·선호·다음에도 쓸 맥락
모든 작업에 필요한 내용만 기본 지도에 둡니다. 특정 폴더의 규칙과 긴 작업 절차는 따로 둡니다. 쉽게 말하면, 매번 펼칠 안내문과 필요할 때 꺼낼 설명서를 나누는 방식입니다.

먼저 바로잡을 두 가지 오해

“CLAUDE.md는 시스템 프롬프트다.” 실제로는 시스템 프롬프트 뒤에 사용자 메시지로 전달되는 맥락입니다. 읽었다고 해서 모호하거나 충돌하는 지침까지 엄격히 지킨다는 보장은 없습니다.

“파일에 없으면 답하지 않고 실패를 보고한다.” 그런 자동 보장은 없습니다. ‘근거 파일이 없으면 없다고 말하기’를 구체적으로 적고, 중요한 답은 원본과 대조해야 합니다.

반드시 막아야 할 도구 실행은 권한 설정이나 PreToolUse 훅으로 제어합니다. 훅은 쉽게 말하면 도구 실행 직전에 정해진 검사를 돌리는 장치입니다. 훅도 적용 대상과 오류 처리가 맞아야 하므로 8장의 확인 기준을 함께 보세요.

기능 근거: Claude Code 기억 문서 · 훅 문서

02

준비물과 완성할 폴더

완성 목표는 ‘주간 뉴스레터 프로젝트의 위치·작성 규칙·진행 상태를 새 세션에서도 확인할 수 있는 폴더’입니다. 아래 뉴스레터와 인물은 모두 연습용 예시입니다.

어디에서 시작하나요?

이 자료는 컴퓨터의 로컬 폴더를 다루는 Claude Code 기준입니다. 일반 Claude 웹 채팅의 프로젝트 지침에 그대로 붙여 넣는 절차와는 다릅니다. Claude Code가 없다면 공식 시작 안내에서 설치와 로그인을 먼저 마치세요. 이용 가능한 구독·Console 계정 또는 지원 제공자 접속이 필요합니다. 별도 노트 앱이나 데이터베이스는 필요하지 않습니다.

  1. 파일 탐색기에서 새 폴더 second-brain을 만듭니다.
  2. Claude Code에서 그 폴더를 작업 폴더로 엽니다. 터미널을 쓰면 해당 폴더로 이동한 뒤 claude를 실행합니다.
  3. Claude에게 “현재 작업 폴더의 절대 경로를 알려줘”라고 요청합니다. 새로 만든 폴더가 맞는지 확인합니다.
  4. 처음부터 만들려면 7장의 전체 설정 요청을 붙여 넣습니다. 각 파일의 역할은 3~6장에서 설명합니다.
기존 프로젝트에는 설정 요청을 바로 실행하지 마세요. 먼저 기존 지침과 규칙을 읽고 겹치는 내용을 비교해야 합니다. 이 실습은 빈 폴더를 기준으로 합니다.

완성 후 이렇게 보이면 됩니다

완성 폴더 구조 · 확인용
second-brain/
├── CLAUDE.md
├── CLAUDE.local.md
├── .gitignore
├── decisions.md
├── notes/
├── people/
├── projects/
│   └── now.md
├── drafts/
└── .claude/
    ├── rules/
    │   ├── people.md
    │   └── writing.md
    └── skills/
        └── weekly-review/
            └── SKILL.md
이 트리는 기대하는 구조입니다. 실제 생성 결과는 Claude Code가 보여 준 파일 목록과 대조하세요.

notes/에는 주제별 자료를, people/에는 사람·회사별 기록을 둡니다. projects/에는 상태와 다음 행동을, drafts/에는 작성 중인 글을 둡니다. decisions.md에는 결정과 이유를 기록합니다.

파일은 주제 하나당 하나로 나눕니다. 예를 들어 newsletter-sources.md와 kim-mina.md처럼 소문자와 하이픈을 쓰세요. notes.md 하나에 모든 기록을 계속 붙이는 방식은 피합니다. 단, CLAUDE.md·SKILL.md 같은 설정 파일 이름은 대소문자까지 그대로 둡니다.

자동 기억 폴더는 이 트리 안에 직접 만들지 않습니다. Claude Code가 관리하는 위치를 /memory로 확인합니다.

03

1계층 · CLAUDE.md에 기본 지도 쓰기

새 세션마다 알아야 하는 원칙만 남깁니다. 200줄 미만은 권장 목표이며, 200줄을 넘으면 파일 전체가 자동으로 사라진다는 뜻은 아닙니다.

규칙을 하나씩 추가하다 보면 모든 작업의 설명이 이 파일에 쌓입니다. 길어질수록 매번 읽는 맥락이 늘고 지침을 따르는 일관성도 떨어질 수 있습니다. 글쓰기 세부 기준은 규칙 파일로, 주간 점검 순서는 스킬로 옮기세요.

아래는 빈 폴더에 넣을 기본 예시입니다. 이미 같은 파일이 있다면 덮어쓰지 말고 필요한 줄만 비교해 반영합니다.

CLAUDE.md 내용
# Second brain 운영 지도

<!-- 관리 메모: 큰 변경 뒤 점검. 본문은 200줄 미만을 목표로 유지. -->

## 기록 위치
- notes/: 주제별 자료
- people/: 사람 또는 회사별 기록
- projects/: 진행 상태, 마지막 작업, 다음 행동
- drafts/: 작성 중인 글
- decisions.md: 결정한 내용과 이유

## 답변 원칙
- 한국어로 간결하게 답한다.
- 기록을 묻는 질문은 관련 파일부터 읽는다.
- 답변에 사용한 파일 이름을 밝힌다.
- 해당 파일이 없거나 근거가 부족하면 그 사실을 말한다.
- 없는 기록을 만들지 말고 저장할 파일을 제안한다.

## 일반 기록의 파일명
- 소문자와 하이픈을 쓴다. 주제 하나당 파일 하나로 나눈다.
- CLAUDE.md와 SKILL.md 등 지정된 설정 파일명은 유지한다.

## 현재 우선순위
@projects/now.md

주석·불러오기·백틱의 차이

HTML 주석. 위의 <!-- ... -->처럼 블록으로 쓴 관리 메모는 지침이 자동 주입될 때 제거됩니다. 코드 블록 안의 주석은 남고, Claude가 파일 자체를 직접 읽으면 주석도 보입니다. 주석을 비밀 보관소로 쓰면 안 됩니다.

@ 불러오기. 마지막 줄의 @projects/now.md는 실제 파일 내용을 함께 읽게 합니다. 파일을 나눴어도 이 방식으로 전부 불러오면 매번 읽는 양은 줄지 않습니다. 다른 파일을 연달아 불러오는 깊이는 최대 4단계입니다.

백틱. 실제 Markdown 파일에서 `@projects/now.md`처럼 감싸면 경로를 설명하는 글자가 됩니다. 현재 우선순위를 자동으로 읽게 하려면 @projects/now.md를 백틱 없이 적어야 합니다. 파일이 비어 있으면 함께 읽어도 알 수 있는 우선순위는 없습니다.

개인 메모와 전역 지침

파일적용 범위사용 예
CLAUDE.md이 프로젝트관련 파일을 읽고 답하기
CLAUDE.local.md이 작업 폴더의 개인 지침나만 쓰는 답변 형식
~/.claude/CLAUDE.md내 컴퓨터의 여러 프로젝트기본 언어와 공통 선호

~/는 내 사용자 홈 폴더를 뜻합니다. 전역 지침은 범위가 넓으므로 한 프로젝트의 세부 내용을 넣지 마세요. 개인 메모도 Claude에 읽힐 수 있으므로 비밀번호나 API 키를 적지 않습니다.

.gitignore에 추가할 한 줄
CLAUDE.local.md
Git을 쓰는 경우 이 파일을 새 커밋에 넣지 않도록 합니다. 이미 추적 중인 파일은 이 줄만 추가해도 추적이 해제되지 않습니다.

직접 쓰기 어렵다면 /init

Claude Code 입력창에서 /init을 실행하면 프로젝트를 살펴보고 시작 지침을 제안합니다. 대화형 초기 설정을 쓰려면 Claude를 실행하기 전에 환경변수 CLAUDE_CODE_NEW_INIT=1을 설정합니다.

macOS·Linux의 Bash/Zsh 터미널에서 실행
CLAUDE_CODE_NEW_INIT=1 claude
Claude가 열린 다음 입력창에 /init을 입력합니다. 폴더와 생성 제안을 확인한 뒤 적용하세요.
Windows PowerShell에서 실행
$env:CLAUDE_CODE_NEW_INIT="1"
claude
Claude 입력창에서 /init을 실행합니다. 이 환경변수는 현재 PowerShell 세션에 적용됩니다.

대화형 /init은 만들 항목을 묻습니다. 프로젝트 탐색과 후속 질문을 마치면 검토할 제안을 보여 줍니다. 이번 실습의 전체 설정 프롬프트와 둘 다 실행할 필요는 없습니다. 한 경로로 만든 뒤 결과를 확인하세요.

04

2계층 · 파일을 다룰 때만 읽는 규칙

인물 기록의 항목과 초안 문체를 따로 저장합니다. paths는 규칙을 적용할 파일의 경로 범위입니다.

.claude/rules/people.md를 만들고 아래 내용을 넣습니다. 맨 위의 --- 두 줄 사이가 설정 영역입니다. 파일 첫 줄부터 시작해야 하며 들여쓰기를 유지합니다.

.claude/rules/people.md 내용
---
paths:
  - "people/**"
---
# 인물·회사 기록
- 항목은 Who, How we met, Last contact, Open threads로 구성한다.
- Last contact는 실제 마지막 연락 날짜다. 확인된 연락이 있을 때만 갱신한다.
- 파일을 편집한 날짜를 마지막 연락일로 바꾸지 않는다.
- 연락 날짜를 모르면 미확인이라고 쓴다.
- 비밀번호, 카드번호, 신분증 번호를 저장하지 않는다.
Last contact는 ‘파일 수정일’과 다릅니다. 연락하지 않고 메모만 고쳤다면 날짜를 그대로 둡니다. 두 날짜를 섞으면 나중에 30일 이상 연락이 없는 사람을 찾을 수 없습니다.

다음으로 .claude/rules/writing.md에 초안 기준을 넣습니다.

.claude/rules/writing.md 내용
---
paths:
  - "drafts/**"
---
# 초안 작성 기준
- 짧고 구체적인 문장으로 쓴다. 의미 없는 도입 문장을 빼라.
- 사실 주장은 바로 아래 줄에 출처를 적는다.
- 출처를 확인하지 못했으면 미확인이라고 표시한다.
- 연습용 예시를 실제 성과나 실제 기록처럼 쓰지 않는다.

“인물 이야기를 했다”만으로 켜지지는 않습니다

조건부 규칙은 Claude가 경로가 맞는 파일을 읽거나 쓰거나 편집할 때 불러옵니다. people/kim-mina.md를 읽으면 인물 규칙이, drafts/weekly-newsletter.md를 다루면 글쓰기 규칙이 적용되는 식입니다. 주제만 언급하고 파일을 열지 않았다면 규칙이 불러와졌다고 단정하지 마세요.

paths가 없는 규칙은 시작할 때 읽습니다. 여러 프로젝트에 쓸 개인 규칙은 ~/.claude/rules/에도 둘 수 있습니다. 긴 규칙을 잘게 쪼개더라도 paths를 빼면 매번 읽는 양은 그대로 늘어납니다.

적용 확인 요청

Claude Code에 붙여 넣기
people/kim-mina.md를 읽어줘.
그 파일의 내용에 적용되는 인물 기록 규칙을 설명하고
어떤 규칙 파일을 읽었는지 경로를 알려줘.
파일은 수정하지 마.
kim-mina.md는 7장의 연습 데이터로 만듭니다. 파일이 없으면 없다고 말하는 것이 정상입니다.

Claude의 설명과 터미널의 Loaded 표시를 함께 확인합니다. 더 엄밀히 추적해야 할 때는 공식 문서의 InstructionsLoaded 훅을 쓸 수 있습니다. 규칙 파일이 생성돼 있다는 사실만으로 적용 성공을 판정하지 마세요.

05

3계층 · 반복 절차를 스킬로 만들기

스킬은 쉽게 말하면 이름을 붙여 다시 실행하는 작업 설명서입니다. 항상 알아야 할 사실보다 여러 단계로 처리하는 일에 어울립니다.

매주 “프로젝트를 읽고, 막힌 일을 찾고, 연락 기록을 확인해서 보고서를 저장해줘”라고 반복한다면 스킬로 묶으세요. 폴더 .claude/skills/weekly-review/ 안에 SKILL.md를 만듭니다.

.claude/skills/weekly-review/SKILL.md 내용
---
name: weekly-review
description: 세컨드 브레인의 프로젝트와 인물 기록을 주간 점검해 달라고 요청할 때 사용한다.
---
1. 현재 날짜를 확인하고 projects/의 파일을 읽는다.
2. 각 프로젝트의 이번 주 변화, 막힘, 다음 행동을 정리한다.
   이전 상태나 날짜 기록이 없으면 변화 여부는 미확인으로 남긴다.
3. people/ 파일을 읽고 실제 Last contact가 현재 날짜보다
   30일 넘게 오래된 사람을 표시한다. 날짜가 없거나 미래이면 따로 표시한다.
4. 이번 대화에서 사용자가 확정한 결정만 이유와 함께 decisions.md에 추가한다.
   확정한 결정이 없으면 추가하지 않는다. 이미 기록한 결정은 중복하지 않는다.
5. notes/weekly-review-YYYY-MM-DD.md에 결과를 저장한다.
   같은 날짜 파일이 있으면 먼저 읽고 중복 없이 갱신한다.
6. 확인한 원본 파일과 수정한 파일을 보고한다.
   메시지 발송, 일정 등록, 외부 업로드는 실행하지 않는다.

name은 부를 이름, description은 어떤 요청에서 쓸지 알려 주는 설명입니다. “도움이 필요할 때”보다 “프로젝트와 인물 기록의 주간 점검을 요청할 때”처럼 구체적으로 적습니다.

Claude Code 입력창에서 아래처럼 직접 부르거나 “내 세컨드 브레인을 주간 점검해줘”라고 요청할 수 있습니다. 확실히 이 스킬을 쓰게 하려면 직접 부르는 방식을 택하세요.

Claude Code 입력창에서 실행
/weekly-review

설명과 본문은 읽는 시점이 다릅니다

일반적인 스킬은 이름·설명이 목록으로 맥락에 들어가고 긴 본문은 사용할 때 읽습니다. 따라서 “사용하지 않는 날은 토큰이 완전히 0”이라고 설명하면 부정확합니다. 길고 반복적인 절차를 기본 지침에서 분리하면 매번 읽는 부담을 줄일 수 있습니다.

이 스킬을 만들었다고 금요일마다 자동 실행되지는 않습니다. 스킬과 예약 실행은 별개입니다. 지금은 필요할 때 직접 호출해 결과를 확인합니다.

주간 점검 결과에서 볼 것: 프로젝트의 다음 행동, 실제 날짜로 계산한 오래된 연락, 근거가 없는 항목의 ‘미확인’ 표시, 저장된 보고서 경로입니다.

기능 근거: Claude Code 스킬 문서

06

4계층 · 교정을 자동 기억에 남기기

Claude는 다음 대화에도 도움이 될 선호와 교정 내용을 골라 기록합니다. 모든 대화를 통째로 저장하거나 모든 교정을 매번 기록하는 기능은 아닙니다.

공식 문서의 기본 구분은 사용자 정보 user, 교정 feedback, 진행 맥락 project, 외부 정보 위치 reference입니다. “알겠습니다”라는 답을 받았으면 실제 저장 파일까지 확인하세요.

저장 위치와 읽는 한도

기본 위치는 ~/.claude/projects/<project>/memory/입니다. 이 안의 MEMORY.md는 세부 기억으로 가는 색인입니다. 시작할 때 읽는 범위는 이 색인의 앞 200줄 또는 25KB 중 먼저 도달하는 한도까지입니다. 다른 기억 파일 전부가 그 한도 안에 합쳐서 읽히는 뜻은 아닙니다. 세부 파일은 필요할 때 따로 읽습니다.

같은 Git 저장소의 하위 폴더와 여러 작업 사본은 기본적으로 자동 기억을 공유합니다. 작업 사본을 worktree라고 부릅니다. Git 저장소가 아니면 프로젝트 루트를 기준으로 구분합니다. 기억은 컴퓨터 로컬에 있으므로 다른 컴퓨터나 클라우드 세션으로 자동 공유된다고 기대하지 마세요.

저장하고 바로 확인하기

1. Claude Code에 기억 요청
기억해줘. 나는 주간 뉴스레터 초안에서 사실 주장 바로 아래에
출처를 적는 형식을 선호해. 확인되지 않은 내용은 미확인으로 표시해줘.
저장했다면 실제로 바꾼 자동 기억 파일 경로와 저장한 내용을 보여줘.
이미 같은 기억이 있으면 중복으로 만들지 마.
2. Claude Code 입력창에서 열기
/memory
자동 기억 켜짐 여부를 보고 auto memory 폴더를 엽니다. MEMORY.md의 색인과 연결된 세부 파일을 직접 확인하세요.

이후 같은 폴더에서 새 세션을 열고 “뉴스레터 초안을 어떤 형식으로 써야 하는지 기억 파일을 읽고 알려줘”라고 요청합니다. 답이 맞는지와 근거 파일을 함께 봅니다. 기존 글쓰기 규칙과 겹치면 Claude가 중복 기억을 만들지 않을 수 있습니다.

“기억해줘”와 “CLAUDE.md에 넣어줘”

앞의 요청은 자동 기억을 대상으로 합니다. 매번 지켜야 하는 공통 지침에 직접 넣으려면 “이 원칙을 CLAUDE.md에 추가해줘”라고 명확히 말합니다. 사람·폴더별 규칙을 아무 생각 없이 양쪽에 복제하면 충돌을 찾기 어려워집니다.

로컬 일반 세션은 자동 기억이 기본으로 켜져 있지만 환경에 따라 다릅니다. /memory에서 확인하세요. 다른 Claude 세션이 시작한 중첩 세션이나 백그라운드 세션은 이 화면에서 켤 수 없는 경우가 있습니다. 그때는 터미널에서 직접 시작한 세션으로 확인합니다. 자동 기억을 꺼도 CLAUDE.md까지 꺼지는 것은 아닙니다.

07

한 번에 구축하고 새 세션에서 확인하기

아래 전체 요청을 Claude Code 입력창에 붙여 넣으면 됩니다. 파일을 만든 다음에는 연습 데이터를 넣고 새 대화에서 다시 읽어 확인합니다.

1. 빈 폴더에서 설정 요청 실행

2장에서 만든 second-brain 폴더가 맞는지 확인하세요. 아래는 원문의 설정 목적을 한국어로 다시 구성한 전체 요청입니다. 연락일·결정 기록을 지어내지 않도록 확인 기준을 보강했습니다.

전체 설정 요청 · 빈 폴더에서 사용
현재 열린 빈 폴더에 Claude Code용 세컨드 브레인을 만들어줘.
기존 파일이 있으면 먼저 읽고 충돌을 보고해. 기존 내용을 덮어쓰지 마.
공식 기억 문서 https://code.claude.com/docs/en/memory 를 기준으로 해.

1. notes/, people/, projects/, drafts/를 만든다.
2. CLAUDE.md는 200줄 미만을 목표로 만든다.
   - 폴더 역할과 일반 기록의 소문자-하이픈 파일명 규칙을 적는다.
   - 주제 하나당 파일 하나. 지정된 설정 파일명은 유지한다.
   - 한국어로 간결하게 답한다.
   - 기록을 묻는 질문은 관련 파일부터 읽고 사용한 파일 이름을 밝힌다.
   - 근거가 없으면 없다고 말하고 만들 파일을 제안한다.
   - 맨 위에 사람이 볼 HTML 블록 주석을 하나 둔다.
3. .claude/rules/people.md를 만든다.
   첫 줄부터 ---로 감싼 YAML 설정을 넣고 paths를 ["people/**"]로 지정한다.
   항목은 Who, How we met, Last contact, Open threads다.
   마지막 연락일은 실제 확인된 연락이 있을 때만 바꾼다.
   파일 수정일을 연락일로 쓰지 않는다. 날짜를 모르면 미확인으로 둔다.
   비밀번호, 카드번호, 신분증 번호는 저장하지 않는다.
4. .claude/rules/writing.md를 만든다.
   첫 줄부터 ---로 감싼 YAML 설정을 넣고 paths를 ["drafts/**"]로 지정한다.
   짧고 구체적인 문장, 불필요한 도입 제거,
   사실 주장 바로 아래 출처, 미검증 내용은 미확인 표시를 규칙으로 쓴다.
5. .claude/skills/weekly-review/SKILL.md를 만든다.
   첫 줄부터 name: weekly-review 와 주간 점검용 description을
   ---로 감싼 YAML 설정에 넣는다. 본문에는 다음 순서를 쓴다.
   - 현재 날짜를 확인하고 projects/를 읽는다.
   - 이번 주 변화, 막힘, 다음 행동을 정리한다.
     이전 상태 기록이 없으면 변화 여부를 추정하지 않는다.
   - people/의 실제 Last contact가 30일 넘게 오래된 사람을 표시한다.
     날짜 없음과 미래 날짜는 따로 표시한다.
   - 이번 대화에서 사용자가 확정한 결정과 이유만 decisions.md에 추가한다.
     결정이 없으면 추가하지 않으며 기존 결정은 중복하지 않는다.
   - notes/weekly-review-YYYY-MM-DD.md에 저장한다.
     같은 날짜 파일이 있으면 읽고 중복 없이 갱신한다.
   - 근거 파일과 수정 파일을 보고한다.
   - 외부 메시지 발송, 일정 등록, 업로드는 하지 않는다.
6. decisions.md와 projects/now.md에는 제목과 비어 있는 항목만 만든다.
   CLAUDE.md 끝에 @projects/now.md를 백틱 없이 적어 불러오게 한다.
7. CLAUDE.local.md에는 제목만 만든다.
   .gitignore의 기존 내용을 유지하면서 CLAUDE.local.md를 추가한다.
8. 내 메모, 인물, 결정, 프로젝트 내용을 지어내지 않는다.
   자동 기억은 별도로 꾸며 만들지 말고 /memory 확인 방법을 알려준다.
9. 완성 트리, 실제 생성한 파일, CLAUDE.md 줄 수,
   규칙의 paths, 스킬의 name/description을 확인해서 보고한다.
   /context와 /memory는 내가 Claude Code 입력창에서 실행하도록 안내한다.

완료 답변에서 파일 트리와 생성 파일을 확인합니다. 숨김 폴더인 .claude가 파일 탐색기에서 보이지 않으면 숨김 파일 표시를 켜거나 Claude에게 실제 경로를 확인해 달라고 요청하세요.

2. 불러온 지도 확인

Claude Code 입력창에서 /context를 실행합니다. Memory files에 시작 시 읽어야 하는 CLAUDE.md가 있는지 확인합니다. 새 설정이 반영되지 않았으면 같은 폴더에서 새 세션을 열고 다시 봅니다. /memory로 자동 기억 상태도 확인합니다.

3. 비어 있는 폴더에 연습 기록 넣기

가상 데이터 입력 요청
아래는 실습을 위한 가상 기록이야. 실제 사람이나 업무 기록으로 취급하지 마.
기존 파일이 있다면 먼저 읽고 연습 내용으로 덮어쓰지 마.

projects/now.md에 다음 항목을 저장해줘.
- 제목: 주간 뉴스레터 준비 (연습용)
- 상태: 자료 정리 중
- 마지막 작업: 공식 문서 후보를 모음
- 다음 행동: 초안의 사실 주장과 출처를 대조
- 막힘: 공식 출처 확인 전이라 초안을 확정하지 못함

people/kim-mina.md에 다음 연습용 인물 카드를 저장해줘.
- Who: 김미나, 연습용 동료
- How we met: 뉴스레터 스터디에서 만남 (가상 설정)
- Last contact: 미확인
- Open threads: 뉴스레터 검토 요청 여부 확인

notes/newsletter-sources.md에는 아래 주소를 참고 후보로 저장해줘.
https://code.claude.com/docs/en/memory
이 단계에서 페이지를 읽은 것으로 표시하지 마.

drafts/weekly-newsletter.md에는 제목 ‘주간 뉴스레터 초안 (연습용)’만 만들어줘.
decisions.md에는 확정된 결정이 없으므로 새 결정을 쓰지 마.
저장 후 실제 파일을 다시 읽고 입력한 항목과 일치하는지 보여줘.

Claude가 원본에 없는 마감일이나 과거 연락일을 덧붙이지 않았는지 파일을 다시 읽어 봅니다. projects/now.md는 자동으로 불러오므로 짧게 유지합니다.

4. 같은 폴더에서 새 세션 열기

현재 대화를 끝내고 같은 second-brain 폴더에서 Claude Code를 다시 시작합니다. 이전 대화를 이어 여는 /resume 대신 새 대화로 확인합니다. 다음 요청에는 이전 내용을 다시 설명하지 않습니다.

새 세션 확인 요청
현재 진행 중인 프로젝트와 다음 행동을 기록 파일에서 찾아 알려줘.
초안을 쓸 때 지킬 출처 규칙도 실제 파일을 읽고 설명해줘.
근거 파일 이름을 함께 적고 파일은 수정하지 마.
CHECK기대하는 답변의 내용 · 실제 실행 로그 아님

프로젝트: 주간 뉴스레터 준비 (연습용).
다음 행동: 초안의 사실 주장과 출처를 대조.
초안 기준: 사실 주장 바로 아래에 출처를 적고 미확인은 표시.
근거: projects/now.md, .claude/rules/writing.md.

문장이 똑같을 필요는 없습니다. 원본과 일치하는 내용과 근거 경로가 있어야 합니다.

5. 주간 점검 실행

/weekly-review를 실행하고 실제로 저장된 notes/weekly-review-YYYY-MM-DD.md를 열어 봅니다. 김미나의 마지막 연락일은 미확인이므로 ‘30일 초과’로 계산하면 잘못입니다. 이전 주 기록도 없으므로 ‘이번 주 크게 진척됨’처럼 변화를 지어내면 안 됩니다.

첫 성공 확인: 새 세션에서 다음 행동을 찾고, 적용할 문체 규칙을 읽고, 점검 보고서가 실제 파일로 저장되면 기본 흐름을 확인한 것입니다. 한 번의 성공이 앞으로 모든 지침을 지킨다는 보장은 아닙니다.
08

언제 읽는지와 관리 명령어

기억 파일은 같은 순간에 전부 읽히지 않습니다. 시작 시 불러올 내용과 파일을 다룰 때 불러올 내용을 나눠서 점검하세요.

상황읽는 내용확인할 점
세션 시작사용자 범위 지침, 작업 폴더와 상위 경로의 CLAUDE.md·CLAUDE.local.md, 조건 없는 규칙, 자동 기억 색인 일부상위 경로부터 합쳐짐. 같은 폴더에서는 local이 뒤에 추가됨
하위 폴더 파일을 읽거나 쓰거나 편집그 하위 폴더의 지침과 경로가 맞는 규칙기존 지침을 지우고 교체하는 방식이 아님
스킬 호출해당 스킬의 본문일반 스킬은 설명 목록에도 맥락을 사용
/compact 이후프로젝트 루트의 CLAUDE.md 재주입, 하위 지침·조건부 규칙은 필요할 때 다시 로드대화에만 쓴 지침은 같은 수준으로 보존되지 않을 수 있음

예를 들어 상위 파일에 “영어로 답하기”, 프로젝트 파일에 “한국어로 답하기”가 동시에 있으면 뒤의 파일만 남는다고 생각하면 안 됩니다. 파일들은 합쳐집니다. 충돌 자체를 없애는 편이 낫습니다.

긴 파일의 한도는 구분해서 보기

CLAUDE.md를 200줄 미만으로 유지하라는 권장과 자동 기억 색인의 ‘200줄 또는 25KB’ 한도는 별개입니다. 필요할 때 읽는 하위 지침·규칙에도 파일별 한도가 있습니다. 공식 문서상 200K 문맥 창에서는 40,000자이며, 초과하면 앞부분과 나머지를 읽으라는 안내만 전달됩니다. 이 동작은 v2.1.309부터 적용됩니다. 1M 문맥 창은 모델에 따라 한도가 달라지므로 현재 한도를 확인하세요.

자주 쓰는 다섯 가지 입력

입력어디에 입력무엇을 확인하나
/initClaude Code 입력창시작 지침 생성·개선 제안. 대화형은 실행 전 환경변수 설정
/memoryClaude Code 입력창기억 파일 위치, 자동 기억 상태, 기억 폴더 열기
/contextClaude Code 입력창시작 시 읽힌 Memory files와 사용 중인 맥락
/doctor prompt-auditClaude Code 입력창충돌·낡은 지침·깨진 참조 점검. v2.1.283 이상
“기억해줘 …”Claude Code에 일반 문장선호 저장 요청. 저장 후 실제 파일까지 확인

/doctor prompt-audit는 수정 제안과 보고를 먼저 내며 적용을 요청하기 전에는 파일을 바꾸지 않습니다. 이 기능은 번들 /claude-api 스킬이 꺼져 있으면 사용할 수 없습니다. 명령이 보이지 않으면 터미널에서 claude --version으로 버전을 확인하고 /help와 공식 문서를 봅니다.

/context에 없다는 이유만으로 모든 파일을 실패로 판정하지 마세요. 하위 폴더 지침과 조건부 규칙은 시작 시 목록에 없을 수 있습니다. 해당 폴더의 파일을 실제로 읽게 한 뒤 로드 표시를 확인합니다.

반드시 지켜야 할 금지는 실행 관문으로

“외부로 보내지 마”라는 문장을 기억 파일에 적으면 행동 지침이 됩니다. 실행을 기술적으로 막아야 한다면 도구 권한과 PreToolUse 훅의 차단 조건을 설계하고 테스트해야 합니다.

  1. 막으려는 실행 경로가 훅의 대상 도구와 일치하는지 확인합니다.
  2. 실제로 금지 입력을 주었을 때 실행 전에 거부되는지 확인합니다. 명령 훅은 차단에 exit 2 등을 사용합니다.
  3. 검사 스크립트가 없거나 오류·시간 초과가 나도 실행을 막아야 한다면 실패 처리를 확인합니다. 지원 버전에서는 onFailure: "block"을 사용할 수 있습니다(v2.1.295 이상).

일반적인 훅 오류나 시간 초과가 항상 실행을 막는 것은 아닙니다. ‘훅이 있으니 안전하다’고 판단하지 말고 실제 대상과 실패 상황을 검사하세요. 이 가이드의 기본 설정 요청은 훅을 설치하지 않습니다.

기능 근거: 훅 실패 처리

09

완료 점검과 내 업무에 적용하기

점수보다 ‘어디에서 기억이 끊기는지’를 확인합니다. 아래 항목을 실제 파일과 새 세션 결과로 점검하세요. 체크 목록은 표시용이며 클릭 상태를 저장하지 않습니다.

‘아니오’가 있는 항목부터 고칩니다. 단순히 개수가 많다는 이유로 기억 시스템 전체가 무효라고 판정하지 않습니다. 마지막으로 7장의 새 세션 실습까지 끝내야 실제 사용 흐름을 확인할 수 있습니다.

자주 막히는 부분

CLAUDE.md가 Memory files에 보이지 않아요

현재 작업 폴더를 먼저 확인합니다. 파일명과 위치가 맞는지 보고 /memory로 해당 파일을 엽니다. 같은 폴더에서 새 세션으로 다시 확인하세요. 하위 폴더의 지침이라면 시작 시 목록에 없을 수 있으므로 그 폴더의 다른 파일을 읽게 합니다. 조직 정책이나 로드 제외 설정이 있는 환경은 공식 문제 해결 문서도 확인하세요.

people 규칙이 글쓰기 작업에도 계속 보입니다

people.md 맨 위의 --- 설정과 paths 들여쓰기를 확인하세요. paths가 없거나 YAML이 깨지면 조건 없는 규칙처럼 읽힐 수 있습니다. CLAUDE.md에서 규칙 파일을 @로 직접 불러오고 있지도 않은지 봅니다. 수정 후 새 세션에서 다시 확인합니다.

“기억했어”라고 했는데 기억 폴더가 비어 있어요

/memory에서 자동 기억 켜짐 여부를 확인하고 실제 저장 경로를 요청하세요. 기존 지침과 겹쳐 새 파일을 만들지 않은 것인지도 확인합니다. 매번 적용할 공통 원칙이면 CLAUDE.md에 명시적으로 추가하되 중복 규칙은 정리합니다.

/weekly-review가 안 보이거나 다른 작업에 켜집니다

.claude/skills/weekly-review/SKILL.md 경로와 대소문자를 확인하세요. 첫 줄부터 설정을 시작하고 name과 description을 확인합니다. 새 세션에서 / 메뉴를 다시 보세요. 너무 자주 켜지면 description을 주간 점검 상황으로 좁히고, 수동 호출만 원하면 disable-model-invocation: true를 추가할 수 있습니다.

200줄 아래인데도 지침을 무시해요

줄 수는 권장 기준일 뿐 준수 보장이 아닙니다. “깔끔하게” 같은 표현을 관찰 가능한 조건으로 바꾸고 상위·전역 지침과 충돌하는지 확인합니다. 예를 들어 “사실 주장 바로 아래에 출처 한 줄”처럼 씁니다. 중요한 실행 금지는 별도의 권한·훅 검사가 필요합니다.

다른 컴퓨터나 worktree에서 개인 메모가 없어요

자동 기억은 기본적으로 컴퓨터 로컬에 있습니다. 같은 Git 저장소의 worktree는 자동 기억을 공유하지만 gitignore한 CLAUDE.local.md 파일까지 자동 복사되지는 않습니다. 공유할 규칙과 개인 파일을 구분하고 필요한 파일의 실제 위치를 다시 확인하세요.

복사 버튼이 작동하지 않아요

브라우저가 클립보드 접근을 막을 수 있습니다. 실패 안내가 뜨면 선택된 상자 안의 본문을 직접 복사하세요. Mac은 Command+C, Windows는 Ctrl+C를 사용합니다. 상자 제목이나 해설은 Claude에 붙여 넣지 않습니다.

주간 뉴스레터에서 내 업무로 바꾸기

폴더와 설정 파일 이름은 유지하고 프로젝트 이름·다음 행동·초안 규칙을 바꿉니다. 예를 들어 제안서를 준비한다면 projects/now.md의 제목을 ‘서비스 제안서 준비’로, 다음 행동을 ‘공식 기능표와 고객 요구사항을 대조’로 바꿉니다. drafts/의 문체 규칙은 제안서에도 계속 적용됩니다.

금요일에는 주간 점검을 직접 부르고 다음 행동을 확인하세요. 결정한 날에만 decisions.md에 결정과 이유를 남깁니다. 프로젝트를 마쳤으면 now.md에서 빼고 별도 프로젝트 파일로 옮깁니다. 세부 기록을 현재 우선순위에 계속 쌓지 않습니다.

내 업무로 바꾸는 요청 · 채워진 예시
프로젝트를 제안서 준비로 바꿀게.
projects/now.md를 먼저 읽고 현재 뉴스레터 기록을 별도 프로젝트 파일로 보존해줘.
다음 내용을 현재 우선순위에 반영해줘.
- 제목: 서비스 제안서 준비
- 상태: 요구사항 정리 중
- 다음 행동: 공식 기능표와 고객 요구사항을 대조
- 막힘: 고객 요구사항 원본 확인 전
마감일과 고객 이름은 아직 정하지 않았으니 만들지 마.
기존 drafts/ 문체 규칙은 유지하고 수정한 파일을 다시 읽어 확인해줘.

이 예시에서 바꿀 자리는 제목·상태·다음 행동·막힘입니다. 실제 고객 이름과 마감일은 확인됐을 때만 추가하세요. 규칙을 고친 날에는 새 세션에서 한 번 더 읽게 해 변경 내용을 확인합니다.

참고한 자료

제공 원문: mojesko (@mojeskoqq), 「Claude Second Brain 2.0: The Complete Guide」, 10월 30일 게시로 제공된 본문. 원문의 주요 내용을 한국어 실습 가이드로 재구성했습니다. 정확한 게시물 주소는 제공되지 않았습니다.

현재 기능 확인: 기억과 지침 · 스킬 · 훅 · 설치와 시작. 문서 확인 기준일 2026-11-03. 실습의 답변과 파일 트리는 교육용 예시이며 Claude Code 실제 실행 로그가 아닙니다.