메모리

메모리를 사용하면 ChatGPT와 Codex가 이전 작업의 유용한 컨텍스트를 향후 작업에 활용할 수 있습니다. ChatGPT 웹은 ChatGPT 메모리를 사용하지만, 로컬 Codex 클라이언트는 별도의 로컬 메모리 저장소와 제어 기능을 사용합니다.

필수 팀 지침은 AGENTS.md 또는 체크인된 문서에 보관하세요. 메모리는 항상 적용해야 하는 규칙의 유일한 출처가 아니라, 기억을 돕는 유용한 계층으로 취급하세요.

ChatGPT 데스크톱 앱에서는 채팅이 로컬 메모리를 사용할 수 있는지 또는 향후 메모리에 반영될 수 있는지를 /memories에서 선택하세요. 기능을 켜거나 꺼야 할 때는 Settings > Personalization에서 관리하세요.

Chronicle은 Codex가 화면에서 최근 작업 컨텍스트를 복구하여 메모리를 구축하도록 돕는 데스크톱 전용 기능입니다.

로컬 Codex 메모리의 작동 방식

메모리를 활성화하면 Codex는 요건을 충족하는 이전 채팅의 유용한 컨텍스트를 로컬 메모리 파일로 변환할 수 있습니다. Codex는 진행 중이거나 수명이 짧은 세션을 제외하고, 생성된 메모리 필드에서 비밀 정보를 가리며, 모든 채팅이 끝날 때마다 즉시 처리하는 대신 백그라운드에서 메모리를 업데이트합니다.

채팅이 끝나도 메모리가 바로 업데이트되지 않을 수 있습니다. Codex는 아직 진행 중인 작업을 요약하지 않도록 채팅이 충분한 시간 동안 유휴 상태가 될 때까지 기다립니다.

또한 Codex 사용량 제한의 잔여 비율이 구성된 임계값보다 낮으면 메모리 생성 시 백그라운드 처리를 건너뛸 수 있으므로, 제한에 가까워졌을 때 Codex가 할당량을 소비하지 않습니다.

로컬 메모리 저장소

Codex는 Codex 홈 디렉터리 아래에 메모리를 저장합니다. 기본 위치는 ~/.codex입니다. Codex가 CODEX_HOME을 사용하는 방식은 구성 및 상태 위치를 참조하세요.

기본 메모리 파일은 ~/.codex/memories/ 아래에 있으며 요약, 지속적으로 보존되는 항목, 최근 입력, 이전 채팅의 근거 자료를 포함합니다.

이 파일은 생성된 상태로 취급하세요. 문제를 해결하거나 Codex 홈 디렉터리를 공유하기 전에 살펴볼 수는 있지만, 파일을 직접 편집하는 방식을 기본 제어 수단으로 사용하지 마세요.

채팅별 로컬 메모리 제어

ChatGPT 데스크톱 앱과 Codex TUI에서는 현재 채팅의 메모리 동작을 제어하려면 /memories을 사용하세요. 채팅별 옵션을 통해 현재 채팅에서 기존 메모리를 사용할 수 있는지, Codex가 이 채팅을 사용하여 향후 메모리를 생성할 수 있는지 결정할 수 있습니다.

채팅별 옵션은 전역 메모리 설정을 변경하지 않습니다.

로컬 메모리 검토

메모리에 비밀 정보를 저장하지 마세요. Codex는 생성된 메모리 필드에서 비밀 정보를 가리지만, Codex 홈 디렉터리나 생성된 메모리 결과물을 공유하기 전에는 반드시 메모리 파일을 검토해야 합니다.

로컬 메모리 구성

로컬 Codex 메모리는 기본적으로 비활성화되어 있습니다. ChatGPT 데스크톱 앱에서 Settings > Personalization을 열고 Enable memories를 켜세요.

구성 파일로 설정하려면 config.toml에 기능 플래그를 추가하세요.

[features]
memories = true

구성 파일 위치와 메모리 관련 설정의 전체 목록은 구성 기본 사항 및 구성 참조를 확인하세요.

일반적인 메모리별 설정은 다음과 같습니다.

• 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: 전역 메모리 통합에 사용되는 모델을 재정의합니다.