에이전트 메모리

AI 에이전트가 사용자 취향, 프로젝트 규칙, 지난 작업 경험을 저장해 두었다가 다음 세션에서 꺼내 쓰게 하는 기술로, 대화가 끝나면 모든 걸 잊는 LLM의 한계를 메운다. 같은 설명을 매번 반복하기 싫을 때나 오래 이어지는 작업을 맡길 때 쓴다.

사람의 기억처럼 여러 종류로 나뉜다.

컨텍스트 윈도우만으로는 부족하다

컨텍스트 윈도우는 아무리 커도 세션이 끝나면 비워진다. 대화가 길어질수록 비용이 늘고 앞부분 내용을 놓치기도 쉽다.

그래서 중요한 것만 골라 바깥에 저장하고, 필요할 때 관련된 것만 다시 넣는다. 저장하고, 검색하고, 컨텍스트에 넣는 순서로 돌아간다.

파일 하나부터 전용 도구까지

가장 쉬운 시작은 파일이다. Claude Code는 세션을 시작할 때 CLAUDE.md를 자동으로 읽는다. 빌드 명령어, 금지 사항, 아키텍처 결정을 여기에 적어 두면 된다. 직접 서비스를 만든다면 Mem0 같은 메모리 레이어를 붙여 사용자별 기억을 관리한다.

안 쓰는 게 나을 때도 있다

한 번 묻고 끝나는 질문이나 매번 같은 결과가 나와야 하는 작업에는 메모리가 오히려 방해가 된다. 예전 기억이 답에 섞이면 결과가 달라질 수 있기 때문이다. 여러 사람이 같은 에이전트를 쓴다면 사용자끼리 기억이 섞이지 않게 나눠 둬야 한다.

저장보다 정리가 어렵다

기억이 많다고 좋은 건 아니다. 오래되거나 틀린 기억을 꺼내 쓰면 성능이 오히려 떨어진다. 무엇을 저장하고 언제 고치거나 지울지 정하는 관리 전략이 저장 자체보다 어렵다.

메모리를 가끔 열어 보고 낡은 항목은 지운다. 비밀번호나 개인정보 같은 민감한 내용은 처음부터 저장하지 않도록 막아 둔다.

한 번 적어 두고 매번 안 말하는 데 쓴다

가장 흔한 건 코딩 에이전트에 프로젝트 규칙을 기억시키는 방식이다. 매번 같은 지시를 입력하는 대신 한 번 적어 두고, 에이전트가 세션마다 알아서 읽게 한다.