3 분 소요

요약

Claude Code 운영에서 문맥 관리는 많은 정보를 넣는 일이 아니다. 무엇을 세션 시작에 로드하고, 무엇을 필요할 때 읽게 하며, 무엇을 요약으로 남길지 정하는 일이다.

이 글은 긴 로그, 외부 이슈, auto memory를 다루는 기준을 정리한다. 핵심은 원문을 잃지 않되, live context에는 작업 판단에 필요한 상태만 남기는 것이다.

문서 정보

  • 작성일: 2026-04-24
  • 검증 기준일: 2026-04-24
  • 문서 성격: analysis
  • 테스트 환경: 실행 테스트 없음. Anthropic Claude Code memory, commands, extension 문서를 바탕으로 한 문맥 운영 정리.
  • 테스트 버전: Claude Code 공식 문서 2026-04-24 확인본. 로컬 Claude Code CLI 버전은 확인하지 않음.

문제 정의

긴 로그와 이슈 전문은 유용한 정보다. 하지만 대화창에 그대로 넣으면 중요한 몇 줄을 찾기 위해 전체 문맥을 계속 들고 가야 한다.

auto memory도 마찬가지다. 유용한 학습을 저장할 수 있지만, stale한 메모리나 너무 넓은 메모리가 쌓이면 작업 기준을 흐릴 수 있다. 이 글은 긴 자료와 memory를 함께 관리하는 기준을 다룬다.

확인된 사실

공식 문서 기준: Claude Code는 CLAUDE.md와 auto memory라는 두 memory mechanism을 사용한다. 둘 다 conversation start에 로드되며, Claude는 이들을 enforced configuration이 아니라 context로 다룬다. 근거: Anthropic, How Claude remembers your project

공식 문서 기준: auto memory는 Claude가 corrections와 preferences를 바탕으로 notes를 저장하는 기능이다. 문서는 auto memory가 모든 세션에서 무언가를 저장하는 것은 아니며, future conversation에 유용하다고 판단한 내용을 저장한다고 설명한다. 근거: Anthropic, How Claude remembers your project

공식 문서 기준: auto memory는 Claude Code v2.1.59 이상이 필요하며, /memory에서 토글하거나 settings의 autoMemoryEnabled로 제어할 수 있다. 근거: Anthropic, How Claude remembers your project

공식 문서 기준: MEMORY.md의 첫 200줄 또는 25KB 중 먼저 도달하는 범위가 conversation start에 로드된다. 자세한 topic files는 startup에 로드되지 않고 Claude가 필요할 때 읽는다. 근거: Anthropic, How Claude remembers your project

공식 문서 기준: /compact command는 지금까지의 conversation을 요약해 context를 확보하는 command다. /memory command는 CLAUDE.md memory files를 편집하고 auto-memory를 켜거나 끄며 auto-memory entries를 볼 수 있다. 근거: Anthropic, Commands

직접 재현한 결과

직접 재현 없음: 이 글은 실제 auto memory 폴더를 생성하거나 /compact 전후 context 변화를 비교한 실험 글이 아니다.

검증한 것은 2026-04-24 기준 공식 문서다. 아래 기준은 긴 자료를 Claude Code와 함께 다룰 때의 운영 판단이다.

해석 / 의견

긴 로그를 주는 방식

나쁜 방식은 원문 전체를 대화창에 붙여 넣고 “분석해 줘”라고 말하는 것이다. 좋은 방식은 원문 위치, 시간 범위, 증상, 질문을 먼저 주고 필요한 부분만 읽게 하는 것이다.

증상: payment-api 500 응답 증가
시간 범위: 2026-04-24 14:00~15:00 KST
원문 위치: logs/payment-api-2026-04-24.log
관련 경로: src/payment/**

먼저 error signature를 3개 이하로 묶고,
각 signature마다 대표 로그 1개와 가능한 원인 후보를 정리해 줘.

의견: live context에 필요한 것은 로그 전문이 아니라 signature, 범위, 근거, 다음 행동이다.

이슈를 주는 방식

이슈 본문도 같은 원칙을 따른다.

live context에 넣을 것 원문 위치에 남길 것
증상 요약 긴 댓글 thread
재현 조건 screenshot 원본
관련 파일 후보 전체 운영 회고
결정해야 할 질문 중복 논의
읽어야 할 외부 자료 위치 raw log 전문

의견: Claude Code가 파일이나 MCP로 원문을 읽을 수 있다면, 대화창은 원문 저장소가 아니라 작업 지시서가 되어야 한다.

auto memory 점검 기준

auto memory는 유용하지만, 사람이 가끔 감사해야 한다.

  1. 오래된 build command가 남아 있지 않은가.
  2. 개인 취향이 프로젝트 규칙처럼 저장되어 있지 않은가.
  3. 한 번만 필요했던 디버깅 메모가 반복 규칙처럼 남아 있지 않은가.
  4. 민감 정보나 내부 URL이 불필요하게 남아 있지 않은가.
  5. CLAUDE.md와 auto memory가 같은 내용을 중복하고 있지 않은가.

의견: memory는 “모델이 기억해 줘서 편한 곳”이 아니라, 운영 상태가 쌓이는 저장소다. 오래된 상태는 오히려 작업을 흐릴 수 있다.

compact 전후에 남길 것

긴 작업에서 /compact가 필요해질 수 있다. 이때 남아야 할 것은 대화 전체가 아니라 다음 행동에 필요한 상태다.

## Working State

- Goal:
- Current hypothesis:
- Files inspected:
- Files changed:
- Tests run:
- Tests not run:
- Open risks:
- Next action:

의견: 좋은 요약은 예쁘게 줄인 글이 아니라 이어서 작업할 수 있는 상태다. 실패 로그 전문보다 실패 signature와 다음 검증이 더 중요하다.

한계와 예외

이 글은 2026-04-24 기준 공식 문서를 바탕으로 한다. auto memory version requirement, /memory, /compact, MEMORY.md 로딩 범위는 이후 바뀔 수 있다.

직접 재현을 하지 않았으므로 실제 compact 결과, memory audit 화면, topic file 로딩 시점은 검증하지 않았다.

법무, 보안, 장애 대응처럼 원문 보존이 중요한 작업에서는 요약만 남기면 안 된다. 원문은 별도 저장소에 보존하고, live context에는 작업에 필요한 상태를 남기는 방식으로 나누어야 한다.

참고자료

댓글남기기

참고