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

FAQ · 자주 묻는 질문

폴더를 추가하면 Claude가 내 컴퓨터 전체를 보게 되는 건가요?

아닙니다. 클로드코드는 기본적으로 실행된 폴더와 그 하위 폴더만 볼 수 있고, /add-dir로는 내가 직접 지정한 폴더만 작업 범위에 더해집니다. 추가하지 않은 폴더는 여전히 손대지 못하니, 필요한 폴더만 골라서 열어주는 방식이라 안심해도 돼요.

경로를 어떻게 적어야 할지 모르겠어요. 쉬운 방법이 있나요?

윈도우 탐색기 주소창에서 폴더 경로를 복사해 붙여넣는 게 가장 실수가 적습니다. 바로 옆 폴더라면 /add-dir ../shared-lib처럼 상위 폴더를 뜻하는 ..을 쓰면 되고, C:\projects\shared-lib 같은 절대경로나 맥·리눅스의 ~(홈 폴더) 표기도 쓸 수 있어요.

껐다 켜니 추가했던 폴더가 사라졌어요. 왜 그런가요?

추가한 폴더는 지금 세션에서만 유지되기 때문입니다. 클로드코드를 껐다 켜면 작업 범위가 기본 상태로 돌아가므로, 다시 /add-dir로 추가해야 해요. 자주 같이 쓰는 폴더가 있다면 /add-dir ../apps ../lib처럼 띄어쓰기로 나란히 적어 한 번에 더하면 편합니다.

기준: Claude Code v2.1.154 (2026.05)