Claude 에이전트 입문 2: AI가 기억하는 것과 놓치는 것
Claude 에이전트 입문 · 2/5 · 공식 문서 확인: 2026년 9월 20일
Claude Code의 기억 문제는 ‘정보를 저장했는가’와 ‘이번 작업에서 그 정보를 읽었는가’를 나누면 진단하기 쉽습니다. 현재 대화에 들어가는 컨텍스트, 사람이 관리하는 CLAUDE.md, 작업 중 남기는 자동 메모는 쓰임과 불러오는 방식이 다릅니다.
컨텍스트에는 무엇이 들어갈까
컨텍스트는 모델이 이번 판단에 참고하는 정보 묶음입니다. 대화, 읽은 파일의 내용, 도구 결과, 불러온 지침이 포함됩니다. 폴더 안에 파일이 있다고 해서 모든 내용이 자동으로 들어가지는 않습니다. Claude가 읽은 자료와 현재 요청에 포함된 내용이 중요합니다.
모델이 한 번에 참고할 수 있는 분량에는 한도가 있으며, 텍스트 처리 단위인 토큰으로 계산합니다. 대화가 길어져 한도에 가까워지면 이전 도구 출력을 정리하거나 대화를 요약합니다. 전체 기록이 저장돼 있어도 매번 같은 분량을 그대로 참고하는 것은 아닙니다. 오래된 세부 조건이 현재 판단에서 빠질 수 있습니다. 공식 문서: 컨텍스트 창
예를 들어 ‘신청 방법을 추측하지 말라’고 초반에만 말했다면, 긴 작업 뒤에도 그 조건이 유지되는지 확인해야 합니다. 반복해서 필요한 규칙은 별도 지침으로 관리하는 편이 낫습니다.
CLAUDE.md에 실제 작업 규칙 적기
작업 폴더의 최상위에 CLAUDE.md라는 파일을 만듭니다. Markdown은 제목과 목록을 텍스트로 적는 형식입니다. 다음은 행사 안내문 작업에 쓸 수 있는 예시입니다.
# 안내문 작업 규칙
- 행사 정보의 기준은 event.txt다.
- 원본에 없는 사실은 '확인 필요'로 표시한다.
- 결과는 announcement.md에 저장한다.
- 완료 전 저장된 파일을 원본과 대조한다.
- 외부 발송은 별도 승인을 받은 뒤 진행한다.이번 행사 날짜처럼 자주 바뀌는 값은 event.txt에 두고, 앞으로도 적용할 처리 규칙을 CLAUDE.md에 둡니다. 날짜를 두 파일에 중복해서 쓰면 한쪽만 수정했을 때 충돌합니다.
| 정보 | 두기 좋은 곳 | 관리 이유 |
|---|---|---|
| 이번 일시·장소·정원 | event.txt | 한 원본에서 최신 값 관리 |
| 빠진 사실의 처리 방식 | CLAUDE.md | 다음 작업에도 적용 |
| 확인한 파일 위치·작업 요령 | 자동 메모 | 다음에 다시 찾을 참고 기록 |
| 현재 진행 상황·남은 질문 | 작업별 인계 메모 | 중단한 일을 이어갈 때 사용 |
Claude Code에서 /context로 이번 세션에 불러온 지침을 확인하고, /memory로 지침·메모 위치를 살펴볼 수 있습니다. 자동 메모는 Claude가 작업 중 기록하는 기능이며 사람이 수정할 수 있습니다. 메모의 상세 파일은 필요할 때 읽습니다. 공식 문서: 지침·자동 메모·확인 명령
긴 작업에서는 무엇을 남겨야 할까
이전 대화를 전부 새 요청에 복사하면 토큰과 읽을 분량이 늘어납니다. 확정 사실, 기준 파일, 남은 일, 미확정 질문을 짧은 인계 메모로 남겨보세요. 아래는 연습 작업을 다음 대화로 넘기는 예입니다.
기준 파일: event.txt
현재 결과: announcement.md에 초안 저장
확인 완료: 행사명·일시·장소·정원 일치
남은 일: 신청 방법 확인 후 해당 문장만 수정
주의: 예전 안내문의 일정과 신청 링크를 가져오지 않기새 작업에서는 이 메모와 기준 파일을 다시 읽도록 요청합니다. 메모의 ‘확인 완료’도 기록일 뿐이므로 결과 파일이 바뀌었다면 재검사가 필요합니다. 요약만 믿고 원본 확인을 생략하지 않도록 기준 파일의 위치를 함께 남깁니다.
파일과 메모를 읽는 과정은 모델 자체를 새로 학습시키는 과정과 구분됩니다. 잘못된 규칙을 저장하면 다음에도 그 규칙을 참고할 수 있으므로, 오래된 메모를 정리하는 일도 기억 관리에 포함됩니다.
‘기억을 못 한다’는 문제를 구체적으로 진단하기
| 문제 | 조치 |
|---|---|
| 지침을 따르지 않음 | /context에서 실제 로드 여부와 충돌 지침 확인 |
| 지난 행사 날짜를 사용함 | 현재 기준 파일 지정, 과거 자료는 말투 참고용으로 표시 |
| 다른 컴퓨터에서 메모가 안 보임 | 자동 메모는 기본적으로 해당 기기의 로컬 기록임을 확인 |
| 발송 금지를 적었는데 실행 가능함 | 지침과 별도로 실제 도구 권한 설정 확인 |
직접 확인: 연습용 event.txt의 정원을 20명에서 15명으로 바꾸고 새 초안을 요청해보세요. 날짜와 말투 규칙은 유지하면서 최신 정원을 반영해야 합니다. 실패하면 ‘기억력’ 전체를 의심하기 전에 어떤 자료를 읽었는지 확인할 수 있습니다.
시리즈 이어 읽기
- AI가 일을 끝내는 과정
- 기억과 작업 맥락 · 현재 글
- 설명서·도구·권한
- 보조 작업자와 협업팀
- 검증과 다음 작업의 개선