[Codex 입문 4/6] AGENTS.md와 Memories - Codex가 내 프로젝트를 기억하는 법

 

Codex 입문 시리즈 · 4/6

04

Codex의 기억 설계

매번 같은 설명을 반복하지 않게 만드는 AGENTS.md와 선택형 Memories

AGENTS.mdMemoryContextRules

이번 회차 목차

1. AGENTS.md는 Codex용 인수인계서다
2. 무엇을 적으면 좋은가
3. Memories는 개인 취향을 담는 선택 기능
4. AGENTS.md 예시

AGENTS.md는 Codex용 인수인계서다

Claude Code에서 CLAUDE.md가 중요했다면, Codex에서는 AGENTS.md가 그 역할을 합니다. 프로젝트의 성격, 작업 규칙, 금지 사항, 검증 방법을 적어두는 파일입니다.

예를 들어 블로그 자동화 프로젝트라면 '원문 디테일을 함부로 삭제하지 말 것', '이미지 순서를 반드시 확인할 것', '발행 후 공개 URL을 검증할 것' 같은 규칙을 적어둘 수 있습니다.

이렇게 해두면 매번 긴 설명을 반복하지 않아도 Codex가 프로젝트의 일하는 방식을 먼저 읽고 시작합니다.

무엇을 적으면 좋은가

첫째, 프로젝트의 목적입니다. 이 폴더가 블로그 재포스팅용인지, 웹앱 개발용인지, 문서 관리용인지 적습니다.

둘째, 작업 방식입니다. 어떤 파일을 우선 읽는지, 어떤 명령으로 검증하는지, 어떤 스타일을 유지해야 하는지 적습니다.

셋째, 안전 규칙입니다. 원본 파일 삭제 금지, 자동 발행 전 확인 방식, 사용자 작성 문장 보존 같은 기준을 명확히 합니다.

Memories는 개인 취향을 담는 선택 기능

Memories는 프로젝트 파일이 아니라 사용자 쪽 기억에 가깝습니다. 자주 쓰는 말투, 선호하는 작업 방식, 반복되는 개인 맥락을 담을 수 있습니다.

다만 모든 것을 Memories에 넣는 것은 좋지 않습니다. 프로젝트별 규칙은 AGENTS.md, 개인 취향이나 자주 반복되는 선호는 Memories로 나누는 편이 깔끔합니다.

공식적으로 Memories는 기본값이 꺼져 있는 선택 기능이므로, 필요한 사람만 켜서 쓰는 방식이 안전합니다.

AGENTS.md 예시

블로그 작업이라면 이런 규칙이 도움이 됩니다.

원문 디테일과 작성자 경험을 최대한 보존한다. 설명과 이미지 순서가 어긋나면 캡션을 기준으로 재배치한다. 새 글 발행 후 공개 URL에서 제목, 핵심 문장, 이미지 노출 여부를 확인한다.

코드 프로젝트라면 테스트 명령, 린트 명령, 배포 전 확인 항목을 적어두면 좋습니다.

구분	역할
AGENTS.md	프로젝트별 작업 규칙과 검증 방법
Memories	사용자 선호와 반복되는 개인 맥락
Thread 맥락	현재 작업 흐름 안의 대화 기록
Prompt	이번 요청에서만 필요한 구체 조건
Goal	긴 작업의 최종 목적

바로 써볼 프롬프트

이 프로젝트에 맞는 AGENTS.md 초안을 만들어줘.
포함할 내용은 프로젝트 목적, 작업 규칙, 말투, 절대 하지 말아야 할 행동,
수정 후 검증 방법, 사용자에게 확인받아야 하는 상황이야.

이전편 보기3편 · Plan과 Goal로 일 맡기기 다음편 가기5편 · Skills·MCP·Plugins

다음 편에서는 Codex를 내 도구로 확장하는 Skills, MCP, Plugins를 정리합니다.