Cmd. /add-dir
현재 세션의 파일 접근 범위에 작업 디렉토리를 추가해 멀티 루트 분석을 수행하는 명령
핵심 요약
- 현재 세션에 파일 접근 작업 디렉터리 추가
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
현재 세션에 파일 접근 작업 디렉터리 추가
/add-dir <path>사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/add-dir ../shared/add-dir ../shared-packages세션 시작 전에는 CLI 인자로도 같은 일을 할 수 있습니다.
claude --add-dir ../shared-packages영구 적용이 필요하면 설정 파일의 additionalDirectories에 추가합니다. 단, 이 경로는 파일 접근만 부여하고 아래의 설정 로딩 예외는 적용되지 않습니다.
선택 시점
- 앱 코드와 공통 패키지 동시 점검
- 마이그레이션 중 구/신 디렉토리 비교
- 문서 저장소와 코드 저장소 동시 참조
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/add-dir | 참조 범위 확장 | 다중 디렉토리 분석 필요 시 |
/mcp | 외부 도구 연동 | 저장소 밖 시스템 조회 필요 시 |
실행 결과와 유지 범위
현재 세션에 파일 접근 범위를 추가합니다. 추가 경로의 프로젝트 설정까지 자동으로 모두 불러오는 것은 아닙니다.
/add-dir는 현재 세션 동안 파일에 접근할 작업 디렉토리를 추가합니다.
모노레포나 다중 저장소를 교차로 분석할 때 쓰면 편합니다. 추가한 디렉토리의 파일은 원래 작업 디렉토리와 같은 권한 규칙을 따르므로 별도 프롬프트 없이 읽을 수 있고, 편집 권한은 현재 권한 모드를 따릅니다.
다만 추가한 디렉토리에서는 대부분의 .claude/ 설정이 자동으로 발견되지 않습니다. 디렉토리를 추가했다고 그곳이 완전한 설정 루트가 되지는 않습니다.
공식 문서는 추가한 디렉토리에서 나중에 --continue나 --resume으로 세션을 이어받을 수 있다고 명시합니다.
추가 디렉토리에서 로드되는 설정 / 로드되지 않는 설정
--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에 나열한 디렉토리는 파일 접근만 부여하며, 위 설정 중 어느 것도 로드하지 않습니다.
주의사항
- 불필요한 대형 디렉토리 추가는 컨텍스트 과부하를 유발
- 민감 폴더는 접근 정책을 먼저 확인
- 추가 디렉토리는 기본적으로 현재 세션 범위에만 적용됩니다 (영구 적용은
additionalDirectories사용). - 추가 디렉토리의
CLAUDE.md는 기본적으로 자동 로드되지 않으며, 로드하려면CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1환경 변수가 필요합니다. - 반면 추가 디렉토리의
.claude/skills/는 자동으로 로드되니 주의하세요. "Skill은 로드되지만 commands·subagents·hooks는 로드되지 않는" 비대칭이 있습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록