CLAUDE.md의 @import는 토큰을 한 푼도 아끼지 않는다, 줄이려면 /doctor prompt-audit

AGENTS.md와 CLAUDE.md는 세션마다 통째로 컨텍스트에 들어가고 매 턴 따라다닌다. 길수록 비싸고, 길수록 안 따른다. 공식 문서 기준은 파일 하나에 200줄 아래다. Codex는 합계 32KiB까지만 읽고 그 뒤는 버린다.

이번 주 많이 공유된 글에서 맞는 내용만 추리면 이렇다.

• @path 가져오기는 보기 좋게 나눌 뿐이다. 가져온 파일도 시작 때 전부 로드되니 토큰은 그대로다.
• Codex는 세션 시작 때 한 번만 읽는다(전역 → 프로젝트 루트 → 현재 폴더). Claude Code는 하위 폴더의 AGENTS.md를 그 폴더 파일을 읽을 때 로드한다. 한 폴더에만 해당하는 규칙은 그 폴더에 둔다.
• 설치한 스킬은 이름과 설명이 매 턴 컨텍스트를 차지한다. /skill-doctor가 스킬마다 비용과 사용 횟수를 보여 주니 안 쓰는 건 끈다(v2.1.252 이상).

정리는 아래 명령 한 줄에 맡긴다. 옛 모델용 지시나 없는 파일을 가리키는 참조, 서로 어긋나는 파일을 찾아 주고 승인하기 전엔 아무것도 바꾸지 않는다(v2.1.283 이상).

/doctor prompt-audit

두 파일을 다 두는 저장소라면 Claude Code는 기본적으로 CLAUDE.md만 읽는다(v2.1.277 이상에서 AGENTS.md 직접 읽기는 CLAUDE.md가 없을 때만). 공통 규칙을 AGENTS.md에 두고 CLAUDE.md는 한 줄로 가리키게 한다.

@AGENTS.md