메모리
메모리는 Codex가 이전 스레드에서 얻은 유용한 맥락을 이후 작업에서 다시 참고할 수 있게 해 주는 기능입니다. 메모리를 켜면 Codex는 안정적인 선호 사항, 반복되는 워크플로, 기술 스택, 프로젝트 규칙, 자주 헷갈리는 주의점 등을 기억할 수 있습니다. 덕분에 새 스레드를 시작할 때마다 같은 맥락을 반복해서 설명하지 않아도 됩니다.
다만 메모리는 이전 맥락을 덜 반복해 설명하기 위한 보조 장치입니다. 반드시 지켜야 하는 팀 지침이나 프로젝트 규칙은 AGENTS.md 또는 저장소 문서에 남겨 두는 것이 좋습니다. 항상 적용되어야 하는 규칙을 메모리에만 의존하지 마십시오.
크로니클은 최근 화면의 작업 맥락을 바탕으로 메모리 생성을 보강하는 기능입니다.
메모리 켜기
메모리는 기본적으로 꺼져 있습니다. Codex 앱에서는 설정에서 메모리를 켤 수 있습니다.
설정 파일로 켜려면 ~/.codex/config.toml의 [features] 테이블에 다음 값을 추가합니다.
[features]
memories = true
사용자 설정 파일의 위치와 ~/.codex/config.toml을 불러오는 방식은 설정 기본을 참고하면 됩니다.
설정
메모리를 켠 뒤에는 config.toml에서 사용 방식과 생성 조건을 더 세부적으로 조정할 수 있습니다. 설정 파일 위치와 전체 설정 목록은 설정 참조를 참고하면 됩니다.
memories.generate_memories: 새로 생성된 스레드를 메모리 생성 입력으로 저장할 수 있는지 제어합니다.memories.use_memories: Codex가 기존 메모리를 이후 세션에서 사용할지 제어합니다.memories.disable_on_external_context:true이면 MCP 도구 호출, 웹 검색, 도구 검색처럼 외부 맥락을 사용한 스레드를 메모리 생성 대상에서 제외합니다. 이전 키인memories.no_memories_if_mcp_or_web_search도 별칭으로 계속 허용됩니다.memories.min_rate_limit_remaining_percent: 메모리 생성을 시작하기 전에 필요한 Codex 사용량 제한의 최소 남은 비율을 제어합니다.memories.extract_model: 스레드별 메모리 추출에 사용할 모델을 재정의합니다.memories.consolidation_model: 전역 메모리 통합에 사용할 모델을 재정의합니다.
Codex 앱과 Codex TUI에서는 /memories를 사용해 현재 스레드의 메모리 동작만 따로 제어할 수 있습니다. 현재 스레드에서 기존 메모리를 사용할지, 현재 스레드를 나중에 메모리 생성에 사용할지 선택할 수 있습니다. 이 선택은 전역 메모리 설정을 바꾸지 않습니다.
메모리 저장 방식
메모리를 켜면 Codex는 조건에 맞는 이전 스레드에서 유용한 맥락을 추출해 로컬 메모리 파일로 저장할 수 있습니다. 아직 진행 중인 스레드나 너무 짧게 끝난 세션은 건너뜁니다.
스레드가 끝났다고 해서 메모리가 즉시 업데이트되는 것은 아닙니다. Codex는 진행 중인 작업을 너무 일찍 요약하지 않도록 스레드가 충분히 오래 유휴 상태가 될 때까지 기다린 뒤, 백그라운드에서 메모리를 업데이트합니다.
Codex 사용량 제한의 남은 비율이 설정된 기준보다 낮으면 메모리 생성을 건너뛸 수 있습니다. 제한에 가까워졌을 때 메모리 생성에 할당량을 쓰지 않기 위한 동작입니다.
Codex는 메모리를 Codex 홈 디렉터리 아래에 저장합니다. 기본값은 ~/.codex입니다. Codex가 CODEX_HOME을 어떻게 사용하는지는 설정과 상태 위치를 참고하면 됩니다.
주요 메모리 파일은 ~/.codex/memories/ 아래에 저장됩니다. 여기에는 이전 스레드에서 얻은 요약, 지속적인 항목, 최근 입력, 근거 자료가 포함됩니다.
이 파일들은 Codex가 만든 상태 데이터로 보는 것이 좋습니다. 문제를 해결하거나 Codex 홈 디렉터리를 공유하기 전에 확인할 수는 있지만, 직접 편집하는 방식을 주된 제어 방법으로 삼는 것은 권장되지 않습니다.
비밀 정보를 메모리에 저장하지 마십시오. Codex는 생성된 메모리 필드에서 비밀 정보를 가리지만, Codex 홈 디렉터리나 생성된 메모리 산출물을 공유하기 전에는 메모리 파일을 직접 검토하는 것이 좋습니다.