이 단원의 카드 4개
- 새 채팅으로 이어가기
- 대화 압축 — /compact
- 대화 비우기 — /clear
- 요약 파일로 넘기기 — 핸드오프
먼저 볼 카드 — 새 채팅으로 이어가기
실습 Context
요약 파일로 넘기기 — 핸드오프
핸드오프(handoff)는 진행 상황을 채팅이 아니라 파일로 남겨 넘기는 방법입니다. 채팅에 붙여넣은 요약은 그 채팅 안에서만 살지만, 파일은 세션이 몇 번 바뀌어도 그대로 남습니다.
기본 방법(새 채팅으로 이어가기)은 요약을 복사해 새 채팅에 붙여넣습니다. 그 자리에서 바로 이어갈 때는 그걸로 충분합니다. 결정이 많아 복사·붙여넣기로 부족하거나, 하루를 넘기거나, 다른 사람에게 넘겨야 할 때는 파일이 낫습니다.
파일 이름과 위치는 정해진 자리를 지킵니다. 다음 세션이 찾을 수 있어야 넘긴 것입니다. 매 세션 지키는 규칙으로 굳었다면 요약 파일이 아니라 CLAUDE.md에 올리는 것이 맞습니다.
순서의 각 단계 아래 붙여넣기 예제가 있습니다. 위에서부터 하나씩 실행해 보세요.
실행 순서
-
지금까지의 결정과 남은 일을 파일로 요약합니다.
지금까지 이 대화에서 정한 결정과 남은 할 일을 파일 하나로 정리해 줘. 결정 / 남은 일 두 섹션으로 나누고, 각 항목은 한 줄씩만 적어 줘.
확인결정 / 남은 일 두 섹션으로 나뉜 요약 파일이 새로 생기고, 각 항목이 한 줄씩 정리되어 담깁니다.
-
채팅을 정리합니다. 새 채팅을 열거나, 그날 작업을 끝냅니다.
-
다음 세션에서 요약 파일을 읽혀 이어갑니다.
방금 만든 요약 파일을 읽고, 그 내용을 이어서 진행해 줘.
확인요약 파일에 적힌 결정과 남은 일이 반영되어 작업이 이어집니다.
직접 해보기
오늘 작업을 여기서 멈출게. 내일 이어갈 수 있게 결정 / 남은 일 요약 파일을 만들어 줘.
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
[진행 중인 작업 이름]에 대해 지금까지 정한 내용을 요약 파일로 남겨 줘. 다음에는 이 파일만 읽고 이어갈 수 있게 해 줘.
이 요약 파일을 다른 사람에게 넘긴다고 치고, 처음 보는 사람도 이해할 수 있게 배경 설명 섹션을 앞에 추가해 줘.
오늘 작업을 요약 파일로 남기고, 내일 새 세션에서 그 파일부터 읽혀 이어가 보세요.
헷갈리기 쉬운 것
요약 파일 없이 다음 날 세션을 열면 앞서 정한 결정과 이유가 그대로 사라집니다. 파일 이름과 위치를 정해 두지 않으면 다음 세션이 못 찾으니, 프로젝트 폴더 안 정해진 자리에 남깁니다. 매번 지키는 규칙이 됐다면 요약 파일이 아니라 CLAUDE.md로 옮기는 것이 맞습니다.
용어 풀이
전체 용어집 →- 핸드오프(handoff)
- 진행 상황을 파일로 남겨 다음 세션이나 다른 사람에게 넘기는 것입니다. 넘겨받는 쪽은 그 파일부터 읽고 시작합니다.
2026-07-21 기준 · 출처 · Claude Code — Best Practices