클로드 코드 @ 파일 언급을 내용 대신 경로로만 넘기는 환경변수 설정법

클로드 코드(Claude Code)는 프롬프트에 @파일을 쓰면 그 파일 내용을 대화에 통째로 넣는다. 2.1.299에 추가된 CLAUDE_CODE_DISABLE_FILE_MENTIONS를 1로 켜면 @ 언급을 펼치지 않는다. 클로드는 경로와 파일 도구로 읽으라는 안내만 받고, 내용은 Read 같은 파일 도구로 직접 읽는다. 큰 파일이나 디렉터리를 언급했다가 내용이 한꺼번에 컨텍스트로 쏟아지는 게 싫을 때 쓴다.

export CLAUDE_CODE_DISABLE_FILE_MENTIONS=1
claude

프로젝트 설정(.claude/settings.json)이나 로컬 설정의 env에 넣으면 무시된다. 셸에서 내보내거나 사용자 설정(~/.claude/settings.json)의 env에 넣는다. v2.1.299 이상이 필요하다.