OpenAI Codex 메모리·이미지 기능 완전 정리 — 켜는 법, 설정, 검열 정책까지

"Codex에 메모리 기능이 있다던데, 왜 내 Codex는 아무것도 기억을 못 하지?" — 답부터 말하면, 로컬 Codex의 메모리는 기본값이 꺼짐이기 때문이에요. 그리고 ChatGPT 웹에서 쓰는 Codex와 터미널/데스크톱에서 쓰는 Codex는 서로 다른 메모리 저장소를 씁니다. 이 두 가지만 알아도 혼란의 절반이 풀려요. 이 글은 공식 문서 기준으로 Codex의 기억 구조와 이미지 기능(입력·생성·검열)을 실무자 관점에서 정리한 가이드예요.

참고로 문서 위치가 최근 바뀌었어요. Codex가 7월에 ChatGPT 데스크톱 앱으로 통합되면서 개발자 문서도 learn.chatgpt.com으로 이사했습니다(developers.openai.com/codex는 리다이렉트돼요).

Codex의 기억은 3계층이에요

혼동을 막으려면 먼저 구조를 알아야 해요. Codex에는 성격이 다른 지속성 계층이 세 개 있습니다.

1. 메모리(Memories) — 자동 생성, 로컬, 기본 꺼짐. 켜면 Codex가 과거 세션에서 선호, 코딩 스타일, 지적받은 실수, 프로젝트 관례, 반복 워크플로우를 추출해 ~/.codex/memories/ 아래 파일로 저장하고 다음 세션에 주입해요.

2. AGENTS.md — 수동 작성, 명시적 규칙. 전역(~/.codex/AGENTS.md)과 프로젝트별(리포 루트부터 현재 디렉토리까지) 파일이 위에서 아래로 이어 붙고, 가까운 파일이 우선해요. 공식 문서의 원칙이 명확합니다 — "팀 규칙은 AGENTS.md에, 메모리는 보조 회상 계층으로". 합산 용량 기본 한도는 32KiB이고 project_doc_max_bytes로 늘릴 수 있어요.

3. 세션 지속 — codex resume. 현재 리포의 최근 대화를 다시 열거나 과거 세션을 검색해요. 7월 CLI v0.145.0부터는 스레드 검색·이름 저장이 붙었고,

할 수 있게 됐어요.

메모리 켜는 법

두 가지 경로가 있어요.

• GUI: ChatGPT 데스크톱 → Settings → Personalization → "Enable memories"
• 설정 파일: ~/.codex/config.toml에 아래 두 줄

[features]
memories = true

세션 단위 제어는 /memories 슬래시 커맨드로 해요 — 이 대화가 기존 메모리를 쓸지, 앞으로의 메모리 생성에 기여할지를 대화별로 정할 수 있습니다.

더 세밀하게 조이고 싶으면 config.toml의 memories.* 키를 쓰면 돼요. 실무에서 유용한 것만 추리면:

삭제는 주의가 필요해요. 공식 문서 어디에도 메모리 초기화 명령이 없습니다. 메모리가 ~/.codex/memories/의 일반 파일이라 디렉토리를 지우는 게 통용되는 방법이지만, 이건 문서화되지 않은 방식이니 백업 후에 하세요.

프라이버시: 공식 문서는 생성된 메모리에서 시크릿을 자동 마스킹한다고 명시하지만, Codex 홈 디렉토리를 공유하기 전엔 메모리 파일을 직접 검토하라고 권해요. 학습 사용 여부에 대한 명시적 문구는 문서에서 확인하지 못했습니다. 참고로 요금제별 롤아웃은 4월 발표 당시 Enterprise·Edu 우선이었는데, 7월 현재 전 플랜 완료 여부는 공식 확인이 없어요 — 안 보이면 플랜 문제일 수 있습니다.

이미지 입력 — 모든 표면에서 됩니다

스크린샷을 주고 "이 에러 고쳐줘"를 하고 싶다면:

codex -i screenshot.png "이 에러 설명하고 최소 수정안 제시해줘"
codex --image before.png,after.png "두 상태를 비교해서 차이를 정리해줘"

인터랙티브 CLI에선 클립보드 붙여넣기와 드래그 앤 드롭이 되고, IDE 확장/데스크톱 앱에선 Shift를 누른 채 드래그해야 에디터가 드롭을 가로채지 않아요. macOS 데스크톱엔 Appshots라는 기능도 있어요 — Command 키 두 개를 동시에 누르면 최전면 앱 창의 스크린샷+텍스트가 대화에 첨부됩니다(화면 기록 권한 필요).

