# 접근을 넓히는 것과 설정을 상속하는 것은 다르다

> 추가 디렉토리의 로딩 비대칭, 자동 메모리의 범위, 로컬 상태 정리

- Canonical: https://learning.reopt.ai/courses/claude-code-project-context/lessons/ccpc-m4-concept
- Language: ko-KR
- HTML: https://learning.reopt.ai/courses/claude-code-project-context/lessons/ccpc-m4-concept

---

[프로젝트 컨텍스트 설계](/courses/claude-code-project-context) 4. 경계 확장과 흔적 정리 7 / 9

# 접근을 넓히는 것과 설정을 상속하는 것은 다르다

추가 디렉토리의 로딩 비대칭, 자동 메모리의 범위, 로컬 상태 정리
개념 학습 45 XP 9분

모노레포나 사내 공통 패키지를 다루면 --add-dir 로 작업 범위를 넓히게 됩니다. 이때 따라오는 것과 따라오지 않는 것이 비대칭 입니다 — 그쪽 .claude/skills/ 의 Skills는 라이브 리로드까지 되며 자동 로드되지만, CLAUDE.md 와 rules는 전용 환경 변수 없이는 로드되지 않고 hooks·commands·subagents는 아예 로드되지 않습니다. 자동 메모리도 마찬가지로 범위가 정해져 있습니다. git 저장소 단위로 산출되는 머신 로컬 데이터라 worktree끼리는 공유되고 팀원과는 공유되지 않습니다. 범위를 넓히는 결정과 흔적을 지우는 절차는 한 세트로 정해야 합니다.
붙이기 전에 신뢰를 묻는다 디렉토리를 추가할 때는 그 저장소의 .claude/skills/를 먼저 열어보고, 그쪽 규칙이 필요하면 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1을 명시적으로 켭니다. 켜지 않았다면 그 디렉토리의 규칙은 적용되지 않는다고 전제하고 작업합니다.

| 설정 종류 | 로드 여부 | 비고 |
| .claude/skills/ | 로드됨 | 라이브 리로드 포함, 보안 검토 필요 |
| 플러그인 설정 | 일부만 로드 | enabledPlugins·extraKnownMarketplaces |
| CLAUDE.md·rules·CLAUDE.local.md | 환경 변수 필요 | CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 |
| Subagents·commands·output styles | 로드 안 됨 | cwd·상위·~/.claude·managed만 |
| Hooks·기타 settings.json 키 | 로드 안 됨 | cwd의 .claude와 사용자/managed만 |

--add-dir는 파일 접근 범위를 넓힐 뿐 설정 루트를 만들지 않습니다.

- 1 신뢰 확인 붙일 디렉토리의 .claude/skills/를 열어 자동 로드될 스킬을 먼저 검토합니다.

- 2 규칙 로딩 결정 그쪽 규칙이 필요하면 전용 환경 변수를 켜서 실행하고 팀 표준으로 문서화합니다.

- 3 메모리 감사 자동 메모리 폴더를 열어 민감 정보와 팀에 공유해야 할 지식을 분류합니다.

- 4 흔적 정리 claude project purge <path>를 --dry-run으로 확인한 뒤 path를 명시해 실행합니다.

실무에 남길 기준

- permissions.additionalDirectories는 파일 접근만 부여하고 설정 로딩 예외는 적용되지 않는다
- 팀이 공유해야 할 지식은 머신 로컬 자동 메모리가 아니라 저장소에 커밋되는 CLAUDE.md·rules에 둔다
- /clear는 세션 컨텍스트만 비우고 디스크의 transcript와 자동 메모리는 claude project purge로 정리한다

[이전](/courses/claude-code-project-context/lessons/ccpc-m3-checklist) 이해했어요 · 계속

---

에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact
