[Claude Code 스킬] 작업 디렉토리 관리(--add-dir·/cd) — AI에게 어떤 폴더를 보여줄지 정한다 | DAKER 커뮤니티

무엇

Claude Code는 기본적으로 실행한 그 폴더 하나만 읽고 편집한다. '작업 디렉토리 관리'는 이 경계를 넓히거나 옮기는 기능이다. 비유하면 책상 위에 펼친 서류철 — 기본은 한 권만 손이 닿지만, 옆 폴더를 끌어다 놓으면 그 안의 서류도 함께 다룰 수 있다. 폴더를 더하면 그 안의 파일이 '내 작업 범위'가 된다.

언제 쓰나

한 레포를 고치면서 옆에 있는 공유 라이브러리나 별도 설계 문서 폴더를 같이 봐야 할 때. 모노레포의 패키지 두 개를 동시에 손볼 때. 참고용 코드가 프로젝트 밖에 흩어져 있을 때. 추가한 폴더의 파일은 프롬프트 없이 읽히고, 원래 폴더와 똑같은 권한 규칙으로 편집된다.

사용법

넓히는 방법은 '지속성'에 따라 셋이고, 주 폴더 자체를 옮기는 /cd가 따로 있다.

# 1) 시작할 때 — 그 세션에만 적용 (CLI 플래그)
claude --add-dir ../shared-lib ../docs

# 2) 세션 도중 즉석 추가
/add-dir ../shared-lib

# 3) settings.json 에 영구 등록 — 모든 세션 자동 적용
{
  "permissions": {
    "additionalDirectories": ["../shared-lib", "~/notes"]
  }
}

# 4) 주 작업 폴더 자체를 이전 (v2.1.169+)
/cd packages/api

팁

1. '폴더 추가'와 '설정 켜기'는 다르다. --add-dir·/add-dir로 더한 폴더는 그 안의 Skills·Subagents·일부 플러그인 설정까지 불러온다(Skills는 실시간 반영). 반면 settings.json의 additionalDirectories로 등록한 폴더는 파일 접근만 주고 설정은 일절 읽지 않는다. CLAUDE.md는 --add-dir라도 환경변수 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1일 때만 로드된다.

2. /add-dir은 곁들이기, /cd는 이사. /add-dir은 현재 폴더를 그대로 두고 옆 폴더를 곁들이는 것이고, /cd는 세션의 중심을 통째로 옮긴다 — 새 폴더의 CLAUDE.md가 로드되고 --resume도 그 위치에서 세션을 찾는다.

출처

· Configure permissions — Working directories (Claude Code Docs)
· Settings — settings files & precedence
· Memory — CLAUDE.md 로딩 규칙