Memory 와 Session
Claude가 경험으로 배우는 법, 그리고 멈춘 곳에서 이어가는 법
⏱ 예상 ~6분
01 · 읽기
CLAUDE.md 는 Claude에게 명시적인 지시를 주려고 쓰죠. 하지만 Claude Code 에는 auto memory 도 있어요 — session 중에 알게 된 것들에 대한 메모를 저장할 수 있죠. Build 명령의 잔재, 디버깅 패턴, 프로젝트별 함정 같은 거요.
이 메모는 session 을 가로질러 유지되고, Claude 는 경험으로 배워요. Auto memory 는 ~/.claude/projects/<project>/memory/ 에 살아요. 로컬이고, git 에 절대 동기화되지 않아요.
핵심 정리
- CLAUDE.md = 여러분이 명시적으로 쓴 규칙
- Auto memory = Claude가 경험에서 저장한 메모
- Memory 는 ~/.claude/projects/<project>/memory/ 에 살아요
- 로컬 전용 — git 으로 공유 안 돼요
- Claude Code 에서 /memory 명령으로 켜고 끌 수 있어요
02 · 읽기
각각의 Claude Code 대화는 하나의 session 이에요. Session 은 로컬에 저장되고 나중에 이어갈 수 있어요.
핵심 인사이트는 — session 은 처음부터 시작한다는 거예요. 새 터미널을 열고 claude 를 실행해도, 어제 무엇을 하고 있었는지 자동으로 알지 못해요. session 을 명시적으로 이어가거나, CLAUDE.md 와 memory 로 context 를 제공해야 해요.
Session 에 이름을 붙이는 건 생산성 있는 context 관리에서 가장 중요한 습관이에요.
핵심 정리
- 각 대화는 session 이고 로컬에 저장돼요
- 새 session 은 처음부터 시작해요 — 이전 대화 이력이 없어요
- 이름 붙인 session 은 나중에 찾고 이어가기 좋아요
- CLAUDE.md 와 memory 가 session 사이의 연속성을 제공해요
03 · 코드 예제
아래는 session 관리에 핵심이 되는 명령들이에요 — 이름 짓기, 이어가기, fork.
현재 session 이름 짓기
/rename "auth-refactor"
가장 최근 session 이어가기
claude --continue
최근 session 에서 고르기
claude --resume
이름 붙인 특정 session 이어가기
claude --resume auth-refactor
Session fork (현재 상태에서 새 분기)
claude --continue --fork-session
작업을 시작할 때 session 에 이름을 붙이세요 — /rename "feature-name". 프로젝트로 돌아올 때 claude --resume 을 쓰면 picker 가 뜨고 검색, 미리보기, 선택할 수 있어요. Fork 는 현재 상태에서 새 session 을 만들고 원본은 그대로 둬요.
04 · 단계별 설명
1. 시작과 이름 짓기
Claude Code를 열고 바로 /rename "내가 하는 일" 로 session 에 이름을 붙여요. 나중에 찾기 좋아요.
2. 작업 하기
Claude에게 기능 구현, 버그 수정, 테스트 작성을 요청해요. Claude 는 CLAUDE.md 와 memory 를 자동으로 읽어요.
3. 자연스럽게 끝내기
끝나면 터미널을 닫거나 Ctrl+C 를 눌러요. Session 은 자동으로 저장돼요.
4. 나중에 이어가기
돌아왔을 때 claude --resume 으로 멈춘 곳에서 이어가거나, claude --continue 로 가장 최근 session 을 이어가요.
05 · 퀴즈
어제 기능 작업을 하다가 오늘 이어서 하려고 해요. 가장 빠르게 이어가는 방법은?
- 새 session 을 열고 처음부터 다시 설명하기
- 이전 대화를 복사해서 붙여넣기
- claude --continue 로 가장 최근 session 이어가기
- CLAUDE.md 를 지우고 처음부터 다시 하기
06 · 짝짓기
각 명령을 무엇을 하는지와 짝지어요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.