Codex resume AGENTS.md 변경 반영 확인법

Codex resume AGENTS.md 변경을 확인할 때는, 최신 지침을 읽었다고 추측하지 말고 비민감한 marker 한 줄로 확인한다. 같은 질문을 재개한 세션과 새 세션에 각각 보내 출력이 모두 새 marker인지 비교하면 된다.

Codex CLI 0.155.1 직접 재현에서는 두 세션 모두 변경된 marker를 읽었지만, 공개된 0.136.0 사례는 resume한 세션에 이전 marker가 남았다. 버전과 세션 조건을 함께 기록해야 하는 이유다.

먼저 새 지침을 비민감 marker로 바꾼다

실제 회사 규칙, 고객 정보, 토큰을 시험 문구로 쓰지 않는다. 별도 테스트 저장소나 공개해도 무방한 프로젝트의 AGENTS.md에 아래처럼 구분하기 쉬운 한 줄을 둔다.

Codex와 Claude Code를 같은 저장소에서 쓴다면, marker를 추가하기 전에 CLAUDE.md와 AGENTS.md의 역할을 나누는 방법으로 파일 자체를 혼동한 경우부터 제외한다.

TEMPORARY TEST: when asked "agents reload marker?", answer exactly "markerA-2026-09-22".

Codex 새 세션을 열고 agents reload marker?라고 묻는다. markerA-2026-09-22가 나오면 첫 기준선이 생긴다. 이제 Codex를 종료하고 파일의 A만 B로 바꾼다.

TEMPORARY TEST: when asked "agents reload marker?", answer exactly "markerB-2026-09-22".

날짜나 임의 문자열을 함께 넣는 이유는 예전 답을 우연히 반복한 것과 현재 파일을 읽은 것을 구분하기 위해서다. marker는 ASCII 한 줄이면 충분하다.

resume한 세션과 새 세션에 같은 질문을 보낸다

먼저 이전 thread를 재개한다. TUI에서는 기존 세션 선택 화면이나 /resume을 사용할 수 있다. 비대화형 CLI로 확인한다면 원래 저장소의 Git 루트에서 session ID를 지정한다.

codex exec resume SESSION_ID "agents reload marker?"

그다음 같은 폴더에서 새 thread를 열어 같은 질문을 보낸다.

codex exec -C /테스트/저장소 "agents reload marker?"

두 결과를 다음처럼 나눈다.

resume 결과	새 thread 결과	먼저 확인할 것
marker B	marker B	현재 환경에서는 두 경로 모두 변경 지침을 읽음
marker A	marker B	재개한 thread에 이전 지침이 남는 버전·세션 동작 가능성
marker A	marker A	파일 저장 위치, 활성 AGENTS.md, override, 크기 상한부터 재확인
설명만 하고 marker를 답하지 않음	어느 쪽이든	질문 문구와 충돌 지침을 줄여 별도 비민감 fixture에서 다시 확인

marker B가 나왔다고 모든 지침을 반드시 지킨다는 뜻은 아니다. 여기서 확인한 것은 새 문장이 입력에 반영됐는지다. 구체 행동이 어긋나면 로드 문제와 분리해 지침 충돌이나 준수 문제를 좁힌다.

현재 버전과 과거 공개 사례의 결과가 달랐다

이번에는 macOS의 비민감 Git fixture, Codex CLI 0.155.1, gpt-5.6-sol low, read-only 실행에서 확인했다.

단계	실제 출력
marker A로 만든 새 thread	markerA-2026-09-22
파일을 marker B로 바꾼 뒤 같은 thread resume	markerB-2026-09-22
marker B 상태에서 만든 별도 새 thread	markerB-2026-09-22

즉, 이번 환경에서는 resume도 변경된 AGENTS.md를 읽었다.

반면 OpenAI Codex 공개 이슈 #27473의 작성자는 CLI 0.136.0에서 반대 결과를 기록했다. marker A로 만든 세션을 종료하고 파일을 marker B로 바꾼 뒤 /resume했을 때는 marker A 동작이 남았고, 같은 폴더의 새 세션은 marker B를 읽었다. 이슈는 작성자가 다른 이슈의 중복 가능성으로 닫았다.

이 차이만으로 어느 버전에서 수정됐다고 단정할 수는 없다. 공개 이슈의 환경은 Ubuntu와 CLI 0.136.0이고, 이번 재현은 macOS와 CLI 0.155.1이다. 공식 AGENTS.md 안내에서 세션 시작 시 지침 체인을 구성한다는 설명은 확인했지만, 모든 resume 경로가 언제 파일을 다시 읽는다는 보장은 이번 확인 범위에서 찾지 못했다.

