Codex CLI 로컬 메모리 시작: /memories로 사용·생성을 처음 나누는 법
TL;DR
Codex CLI의 로컬 메모리는 이전 세션에서 추린 작업 습관을 다음 세션의 맥락으로 다시 쓰는 기능입니다. TUI 입력창에서
/memories
를 찾아 기존 메모리 사용과 향후 메모리 생성을 따로 관리합니다. 기본값은 꺼져 있습니다. 처음에는 비민감 폴더에서 활성화 상태와 새 세션 반영만 확인하세요. 메모리는 개인 작업 보조용이므로 필수 팀 규칙은
AGENTS.md
에 남겨야 합니다.
핵심 3줄 요약
핵심 1
/memories
는 운영체제 셸이 아니라 Codex 대화형 입력창에서 실행합니다.
핵심 2
메모리 사용과 생성은 서로 다른 제어 항목입니다. 새 세션 반영도 확인합니다.
핵심 3
~/.codex/memories/
의 로컬 생성 상태를 검토하고 필수 팀 규칙은
AGENTS.md
에 둡니다.
이 글에서 다룰 내용
-
/memories를 입력할 위치와 Enter 전 확인법 - 로컬 메모리 사용과 생성의 차이
- 처음 활성화하고 새 세션에서 확인하는 6단계
- 저장 파일, 백그라운드 생성,
AGENTS.md의 경계
Codex 로컬 메모리는 무엇인가
Codex 로컬 메모리는 최근 세션에서 반복 활용할 만한 패턴을 추려 로컬에 저장합니다. 이후 세션에서는 이 정보를 컨텍스트에 넣습니다.
개인 저장소 작업 흐름을 돕는 보조 수단이며 ChatGPT 메모리와 동기화되거나 공유되지 않습니다.
기본 Codex 홈은
~/.codex
이고 주요 메모리 파일은
~/.codex/memories/
아래에 저장됩니다. 이 폴더에는 요약, 오래 유지되는 항목, 최근 입력, 이전 채팅의 근거 자료가 포함될 수 있습니다. Codex는 생성하는 메모리 필드에서 비밀값을 가립니다. 그래도 공유 전에는 사람이 직접 검토해야 합니다.
사용과 생성을 왜 나눠야 하나
/memories
는 현재 채팅에서 기존 로컬 메모리를 사용할지와 이 세션이 향후 메모리 생성에 기여할지를 따로 제어합니다. 사용을 끄면 저장 내용을 현재 컨텍스트에 넣지 않고, 생성을 끄면 그 세션은 새 메모리 후보 입력에서 빠집니다.
이 선택은 현재 채팅 범위이며 전역 설정을 자동으로 바꾸지 않습니다. 공식 문서의 config 기반 설정은
config.toml
에
[features]
와
memories = true
를 추가합니다. 이번
codex-cli 0.144.6
메뉴는 활성화 뒤 새 세션이 필요하다고 안내했습니다.
언제 쓰면 좋은가
같은 저장소에서 반복하는 탐색 순서, 검증 습관, 개인 작업 흐름을 매번 다시 설명하는 비용을 줄이고 싶을 때 맞습니다. 새 세션에서 참고 맥락이 유용한지 확인한 뒤 유지 여부를 결정합니다.
팀 전체가 반드시 따라야 하는 명령, 금지 작업, 코드 규칙은 메모리에만 두면 안 됩니다. 명시적이고 오래 유지할 지침은
AGENTS.md
에 둡니다. 메모리는 자동 발견된 보조 컨텍스트이지 권한 통제나 사실 원장이 아닙니다.
/memories
로 처음 설정하는 6단계
1. 비민감한 폴더에서 Codex를 엽니다
고객 저장소나 운영 자료 대신 빈 폴더나 공개 예제처럼 노출 위험이 낮은 위치를 고릅니다.
codex --version
으로 설치본을 기록합니다. 이번 확인 환경은
codex-cli 0.144.6
이었습니다.
2. 입력창에서
/memories
completion을 확인합니다
Codex TUI 입력창에
/memories
를 입력하되 바로 Enter를 누르지 않습니다. 현재 설치본에서는
configure memory use and generation
completion이 나타났습니다.
설명이 없으면 토큰을 지우고 실행하지 마세요. 인식되지 않은 slash token이 일반 모델 입력으로 제출될 수 있습니다.
3. 비활성화 상태라면 전역 활성화를 검토합니다
Enter를 누르면 현재 설정을 반영한 메뉴가 열립니다. 격리 확인에서는 메모리가 꺼져 있다는 안내와
Yes, enable
,
Not now
선택지가 보였습니다. 활성화를 선택하면 설정이 갱신되고 새 세션이 필요하다는 안내도 나타났습니다.
이 문구는
codex-cli 0.144.6
관찰값입니다. 현재 화면이 다르면 공식 문서와 설치본 안내를 우선합니다. 공식 문서에 공통 플랜·지역·언어·최소 버전 조건은 따로 적혀 있지 않으므로 현재 계정과 UI를 확인합니다.
4. 새 세션에서 사용과 생성을 따로 정합니다
활성화를 승인했다면 Codex를 다시 열고
/memories
를 실행합니다. 기존 메모리 사용과 이 세션의 향후 메모리 생성 기여를 각각 검토합니다.
어떤 항목을 켰는지 내부 메모에 남기고 다음 세션에도 같다고 추정하지 않습니다.
5. 읽기 전용 비민감 작업을 한 번 수행합니다
프로젝트 구조를 훑고 반복 가능한 작업 습관 후보만 분류하도록 요청합니다. 파일 수정, 명령 실행, 외부 전송은 완료 범위에서 뺍니다. 응답이 매끄러워도 메모리에서 온 내용이 현재 저장소와 맞는지는 원본 문서로 대조합니다.
6. 저장 파일과 생성되지 않은 경우를 함께 확인합니다
세션을 마친 뒤
~/.codex/memories/
에 생성 상태가 생겼는지 읽기 전용으로 확인합니다. 파일이 없어도 오류로 단정하지 마세요. 활성 상태이거나 짧게 끝난 세션은 생성을 건너뛸 수 있습니다.
생성은 백그라운드에서 실행됩니다. 남은 사용 한도가 설정된 기준보다 낮아도 건너뛸 수 있습니다.
파일이 있다면 비밀값, 내부 경로, 오래된 가정을 검토합니다. 공식 문서는 이 폴더를 생성 상태로 다루고 직접 편집을 기본 제어 수단으로 삼지 말라고 안내합니다. 꼭 필요한 수정은 원래 프로젝트 문서나
AGENTS.md
에 반영합니다.
첫 작업용 복사 프롬프트
아래 프롬프트는
/memories
대신 입력하는 명령이 아닙니다. 메모리를 켠 새 세션에서 비민감한 작업 습관 후보를 읽기 전용으로 분류할 때 사용합니다.
목표: 현재 폴더의 공개·비민감 문서에서 반복 가능한 개인 작업 습관 후보를 찾습니다. 반드시 지켜야 할 프로젝트 규칙과는 분리합니다.
허용 입력: 현재 폴더에서 사람이 열어 확인한 README, 공개 문서, 파일명, 비민감 테스트 절차만 사용합니다.
제외 입력: 비밀값, 인증 파일, 고객 데이터, 개인식별정보, 전체 대화 기록, 현재 폴더 밖의 자료는 사용하지 않습니다.
출력 형식: 1) 개인 작업 습관 후보 · 2) AGENTS.md에 명시할 필수 규칙 후보 · 3) 오래되었거나 충돌해 확인 필요한 항목 · 4) 근거 파일 위치
완료 기준: 각 항목을 실제 문서 위치와 대조할 수 있어야 합니다. 파일 수정·명령 실행·메모리 생성 성공 주장은 하지 않습니다.
추정 금지: 보이지 않은 규칙, 실행 결과, 팀 합의, 권한, 보안 상태를 만들지 않습니다.
승인 지점: 사람이 근거를 확인하기 전에는 AGENTS.md 수정, 메모리 신뢰, 외부 공유, 작업 실행을 제안으로만 남깁니다.
실전 인사이트
첫 시험의 성공 기준은 “메모리가 하나 생겼다”가 아닙니다.
/memories
인식, 전역 활성화 여부, 현재 채팅의 사용·생성 범위, 새 세션의 비민감 작업을 구분해 기록하면 충분합니다.
생성된 메모리는 저장소의 최신 사실을 보증하지 않습니다. 다음 세션에서도 현재 파일, 테스트 결과, 승인된 문서를 다시 확인합니다.
AGENTS.md
와 구분하기
AGENTS.md
는 사용자가 직접 작성하는 명시적이고 오래 유지할 프로젝트 지침입니다. 로컬 메모리는 최근 세션에서 자동으로 찾은 개인 작업 패턴입니다. 반드시 따라야 할 빌드 명령, 테스트 기준, 금지 작업을 메모리에만 맡기지 마세요.
Codex 로컬 메모리는 개인 로컬 작업 흐름을 위한 기능이며 팀원과 동기화하거나 ChatGPT 메모리와 공유하지 않습니다. 팀에 전달할 규칙은 검토를 거쳐 저장소 문서로 옮깁니다.
주의할 점
-
/memories는 Codex TUI 입력창에서 실행하며 운영체제 셸 명령이 아닙니다. - 로컬 메모리는 기본적으로 꺼져 있고 활성화 뒤 새 세션이 필요할 수 있습니다.
- 활성 상태이거나 짧게 끝난 세션은 메모리 생성 대상에서 제외될 수 있습니다.
- Codex는 생성하는 메모리 필드에서 비밀값을 가립니다. 그래도 저장 파일과 공유본을 사람이 검토합니다.
- 생성 파일을 직접 관리하는 지식베이스로 쓰지 말고 필수 규칙은
AGENTS.md에 둡니다. -
memories.disable_on_external_context가 켜져 있으면 MCP·웹 검색·도구 검색 같은 외부 컨텍스트를 쓴 채팅은 메모리 생성에서 빠집니다.
자주 묻는 질문
/memories를 일반 셸에서 실행해도 되나요?
아닙니다. Codex 대화형 TUI 입력창에서 completion을 확인한 뒤 실행합니다. 설명이 없으면 일반 프롬프트로 제출하지 마세요.
메모리를 켜면 이전 대화 전체가 저장되나요?
그렇게 설명할 수 없습니다. 공식 문서는 로컬 폴더에 요약, 오래 유지되는 항목, 최근 입력, 이전 채팅의 근거 자료가 포함될 수 있다고 설명합니다. 대화 전체를 그대로 보관한다고 단정하지 말고 민감정보가 없는지 사람이 확인합니다.
메모리 파일이 바로 생기지 않으면 실패인가요?
아닙니다. 생성은 백그라운드에서 진행되며 짧거나 일회성인 세션, 사용 한도 조건 등에 따라 건너뛸 수 있습니다. 활성화와 현재 채팅 범위를 먼저 확인하세요.
팀 규칙도 메모리에 넣으면 되나요?
아닙니다. 꼭 지켜야 하는 명령과 규칙은
AGENTS.md
처럼 명시적이고 검토 가능한 프로젝트 문서에 둡니다. 로컬 메모리는 개인 작업 흐름을 위한 보조 컨텍스트입니다.
출처
- OpenAI Codex Memories 공식 문서 — 기본 비활성화, 사용·생성 제어, 저장 위치, 백그라운드 생성, 비밀값 가림,
AGENTS.md경계를 확인했습니다. - OpenAI Codex Developer Commands 공식 문서 — TUI의
/memories진입점과 현재 채팅의 사용·생성 제어를 확인했습니다.
마무리
Codex 로컬 메모리는
/memories
completion 확인 → 전역 활성화 검토 → 새 세션 시작 → 사용·생성 범위 분리 → 비민감 읽기 전용 작업 → 저장 파일 검토 순서로 시작합니다. 자동으로 쌓인 맥락은 참고 자료일 뿐입니다. 필수 규칙과 최신 사실은
AGENTS.md
, 현재 파일, 테스트 결과에서 다시 확인하세요.
