3장은 대화 프롬프트 대신 터미널 명령어 중심의 장입니다. 어두운 상자는 터미널에 입력하는 명령어, 밝은 상자는 Claude 웹에 붙여 넣는 도움 요청 프롬프트입니다.
3.2 터미널이란 무엇인가 — 키보드로 컴퓨터와 대화하기 터미널 열기
macOS — Spotlight 검색으로 열기
Cmd + Space → "터미널" 입력 → Enter
Windows — 실행 창으로 PowerShell 열기
Win + R → powershell 입력 → Enter
※ $ 또는 % (Mac), PS C:\Users\user> (Windows) 옆에 깜빡이는 커서가 보이면 성공입니다. 보안 정책 안내가 뜨면 그냥 Enter. 지금은 열기만 하면 됩니다.
3.3.1 ls — 안에 뭐 있는지 보기 핵심 명령어 ①
ls
※ "list"의 줄임말 — 지금 있는 폴더 안의 목록을 보여줍니다. 안내대로 연 PowerShell에서는 ls가 정상 작동하며, 다른 환경에서 안 되면 dir을 입력해 보세요(같은 결과).
3.3.2 cd — 폴더 이동하기 핵심 명령어 ②
기본 사용 — Documents 폴더로 이동해 목록 보기
cd Documents
ls
요긴한 cd 명령어들
cd my_directory ← "my_directory" 폴더로 이동
cd .. ← 한 칸 위 폴더로 (뒤로 가기)
cd ~ ← 홈 폴더로 바로 (집으로 가기)
cd Documents ← 문서 폴더로 (화면엔 "문서", 실제 이름은 영문 Documents)
※ 길을 잃었다면 cd ~ — 어디에 있든 홈 폴더로 돌아옵니다. ('~'는 틸드/물결표 기호)
3.3.3 mkdir — 폴더 만들기 핵심 명령어 ③
앞으로 가장 많이 쓰게 될 조합 — 폴더 만들고, 그 안으로 이동
mkdir my-project
cd my-project
※ "make directory"의 줄임말 — 마우스 오른쪽 클릭 → "새 폴더"와 같습니다. 새 프로젝트를 시작할 때마다 이 두 줄로 시작합니다.
3.3.4~5 복사/붙여넣기 · Ctrl+C 핵심 조작 ④ ⑤
운영체제별 복사·붙여넣기
Mac : 복사 Cmd + C / 붙여넣기 Cmd + V
Windows : 복사 Ctrl + C / 터미널에서는 Ctrl + V 또는 마우스 오른쪽 클릭
비상 정지 — 뭔가 잘못되면 이것만
Ctrl + C
※ 끝나지 않고 계속 돌거나 화면이 멈춘 것 같을 때 실행 중인 작업을 강제 중단합니다. Mac에서도 중단은 Ctrl+C입니다(Cmd+C 아님) — 중단은 Ctrl, 복사는 Cmd. 저장·설치 도중 누르면 덜 끝난 상태가 남을 수 있으니 중단 후 상태를 다시 확인하세요.
※ uv 공식 사이트(astral.sh) 제공 명령어입니다. 상세 설명은 github.com/astral-sh/uv 의 "Installation" 항목.
설치 확인 — 반드시 터미널을 닫고 새로 연 뒤
uv --version
※ '-'가 두 개입니다. 버전 번호가 나오면 성공(숫자는 달라도 됨). 안 되면 컴퓨터를 한 번 재시작해 보세요. 터미널이 새 프로그램을 인식하려면 재시작이 필요합니다.
3.1 · 3.4 막혔을 때 — Claude 웹에게 도움 요청 문제 해결 프롬프트
설치 중 빨간 글씨·에러가 나오면 (에러 메시지를 그대로 복사해서 붙여넣기)
이 에러가 났어. 어떻게 해결해?
(터미널에 나타난 에러 메시지 전체를 여기에 붙여넣기)
이 에러 해결해줘.
(문제가 나타난 화면의 내용을 여기에 붙여넣기)
※ 설치 도우미로 AI를 쓰는 것 — 이 책이 가르치는 방식이며, 설치 단계에도 똑같이 통합니다. 자주 막히는 곳과 해결 문장은 부록 A에 정리되어 있습니다.
3.5 [체크리스트] Claude Code를 시작하기 위한 확인 사항 완료 점검
✅ 3장 완료 체크리스트
☐ 터미널을 열 수 있다
☐ cd, ls, mkdir이 뭘 하는 건지 안다
☐ cd ~를 치면 홈 폴더로 돌아간다
☐ mkdir my-project로 폴더를 만들 수 있다
☐ 터미널에서 복사·붙여넣기를 할 수 있다
☐ Ctrl+C가 "비상 정지"라는 걸 안다
☐ claude.ai에 가입했다 (1장에서 완료)
☐ uv --version을 치면 버전 번호가 나온다
※ 안 되는 항목이 있어도 괜찮습니다. 터미널을 열 수 있고 cd와 ls의 의미를 알면 4장으로 넘어가기에 충분합니다.