본문으로 건너뛰기

# Claude Code 세션 관리 — 직접 겪으며 정리한 것

# Claude Code 세션 관리 — 직접 겪으며 정리한 것

> 2026-08-16 · KRX 데이터북 작업 중 알게 된 것들
> 비개발자 입장에서 헷갈렸던 부분 위주로 남김

---

## 🤔 시작은 이 질문이었다

작업 도중 Claude가 이런 말을 했다.

> "제 기억(**다음 세션**에도 자동으로 뜸)과 문서에 남기겠습니다"

**"다음 세션이 뭐지?"**

여기서부터 파고들었다.

---

## 세션 = 지금 이 대화 하나

간단하다. 대화창 하나 = 세션 하나.

세션이 끝나면 Claude는 그 대화를 전혀 기억 못 한다. 처음 만나는 상태가 된다.

---

## 세션이 끝나는 3가지 경우 — 사실 2종류다

| 경우 | 무슨 일 | 이어가기 |
|---|---|---|
| VS Code 껐다 켜기 | 프로그램 종료 | ⭕ 가능 |
| 다음날 다시 시작 | 위와 완전히 동일 | ⭕ 가능 |
| /clear | 문맥을 일부러 비움 | ❌ 지우는 게 목적 |

처음엔 셋이 다 같은 줄 알았는데 아니었다.

**1번과 3번(껐다 켜기 / 다음날)은 같은 일**이다. 시간 간격만 다르다.
**`/clear`만 성격이 다르다.** 사고가 아니라 의도다.

### 비유

```
껐다 켜기 / 다음날  →  책상 두고 퇴근했다가 출근
                       서류 그대로. 이어서 하면 됨

/clear             →  책상 싹 치우고 새 일 시작
                       일부러 비운 것
```

---

## 🧪 실제로 겪어봤다

작업 중간에 VS Code를 껐다 켰다. 그리고 물어봤다.

> "지금 VS코드를 끄고 다시 켰는데.. 새 세션인가요?"

**결과: 새 세션이 시작됐지만 이전 대화가 그대로 이어졌다.**

Claude가 어제 한 일(사업보고서 함정, 우선주 113개, API 78회…)을 전부 기억하고 있었다.

### 증거는 숫자에 있었다

`/context` 를 쳐보니:

```
Messages   209.3k
```

재시작 이후만이라면 몇 k 수준이어야 하는데 209.3k였다.
→ 어제 대화가 통째로 살아 있다는 뜻.

---

## 💾 3층으로 나눠 생각하면 편하다

| 층 | 어디 | 세션 끝나면 |
|---|---|---|
| ① 대화 | 지금 화면 | ❌ 사라짐 (복구 가능한 경우 있음) |
| ② 파일 | 프로젝트 폴더 (`docs/` `scripts/` data/) | ⭕ 남음. 단 읽으라고 해야 봄 |
| ③ 기억 | ~/.claude/projects/…/memory/ | ⭕ 자동으로 읽힘 |

②와 ③의 차이가 핵심이다.

- ②는 책장에 꽂힌 책 — 있는 줄 알아야 꺼내 본다
- ③은 책상 위 포스트잇 — 앉자마자 눈에 들어온다

그래서 "이건 절대 잊으면 안 된다" 싶은 건 ③(기억)에 붙였다.
예: "전 종목 전체 실행 전엔 반드시 나에게 다시 물어볼 것"

### 기억이 뜨는 범위

```
이 프로젝트 폴더에서 열 때만   →  뜸  ⭕
다른 폴더에서 열 때            →  안 뜸  ❌
웹(claude.ai)에서 열 때        →  안 뜸  ❌
```

---

## ⚖️ 이어가기 vs /clear — 장단점

### 이어가기 (돌아옴)

| 장점 | 단점 |
|---|---|
| 설명 반복 없음 | 옛 시행착오가 계속 남아 Claude가 헷갈림 |
| 미묘한 합의도 유지 | 문맥이 무거워져 자동 요약 → 세부가 뭉개짐 |
| 바로 이어서 작업 | 지나간 결정을 잘못 끌어다 씀 |

### /clear

| 장점 | 단점 |
|---|---|
| 깨끗한 머리로 시작 | 문서에 없는 건 그냥 사라짐 |
| 문맥 여유 → 오래 감 | 문서 다시 읽히는 수고 (1분) |
| 잘못 잡은 가정이 리셋 | |

### 👉 핵심 깨달음

```
문서가 부실하면  →  /clear = 위험
문서가 튼튼하면  →  /clear = 저렴
```

**`/clear`의 단점은 문서화로 없앨 수 있다.**
그래서 작업하면서 결정을 계속 문서에 적어두는 게 중요했다.

---

## 🆕 그런데 더 나은 방법이 있었다 — New session

왼쪽 사이드바의 `+ New session`.

| | /clear | New session |
|---|---|---|
| 지금 대화 | 비워짐 | 그대로 남음 ⭕ |
| 되돌아가기 | 어려움 | 클릭 한 번 ⭕ |

**New session이 /clear보다 낫다.** 안전망이 있으니까.

```
목록
 ├ KRX 분기 실적…    ← 기존 대화. 보존
 └ (새 대화)        ← 여기서 새 작업
```

### ⚠️ 주의

두 대화가 같은 폴더의 같은 파일을 건드린다.
**한 번에 하나만** 작업시킬 것. 동시에 시키면 서로 덮어쓴다.

---

## 📊 용량 확인 — /context

```
/context
```

실제로 나온 화면:

```
claude-opus-5
253.0k / 1.0M tokens (25%)

System prompt      3.9k    0.4%
System tools      20.6k    2.1%
Custom agents     12.2k    1.2%
Memory files       1.4k    0.1%
Skills             6.0k    0.6%
Messages         209.3k   20.9%   ← 실제 대화
Free space       746.6k   74.7%
```

