메모리

팀에서 반드시 따라야 하는 지침은 AGENTS.md나 레포지토리에 포함된 문서에 기록하세요. 메모리는 이전 내용을 떠올리는 데 활용하되, 항상 적용해야 하는 규칙을 메모리에만 기록하지 마세요.

ChatGPT 데스크톱 앱에서는 /memories로 채팅에서 로컬 메모리를 사용할지, 채팅 내용을 향후 메모리 생성에 활용할지 선택할 수 있습니다. 설정 > 개인 설정에서 Codex 메모리 활성화 옵션을 사용해 선택한 기기의 메모리 기능을 켜거나 끄세요. 도구를 사용한 채팅의 메모리 허용 옵션에서는 MCP 도구나 웹 검색을 사용한 채팅 내용을 향후 메모리 생성에 활용할지 선택할 수 있습니다.

선택한 기기의 메모리 저장소를 초기화하려면 Codex 메모리 삭제를 선택한 다음 확인하세요. 로컬 기기에서 컴퓨터 기록 기능을 사용할 수 있는 경우 컴퓨터 기록도 함께 삭제됩니다.

설정 > 개인 설정에서 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 홈 디렉터리에서 메모리를 활성화하면 CLI는 기본적으로 $CODEX_HOME/memories_v2/를 사용합니다. $CODEX_HOME/memories/ 디렉터리가 이미 있으면 CLI는 해당 저장소를 계속 기본값으로 사용합니다. 버전을 직접 지정하려면 memories.version을 설정하세요. 버전을 따로 지정하지 않고 memories.dual_write = false로 설정하면 새 프로필에서도 v1을 사용합니다.

데스크톱 앱에서 이전 채팅을 바탕으로 생성된 요약과 그 근거 자료를 찾으려면 $CODEX_HOME/memories/와 $CODEX_HOME/memories_v2/ 두 디렉터리를 모두 확인하세요. 마이그레이션 기간에는 새 프로필에서도 메모리가 활성화된 새 로컬 채팅이 memories/에서 메모리를 읽고 두 디렉터리 모두에 메모리를 쓸 수 있습니다.

이 파일들은 Codex가 자동으로 생성하는 상태 파일입니다. 문제를 해결할 때나 Codex 홈 디렉터리를 공유하기 전에 내용을 확인할 수 있습니다. 다만 파일을 직접 편집하는 방식을 메모리를 관리하는 주된 수단으로 삼지 마세요.

채팅별 로컬 메모리 관리

ChatGPT 데스크톱 앱과 Codex TUI에서는 /memories로 현재 채팅의 메모리 동작을 설정하세요. 현재 채팅에서 기존 메모리를 사용할지, Codex가 현재 채팅 내용을 향후 메모리 생성에 활용할지 각각 선택할 수 있습니다.

채팅별 설정을 변경해도 전역 메모리 설정에는 영향을 주지 않습니다.

로컬 메모리 검토

메모리에 비밀 정보를 저장하지 마세요. Codex가 생성된 메모리 필드에서 비밀 정보를 가리더라도, Codex 홈 디렉터리나 생성된 메모리 산출물을 공유하기 전에는 메모리 파일을 검토하세요.

로컬 메모리 설정

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

설정 파일을 사용하려면 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: 전체 메모리 통합에 사용할 모델을 기본 모델 대신 지정합니다.