직접 코딩 0% — CLAUDE CODE로 진짜 서비스 만들고 배포·운영까지
3장. 실습 환경 구성
터미널과 uv 설치 — AI 작업실의 기초공사
3장 · 도입
터미널은 무서운 곳이 아닙니다
검은 화면에 글씨가 나온다고 해커가 되는 것이 아닙니다.
키보드로 컴퓨터에게 말을 거는 곳일 뿐입니다.
키보드로 컴퓨터에게 말을 거는 곳일 뿐입니다.
3장 · 학습 목표
오늘 할 일은 딱 세 가지
01
터미널 열기
컴퓨터가 명령을 기다리는 화면을 확인합니다.
02
폴더 다루기
만들고, 이동하고, 안을 확인합니다.
03
uv 설치
5장의 문서 자동화를 위한 실행 환경을 준비합니다.
3장 · 전체 흐름
AI 작업실을 만드는 전체 지도
터미널텅 빈 공방
→uv · Node.js전기 · 수도
→Claude CodeAI 작업자
지금 이름을 모두 외울 필요는 없습니다. 오늘은 터미널과 uv만 준비합니다.
3.1 · 안내서
왜 웹의 Claude만으로는 부족할까요?
웹의 Claude생각하고
생각하고
설명합니다
내 컴퓨터의 파일을 직접 설치·실행할 손발이 없습니다.
Claude Code내 컴퓨터에서
내 컴퓨터에서
직접 작업합니다
그러려면 먼저 작업할 환경을 준비해야 합니다.
3.1 · 핵심 메시지
공사가 끝나면, 당신은 감독자입니다
직접 망치질하는 작업자가 아니라
“이거 만들어”, “저렇게 고쳐”라고 지시하고 결과를 확인합니다.
“이거 만들어”, “저렇게 고쳐”라고 지시하고 결과를 확인합니다.
막히면 화면의 에러 메시지를 복사해 Claude 웹에게 해결을 요청하세요.
3.2 · 터미널
마우스로 하던 일을 키보드로 하는 곳
마우스
폴더 더블클릭
창을 열고 목록을 봅니다.
터미널
cd · ls
같은 일을 글자로 지시합니다.
이유는 하나 — Claude Code가 터미널에서 돌아가기 때문입니다.
3.2 · ACTIVITY
지금 바로 터미널을 열어봅시다
macOS
Spotlight Cmd + Space
→ “터미널” 검색 → Enter
user@Mac ~ % ▌
Windows
Win + R
→ powershell 입력 → Enter
PS C:\Users\user> ▌
$ · % · > 옆에 깜빡이는 커서가 보이면 성공입니다. 표시 문구가 달라도 괜찮습니다.
3.3 · 핵심 명령어
수백 개 중 딱 5가지
01ls
02cd
03mkdir
04복사·붙여넣기
05Ctrl+C
명령어 3개 + 조작 2개면 이 책을 끝까지 따라갈 수 있습니다.
3.3.1 · ls
① ls — 안에 뭐가 있는지 보기
PS C:\Users\user>ls
Documents Downloads Desktop
뜻
list
현재 폴더 안의 파일과 폴더 목록을 보여줍니다.
마우스로 치면
폴더 열기
탐색기나 Finder에서 목록을 보는 것과 같습니다.
PowerShell이 아닌 환경에서 ls가 안 되면 dir을 입력해 보세요.
3.3.2 · cd
② cd — 폴더 이동하기
폴더 안으로
cd Documents한 단계 위로
cd ..홈 폴더로
cd ~길을 잃었다면
cd ~cd는 폴더 더블클릭, cd ..은 뒤로 가기, cd ~는 집으로 가기입니다.
3.3.3 · mkdir
③ mkdir — 새 폴더 만들기
PS C:\Users\user>mkdir my-project
PS C:\Users\user>cd my-project
PS C:\Users\user\my-project>▌
앞으로 가장 많이 쓰는 조합 — “폴더를 만들고, 그 안으로 이동”
3.3.4–5 · 조작
④ 복사·붙여넣기 · ⑤ 비상 정지
긴 명령어
타이핑하지 말고 복사
Mac: Cmd+C / Cmd+V
Windows: Ctrl+C / Ctrl+V 또는 오른쪽 클릭
작업이 끝나지 않을 때
Ctrl+C로 중단
멈추지 않거나 메시지가 계속 나오면 실행 중인 작업을 멈춥니다.
Mac도 실행 중단은 Ctrl+C입니다. 복사는 Cmd, 중단은 Ctrl!
3.3 · ACTIVITY
5가지를 직접 실행해 봅시다
cd ~
mkdir my-project
cd my-project
ls
cd ..
① 한 줄씩 입력하고 Enter ② 프롬프트의 위치가 어떻게 바뀌는지 관찰 ③ 마지막에 cd ~로 홈으로 복귀
3.3 · 한 장 요약
터미널 기본 명령어 5가지
명령어·조작하는 일마우스로 치면
cd 폴더이름폴더 이동더블클릭
ls목록 보기폴더 열기
mkdir 이름폴더 만들기새 폴더
복사·붙여넣기명령 입력타이핑 대신 복붙
Ctrl+C실행 중단비상 정지
3.4 · uv 설치
uv — 5장에 켤 전기를 미리 준비합니다
지금 하는 일
파이썬 실행 환경 준비
Claude가 문서·엑셀·PDF 자동화 프로그램을 실행할 기반을 만듭니다.
실제로 쓰는 순간
5장 문서 자동화
4장의 Claude Code 실행 자체에는 uv가 없어도 문제없습니다.
깊이 이해할 필요 없이 — “5장을 위한 전기 공사”라고 기억하세요.
3.4 · uv 설치
내 운영체제의 명령어를 복사하세요
macOS · 터미널
curl -LsSf https://astral.sh/uv/install.sh | shWindows · PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"반드시 내 운영체제에 맞는 명령어 하나만 복사해 붙여 넣고 Enter를 누르세요.
3.4 · 설치 확인
터미널을 닫고 새로 연 뒤 확인
uv --versionPS C:\Users\user>uv --version
uv 0.x.x
버전 번호가 나오면 성공 — 숫자는 달라도 됩니다.
인식하지 못하면 터미널을 다시 열고, 그래도 안 되면 컴퓨터를 재시작합니다.
3.4 · 오류 대응
빨간 글씨가 나오면 AI를 설치 도우미로
“uv를 설치하는 중 아래 오류가 났어. 내 운영체제는 Windows/macOS야. 원인과 해결 절차를 한 단계씩 알려줘.”
[에러 메시지 전체 붙여넣기]
[에러 메시지 전체 붙여넣기]
하지 말 것
혼자 추측하며 반복
같은 명령을 무작정 여러 번 실행하지 않습니다.
할 것
메시지 그대로 복사
운영체제와 실행한 명령도 함께 알려줍니다.
3.5 · 체크리스트
3장 완료 — 4장으로 갈 준비
터미널을 열 수 있다
cd, ls, mkdir의 뜻을 안다
cd ~로 홈에 돌아갈 수 있다
mkdir로 폴더를 만들 수 있다
터미널에서 복사·붙여넣기 가능
Ctrl+C가 비상 정지임을 안다
Claude 계정이 준비되었다
uv --version에 버전이 나온다
모두 완벽하지 않아도 괜찮습니다. 터미널을 열고 cd와 ls를 이해했다면 다음 단계로 갈 수 있습니다.
3장 · 마무리
전기는 들어왔습니다.
이제 AI 작업자를 모셔올 차례입니다.
NEXT · 4장
Claude Code 설치와 첫 실행
Claude Code 설치와 첫 실행