### 읽는 법

- 앞의 5개(**약 44k**)는 고정비. 새로 시작해도 그대로 들어감
- `/clear`로 줄어드는 건 Messages뿐

```
지금        253k  (25%)
clear 후    약 44k  (4%)
```

### 기준선

| 사용량 | 상태 |
|---|---|
| ~50% | 여유 |
| 70~80% | 정리할 때 |
| 90%+ | 자동 요약 시작 → 이미 늦음 |

---

## 🚨 숫자 안 봐도 알아채는 신호

| 신호 | 뜻 |
|---|---|
| "이전 대화 요약" 표시가 뜬다 | 이미 꽉 참. 즉시 정리 |
| Claude가 앞에서 한 얘기를 잘못 기억한다 | 요약으로 세부가 뭉개짐 |
| 응답이 눈에 띄게 느려진다 | 문맥이 무거워짐 |

---

## ✅ 언제 새 세션이 필요한가

| 신호 | |
|---|---|
| 큰 단계가 바뀔 때 (A작업 → B작업) | 앞 단계 시행착오가 방해 |
| 용량이 70~80% | 자동 요약 전에 |
| 시행착오가 많이 쌓였을 때 | Claude가 헷갈림 |
| 날짜가 바뀔 때 | 자연스러운 끊는 점 |

### 반대로 — 단계 중간엔 끊지 말 것

다음 세션이 애매해진다. 한 단계를 끝내고 끊는 게 좋다.

---

## 📋 안전하게 넘어가는 순서

```
1.  /context                              →  얼마나 찼나
2.  "이 대화에만 있고 문서엔 없는 거 있어?"   →  Claude가 점검
3.  빠진 것 문서에 기록
4.  + New session                         →  기존 대화는 보존
5.  "docs 읽어줘. 다음 작업 시작하자"
```

**2번이 핵심이다.** 이것만 하면 뭘 잃을 걱정이 없다.

---

## 💡 한 줄 정리

> 대화는 도구고, 결과는 파일에 있다.
> 오늘 대화가 통째로 사라져도 문서와 코드가 남아 있으면 작업은 안 날아간다.

그래서 작업하면서 문서를 계속 정비했다.

```
HANDOFF.md    설계도 — 무엇을 만드나
DECISIONS.md  결정 기록 — 왜 이렇게 정했나
PROGRESS.md   진행 현황 — 어디까지 왔나
memory/       포스트잇 — 절대 잊으면 안 되는 것
```

이 4개만 있으면 세션이 몇 번 끊겨도 이어갈 수 있다.

---

## ❓ 아직 확인 못 한 것

- 세션 목록이 몇 개까지 유지되는지, 오래되면 지워지는지 [미확인]
- 이번 재시작에서 이어가기가 자동으로 된 건지, 확장이 복구한 건지 [미확인]
  → 결과적으로 이어졌다는 것만 사실

**중요한 건 계속 문서에 남기는 게 안전하다.**

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

김도경 프로필 이미지
김도경2026.09.27

좋은 글 잘 읽었습니다~

박준_JoonLab 프로필 이미지
박준_JoonLab2026.08.19

재시작 후에 이어졌다는 걸 느낌이 아니라 '/context'의 Messages 209.3k로 판정하신 대목이 인상 깊습니다. 문서가 부실하면 /clear가 위험하고 튼튼하면 저렴해진다는 결론도, 저는 도착하는 데 시간이 꽤 걸렸는데 세션 한 번으로 잡아내셨네요.

한 가지 보태자면, 저는 한 프로젝트의 핸드오프를 전수조사했다가 42건 중 41건이 같은 세션 ID였던 걸 뒤늦게 발견한 적이 있습니다. 문서는 매번 갱신했는데 세션은 30일을 통째로 이어간 거였어요. 문서를 잘 쓰는 것과 실제로 끊는 것이 별개의 일이더라고요.

그래서 정리해주신 새 세션 신호에 하나만 더 얹어보시면 좋을 것 같습니다. 예를 들어, 한 대화에서 "아까 그건 아니었고"를 두 번 이상 말했다면 용량과 무관하게 새 세션이 낫습니다. 교정된 결론은 문서에 남고 틀린 원본은 대화에만 남는데, 이어가면 자동 요약에서 "철회됨" 꼬리표가 먼저 흐려지거든요. 이 경우 새 세션은 절약이 아니라 정확도 개선이 됩니다.

화이팅입니다!!

뽀짝이 프로필 이미지
뽀짝이2026.08.16

비개발자 시각에서 직접 실험으로 검증한 게 이 글의 가장 큰 강점이에요. "재시작 이후만이라면 몇 k 수준이어야 하는데 209.3k였다"—이걸 /context로 직접 확인해서 증명한 부분, 그냥 설명을 읽는 것보다 훨씬 설득력이 있어요.

3층 구조 비유(대화=사라짐, 파일=책장, 기억=포스트잇)도 딱 맞아요. 특히 ②와 ③의 차이—"있는 줄 알아야 꺼내 본다" vs "앉자마자 눈에 들어온다"—이렇게 정리하면 처음 쓰는 사람도 바로 감이 오거든요.

"문서가 튼튼하면 /clear = 저렴"이라는 깨달음도 인상 깊어요. /clear를 두려워하는 이유 대부분이 문서화 부재에서 오는 건데, 그걸 명확하게 짚었어요. 안전하게 넘어가는 5단계 순서도 실제로 써먹을 수 있는 형태라서 좋아요.

고롱고롱… 이런 실험 기록 보면 저도 자세 고쳐 앉게 돼요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기