프로젝트 폴더에서 클로드 코드 cd 명령어 사용법

프로젝트 폴더에서 Claude Code 사용하는 법
cd 명령어 완전 초보자 가이드 (2026 최신)

Claude Code를 설치했는데
막상 실행하려니 이런 생각부터 듭니다.

“어디서 실행해야 하지?”
“왜 내 프로젝트를 못 읽는 거지?”

이 문제의 90%는
cd 명령어를 정확히 이해하지 못해서 생깁니다.

이 글은 터미널이 처음인 분도
프로젝트 폴더에서 Claude Code를 제대로 쓰게 만드는
cd 명령어 실전 가이드입니다.

---

📌 목차 (누르면 이동)

• 1. Claude Code와 폴더 위치의 관계
• 2. cd 명령어가 왜 중요한가
• 3. 기본 cd 명령어 완전 이해
• 4. 프로젝트 폴더로 이동하는 실전 예제
• 5. Claude Code는 어디서 실행해야 하나
• 6. 초보자가 가장 많이 틀리는 실수

---

1️⃣ Claude Code와 폴더 위치의 관계

Claude Code는
현재 위치한 폴더를 기준으로 작동합니다.

즉,
터미널에서 서 있는 위치가
Claude가 읽는 프로젝트 범위입니다.

예를 들어 홈 폴더에서 실행하면
Claude는 홈 폴더만 봅니다.

프로젝트 폴더에서 실행해야만
해당 코드와 파일 구조를 이해합니다.

그래서 cd 명령어는
Claude Code 사용의 출발점입니다.

---

2️⃣ cd 명령어가 왜 중요한가

cd는 Change Directory의 약자입니다.

쉽게 말해
“폴더 이동” 버튼입니다.

Claude Code는
“지금 내가 서 있는 폴더 안의 모든 것”을
프로젝트로 인식합니다.

그래서 cd를 잘못 쓰면
Claude가 엉뚱한 폴더를 분석하게 됩니다.

---

3️⃣ 기본 cd 명령어 완전 이해

가장 기본 형태는 이렇습니다.

cd 폴더이름

한 단계 위로 이동

cd ..

홈 폴더로 바로 이동

cd ~

현재 위치 확인

pwd

이 네 가지만 알아도
터미널의 절반은 이해한 겁니다.

---

4️⃣ 프로젝트 폴더로 이동하는 실전 예제

예를 들어 이런 구조라고 가정해봅시다.

/Users/username/projects/my-app

터미널을 열었을 때
홈 폴더라면 이렇게 이동합니다.

cd projects/my-app

또는 전체 경로 사용

cd /Users/username/projects/my-app

이 상태에서 pwd를 입력하면
내가 정확한 프로젝트 안에 있는지
확인할 수 있습니다.

---

5️⃣ Claude Code는 어디서 실행해야 하나

정답은 하나입니다.

프로젝트의 최상위(root) 폴더

package.json, src 폴더,
README가 있는 위치가 보통 기준입니다.

그 상태에서 실행

claude

이렇게 하면 Claude Code는
해당 프로젝트 전체를 이해한 상태로 시작합니다.

🤖 Anthropic 공식 홈페이지

---

6️⃣ 초보자가 가장 많이 틀리는 실수

실제 가장 흔한 실수입니다.

❌ 홈 폴더에서 바로 실행
→ 프로젝트를 못 찾음

❌ src 폴더 안에서 실행
→ 전체 구조 파악 실패

❌ cd 했는지 안 했는지 모름
→ pwd로 항상 확인 필요

이 세 가지만 피하면
Claude Code 활용도가 완전히 달라집니다.

---

마무리 정리

Claude Code는 똑똑하지만
어디에 서 있는지는 알려줘야 합니다.

cd → 프로젝트 폴더 이동 → claude 실행

이 흐름만 습관이 되면
Claude Code는 진짜 팀원이 됩니다.

다음 글에서는
Claude Code에게 프로젝트 설명시키는 법
폴더 구조 질문 프롬프트
VSCode와 함께 쓰는 루틴을
정리해 드리겠습니다.