AI Briefing

Claude Code 자동 모드서 중첩 설정 파일 미로드 문제

In auto mode, your nested CLAUDE.md files are probably not being loaded

·2026.09.18 07:05

핵심 내용

Claude Code 자동 모드의 Bash 우선 지침으로 인해 중첩 CLAUDE.md 파일이 로드되지 않는 문제가 확인됐다.

자세히 보기

Claude Code v2.1.229 이후 활성화된 **자동 모드(Auto Mode)**와 권한 우회 모드가 세션에 'Bash 도구 우선 사용' 지침을 추가하면서, 중첩된 CLAUDE.md 파일이 로드되지 않는 문제가 발생하고 있다. 해당 지침은 Claude에게 cat, sed 등 Bash 명령어를 통해 파일을 읽고 편집하도록 유도하지만, 중첩 설정 파일은 네이티브 Read 도구를 사용할 때만 트리거되므로 규칙이 무시된다.

문제의 심각성 및 데이터 분석

한 개발자가 1개월간의 세션 기록(480개 메인 세션, 1,200개 하위 에이전트 세션)을 분석한 결과, Bash 우선 모드가 활성화된 세션에서는 **97%**의 파일 읽기가 Bash로 수행되었으며, 중첩 CLAUDE.md가 첫 편집 전에 로드된 비율은 **10%**에 불과했다. 반면, 해당 모드가 비활성화된 세션에서는 로드율이 **79%**였다.

  • 규칙 위반: infra/ 폴더의 'main 브랜치에서만 terraform apply 실행' 규칙이 30회 중 3회만 적용됨.
  • 후크(Hook) 미작동: Edit 또는 Write 도구를 감지하는 PostToolUse 후크가 Bash 편집 시 실행되지 않아, 포매터 및 리마인더 등 6개의 후크가 약 2/3의 편집에서 스킵됨.
  • 하위 에이전트 영향: v2.1.260 이전 버전에서는 하위 에이전트(Subagents)가 중첩 CLAUDE.md를 전혀 로드하지 못함.

해결 방안 및 임시 조치

현재 Anthropic은 관련 GitHub 이슈(#90450 등)에 대해 공식 답변이나 변경 로그 업데이트를 제공하지 않고 있다. 개발자가 제시한 우회 방법은 다음과 같다.

  1. 루트 파일 임포트: 모든 중첩 파일을 루트 CLAUDE.md에서 @service/AGENTS.md 형식으로 임포트하여 세션 시작 시 로드되도록 설정 (토큰 비용 약 3k 증가).
  2. 비공식 환경 변수: settings.json에 "CLAUDE_CODE_THRIFTY_SONIC": "0"을 추가하여 Bash 우선 지침을 제거하고 자동 모드 유지 (v2.1.271 바이너리에서 확인, 향후 버전에서 제거될 수 있음).
  3. 경로 범위 규칙 한계: .claude/rules/의 경로 범위 규칙도 Read 도구에만 의존하므로 이 문제를 해결하지 못함.

이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.

AI 처리 방식을 확인하거나, 요약 오류와 출처 표기 문제, 삭제 요청을 문의 · 건의로 알려주세요.