메모리

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

ChatGPT 데스크톱 앱에서는 /memories을 사용하여 채팅이 로컬 메모리를 사용하거나 향후 메모리 생성에 기여할 수 있는지 선택합니다. 기능을 켜거나 꺼야 할 때는 설정 > 개인화 에서 관리하세요.

ChatGPT 메모리는 설정 > 개인 맞춤 설정 에서 관리하세요. ChatGPT Work는 계정과 워크스페이스에서 사용할 수 있는 메모리 설정을 사용하며, 로컬 Codex 메모리 저장소나 로컬 메모리 제어 기능은 사용하지 않습니다.

Codex CLI에서는 대화형 세션에서 /memories을 사용하여 현재 채팅이 기존 로컬 메모리를 사용하거나 향후 메모리의 입력으로 사용될 수 있는지 제어할 수 있습니다. 명령을 사용할 수 없다면 로컬 메모리 구성을 참조하세요.

IDE 확장은 연결된 Codex 호스트의 로컬 메모리 저장소를 사용합니다. 해당 호스트에서 메모리가 활성화되어 있으면 Codex CLI와 동일한 채팅 수준 제어 기능을 사용하세요.

컴퓨터 기록은 허용된 앱과 웹사이트의 활동을 ChatGPT와 Codex가 참조할 수 있는 메모리와 타임라인으로 변환하는 macOS 데스크톱 기능입니다.

로컬 Codex 메모리의 작동 방식

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

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

Codex 사용량 한도의 남은 비율이 구성된 임계값보다 낮으면 백그라운드 메모리 생성 작업을 건너뛸 수도 있습니다. 따라서 한도에 가까울 때 메모리 생성에 할당량을 소비하지 않습니다.

로컬 메모리 저장소

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

주요 메모리 파일은 ~/.codex/memories/ 아래에 있으며, 이전 채팅의 요약, 영구 항목, 최근 입력, 근거 자료가 포함됩니다.

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

채팅별 로컬 메모리 제어

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

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

로컬 메모리 검토

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

로컬 메모리 구성

로컬 Codex 메모리는 기본적으로 꺼져 있습니다. ChatGPT 데스크톱 앱에서 설정 > 개인화 를 열고 메모리 활성화 를 켜세요.

구성 파일로 설정하려면 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: 전역 메모리 통합에 사용하는 모델을 재정의합니다.