Claude Code의 반복 설명을 줄이는 로컬 메모리 도구
은 Claude Code를 쓸 때 매번 프로젝트 상황을 다시 설명하는 일을 줄이기 위한 로컬 다. 작업 내용은 프로젝트 안의 `./history.md`에 쌓이고, 다음 세션에서 바로 이어갈 수 있도록 `./.md`에 짧은 요약이 만들어진다. 세션이 시작되면 저장된 내용을 이어서 쓸지, 이번 세션도 기록할지 묻는다.
사용자는 `/:save` 명령으로 요약을 만들 수 있고, 설정을 켜면 세션이 끝날 때 자동으로 다시 만들 수도 있다. 요약에는 목표, 진행 상황, 다음 단계, 만진 파일, 실행한 명령, 깃 변경 요약 같은 정보가 들어간다. 별도 설치나 API 키가 필요 없고, 외부 모델 호출도 하지 않으며, 와 TextRank라는 로컬 요약 방식으로 문장을 고른다.
그래서 메모리를 만들 때 추가 토큰 비용이 들지 않고, 다음 세션에 1천~2천 토큰 정도의 짧은 문맥만 넣어 시작할 수 있다. 보안 쪽에서는 흔한 비밀값을 지우려는 처리, 프로젝트 밖으로 쓰기 방지, 안전한 깃 읽기 설정을 제공하지만, `.` 파일을 커밋하기 전에는 직접 확인해야 한다.
핵심 포인트
- Claude Code 세션 기록을 프로젝트 안의 `./history.md`에 저장한다.
- 다음 세션용 요약은 `./.md`에 만들어진다.
- 요약 생성에 나 LLM을 쓰지 않아 추가 토큰 비용이 없다.
- `/:save`로 수동 저장하거나, 세션 종료 때 자동 저장하도록 설정할 수 있다.
- 요약에는 목표, 다음 단계, 파일 변경, 실행 명령, 깃 변경 정보가 포함될 수 있다.