이 장에서 배우는 것 터미널이 무엇이고 왜 아직 쓰는지, 명령 한 줄을 읽는 법, 그리고 설치에서 막히는 사람의 대부분이 만나는
command not found의 정체.
터미널은 컴퓨터에 글자로 명령하는 창입니다. 마우스로 아이콘을 누르는 것과 하는 일은 같습니다. 방식만 다릅니다.
| 화면(GUI) | 터미널(CLI) | |
|---|---|---|
| 지시 | 누른다 | 적는다 |
| 배우기 | 쉬움 | 이름을 알아야 함 |
| 반복 | 매번 똑같이 눌러야 함 | 한 줄을 저장해 두면 끝 |
| 남기기 | 무엇을 했는지 안 남음 | 그대로 복사해 전달 가능 |
아직 쓰는 이유는 아래 두 줄입니다. 자동화와 재현 — 화면으로 한 일은 남에게 "거기서 그거 누르세요"라고 밖에 전할 수 없지만, 명령은 그대로 붙여넣으면 같은 일이 일어납니다. 이 매뉴얼이 설치 안내를 명령 한 줄로 주는 이유입니다.
| 운영체제 | 프로그램 |
|---|---|
| macOS | 터미널(Terminal) — Spotlight에서 "터미널" |
| Windows | PowerShell — 시작 메뉴에서 "PowerShell" |
| Linux | 터미널 |
열면 이런 줄이 깜빡입니다. 여기에 적으라는 뜻입니다.
~ 는 내 홈 폴더를 뜻하는 약자입니다. 즉 "지금 홈 폴더에 있다"는 표시입니다.
띄어쓰기가 구분자입니다. 그래서 폴더 이름에 공백이 있으면 따옴표로 묶어야 합니다 — 앞 장에서 "공백보다 하이픈"이라고 한 이유입니다.
이 매뉴얼을 읽는 데 필요한 것만 추리면 이렇습니다.
| 명령 | 하는 일 |
|---|---|
cd <폴더> | 그 폴더로 이동 |
ls (Windows dir) | 지금 폴더의 파일 목록 |
pwd | 지금 어느 폴더인지 |
<명령> --version | 설치됐는지 · 버전 확인 |
Ctrl-C | 지금 도는 것을 멈춤 |
Ctrl-C 는 명령이 아니라 키입니다. 무언가 계속 돌면서 안 끝날 때 빠져나오는
비상구라, 다섯 개 중 가장 자주 씁니다.
터미널에서 붙여넣기는
Ctrl-V가 아닐 수 있습니다. macOS는⌘V, Windows PowerShell은 마우스 오른쪽 버튼이나Ctrl-Shift-V입니다.
command not found — 설치에서 막히는 이유의 대부분이 한 줄이 준비물에서 가장 많이 나오는 실패입니다.
뜻은 "그런 명령을 찾지 못했다"입니다. 설치가 안 된 것과 못 찾는 것은 다릅니다. 터미널은 명령을 아무 데서나 찾지 않고, 미리 정해진 폴더 목록만 뒤집니다. 그 목록을 PATH 라고 합니다.
graph TD
A["claude 라고 입력"] --> B["PATH에 적힌 폴더들을 차례로 뒤짐"]
B -->|"찾음"| C["실행"]
B -->|"못 찾음"| D["command not found"]설치 프로그램은 대개 이 PATH를 고칩니다. 그런데 이미 열려 있던 터미널은 그 변경을 모릅니다 — 창을 열 때 읽은 목록을 그대로 쓰기 때문입니다.
터미널은 "정말 지울까요?"를 잘 묻지 않습니다. 인터넷에서 주워온 명령을 붙여넣기 전에 이 세 가지만 보세요.
무슨 일을 하는지 모르는 명령은 붙여넣기 전에 물어보세요. 에이전트에게 "이 명령이 무슨 일을 하는지 설명해줘"라고 먼저 시키는 것도 좋은 습관입니다.
보통 명령은 안전합니다. 위험한 것은 위의 세 가지처럼 지우거나 권한을 올리는 명령이고, 그건 화면에서도 똑같이 위험합니다. 차이는 확인 대화상자가 없다는 것뿐입니다.
아니요. 위의 다섯 개면 이 매뉴얼은 끝까지 읽힙니다. 나머지는 필요할 때 찾아 쓰는 것이고, 명령어 레퍼런스 같은 문서가 그래서 있습니다.
1. command not found 는 설치가 안 됐다는 뜻입니까?
꼭 그렇지는 않습니다. "찾지 못했다"는 뜻이고, 설치는 됐는데 PATH를 아직 못 읽은 경우가 대부분입니다. 새 터미널 창을 여는 것이 첫 조치입니다.
2. 도는 명령을 멈추는 키는?
Ctrl-C 입니다.
3. 폴더 이름에 공백이 있으면 왜 따옴표가 필요합니까?
터미널이 띄어쓰기로 명령과 인자를 나누기 때문입니다. 묶지 않으면 두 개의 인자로 읽힙니다.
다음은 그 명령들이 실행하는 것의 정체입니다 → 프로그램과 언어 — 파이썬 · 자바스크립트 · Node
jinho@macbook ~ %claude --version└──┬─┘ └───┬───┘ 명령 옵션node scripts/deck-pdf.mjs deck.pdf└─┬┘ └────────┬─────────┘ └──┬───┘ 명령 인자 인자cd "내 문서/작업 폴더"zsh: command not found: claude✓ 새 터미널 창을 연다 → 십중팔구 해결✓ 그래도 안 되면 재부팅✗ 같은 창에서 계속 다시 친다 → 몇 번을 쳐도 같습니다□ rm · del — 지웁니다. 휴지통을 거치지 않습니다□ sudo — 관리자 권한으로 실행합니다□ curl … | bash — 받아온 것을 바로 실행합니다 (공식 배포처인지 확인)