한 가지 알려진 한계: 세션 중간에 "경로에 있는 이미지 파일을 읽어줘"라고 하면 에이전트가 못 읽고 붙여넣기를 요청하는 경우가 있어요. 이미지는 처음부터 첨부하는 게 확실합니다.

이미지 생성 — 이제 진짜 됩니다 (그리고 비용 주의)

"Codex가 이미지 생성이 되나?"에 대한 답이 올봄에 바뀌었어요. 예전엔 안 됐지만, 지금은 gpt-image-2 기반 네이티브 생성이 들어와 있습니다. 자연어로 요청하거나 $imagegen 스킬을 명시하면 돼요:

codex "다크 모드 대시보드 헤더 배너 만들어줘 $imagegen"

실무에서 중요한 세 가지:

1. 비용: 생성 턴은 일반 텍스트 턴보다 사용량을 약 3~5배 빠르게 소모해요(공식 문서 기준 플랜 한도에 합산). 대량 생성은 OPENAI_API_KEY를 설정하면 API 종량제로 분리 과금됩니다.
2. 끄기: 팀 환경에서 생성을 막으려면 config.toml에서 imagegen 스킬을 비활성화할 수 있어요.
3. 제약: 투명 배경은 미지원이고(서드파티 문서 기준), 해상도는 2K가 안정권이에요.

"코덱스 이미지 검열"에 대하여 — 차단의 구조

이 검색어로 오신 분들이 실제로 겪는 상황을 구조적으로 설명하면 이래요.

• 사전 분류기 차단: 모델이 돌기 전에 프론트엔드 안전 분류기가 요청을 거절하면 moderation_blocked 에러가 나요. 상표·저작권 캐릭터명, 특정 신체·의상 표현이 문서화된 트리거이고, 같은 프롬프트를 재시도해도 절대 풀리지 않습니다. 표현을 바꿔야 해요.
• 정책 적용 범위: 실존 인물 묘사, 브랜드 모방, 이미지 내 텍스트는 공식 문서가 명시적으로 주의를 주는 영역이에요.
• 프롬프트 재작성: 커뮤니티 보고에 따르면 내장 imagegen 스킬이 안전 한정어를 프롬프트에 주입해 의도와 다른 결과가 나오는 경우가 있다고 해요(공식 확인은 아님).
• API 우회 아님 주의: 이미지 API엔 moderation 파라미터(auto/low)가 있지만 low도 정책 위반을 허용하는 게 아니라 필터 민감도를 낮추는 것뿐이에요.

이렇게 볼 수도 있어요

정직한 한계 셋. 첫째, 이 글의 설정 키와 경로는 2026년 7월 28일 기준 공식 문서 검증값인데, Codex는 문서 이사까지 할 만큼 빠르게 바뀌고 있어요 — 동작이 다르면 공식 문서를 먼저 확인하세요. 둘째, 저장 경로(generated_images/)와 일부 제약(투명 배경, 용량 한도)은 서드파티 문서 기준이라 표기해 뒀어요. 셋째, 메모리를 켠다는 건 결국 세션 기록이 로컬에 쌓인다는 뜻이에요 — Codex 세션 로그가 디스크를 집어삼킨 사례에서 봤듯, ~/.codex 아래 뭐가 얼마나 쌓이는지는 주기적으로 확인하는 습관이 필요합니다.

한국 개발자 입장에서

정리하면 실무 체크리스트는 이래요. 첫째, 팀 규칙은 AGENTS.md, 개인 취향은 메모리로 역할을 나누세요 — 메모리는 로컬이라 팀원과 공유되지 않으니, 공유돼야 할 규칙이 메모리에만 있으면 온보딩이 깨져요. 둘째, MCP나 웹 검색을 쓰는 팀이라면 disable_on_external_context = true를 고려하세요 — 외부 콘텐츠가 메모리에 스며드는 걸 막는 스위치예요. 셋째, 이미지 생성은 한도 소모가 커서 플랜 한도로 쓸지 API 키로 분리할지를 먼저 정하는 게 좋아요. Codex를 팀에 도입하는 흐름이 빨라지는 만큼, 이런 기본 설정이 곧 팀 표준 문서가 될 항목들입니다.

참고 문서: Codex Memories 공식 문서, AGENTS.md 구성, Codex 이미지 생성, config 레퍼런스