Claude Code가 내 4시간 세션을 잃어버렸어요. 실제로 작동하는 $0 해결책
Source: Dev.to
It Happened on a Friday Afternoon
복잡한 인증 리팩터링을 진행한 지 4시간 차—상태 머신, 엣지 케이스, Claude와 내가 함께 구축한 미묘한 컨텍스트—all—Claude의 응답이 일반적인 내용으로 돌아왔습니다. 우리가 내린 아키텍처 결정과 선택 뒤에 있는 섬세한 “왜”를 잊어버린 것이었습니다. 나는 컨텍스트를 다시 구축하려고 45분을 보냈지만, 완전히 복구되지 않았습니다.
Claude Code를 정기적으로 사용한다면, 이 상황을 겪어봤을 가능성이 높습니다.
Why Claude Code Loses Context
Claude Code에는 컨텍스트 윈도우 제한이 있습니다. 이 한도에 도달하면 대화를 “압축”합니다: 대화 내용을 요약해 공간을 확보합니다. 요약은 손실이 있는 방식으로 이루어지며—미묘한 아키텍처 결정, 선택 뒤의 “왜”, 그리고 섬세한 패턴들이 일반적인 설명으로 평탄화됩니다. 가장 안 좋은 점은? 경고 없이 조용히 일어난다는 것입니다. 흐름에 몰두하고 있다가 갑자기 Claude가 더 이상 당신의 코드베이스를 알지 못하게 됩니다.
Common Scenarios
- 복잡한 기능에 대한 3시간 이상 코딩 세션
- 많은 상호 의존성을 가진 리팩터링 세션
- 이전 시도가 중요한 디버깅 세션
- 많은 파일을 동시에 변경해야 하는 경우, 많은 정보를 머릿속에 유지해야 할 때
Workarounds
Approach 1: Manual CLAUDE.md Summaries
중요한 컨텍스트를 CLAUDE.md 파일에 요약해 두세요. 이는 프로젝트 수준의 컨텍스트에는 도움이 되지만, 세션별 상태—대화 흐름, 방금 시도한 내용, 작업 중간 지점—는 포착하지 못합니다.
Approach 2: Copying Conversation Snippets
번거롭습니다. 실시간으로 무엇이 중요한지 판단해야 하며, 이는 흐름을 깨뜨리고, 스니펫은 검색이 불가능합니다.
Approach 3: /compact Before It Auto‑Compacts
조금은 나아집니다—타이밍을 직접 제어할 수 있습니다. 하지만 여전히 컨텍스트를 잃게 되며, 단지 언제 잃을지를 선택하는 것뿐입니다.
Preserving the Full Conversation History
Claude Code는 대화 기록을 다음 경로에 JSONL 파일로 저장합니다:
~/.claude/projects/[project-hash]/[session-id].jsonl각 파일은 코딩 세션 전체를 기록한 것입니다. 이 파일들을 스냅샷하면 정확한 세션 상태를 복원할 수 있습니다.
Simple Backup Script
#!/bin/bash
# save-session.sh
PROJECT_DIR="$HOME/.claude/projects"
BACKUP_DIR="$HOME/.claude/session-backups/$(date +%Y%m%d_%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r "$PROJECT_DIR" "$BACKUP_DIR"
echo "Session saved to $BACKUP_DIR"위 스크립트를 위험한 작업을 수행하기 전에 실행하세요. 압축으로 컨텍스트가 사라졌을 경우, 특정 세션을 복원하려면:
# Restore a specific session
cp ~/.claude/session-backups/20260221_143022/projects/[hash]/[session].jsonl \
~/.claude/projects/[hash]/그 다음 Claude를 다음과 같이 실행합니다:
claude --resume [session-id]Automated Tool: Mantra
Mantra는 Claude Code(및 Cursor, Windsurf) 세션의 시각적 스냅샷을 생성해 Git 히스토리처럼 탐색하고 복원할 수 있게 해줍니다.
- Visual – 세션 타임라인을 시각적으로 확인
- Automatic – 작업 중 자동으로 스냅샷 생성
- Cross‑tool – Claude Code, Cursor, Windsurf와 모두 호환
mantra.gonewx.com(macOS/Windows/Linux)에서 다운로드하세요.
Broader Context
이것은 Claude Code만의 문제가 아닙니다. Cursor도 AI 채팅 히스토리에서 같은 문제를 겪고, Windsurf 세션이 사라지며, Aider는 실행 사이에 컨텍스트를 잃습니다. 우리는 모두 AI 어시스턴트와 함께 복잡한 작업을 만들고 있지만, 도구들은 아직 세션 상태를 보존할 가치가 있는 것으로 다루지 않습니다. 도구가 이를 지원하기 전까지는 우리가 직접 관리해야 합니다.
Conclusion
위 백업 스크립트는 무료이며 설정하는 데 몇 분이면 충분합니다. 앞으로 압축이 가장 안 좋은 순간에 발생하더라도, 당신의 미래의 자신이 감사할 것입니다.
압축으로 중요한 세션 컨텍스트를 잃어본 적이 있나요? 여러분만의 해결책은 무엇인가요?