메모리 운영
persistent memory, stale fact 방지, reset 전략
핵심 요약
- 메모리에는 반복 개인 선호·안정적 프로젝트 사실·장기 행동 규칙만 넣고, 짧게 바뀌는 티켓 상태나 임시 우회책, 사람 검증이 안 끝난 사실은 제외합니다.
- 0.121.0 이후
[memories]의use_memories·generate_memories·disable_on_external_context세 키가 핵심이며, 외부 도구 호출이 많은 팀은disable_on_external_context = true로 stale fact를 줄입니다. - 개인 취향은 memory, 팀 표준은
AGENTS.md·Team Config·requirements.toml로 분리해 사용자별로 다른 Codex가 되는 것을 막습니다. - 사실(fact)보다 오래 유효한 정책(policy)을 먼저 저장하고, 레포 구조·기본 모델·조직 규칙이 바뀌면 stale fact 제거 루틴을 돌립니다.
- 품질이 떨어지면 더 강한 프롬프트를 덧대기 전에
codex debug clear-memories로 초기화하고 최소 규칙만AGENTS.md/Team Config로 승격합니다.
Codex의 memory는 장기 생산성을 높여주지만, 방치하면 오래된 사실이 그대로 쌓입니다. 최근 릴리스에서 memory는 더 정교해졌지만, 운영 기준 없이 켜두면 품질 편차가 커집니다.
메모리를 언제 쓰나
- 반복되는 개인 선호: 출력 형식, 선호 리뷰 스타일, 자주 쓰는 검증 루틴
- 안정적인 프로젝트 사실: 브랜치 전략, 기본 테스트 명령, 금지 디렉토리
- 장기 업무 패턴: “PR 전에
/diff와/review를 반드시 수행” 같은 행동 규칙
반대로 아래는 memory에 넣지 않는 편이 낫습니다.
- 짧게 바뀌는 티켓 상태
- 임시 우회책
- 브랜치/이슈별 가정
- 사람 검증이 끝나지 않은 사실
최근 릴리스 기준 메모리 변화
- 메모리 설정 분리/구성 가능: memory를 더 세밀하게 켜고 끌 수 있음
- workspace-scoped writes: 메모리가 프로젝트/워크스페이스 경계를 더 잘 인식
- stale/polluted fact guardrails: 오래되거나 오염된 사실이 저장되지 않도록 보호 장치 강화
- 설정 키 개편: 메모리 관련 설정 이름과 UX가 정리됨
- 초기화 도구 추가:
codex debug clear-memories로 저장된 메모리 상태를 리셋 가능 - 0.121.0 memory controls: TUI/app-server에서 memory mode 전환, reset/deletion, memory-extension cleanup이 가능해짐
0.121.0 이후 바로 쓸 설정 키
공식 config reference 기준으로 메모리 운영에서 가장 먼저 챙길 값은 세 가지입니다.
[memories]
use_memories = true
generate_memories = true
disable_on_external_context = trueuse_memories = false: 기존 메모리를 다음 세션에 주입하지 않음generate_memories = false: 새 스레드를 메모리 생성 입력으로 쓰지 않음disable_on_external_context = true: MCP, web search, tool search를 많이 쓴 스레드를 메모리 후보에서 제외
외부 도구 호출이 잦은 팀이라면 disable_on_external_context = true를 기본값으로 두는 게
stale fact를 줄이는 데 좋습니다.
팀 운영 원칙
1) 개인 memory와 팀 규칙을 섞지 않는다
- 개인 취향: memory
- 팀 표준:
AGENTS.md, Team Config,requirements.toml
팀 규칙까지 memory에 맡기면 사용자마다 Codex가 제각각 달라집니다.
2) 사실(fact)보다 정책(policy)을 우선한다
메모리에는 “이번 스프린트에서만 맞는 사실”이 아니라 오랫동안 유효한 규칙을 남겨야 합니다.
3) stale fact 제거 루틴을 정한다
다음 상황이면 memory를 초기화하거나 다시 점검하세요.
- 리포지토리 구조가 크게 바뀜
- 기본 모델/승인 정책이 바뀜
- 조직 규칙이 Team Config로 승격됨
- Codex가 같은 잘못된 가정을 반복함
운영 체크리스트
| 상황 | 권장 동작 |
|---|---|
| 개인 작업 스타일 반복 | memory에 남겨도 됨 |
| 보안/배포 규칙 | memory가 아니라 AGENTS.md/requirements로 승격 |
| 오래된 프로젝트 지식 누적 | codex debug clear-memories 고려 |
| 새 레포 온보딩 | memory보다 로컬 AGENTS.md 우선 |
실전 패턴
좋은 예
- “최종 답변은 변경 요약 + 검증 결과 + 남은 리스크 형식으로 정리”
- “테스트 명령은
yarn typecheck && yarn build를 우선 시도”
나쁜 예
- “이 모듈은 아마 더 이상 안 씀”
- “이 브랜치는 곧 버릴 예정”
- “이번 이슈는 API 문제일 가능성이 높음”
리셋/복구 전략
메모리 품질이 떨어졌다 싶으면 곧장 프롬프트를 더 강하게 덧대기보다 저장 상태부터 점검하세요.
- 최근 반복 오작동이 memory 문제인지 확인
- 프로젝트 규칙이 실제로는
AGENTS.md에 있어야 하는지 판단 - 필요하면
codex debug clear-memories로 초기화 - 다시 필요한 최소 규칙만
AGENTS.md와 Team Config로 승격
참고 문서
- Changelog: https://developers.openai.com/codex/changelog (영어)
- Team Config: https://developers.openai.com/codex/team-config (영어)
- AGENTS.md 가이드: https://developers.openai.com/codex/guides/agents-md (영어)
- GitHub Releases: https://github.com/openai/codex/releases (영어)