6계층의 계층적 Rule 구조를 통한 Agent 행동 제어 및 강제 집행 아키텍처

How Claude Code Rules Actually Work

Mario2026년 4월 27일7분intermediate

AI 요약

Context

Claude Code의 'Rules' 개념이 단순 가이드라인과 강제 설정으로 혼재되어 발생하는 모호성 존재. Prose 기반의 CLAUDE.md만으로는 Agent의 행동을 물리적으로 제어할 수 없는 아키텍처적 한계 직면.

Environment $\rightarrow$ settings.json $\rightarrow$ Hooks $\rightarrow$ CLAUDE.md 순의 엄격한 Loading Order 설계를 통한 설정 우선순위 확립
CLAUDE.md를 단순 Behavioral Norms 전달을 위한 Reading Material로 분리하여 Context Window 부하 감소
PreToolUse Hook을 통한 Tool 호출 전단 검증 및 Non-zero exit으로 특정 Action을 물리적으로 차단하는 Enforcement Layer 구축
SessionStart Hook을 이용한 런타임 컨텍스트(Branch, PR 상태 등) 동적 주입으로 정적 파일의 한계 극복
MCP Server Permissions를 통해 Tool 단위의 세밀한 Access Control 구현
Project-local 설정이 Global 설정을 덮어쓰는 Layered Override 구조 적용

실천 포인트

1. 물리적 차단이 필요한 규칙은 CLAUDE.md가 아닌 PreToolUse Hook에 정의했는가?

2. 동적 컨텍스트 주입이 필요한 정보는 SessionStart Hook을 통해 최적화했는가?

3. Project-local CLAUDE.md 작성 시 Global 설정의 Overriding 범위를 명시적으로 정의했는가?

4. Hook 실패 시 세션에 영향을 주지 않는 Silent Failure 가능성을 고려해 별도 로깅 체계를 갖췄는가?

태그