Cmd. /add-dir
현재 세션의 파일 접근 범위에 작업 디렉토리를 추가해 멀티 루트 분석을 수행하는 명령
핵심 요약
/add-dir <path>는 현재 세션 동안 추가 작업 디렉토리에 접근하게 해주므로, 모노레포나 다중 저장소를 교차로 분석할 때 편합니다.- 추가 디렉토리의 파일은 원래 디렉토리와 같은 권한 규칙을 따라 별도 프롬프트 없이 읽을 수 있습니다.
- 추가 디렉토리의
.claude/skills/는 자동 로드되지만 commands·subagents·hooks는 로드되지 않는 비대칭이 있습니다. - 추가 디렉토리의
CLAUDE.md는CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1을 설정해야 로드되며, 영구 적용은additionalDirectories로 합니다.
명령어 원본 선언
/add-dir <path>공식 설명 요약
/add-dir는 현재 세션 동안 파일에 접근할 작업 디렉토리를 추가합니다.
모노레포나 다중 저장소를 교차로 분석할 때 쓰면 편합니다. 추가한 디렉토리의 파일은 원래 작업 디렉토리와 같은 권한 규칙을 따르므로 별도 프롬프트 없이 읽을 수 있고, 편집 권한은 현재 권한 모드를 따릅니다.
다만 추가한 디렉토리에서는 대부분의 .claude/ 설정이 자동으로 발견되지 않습니다. 디렉토리를 추가했다고 그곳이 완전한 설정 루트가 되지는 않습니다.
공식 문서는 추가한 디렉토리에서 나중에 --continue나 --resume으로 세션을 이어받을 수 있다고 명시합니다.
최소 지원 버전
- 공식 명령어 문서에 별도의 최소 버전이 명시되어 있지 않습니다. (Working directories 기능 일부로 제공)
사용법
/add-dir ../shared-packages세션 시작 전에는 CLI 인자로도 같은 일을 할 수 있습니다.
claude --add-dir ../shared-packages영구 적용이 필요하면 설정 파일의 additionalDirectories에 추가합니다. 단, 이 경로는 파일 접근만 부여하고 아래의 설정 로딩 예외는 적용되지 않습니다.
추가 디렉토리에서 로드되는 설정 / 로드되지 않는 설정
--add-dir 플래그 또는 /add-dir 명령으로 추가한 디렉토리에 한해 일부 설정이 예외적으로 로드됩니다.
| 설정 종류 | --add-dir에서 로드 여부 |
|---|---|
.claude/skills/의 Skills | 로드됨 (라이브 리로드 포함) |
.claude/settings.json의 플러그인 설정 | enabledPlugins와 extraKnownMarketplaces만 로드됨 |
CLAUDE.md, .claude/rules/, CLAUDE.local.md | CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 설정 시에만 로드됨 |
| Subagents, commands, output styles | 로드되지 않음 (현재 작업 디렉토리·상위·~/.claude/·managed settings에서만 발견) |
Hooks 및 기타 settings.json 키 | 로드되지 않음 (현재 작업 디렉토리의 .claude/와 사용자/managed settings에서만) |
permissions.additionalDirectories에 나열한 디렉토리는 파일 접근만 부여하며, 위 설정 중 어느 것도 로드하지 않습니다.
좋은 사용 예
- 앱 코드와 공통 패키지 동시 점검
- 마이그레이션 중 구/신 디렉토리 비교
- 문서 저장소와 코드 저장소 동시 참조
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/add-dir | 참조 범위 확장 | 다중 디렉토리 분석 필요 시 |
/mcp | 외부 도구 연동 | 저장소 밖 시스템 조회 필요 시 |
활용 사례
- 모노레포 패키지 영향도 분석
- 공통 유틸 변경 시 소비 앱 파급 점검
주의사항
- 불필요한 대형 디렉토리 추가는 컨텍스트 과부하를 유발
- 민감 폴더는 접근 정책을 먼저 확인
- 추가 디렉토리는 기본적으로 현재 세션 범위에만 적용됩니다 (영구 적용은
additionalDirectories사용). - 추가 디렉토리의
CLAUDE.md는 기본적으로 자동 로드되지 않으며, 로드하려면CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1환경 변수가 필요합니다. - 반면 추가 디렉토리의
.claude/skills/는 자동으로 로드되니 주의하세요. "Skill은 로드되지만 commands·subagents·hooks는 로드되지 않는" 비대칭이 있습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Configure permissions (Working directories): https://code.claude.com/docs/en/permissions