Claude Code는 이제 --add-dir 플래그와 /add-dir 대화형 명령어를 사용하여 단일 세션에서 여러 디렉터리를 작업하는 것을 지원합니다. 이를 통해 프로젝트 간의 지속적인 컨텍스트 전환을 없앨 수 있습니다.
버튼
다중 디렉터리 지원이란 무엇인가요?
핵심 기능
--add-dir /path/to/dir 플래그는 작업 디렉터리를 변경하지 않고 Claude Code 세션에 디렉터리를 추가합니다. 대화형 세션 중에는 /add-dir <path>를 사용하여 작업 공간을 동적으로 확장할 수 있습니다.
Claude Code는 성능을 유지하면서 다양한 디렉터리 구조에 걸쳐 파일 관계를 유지합니다. 추가된 디렉터리의 파일을 참조할 때 시스템이 경로 확인을 자동으로 처리합니다.
주요 사용 사례
모노레포
세션을 전환하지 않고 프런트엔드, 백엔드 및 공유 모듈 전반에서 작업하세요. 논리적으로 분리된 대규모 애플리케이션은 모든 구성 요소에 대한 통합 액세스를 통해 이점을 얻을 수 있습니다.
공유 구성 파일
별도의 위치에 저장된 구성 파일, 문서 및 개발 아티팩트에 액세스하세요. 개인 생산성 파일과 팀 문서는 세션 전반에 걸쳐 일관되게 사용할 수 있습니다.
교차 프로젝트 개발
상호 연결된 리포지토리를 동시에 관리하세요. API 클라이언트는 서버 구현과 동기화 상태를 유지합니다. 코드 변경과 함께 문서도 업데이트됩니다.
구현 전략
작업 공간 설정
- 기본 작업 디렉터리 식별
--add-dir을 사용하여 관련 디렉터리 추가- 일반적인 구성에 대한 셸 별칭 생성
- 팀 전체 디렉터리 패턴 설정
성능 최적화
- 활발하게 사용하는 디렉터리만 추가
- 빌드 아티팩트가 있는 디렉터리 피하기
- 대규모 구성에서 컨텍스트 토큰 사용량 모니터링
- 안정적인 액세스를 위해 절대 경로 사용
개발 통합
다중 디렉터리 지원은 기존 Git 워크플로우, CI 시스템 및 배포 파이프라인과 함께 작동합니다. Apidog와 같은 API 개발 도구는 여러 프로젝트 디렉터리에 걸쳐 사양을 모니터링할 수 있습니다.
실용적인 예시
마이크로서비스 아키텍처
하나의 세션에서 서비스 구현, 공유 라이브러리, 구성 템플릿 및 배포 스크립트에 액세스하세요. 새로운 서비스를 개발하는 동안 기존 패턴을 참조하세요.
오픈 소스 기여
포크된 리포지토리, 업스트림 소스 및 개인 구성을 동시에 작업하세요. 모든 관련 코드베이스에 액세스하면서 깔끔한 기여를 유지하세요.
코드형 인프라
여러 리포지토리에 걸쳐 애플리케이션 정의, 배포 구성 및 모니터링 설정을 관리하세요. 인프라 변경 중 일관성을 유지하세요.
모범 사례
구성 관리
경로 확인 문제를 피하기 위해 절대 경로를 사용하세요. 모든 디렉터리에 대한 읽기 권한을 확인하세요. 팀 일관성을 위해 표준화된 설정을 만드세요.
보안 고려 사항
디렉터리를 추가하기 전에 내용을 검토하세요. 민감한 정보와 프로덕션 자격 증명을 제외하세요. 전용 개발 디렉터리를 사용하세요.
성능 모니터링
광범위한 디렉터리 구조에서 메모리 사용량을 주시하세요. 로컬 디렉터리가 네트워크 마운트된 디렉터리보다 더 나은 성능을 제공합니다. 세션에서 사용하지 않는 디렉터리를 제거하세요.
고급 기능
명령줄 통합
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
대화형 명령어
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
팀 워크플로우
팀 전체에서 다중 디렉터리 구성을 표준화하세요. 일관된 개발자 경험을 위해 일반적인 패턴을 문서화하세요. 온보딩 프로세스와 통합하세요.
API 개발 워크플로우
다중 디렉터리 지원은 API 우선 개발을 향상시킵니다. 백엔드 서비스, 문서, 클라이언트 SDK 및 테스트 스위트는 종종 별도의 리포지토리에 존재하지만 동기화된 업데이트가 필요합니다.
Apidog는 다중 디렉터리 작업 공간 전반에서 작동하는 통합 테스트 인터페이스를 제공합니다. 이를 통해 여러 프로젝트에 걸쳐 기능을 개발할 때 API 일관성을 보장할 수 있습니다.
일반적인 문제 해결
경로 확인 문제
- 상대 경로 대신 절대 경로 사용
- 심볼릭 링크가 올바르게 작동하는지 확인
- 디렉터리 권한 확인
성능 문제
- 필요한 디렉터리로만 추가 제한
- 시스템 리소스 모니터링
- 장기 세션 중 사용하지 않는 디렉터리 제거
액세스 제어
- 적절한 읽기 권한 확인
- 민감한 데이터가 있는 디렉터리 추가 피하기
- 개발 전용 디렉터리 구조 사용
향후 개선 사항
커뮤니티는 영구적인 작업 공간 설정을 위한 구성 파일을 요청합니다. 이는 팀 전체의 표준화를 가능하게 하고 반복적인 설정 작업을 줄일 것입니다.
개발 플랫폼과의 통합 기회는 계속 확장되고 있습니다. API 개발 도구, 프로젝트 관리 시스템 및 협업 플랫폼은 향상된 작업 공간 기능을 활용할 수 있습니다.
결론
Claude Code 다중 디렉터리 지원은 현대 개발에서 워크플로우 마찰을 제거합니다. 모노레포, 마이크로서비스 및 교차 프로젝트 협업은 컨텍스트 전환 오버헤드 없이 원활하게 이루어집니다.
간단한 두 개의 디렉터리 구성으로 시작하여 프로젝트 요구 사항에 따라 확장하세요. 최소한의 학습 곡선은 프로젝트 복잡성이 증가함에 따라 상당한 생산성 향상을 제공합니다.
Apidog와 같은 포괄적인 API 테스트 도구와 결합된 다중 디렉터리 지원은 간소화된 엔드투엔드 개발 경험을 제공합니다. 최대의 이점을 얻으려면 특정 프로젝트 요구 사항에 맞는 구성을 실험해 보세요.
버튼