Codex가 AGENTS.md 에서 규칙을 실행하지 않을 때는 먼저 시작 디렉터리와 파일 계층 구조를 확인하고 프롬프트를 반복적으로 변경하지 마세요. Codex는 전역 구성에서 시작하여 프로젝트의 루트 디렉터리에서 현재 작업 디렉터리까지 읽습니다; 현재 디렉터리에 더 가까운 규칙이 우선권을 가지며, TUI 세션의 각 실행 또는 시작 시 명령어 체인이 재구성됩니다.
먼저, 파일이 실제로 검색 경로에 있는지 확인하세요
프로젝트 규칙은 Git 저장소의 루트 디렉터리나 현재 작업 디렉터리의 부모 디렉터리에 배치해야 합니다. 저장소 외부에서 시작하거나 실제 작업 디렉터리가 다른 하위 디렉터리에 있다면, Codex는 편집한 파일을 절대 통과하지 않을 수 있습니다. 대상 디렉터리에서 시작할 수 있습니다:
codex --cd services/api "列出当前生效的指令文件"프로젝트가 Git 저장소가 아니라면 Codex는 보통 현재 디렉터리만 검사하므로, 관련 없는 부모 디렉터리에 AGENTS.md 넣고 자동으로 적용될 것으로 기대하지 마세요.
그 다음 보장 관계를 확인하세요
같은 디렉터리 내에서 AGENTS.override.md가 AGENTS.md보다 우선하며, Codex는 한 레이어당 최대 하나의 파일을 읽을 수 있습니다. 글로벌 디렉터리 ~/.codex에는 오버라이드 파일도 포함될 수 있습니다; 임시 오버라이딩에는 적합하지만, 삭제를 잊으면 프로젝트 규칙이 무효처럼 보입니다. 중첩된 디렉터리의 규칙은 루트 디렉터리 규칙 다음으로 순위가 매겨집니다; 충돌이 발생할 경우, 현재 디렉터리에 가장 가까운 콘텐츠가 우선합니다.
내용이 너무 길면 삭제됩니다
Codex는 기본적으로 제한된 크기의 프로젝트 명령어만 불러옵니다. 병합된 콘텐츠가 한계에 도달하면 이후 규칙이 맥락에 들어가지 않을 수 있습니다. 일반 명세는 루트 디렉터리에 두고 서비스 전용 명령어는 해당 하위 디렉터리에 배치하는 것이 모든 요구사항을 하나의 큰 파일에 모으는 것보다 보통 더 신뢰할 수 있습니다.
수정 후에는 다시 진행해야 합니다
AGENTS.md 실행 중에 지속적으로 핫 업데이트가 되는 구성이 아닙니다. 파일을 편집한 후에는 Codex를 재시작하거나 현재 TUI 세션을 종료한 후 다시 시작하세요; 커스텀 대체 파일 이름을 변경한다면, project_doc_fallback_filenames에 이미 기록되어 있는지 꼭 확인하세요. 마지막으로, Codex가 유효한 규칙을 다시 한 번 확인하고, 프로젝트 루트 디렉터리, 전역 CODEX_HOME, 가장 가까운 오버라이드 파일을 점검하게 하세요. 이 세 가지가 모두 일관되게 된 후에야 공식 작업을 시작할 수 있습니다.