2026년 9월 22일 Google·Naver에서 같은 표현의 일반 결과를 확인했을 때도 상위 문서는 AGENTS.md의 역할·위치·작성법이나 codex resume 명령 자체를 주로 설명했다. resume 뒤 파일을 바꾼 A/B 대조와 버전별 상반된 결과를 함께 보여 주는 답은 상위 결과에서 확인하지 못했다. 검색 결과가 있다는 사실을 검색량으로 바꾸지는 않았으며, 이 글은 공개 질문 한 건과 직접 재현을 근거로 한 탐색 답이다.

trusted directory 오류가 나면 원래 저장소에서 재개한다

이번 재현의 첫 resume 명령은 다른 작업 폴더에서 실행해 아래 오류로 종료됐다.

Not inside a trusted directory and --skip-git-repo-check was not specified.

이 오류는 marker A와 B 중 무엇을 읽었는지 보여 주는 결과가 아니다. 원래 thread가 만들어진 테스트 저장소의 Git 루트로 이동해 같은 session ID를 다시 지정하자 정상적으로 marker B가 출력됐다.

저장소 루트나 첫 커밋 유무가 불분명하면 Codex worktree의 invalid reference: HEAD 확인 순서로 Git 기준점부터 분리한다.

cd /테스트/저장소
codex exec resume SESSION_ID "agents reload marker?"

--skip-git-repo-check로 검사를 건너뛰기 전에 작업 폴더가 맞는지부터 확인한다. 다른 저장소에서 잘못된 thread를 재개하면 활성 지침 경로까지 달라져 비교가 흐려진다.

결과가 다르면 다섯 가지만 보존한다

resume는 A, 새 thread는 B처럼 결과가 갈리면 긴 개인 설정 파일 전체를 공유하지 않는다. 다음 다섯 항목이면 재현 범위를 설명할 수 있다.

1. codex --version 출력
2. 비민감 fixture의 현재 작업 폴더와 Git 루트
3. 사용한 session ID의 앞부분 또는 비식별 별칭
4. marker A/B를 바꾼 순서와 두 질문 문구
5. resume와 새 thread의 실제 최종 출력

컨텍스트 압축, Desktop 앱, TUI /resume, codex exec resume는 서로 다른 실행 경로일 수 있다. 확인하지 않은 경로까지 “항상 최신” 또는 “항상 이전 상태”라고 넓히지 않는다.

실무에서는 새 세션이 가장 짧은 복구 경로다

이전 세션의 대화 맥락이 꼭 필요하지 않고 marker 결과가 다르면 새 세션을 여는 것이 가장 짧다. 필요한 진행 상황은 비밀이 없는 인계 메모에 적고, 새 세션에서 marker B가 보이는지 먼저 확인한 뒤 작업을 이어간다.

반대로 긴 작업의 문맥을 유지해야 한다면 resume 결과를 버전과 함께 남긴다. 지침이 실제로 갱신됐다는 marker B를 확인한 뒤에만 업무 규칙 준수 문제를 따로 조사한다. 파일을 계속 고치면서 같은 오래된 세션만 반복 재개하면 원인 구분이 더 어려워진다.

자주 묻는 질문

Codex를 종료했다 다시 실행하면 항상 최신 AGENTS.md를 읽나?

모든 버전과 재개 경로에 대해 그렇게 단정할 수 없다. CLI 0.155.1의 이번 재현에서는 resume와 새 thread 모두 최신 marker B를 읽었지만, CLI 0.136.0 공개 사례는 resume에서 marker A가 남았다. 현재 환경에서 같은 marker 대조를 한 번 실행한다.

marker B가 나오면 문제는 완전히 해결된 것인가?

아니다. 최신 문장이 입력에 들어왔다는 뜻이다. 실제 행동이 어긋나면 충돌하는 지침, 모호한 표현, 모델 준수 문제를 별도로 확인한다.

업무용 AGENTS.md에 marker를 넣어도 되나?

비밀값이나 실제 고객 규칙은 넣지 않는다. 공개해도 되는 임시 marker 한 줄만 사용하고, 가능하면 별도 비민감 Git fixture에서 먼저 확인한다.

검증 기준

• 마지막 업데이트일: 2026-09-22
• 확인 환경: Codex CLI 0.155.1, macOS, gpt-5.6-sol low, 비민감 Git fixture
• 과거 공개 사례: Codex CLI 0.136.0, Ubuntu, openai/codex #27473 작성자 재현
• 주요 근거: OpenAI AGENTS.md 안내, Codex 공개 이슈 #27473
• 한계: Codex Desktop, 모든 버전, compaction 뒤 동작, 정확 검색량, seoin.dev 독자 직접 반응은 미확인