OpenAI 공식 문서 — Memories 참고

21. Memories & Chronicle

Codex의 장기 컨텍스트 시스템 — Memories(~/.codex/memories/에 markdown 저장) + Chronicle(macOS 한정 research preview, 백그라운드 화면 캡처). Memories vs AGENTS.md 4-tier 분기, /memories 슬래시, EEA/UK/CH 지역 제한, 화면 콘텐츠 기반 prompt-injection 위험과 한국 기업 보안 정책 고려사항까지.

이 페이지에서 배우는 것

• 1Memories 동작 방식 — 어디에 어떻게 저장되는가
• 2Memories vs AGENTS.md — 언제 무엇을 쓰는가
• 3/memories 슬래시 · 자연어 저장 · Settings 직접 편집
• 4Chronicle — macOS 화면 캡처 기반 자동 기억
• 5지역 제한 (EEA/UK/CH 미제공)
• 6보안 주의 — 화면 캡처가 가져오는 prompt-injection 위험

Memories — 스레드 간 컨텍스트 유지

Memories는 사용자가 명시적으로 저장한 장기 기록을 모든 스레드에서 참조하는 기능입니다. 새 스레드를 시작해도 "내 기본 패키지 매니저는 pnpm" 같은 사실이 유지됩니다.

• ✓저장 위치 — ~/.codex/memories/ 디렉터리에 생성형 markdown 파일로 보관
• ✓flag — generate_memories(새 사실을 자동 추출) · use_memories(저장된 기록을 컨텍스트에 포함) 두 토글
• ✓슬래시 — Composer에 /memories로 현재 기억 목록 확인·편집 화면 진입
• ✓자연어 저장 — 채팅 중 "이 사실을 기억해 줘" 같은 요청. 특정 트리거 문구가 정해진 것은 아닙니다.
• ✓편집·삭제 — Settings → Memories에서 항목별 수정·삭제 가능
• ✓지역 제한 — EEA · UK · 스위스에서는 기본 미제공 (정책에 따라 변동 가능)

Memories vs AGENTS.md vs Personalization

"내 선호를 어디에 적어야 하는가"는 자주 묻는 질문입니다. 4-tier로 정리하면:

분기 가이드. "내 개인 선호"는 Personalization, "특정 사실 기억(예: 패키지 매니저는 pnpm)"은 Memories, "팀 코드 컨벤션"은 저장소 AGENTS.md, "패키지별 특수 규칙"은 패키지 AGENTS.md.

Chronicle — macOS 화면 캡처 기반 자동 기억 (Research Preview)

Chronicle은 macOS 한정 research preview입니다. 백그라운드에서 사용자의 화면을 주기적으로 캡처·요약해 Memories에 합성합니다 — 즉 "내가 코드를 어떻게 짜는지" "어떤 도구를 같이 쓰는지"를 자동 학습합니다.

• ✓저장 위치 — ~/.codex/memories_extensions/chronicle/
• ✓consolidation_model 설정 — 화면 캡처를 요약·압축할 모델 지정
• ✓일시정지 — Settings에서 즉시 끄거나 특정 앱·전체 화면 캡처를 비활성
• ✓권한 — Screen Recording 권한 필요. macOS 시스템 설정에서 부여.

⚠️ Chronicle 사용 전 반드시 알아둘 것

실전 패턴

• ✓처음에는 Memories만 사용 — 명시적 저장만으로도 충분히 효과 있습니다. Chronicle은 검증 후.
• ✓팀 컨벤션은 AGENTS.md로 — Memories에 적으면 본인만 효과. 팀 공유는 저장소 AGENTS.md.
• ✓주기적 검토 — Settings → Memories에서 한 달에 한 번 항목을 검토하고 부정확하거나 오래된 사실 삭제.
• ✓Chronicle 시작 시 화면 정리 — 비밀번호 매니저 닫기, 민감 이메일·문서 닫기. "Chronicle on" = 화면을 깨끗하게 유지.

한계점