메모리 운영

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 = true

• use_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가 같은 잘못된 가정을 반복함

운영 체크리스트

실전 패턴

좋은 예

• “최종 답변은 변경 요약 + 검증 결과 + 남은 리스크 형식으로 정리”
• “테스트 명령은 yarn typecheck && yarn build를 우선 시도”

나쁜 예

• “이 모듈은 아마 더 이상 안 씀”
• “이 브랜치는 곧 버릴 예정”
• “이번 이슈는 API 문제일 가능성이 높음”

리셋/복구 전략

메모리 품질이 떨어졌다고 느끼면, 바로 더 강한 프롬프트를 덧대기보다 먼저 저장 상태를 점검하는 편이 낫습니다.

1. 최근 반복 오작동이 memory 문제인지 확인
2. 프로젝트 규칙이 실제로는 AGENTS.md에 있어야 하는지 판단
3. 필요하면 codex debug clear-memories로 초기화
4. 다시 필요한 최소 규칙만 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 (영어)