클로드코드 /add-dir로 작업 폴더 밖 파일까지 다루기

클로드코드(Claude Code)를 켜면 보통 한 폴더 안에서만 작업하게 돼요. 그런데 "옆 폴더에 있는 공용 코드도 같이 봐야 하는데" 싶을 때가 생깁니다. 그럴 때 폴더를 하나 더 끼워 넣어주는 명령이 /add-dir이에요.

정의 (뭐냐면)

/add-dir은 지금 켜진 세션(클로드코드를 실행 중인 한 번의 작업 단위)에서 추가로 읽고 쓸 폴더를 더해주는 명령이에요.

클로드코드는 기본적으로 자기가 실행된 폴더(작업 폴더)와 그 하위 폴더만 볼 수 있어요. 그래서 작업 폴더 밖에 있는 파일은 손대지 못합니다. /add-dir로 폴더를 추가하면, 그 폴더도 작업 범위 안으로 들어와서 Claude가 읽고 고칠 수 있게 돼요.

어떻게 쓰나 (난이도별)

기초 — 폴더 하나 추가하기

/add-dir ../shared-lib

../shared-lib은 "지금 폴더에서 한 단계 위로 올라가서(..) shared-lib 폴더"라는 뜻이에요. 여기서 ..은 상위 폴더(부모 폴더)를 가리키는 경로 표기입니다. 이렇게 치면 공유 라이브러리 폴더에 Claude가 접근할 수 있게 돼요.

응용 — 여러 폴더를 한 번에

/add-dir ../apps ../lib

폴더 경로를 띄어쓰기로 나란히 적으면 한 번에 여러 폴더를 더할 수 있어요. 앱 폴더와 라이브러리 폴더를 같이 봐야 할 때 편합니다.

윈도우(Windows)에서는 절대경로(드라이브부터 시작하는 전체 주소)를 쓸 수도 있어요. 예를 들어 C:\projects\shared-lib 같은 식이에요. 맥이나 리눅스라면 ~/projects/shared-lib처럼 ~(홈 폴더, 윈도우로 치면 C:\Users\내이름)를 씁니다.

흔한 함정

• 경로를 잘못 적으면 폴더를 못 찾아요. 명령을 치기 전에 그 폴더가 실제로 어디 있는지 확인해두세요. 윈도우 탐색기 주소창에서 폴더 경로를 복사해 쓰면 실수가 줄어요.
• 추가한 폴더는 지금 세션에서만 유지돼요. 클로드코드를 껐다 켜면 다시 추가해야 합니다.

실전 사례

메인 앱 폴더에서 작업하다가, 그 앱이 가져다 쓰는 공용 라이브러리 코드도 같이 고쳐야 하는 상황이 자주 생겨요. 이럴 때 클로드코드를 껐다가 라이브러리 폴더에서 다시 켤 필요 없이, /add-dir로 라이브러리 폴더만 추가하면 두 폴더를 한 세션에서 오갈 수 있어요.

이렇게 더 씁니다

폴더를 여러 개 더할 수 있다는 건, 여러 모듈에 걸친 작업도 한 세션에서 처리할 수 있다는 뜻이에요. 프론트엔드와 백엔드 폴더가 따로 있는 프로젝트라면, 두 폴더를 모두 추가해두고 "프론트에서 보낸 데이터를 백엔드가 어떻게 받는지" 같은 작업을 끊김 없이 시킬 수 있어요.

정리

/add-dir은 작업 폴더 밖에 있는 폴더를 지금 세션 작업 범위에 더해주는 명령이에요. 공유 라이브러리, 다른 모듈처럼 한 폴더에 담기지 않는 코드를 같이 다룰 때 쓰면 됩니다.

기준: Claude Code v2.1.154 (2026.05)