결론부터 말하면 Claude Code를 켜는 데 필요한 터미널 명령어는 6개뿐이에요. pwd, ls, cd, mkdir, cat, clear. 이 여섯 개와 “경로”라는 개념 하나만 잡으면 검은 화면 앞에서 손이 멈추는 일은 없어요.
터미널을 처음 열면 커서만 깜빡이는 화면이 나와요. 뭘 쳐야 할지 모르니까 그냥 창을 닫게 되죠. 그런데 막상 뜯어보면 터미널은 폴더를 열고 파일을 확인하는 탐색기의 글자 버전에 가까워요. 마우스로 하던 걸 키보드로 할 뿐이에요.
명령어 사전을 통째로 외울 필요는 없어요. 오히려 초보가 가장 많이 막히는 지점은 명령어를 몰라서가 아니라, 내가 지금 어느 폴더에 서 있는지 몰라서 생기는 문제예요. 이 글은 그 관문만 골라서 정리했어요.
- 터미널 기초, Claude Code를 켜기 위한 최소한의 관문
- 터미널·셸·CLI, 헷갈리는 세 단어부터 정리
- 맥·윈도우·리눅스에서 터미널 여는 법
- 명령어는 다 같은 문법이다: 명령어 + 옵션 + 인자
- 경로를 모르면 엉뚱한 폴더에서 작업하게 된다
- Claude Code 시작에 필요한 명령어 6개만
- 오류 메시지 3종 해석법
- 터미널이 갑자기 빨라지는 습관 4가지
- 여기까지 익혔다면 다음 단계
- 자주 묻는 질문
- 참고자료
터미널 기초, Claude Code를 켜기 위한 최소한의 관문
📌 핵심 요약
Claude Code를 시작하려면 터미널 명령어 6개(pwd·ls·cd·mkdir·cat·clear)와 절대경로·상대경로 개념 하나면 충분해요. 나머지는 필요할 때 찾아 써도 늦지 않아요.
터미널을 배워야 하는 이유는 단순해요. Claude Code, Cursor, Codex, Gemini CLI 같은 AI 코딩 도구 상당수가 터미널에서 실행되는 CLI 프로그램이거든요. 설치도 터미널, 실행도 터미널, 업데이트도 터미널이에요. 아이콘을 더블클릭하는 창구가 아예 없는 경우가 많아요.
그래서 “코딩을 배우기 전에 터미널부터”라는 말이 나오는 거예요. 정확히는 코딩을 배우려는 게 아니라, AI에게 일을 시킬 작업실 문을 여는 열쇠를 만드는 셈이에요.
다행히 이 열쇠는 생각보다 작아요. 리눅스 명령어를 전부 다루는 책은 500페이지가 넘지만, AI 코딩 도구를 굴리기 위해 실제로 매일 치는 명령어는 손가락으로 셀 정도예요. 나머지 명령어는 대부분 Claude Code가 대신 실행해주기 때문에, 사람이 할 일은 올바른 폴더에서 도구를 켜는 것과 화면에 뜬 오류를 읽는 것 두 가지로 좁혀져요.
이 글은 그 두 가지 기준으로만 내용을 추렸어요. 명령어 사전식 나열은 일부러 뺐고, 대신 초보가 가장 많이 삽질하는 “경로” 문제와 오류 메시지 해석에 분량을 몰았어요.
터미널·셸·CLI, 헷갈리는 세 단어부터 정리
검색을 시작하면 터미널, 셸, CLI, 배쉬, zsh, 커맨드라인, 명령 프롬프트가 뒤섞여 나와요. 이 단어들이 같은 말인지 다른 말인지부터 헷갈려서 진도가 안 나가요. 관계를 한 번만 정리하면 끝나요.
터미널은 글자를 입력하고 결과를 보여주는 창이에요. 맥의 Terminal 앱, 윈도우의 Windows Terminal이 여기에 해당해요. 창 자체는 명령어를 이해하지 못해요. 그냥 입력을 받아 전달하고 출력을 그려주는 역할이에요.
셸(shell)은 그 입력을 해석해서 실제로 실행하는 프로그램이에요. bash, zsh, PowerShell이 셸이에요. 우리가 ls를 쳤을 때 “아, 파일 목록을 보여달라는 뜻이구나” 하고 알아듣는 쪽이 셸이에요. 맥은 요즘 기본 셸이 zsh이고, 리눅스는 배포판에 따라 bash가 많아요.
CLI(Command Line Interface)는 이런 방식 전체를 부르는 이름이에요. 마우스로 아이콘을 클릭하는 GUI의 반대말이에요. 그러니까 “터미널 창을 열어서, 셸에게, CLI 방식으로 명령한다”가 정확한 문장이에요.
💡 꼭 알아두세요
이 구분이 필요한 순간은 오류가 났을 때예요. 설치 안내문에 “~/.zshrc 파일에 추가하세요”라고 쓰여 있는데 내 셸이 bash라면 그 설정은 적용되지 않아요. 지금 쓰는 셸이 궁금하면 터미널에 echo $SHELL 을 치면 경로가 나와요.
왜 굳이 이 창을 쓰냐고 물으면, 답은 재현성이에요. 마우스로 한 작업은 말로 설명하기 어렵지만, 명령어는 그대로 복사해서 남에게 건네줄 수 있어요. AI에게 상황을 설명할 때도 마찬가지예요. 터미널에 뜬 문장을 그대로 Claude Code에 붙여넣으면 그게 가장 정확한 상황 설명이 돼요.
맥·윈도우·리눅스에서 터미널 여는 법
운영체제마다 여는 방법이 달라요. 특히 윈도우는 선택지가 여러 개라서 여기서 첫 번째 갈림길이 생겨요.
| 환경 | 여는 방법 | 기본 셸 / 특징 |
|---|---|---|
| macOS | Command+Space → terminal 입력 → 엔터 | zsh. 유닉스 계열이라 리눅스 명령어가 거의 그대로 통해요 |
| Windows (PowerShell) | 시작 → terminal 또는 powershell 검색 | PowerShell. cd·ls는 되지만 touch 같은 일부 명령은 달라요 |
| Windows (WSL) | PowerShell에서 wsl –install 후 재부팅, 이후 Ubuntu 실행 | bash. 리눅스 환경 그대로. 개발 도구 설치 안내문과 가장 잘 맞아요 |
| Windows (cmd) | 시작 → cmd | 구식 명령 프롬프트. 개발 입문 용도로는 권하지 않아요 |
| Linux | Ctrl+Alt+T | bash 또는 zsh. 배포판마다 조금씩 달라요 |
윈도우 사용자라면 WSL을 권해요. 이유는 명확해요. 개발 도구 공식 문서와 인터넷에 널린 해결책 대부분이 유닉스 계열 명령어를 기준으로 쓰여 있거든요. cmd나 PowerShell에서 그 명령어를 그대로 치면 안 먹히는 경우가 생기고, 그때부터 “내가 뭘 잘못했나” 하며 시간을 버려요.
WSL 설치는 관리자 권한 PowerShell에서 wsl --install 한 줄이면 시작되지만, 윈도우 버전과 가상화 설정에 따라 추가 단계가 필요할 수 있어요. 설치 중 막히면 마이크로소프트 공식 문서의 안내를 그대로 따라가는 게 제일 빨라요.
맥이라면 고민할 게 없어요. 기본 터미널로 충분하고, 나중에 iTerm2 같은 대체 앱으로 옮겨도 명령어는 똑같아요.
명령어는 다 같은 문법이다: 명령어 + 옵션 + 인자
명령어를 하나씩 외우려고 하면 끝이 없어요. 그런데 터미널 명령어는 거의 전부 같은 구조를 따라요. 이 구조 하나만 알면 처음 보는 명령어도 대충 읽혀요.
구조는 이래요. 명령어 [옵션] [인자]. 예를 들어 ls -la Documents를 뜯어보면 이렇게 나뉘어요.
ls— 명령어. “목록을 보여줘”라는 동사예요.-la— 옵션. “어떻게” 보여줄지를 정해요. l은 자세히(long), a는 숨김 파일까지(all)예요.Documents— 인자. “무엇을” 대상으로 할지예요. 생략하면 현재 폴더가 대상이 돼요.
옵션 앞의 하이픈 개수도 규칙이 있어요. 하이픈 하나는 짧은 이름(-a), 두 개는 긴 이름(--all)이에요. 짧은 옵션은 -l -a처럼 따로 써도 되고 -la로 붙여 써도 같아요. 긴 옵션은 붙여 쓸 수 없어요.
⚠️ 주의사항
띄어쓰기가 문법이에요. 명령어와 옵션, 인자는 반드시 공백으로 구분해요. 그래서 폴더 이름에 공백이 들어가면 문제가 생겨요. “내 프로젝트” 같은 폴더는 두 개의 인자로 인식돼요. 이럴 땐 cd “내 프로젝트” 처럼 따옴표로 감싸거나, 애초에 폴더 이름을 my-project 같은 영문 하이픈 형태로 만드는 게 안전해요.
한글 폴더명도 동작은 하지만, 개발 도구가 경로를 처리하다가 깨지는 경우가 종종 있어요. 작업 폴더만큼은 영문 소문자에 하이픈이나 밑줄 조합으로 만드는 습관을 들이면 나중에 겪을 문제 하나를 미리 지우는 셈이에요.
경로를 모르면 엉뚱한 폴더에서 작업하게 된다
초보가 가장 크게 시간을 버리는 지점이 여기예요. 명령어를 몰라서가 아니라, 지금 내가 어느 위치에 서 있는지 몰라서 생기는 문제예요.
터미널은 항상 “현재 위치”를 하나 갖고 있어요. 파일 탐색기에서 열어둔 폴더 창이라고 생각하면 돼요. 명령어를 치면 그 위치를 기준으로 동작해요. 위치를 확인하지 않고 mkdir blog를 치면, 내가 원했던 곳이 아니라 지금 서 있는 아무 곳에나 폴더가 생겨요.
실제로 가장 흔한 실패 사례가 이거예요. 홈 폴더에서 Claude Code를 실행해놓고 “내 프로젝트 파일을 수정해줘”라고 요청하는 경우예요. AI는 현재 폴더 기준으로 파일을 찾기 때문에, 엉뚱한 위치에 새 파일을 만들거나 파일을 못 찾겠다고 답해요. 사람은 “AI가 이상하다”고 생각하지만 원인은 경로예요.
경로에는 두 종류가 있어요.
- 절대경로: 최상위부터 다 적은 전체 주소예요.
/Users/kim/projects/blog처럼 슬래시로 시작해요. 지금 어디에 있든 결과가 같아요. - 상대경로: 현재 위치에서 출발하는 주소예요.
projects/blog처럼 슬래시 없이 시작해요. 현재 위치가 바뀌면 결과도 바뀌어요.
여기에 기호 네 개가 붙어요. 이것만 알면 이동은 자유로워져요.
| 기호 | 의미 | 사용 예 |
|---|---|---|
| . | 현재 폴더 | claude . (현재 폴더에서 실행) |
| .. | 상위 폴더 | cd .. (한 단계 위로) |
| ~ | 내 홈 폴더 | cd ~ (어디서든 집으로) |
| / | 최상위 루트 | 경로 구분자로도 쓰여요 |
경로 삽질을 막는 가장 확실한 습관은 간단해요. 새 명령을 치기 전에 pwd 한 번이에요. 특히 AI 코딩 도구를 실행하기 직전에는 반드시 확인하세요. 프롬프트에 폴더명이 표시되는 설정이라도, 하위 폴더 이름만 나오는 경우가 많아서 전체 경로는 pwd로 봐야 정확해요.
💡 꼭 알아두세요
경로를 손으로 타이핑할 필요가 없어요. 터미널에 cd 를 치고 한 칸 띄운 다음, 파일 탐색기나 파인더에서 폴더를 터미널 창으로 끌어다 놓으면 전체 경로가 자동으로 입력돼요. 맥·윈도우 터미널 모두 동작해요. 오타로 인한 경로 오류를 거의 없앨 수 있는 방법이에요.
Claude Code 시작에 필요한 명령어 6개만
이제 실제로 손을 움직여볼 차례예요. 아래 순서대로 따라 치면 작업 폴더 하나가 만들어지고, 그 안에서 AI 코딩 도구를 켤 준비가 끝나요.
pwd — 지금 어디인지 확인
터미널을 열자마자 pwd 를 쳐보세요. /Users/이름 또는 /home/이름 같은 경로가 나와요. 이게 홈 폴더예요. 모든 이동의 출발점이에요.
ls — 여기에 뭐가 있는지 보기
ls 를 치면 현재 폴더의 파일과 폴더 이름이 나열돼요. ls -la 로 치면 크기·수정일과 점(.)으로 시작하는 숨김 파일까지 보여요. 설정 파일은 대부분 숨김이라 -a 옵션이 필요해요.
mkdir — 작업 폴더 만들기
mkdir my-first-site 라고 치면 현재 위치에 폴더가 생겨요. 영문 소문자와 하이픈 조합을 권해요. ls 로 잘 만들어졌는지 바로 확인하세요.
cd — 그 폴더 안으로 들어가기
cd my-first-site 로 이동하고, 다시 pwd 로 위치를 확인해요. 경로 끝에 폴더 이름이 붙었으면 성공이에요. 나올 때는 cd .. 이에요.
cat — 파일 내용 확인하기
cat index.html 처럼 쓰면 파일 내용이 화면에 그대로 출력돼요. AI가 만든 파일이 제대로 들어갔는지 창을 열지 않고 바로 확인할 때 씁니다. 내용이 길면 화면이 넘치니 그럴 땐 less 파일명 을 쓰고 q로 빠져나와요.
clear — 화면 정리하기
출력이 쌓여 지저분해지면 clear 로 화면을 비워요. 단축키 Ctrl+L도 같은 동작이에요. 기록이 지워지는 게 아니라 화면만 정리되는 거라 안심해도 돼요.
여기까지가 실습이에요. 이 여섯 개 흐름이 손에 익으면, 어떤 AI 코딩 도구든 “작업 폴더로 이동해서 실행”이라는 안내문을 막힘없이 따라갈 수 있어요.
여유가 생기면 아래 명령어를 추가로 익히면 돼요. 당장 외울 필요는 없고, 필요해질 때 이 표로 돌아오면 충분해요.
| 명령어 | 하는 일 | 주의점 |
|---|---|---|
| touch 파일명 | 빈 파일 생성 | PowerShell에선 동작이 달라요 |
| cp 원본 대상 | 파일 복사 | 폴더 통째로는 cp -r |
| mv 원본 대상 | 이동 또는 이름 변경 | 같은 이름 파일을 덮어써요 |
| rm 파일명 | 파일 삭제 | 휴지통 없이 바로 사라져요 |
| echo 내용 | 화면에 값 출력 | 환경변수 확인에 자주 써요 |
| grep 단어 파일 | 파일 안에서 단어 찾기 | 대소문자 무시는 -i |
⚠️ 주의사항
rm 은 되돌릴 수 없어요. 특히 rm -rf 는 폴더와 그 안의 모든 것을 확인 없이 지우는 명령이라, 인터넷에서 본 명령어를 뜻도 모른 채 붙여넣는 일은 피해야 해요. 지우기 전에 ls 로 대상을 먼저 확인하는 습관이 안전장치가 돼요.
오류 메시지 3종 해석법
터미널이 무섭게 느껴지는 진짜 이유는 영어 오류 메시지예요. 그런데 초반에 만나는 오류는 사실상 세 종류로 수렴해요. 이 셋만 읽을 줄 알면 대부분의 상황을 스스로 넘길 수 있어요.
1. command not found — “그런 명령어를 모르겠다”는 뜻이에요. 원인은 셋 중 하나예요. 오타를 냈거나, 프로그램이 설치되지 않았거나, 설치는 됐는데 컴퓨터가 그 위치를 못 찾는 경우예요. 마지막이 PATH 문제인데, 설치 직후 자주 생겨요. 이럴 땐 터미널 창을 완전히 껐다 다시 여는 것만으로 해결되는 경우가 많아요. 설정 파일이 새 창에서만 다시 읽히기 때문이에요.
2. No such file or directory — “그 파일이나 폴더가 여기 없다”는 뜻이에요. 대부분 파일이 사라진 게 아니라 내가 다른 폴더에 서 있는 거예요. pwd로 위치를 확인하고 ls로 목록을 보면 십중팔구 원인이 보여요. 대소문자 구분도 흔한 원인이에요. 맥과 리눅스에서 Documents와 documents는 다른 이름이에요.
3. Permission denied — “권한이 없다”는 뜻이에요. 시스템 폴더를 건드리려 했거나, 실행 권한이 없는 파일을 실행하려 했을 때 나와요. 관리자 권한이 필요하면 명령어 앞에 sudo를 붙이고 로그인 비밀번호를 입력해요. 비밀번호는 타이핑해도 화면에 아무것도 안 보이는데, 고장이 아니라 원래 그렇게 설계된 거예요.
💡 꼭 알아두세요
sudo는 만능 해결책이 아니에요. 권한 오류가 났다고 무조건 sudo를 붙이면, 내 홈 폴더 안 파일이 관리자 소유로 바뀌어 나중에 더 꼬이는 일이 생겨요. 내 작업 폴더에서 권한 오류가 났다면 sudo보다 먼저 경로가 맞는지, 그 파일을 다른 프로그램이 쓰고 있지는 않은지 확인하는 게 순서예요.
세 가지 모두 해당되지 않는 낯선 오류라면, 메시지 전체를 그대로 복사해서 Claude Code나 검색창에 붙여넣으세요. 앞부분만 요약해서 옮기면 정작 원인이 담긴 뒷문장이 빠져서 엉뚱한 답이 돌아와요. 오류 메시지는 요약하지 말고 통째로 넘기는 게 원칙이에요.
터미널이 갑자기 빨라지는 습관 4가지
명령어를 알아도 타이핑이 느리면 터미널이 계속 불편하게 느껴져요. 아래 네 가지는 처음 30분만 의식해서 쓰면 그 뒤로는 자동으로 손이 가요.
- Tab 자동완성 — 파일이나 폴더 이름을 두세 글자만 치고 Tab을 누르면 나머지가 채워져요. 오타로 인한 오류를 가장 많이 줄여주는 기능이에요. 후보가 여러 개면 Tab을 두 번 눌러 목록을 볼 수 있어요.
- 방향키 위아래 — 이전에 친 명령어가 순서대로 불려와요. 긴 명령어를 다시 칠 필요가 없어요. 과거 기록 전체를 보려면 history 를 쓰면 돼요.
- Ctrl+C — 실행 중인 명령을 중단해요. 뭔가 멈춘 것 같고 커서가 안 돌아올 때 누르는 탈출 버튼이에요. 창을 닫을 필요가 없어요.
- Ctrl+L — 화면을 즉시 정리해요. clear 명령보다 빨라요.
여기에 하나 더, 스스로 배우는 방법도 알아두면 좋아요. 명령어 뒤에 --help를 붙이면 사용법 요약이 나와요. 맥·리눅스에서는 man ls 처럼 man을 쓰면 더 자세한 설명서가 열려요. 방향키로 읽고 q를 누르면 나와요. 옵션이 기억나지 않을 때 검색창을 여는 대신 이걸 쓰는 습관이 실력 차이를 만들어요.
여기까지 익혔다면 다음 단계
기본 명령어와 경로 개념이 손에 붙었다면, 이제 확장 방향은 세 갈래예요. 순서대로 가는 게 부담이 적어요.
첫째는 깃(Git)이에요. AI가 코드를 고쳤는데 이전 상태로 돌리고 싶을 때 필요해요. git init, git add, git commit 세 개만 알아도 되돌리기 안전망이 생겨요. 바이브코딩에서 이 안전망은 생각보다 빨리 필요해져요.
둘째는 패키지 설치 명령이에요. npm이나 brew 같은 도구로 프로그램을 설치하게 되는데, 이때 앞서 익힌 오류 메시지 해석이 그대로 쓰여요. 설치 실패의 상당수가 권한과 PATH 문제거든요.
셋째는 환경변수와 PATH예요. “명령어를 분명 설치했는데 command not found가 뜬다”의 근본 원인이 여기예요. echo $PATH 로 목록을 확인하고, 설정 파일에 경로를 추가하는 방법까지 익히면 설치 문제 대부분을 스스로 풀 수 있어요.
📋 점검 체크리스트
✓ mkdir로 작업 폴더를 만들고 cd로 그 안에 들어갈 수 있다
✓ 절대경로와 상대경로의 차이를 설명할 수 있다
✓ command not found와 No such file 오류의 원인을 구분한다
✓ Tab 자동완성과 Ctrl+C를 손이 기억한다
✓ AI 코딩 도구를 실행하기 전에 위치부터 확인한다
자주 묻는 질문
터미널과 셸은 정확히 뭐가 다른가요?
터미널은 글자를 주고받는 창이고, 셸은 그 글자를 해석해 실행하는 프로그램이에요. 맥의 Terminal 앱이 터미널, 그 안에서 돌아가는 zsh가 셸이에요. 설치 안내문에 나오는 .zshrc, .bashrc 같은 파일은 셸 설정 파일이라, 내가 쓰는 셸이 무엇인지 알아야 올바른 파일을 고칠 수 있어요.
초보자가 꼭 알아야 할 명령어는 몇 개인가요?
AI 코딩 도구를 시작하는 목적이라면 여섯 개면 돼요. pwd(위치 확인), ls(목록 보기), cd(이동), mkdir(폴더 생성), cat(내용 확인), clear(화면 정리)예요. cp·mv·rm·grep은 필요해질 때 찾아 써도 늦지 않아요.
맥북 터미널 명령어는 리눅스와 같나요?
대부분 같아요. 둘 다 유닉스 계열이라 ls, cd, pwd, mkdir 같은 기본 명령은 그대로 통해요. 다만 패키지 설치 도구가 달라서(맥은 brew, 우분투는 apt) 설치 관련 명령은 갈라져요. 윈도우 PowerShell은 계열이 달라 일부 명령이 다르게 동작하니, 개발 입문이라면 WSL을 쓰는 편이 혼란이 적어요.
명령어를 잘못 쳐서 컴퓨터가 망가지지는 않나요?
기본 조회 명령어(pwd, ls, cd, cat)는 읽기만 하기 때문에 안전해요. 주의가 필요한 건 삭제(rm)와 관리자 권한(sudo)이 붙은 명령이에요. 특히 뜻을 모르는 명령어를 인터넷에서 복사해 붙여넣는 습관이 가장 위험해요. 낯선 명령어는 실행 전에 –help로 무슨 일을 하는지 확인하는 게 좋아요.
터미널을 켜면 Claude Code가 바로 실행되나요?
아니에요. 터미널은 창일 뿐이고, 도구는 따로 설치해야 해요. 다만 설치와 실행 모두 터미널에서 이뤄지기 때문에, 이 글의 명령어와 경로 개념이 먼저 잡혀 있어야 설치 안내문을 따라갈 수 있어요. 설치 방법과 요구 환경은 버전에 따라 바뀌니 공식 문서를 기준으로 확인하는 게 정확해요.
참고자료
- Apple 터미널 사용 설명서 — 맥 터미널 실행법과 기본 조작을 애플이 직접 제공하는 공식 안내서예요.
- Microsoft WSL 설치 문서 — 윈도우에서 리눅스 환경을 설치하는 공식 절차와 문제 해결 안내가 있어요.
- GNU Bash 매뉴얼 — 셸 문법과 명령어 구조의 원문 설명서예요.
- Anthropic 공식 문서 — Claude Code의 최신 설치 요건과 실행 방법을 확인할 수 있어요.
터미널이 어려웠던 건 명령어가 많아서가 아니라, 내가 어디에 서 있는지 알려주는 기준이 없어서였어요. pwd로 위치를 확인하고, cd로 이동하고, ls로 확인하는 이 짧은 순환만 몸에 붙으면 검은 화면은 그냥 폴더를 여는 또 하나의 방법이 돼요.
오류 메시지도 마찬가지예요. command not found, No such file or directory, Permission denied 세 문장의 뜻만 알면 대부분의 상황에서 다음 행동을 스스로 정할 수 있어요. 나머지는 메시지를 통째로 복사해 AI에게 넘기면 돼요.
다음 순서를 권합니다. 오늘은 작업 폴더 하나를 mkdir로 만들고 cd로 들어가 pwd까지 확인해보세요. 그다음 Claude Code 설치 안내문을 열면, 어제까지 외계어처럼 보이던 문장들이 읽히기 시작할 거예요. 그 지점부터 바이브코딩이 실제로 시작돼요.
함께 보면 좋은 글
