codex 메모리 활성화 — 켜는 법과 저장 위치
Codex의 로컬 메모리는 기본으로 꺼져 있습니다. "왜 이전 대화를 하나도 기억 못 하지?" 싶다면 켜지 않아서입니다. 켜는 건 한 줄 — codex features enable memories 이고, 켜면 메모리는 ~/.codex/memories/ 에 파일로 쌓입니다. 다만 대화가 끝나자마자 저장되지 않고, 충분히 유휴 상태가 된 뒤 백그라운드에서 만들어집니다. 이걸 모르면 "켰는데도 폴더가 안 생긴다"고 헤매게 됩니다. 아래는 codex-cli 0.153.4에서 직접 확인한 값과 공식 설정 레퍼런스 기준입니다. (2026년 9월 6일 확인)
지금 켜져 있는지부터 확인
추측하지 말고 확인하면 됩니다. Codex는 기능 플래그를 직접 보여 주는 명령을 갖고 있습니다.
codex features list | grep memories제 PC에서 실제로 돌린 결과입니다.
memories stable false
external_agent_memory_import under development false가운데가 기능 단계, 오른쪽이 지금 켜져 있는지입니다. memories는 stable(정식)인데 값이 false — 즉 완성된 기능인데 기본값이 꺼짐이라는 뜻입니다. 실험 기능이라 안 켜진 게 아니니 마음 놓고 켜도 됩니다.
codex features list는 전체 플래그를 보여 줍니다(이 버전에서 135개). 설정 파일을 열어 보기 전에 지금 무엇이 켜져 있는지 확인하는 가장 빠른 방법입니다.
켜는 방법 세 가지
1. 명령 한 줄 — 가장 간단합니다. 이 명령은 config.toml에 설정을 써 줍니다.
codex features enable memories
# 되돌리려면
codex features disable memories2. 설정 파일에 직접 — ~/.codex/config.toml을 열어 아래를 넣습니다. 파일이 없으면 만들면 됩니다.
[features]
memories = true3. 데스크톱 앱 — Settings > Personalization에서 Enable memories를 켭니다.
파일을 건드리기 전에 켜면 어떻게 되는지만 잠깐 보고 싶다면 오버라이드 옵션이 있습니다. 이건 설정 파일에 아무것도 쓰지 않습니다.
codex features list -c features.memories=true | grep memories
# memories stable true어디에 저장되나
Codex의 로컬 상태는 전부 CODEX_HOME 아래에 모입니다. 기본값은 ~/.codex이고, 메모리는 그 안 memories/ 폴더에 들어갑니다.
~/.codex/memories/여기에는 요약, 오래 남길 항목, 최근 입력, 그리고 이전 대화에서 온 근거가 들어갑니다. 다만 공식 문서는 이 파일들을 "생성된 상태(generated state)"로 다루라고 합니다. 문제를 쫓거나 남에게 넘기기 전에 들여다보는 건 괜찮지만, 손으로 고치는 걸 주된 조작 수단으로 삼지 말라는 뜻입니다. 설정은 config.toml로 하세요.
memories/ 폴더 자체가 없습니다. 실제로 확인해 보니 켜지 않은 상태에서는 ~/.codex 안에 config.toml도 없습니다. "폴더가 안 보인다"는 고장이 아니라 아직 안 켰다는 신호입니다.
켰는데 왜 안 쌓이나 — 저장 시점
여기가 가장 많이 헷갈리는 부분입니다. 메모리는 대화가 끝나는 순간 만들어지지 않습니다. 공식 문서가 밝히는 조건이 이렇습니다.
- 대화가 충분히 유휴 상태가 된 뒤 백그라운드에서 만든다 — 아직 진행 중인 작업을 요약하지 않기 위해서입니다.
- 진행 중이거나 너무 짧은 세션은 건너뛴다.
- 남은 사용 한도 비율이 기준 아래면 생성 자체를 건너뛴다 — 한도가 빠듯할 때 할당량을 메모리 만드는 데 쓰지 않으려는 설계입니다.
- 생성되는 메모리 필드에서 비밀정보는 가려 넣는다.
즉 켜자마자 확인하면 아무것도 없는 게 정상입니다. 기본값 기준으로 대화가 6시간 이상 유휴가 되어야 후보가 되고, 남은 한도가 25% 아래면 그 패스를 건너뜁니다. 지금 한도가 얼마나 남았는지는 codex 사용량 확인 글의 방법으로 볼 수 있습니다.
대화 하나만 껐다 켜기
전역 설정을 건드리지 않고 지금 이 대화에서만 메모리 동작을 정할 수 있습니다. 입력창에 이렇게 칩니다.
/memories여기서 두 가지를 고릅니다 — 이 대화가 기존 메모리를 쓸지, 그리고 이 대화가 나중에 메모리를 만드는 재료가 될지입니다. 민감한 코드를 다루는 대화라면 이걸로 재료에서 빼 두면 됩니다. 여기서 고른 값은 전역 설정을 바꾸지 않습니다.
세부 설정 — config.toml 키와 기본값
더 세밀하게 조이고 싶으면 config.toml에 아래 키를 넣습니다. 값은 모두 공식 설정 레퍼런스 기준입니다.
| 키 | 기본값 | 뜻 |
|---|---|---|
memories.use_memories |
true |
false면 기존 메모리를 새 세션에 넣지 않는다(읽기 차단) |
memories.generate_memories |
true |
false면 새 대화가 메모리 재료로 안 쌓인다(쓰기 차단) |
memories.disable_on_external_context |
false |
true면 MCP 호출·웹 검색을 쓴 대화는 메모리 생성에서 제외 |
memories.min_rollout_idle_hours |
6 (1~48) |
대화가 몇 시간 놀아야 메모리 후보가 되는지 |
memories.min_rate_limit_remaining_percent |
25 (0~100) |
남은 한도가 이 퍼센트 아래면 생성을 안 한다 |
memories.max_rollout_age_days |
30 (0~90) |
며칠 전 대화까지 메모리 생성 대상으로 볼지 |
memories.max_unused_days |
30 (0~365) |
안 쓴 지 며칠 지나면 정리 대상에서 빠지는지 |
memories.max_raw_memories_for_consolidation |
256 (최대 4096) |
정리할 때 몇 개까지 들고 갈지 |
실무에서 손댈 만한 건 위 두 줄입니다. 읽기는 되게 두고 쓰기만 막고 싶다면 이렇게 씁니다.
[features]
memories = true
[memories]
generate_memories = false # 새 대화를 재료로 안 쌓는다
disable_on_external_context = true # 웹 검색·MCP 쓴 대화는 제외AGENTS.md와 무엇이 다른가
둘 다 "Codex에게 맥락을 주는 것"이라 헷갈리는데, 공식 문서가 선을 분명히 긋습니다.
| 구분 | 메모리 | AGENTS.md |
|---|---|---|
| 성격 | 도움이 되면 떠올려 주는 회상 계층 | 항상 적용돼야 하는 규칙 |
| 어디에 | 내 PC의 ~/.codex/memories/ |
저장소에 커밋되는 파일 |
| 팀 공유 | 안 됨(내 것) | 됨 |
그래서 "반드시 지켜야 하는 팀 규칙을 메모리에 맡기면 안 됩니다." 문서도 메모리를 유일한 근거로 삼지 말라고 못 박습니다. 규칙은 agents.md 작성법에 정리한 대로 파일에 적어 두고, 메모리는 "매번 다시 설명하기 귀찮은 취향" 정도로 쓰는 게 맞습니다.
자주 묻는 질문 (FAQ)
Q. 켰는데 ~/.codex/memories/가 안 생깁니다.
정상일 가능성이 큽니다. 메모리는 대화가 충분히 유휴 상태(기본 6시간)가 된 뒤 백그라운드에서 만들어집니다. 방금 켜고 바로 확인하면 아무것도 없습니다. 남은 사용 한도가 25% 아래여도 그 패스를 건너뜁니다.
Q. ChatGPT 웹에서 쓰던 메모리랑 같은 건가요?
아닙니다. 문서가 명시하듯 ChatGPT 웹은 ChatGPT 메모리를, 로컬 Codex 클라이언트는 별도의 로컬 메모리 저장소를 씁니다. 설정도 따로입니다.
Q. 회사 코드가 메모리에 들어가는 게 걱정됩니다.
세 가지로 막을 수 있습니다. ① 대화마다 /memories로 그 대화를 재료에서 빼기, ② memories.generate_memories = false로 아예 안 쌓기, ③ memories.disable_on_external_context = true로 웹 검색·MCP를 쓴 대화만 제외하기. 참고로 비밀정보는 생성 단계에서 가려지지만, Codex 홈 디렉터리를 남에게 넘기기 전에는 직접 확인하라고 문서가 권합니다.
Q. 메모리 파일을 직접 고쳐도 되나요?
문제를 쫓을 때 들여다보는 건 괜찮지만, 문서는 이 파일들을 생성된 상태로 다루라며 손 편집을 주된 조작 수단으로 삼지 말라고 합니다. 동작을 바꾸려면 config.toml을 쓰세요.
마무리
정리하면 ① codex features list로 지금 상태를 보고 → ② codex features enable memories로 켜고 → ③ ~/.codex/memories/에 쌓이길 기다린다입니다. 기본이 꺼짐이라는 것과, 저장이 즉시가 아니라 유휴 뒤 백그라운드라는 두 가지만 알면 헤맬 일이 없습니다.
버전이 자주 올라가는 도구입니다. 이 글은 codex-cli 0.153.4 기준이니, 플래그 이름이나 기본값이 다르면 codex features list로 그 자리에서 확인하는 게 가장 정확합니다.
📚 참고 출처 (2026년 9월 6일 확인 · 상태값은 codex-cli 0.153.4에서 직접 확인)
· Memories
· Personalize ChatGPT
· Configuration reference
· Config and state locations
COMMENTS