이 장에서 배우는 것
•
터미널이 무엇이고, 왜 필요한지
•
자신의 OS에 맞는 터미널 앱 선택 (Mac: iTerm2, Windows: Windows Terminal)
•
Homebrew 설치 (Mac)
•
터미널 기본 사용법 (cd, pwd)
•
터미널 사용 중 흔한 문제와 해결법
Claude Code는 터미널에서 실행됩니다. 이 장에서는 터미널이 무엇인지, 어떤 앱을 쓰면 좋은지, 그리고 Claude Code를 쓰기 위해 알아야 할 최소한의 사용법을 다룹니다.
터미널이란
터미널은 컴퓨터에 텍스트로 명령을 입력하는 프로그램입니다. 평소에 마우스로 폴더를 열고, 파일을 클릭하는 것과 같은 일을 텍스트로 하는 것입니다.
Claude Code를 쓸 때 터미널 명령어를 많이 알 필요는 없습니다. 터미널은 Claude Code를 실행하는 입구이고, 실행한 뒤에는 자연어로 대화하면 됩니다. 알아야 할 명령어는 이 장에서 다루는 것이 전부입니다.
터미널은 안전합니다 처음 터미널을 열면 까만 화면에 텍스트만 나와서 당혹스러울 수 있습니다. 뭘 잘못 건드려서 컴퓨터가 망가지면 어쩌나 싶은 마음도 들 수 있습니다. 걱정하지 않아도 됩니다.
이 장에서 다루는 명령어(cd, pwd)는 폴더 위치만 확인하고 이동하는 것이라서, 파일이 지워지거나 변경되는 일은 없습니다. 마치 Finder나 탐색기에서 폴더를 클릭하는 것과 같습니다.
터미널 앱 선택
자신의 운영체제에 해당하는 부분만 읽으세요.
Mac
Mac에서 쓸 수 있는 터미널 앱은 여러 가지입니다.
앱 | 설치 | 특징 |
Terminal.app | 기본 내장 | 기본적인 기능만 제공. 바로 쓸 수 있다는 장점 |
iTerm2 (추천) | 별도 설치 | 20년 넘게 검증된 무료 터미널. 안정적 |
Warp | 별도 설치 | AI 기능 내장, 현대적 UI. 계정 가입 필요 |
Claude Code와 함께 쓸 때는 iTerm2를 추천합니다. 2003년부터 20년 넘게 유지되고 있는 무료 터미널 앱입니다. 출력이 길어질 때 스크롤과 검색이 편리하고, 탭으로 여러 작업을 동시에 볼 수 있습니다.
Terminal.app도 충분히 사용할 수 있습니다. 설치 없이 바로 시작하고 싶다면 기본 앱으로 먼저 써보고, 불편함이 느껴질 때 iTerm2로 바꿔도 됩니다.
iTerm2 설치는 아래 Homebrew를 먼저 설치한 뒤 진행합니다.
흔한 실수: Terminal.app vs iTerm2 Spotlight(⌘ + Space)에서 "터미널"을 검색하면 Terminal.app이 나옵니다. 이것과 iTerm2는 별개의 앱입니다. iTerm2를 설치한 뒤에도 습관적으로 Terminal.app을 열어서 "아까 설정한 게 왜 안 보이지?" 하는 경우가 있습니다. 어떤 앱을 열었는지 타이틀 바를 확인하세요.
Windows
앱 | 설치 | 특징 |
명령 프롬프트 | 기본 내장 | 오래된 방식. 탭 없음, 복사/붙여넣기 불편 |
Windows Terminal (추천) | Win 11 기본 내장 | 탭, 화면 분할, 복사/붙여넣기 편리 |
Windows Terminal을 사용합니다. Windows 11에는 기본 내장되어 있고, Windows 10 사용자는 Microsoft Store에서 "Windows Terminal"을 검색해서 설치합니다.
여는 법: Windows 키 + R → wt 입력 → Enter
주의: 비슷해 보이는 앱들 Windows에는 비슷해 보이는 터미널 앱이 여러 개 있습니다. "명령 프롬프트(cmd)", "PowerShell", "Windows Terminal" 모두 다른 프로그램입니다. Windows Terminal을 열면 그 안에서 PowerShell이 기본 탭으로 열리는데, 이것이 정상입니다. "명령 프롬프트"는 사용하지 마세요. Claude Code에 필요한 기능이 부족합니다.
Linux
기본 터미널 앱을 그대로 사용하면 됩니다. Ctrl + Alt + T로 열 수 있습니다.
Homebrew 설치 (Mac)
Mac에서 프로그램을 설치할 때 보통 웹사이트에서 파일을 다운로드하고, 드래그해서 옮기는 과정을 거칩니다. Homebrew는 이 과정을 터미널 명령어 한 줄로 줄여주는 도구입니다.
Homebrew가 필요한 이유는 두 가지입니다:
1.
iTerm2와 Claude Code 자체를 Homebrew로 설치할 수 있습니다
2.
Claude Code가 작업 중에 추가 도구가 필요하면 Homebrew를 통해 설치합니다
예를 들어 PDF 변환을 시키면 Claude Code가 알아서 brew install로 필요한 도구를 깔고 작업을 진행합니다. Homebrew가 설치되어 있으면 이 과정이 자동으로 이루어져서 훨씬 수월합니다.
Terminal.app을 열고 아래 명령어를 그대로 복사해서 붙여넣습니다. 명령어의 내용을 이해할 필요는 없습니다. 붙여넣고 Enter를 누르면 자동으로 설치가 진행됩니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Plain Text
복사
설치 중에 비밀번호를 물어볼 수 있습니다. Mac 로그인 비밀번호를 입력하면 됩니다.
비밀번호 입력이 안 되는 것 같다면 키보드를 누르고 있는데 화면에 ****도 안 나오면 고장난 것 같지만, 보안상 일부러 아무것도 표시하지 않는 것입니다. 보이지 않더라도 비밀번호를 끝까지 입력하고 Enter를 누르면 됩니다. 비밀번호를 잘못 입력하면 다시 물어보니 당황하지 마세요.
설치가 끝나면 터미널을 한 번 껐다 켜고, 아래 명령어로 확인합니다:
brew --version
Plain Text
복사
Homebrew 4.x.x 같은 버전 번호가 나오면 설치가 된 것입니다.
command not found가 나오면
버전 번호 대신 command not found라는 메시지가 나오면, 터미널을 완전히 껐다가 다시 열고 시도해보세요.
그래도 같은 메시지가 나오면 설치 과정에서 마지막에 표시된 안내 문구를 확인합니다. "Next steps"라는 제목 아래 명령어를 붙여넣으라는 안내가 있을 수 있습니다.
Apple Silicon Mac에서 자주 발생 이것은 Homebrew 설치에서 가장 흔한 문제입니다. 특히 Apple Silicon(M1, M2, M3, M4) Mac에서 자주 발생합니다. Homebrew가 /opt/homebrew/에 설치되는데, 터미널이 이 경로를 아직 인식하지 못하기 때문입니다. "Next steps"에 나온 명령어 두 줄을 그대로 복사해서 붙여넣으면 해결됩니다. 이 안내를 이미 닫아버렸다면, Homebrew를 다시 설치하면 같은 안내가 나옵니다.
iTerm2 설치
Homebrew가 설치되었으면 한 줄이면 됩니다:
brew install --cask iterm2
Plain Text
복사
설치 후 iTerm2를 실행합니다. 이후 작업은 iTerm2에서 진행하세요.
iTerm2 테마 커스터마이징 iTerm2는 색상 테마를 변경할 수 있습니다. https://iterm2colorschemes.com/에서 마음에 드는 테마를 찾아 적용해보세요. 보기 편한 터미널은 작업 효율을 높여줍니다.
터미널 화면 읽기
터미널을 처음 열면 낯설어 보이지만, 이 장에서 알아야 할 것은 cd와 pwd 두 가지뿐입니다. 나머지는 Claude Code에게 말로 시키세요.
터미널을 열면 이런 화면이 보입니다:
Mac/Linux:
사용자이름@컴퓨터이름 ~ %
Plain Text
복사
Windows (PowerShell):
PS C:\Users\사용자이름>
Plain Text
복사
이것을 프롬프트라고 합니다. "입력할 준비가 됐다"는 뜻입니다. Mac에서 ~는 현재 위치(홈 폴더)를 나타내고, Windows에서는 경로가 직접 표시됩니다.
명령어를 입력하고 Enter를 누르면 결과가 아래에 표시되고, 다시 프롬프트가 나타납니다. 이것이 터미널의 전부입니다.
프롬프트가 보이지 않으면 이전 명령어가 아직 실행 중인 것입니다. Ctrl + C를 누르면 실행 중인 명령을 중단하고 프롬프트가 다시 나타납니다. 터미널을 쓰면서 가장 많이 쓰게 될 키 조합이니 기억해 두세요.
폴더 이동: cd
Claude Code는 실행한 폴더의 파일에 접근합니다. 바탕화면의 파일을 다루고 싶으면 바탕화면에서 실행해야 합니다.
폴더를 이동하는 명령어는 cd입니다:
Mac/Linux:
cd ~/Desktop
Plain Text
복사
•
cd ~/Desktop: 바탕화면으로 이동
•
cd ~/Documents: 문서 폴더로 이동
•
cd ~/Downloads: 다운로드 폴더로 이동
•
cd ..: 상위 폴더로 이동 (한 단계 위로)
•
cd ~: 홈 폴더로 돌아가기
Windows (PowerShell):
cd ~\Desktop
Plain Text
복사
•
cd ~\Desktop: 바탕화면으로 이동
•
cd ~\Documents: 문서 폴더로 이동
•
cd ~\Downloads: 다운로드 폴더로 이동
•
cd ..: 상위 폴더로 이동 (한 단계 위로)
•
cd ~: 홈 폴더로 돌아가기
cd 뒤에 이동할 폴더 경로를 씁니다. ~는 홈 폴더를 뜻합니다. Mac과 Windows 모두 같습니다.
현재 위치를 확인하고 싶으면 pwd를 입력합니다:
Mac/Linux:
/Users/사용자이름/Desktop
Plain Text
복사
Windows:
C:\Users\사용자이름\Desktop
Plain Text
복사
cd와 pwd, 이 두 가지면 Claude Code를 쓰기에 충분합니다. 파일 목록 보기, 폴더 만들기, 파일 이동 같은 작업은 Claude Code에게 자연어로 시킵니다.
여기서 사람들이 막힙니다
터미널을 처음 쓸 때 가장 많이 겪는 문제 세 가지입니다.
1. "No such file or directory"
cd 명령어를 입력했는데 이 에러가 나오면, 폴더 이름을 정확히 입력했는지 확인하세요. 터미널은 오타를 추측해주지 않습니다. 대소문자도 구분합니다. Desktop과 desktop은 다른 이름입니다.
Mac에서 흔한 경우: 바탕화면 언어 설정이 한국어이면 Finder에서는 "바탕화면"으로 보이지만, 터미널에서는 여전히 Desktop을 써야 합니다. cd ~/바탕화면은 작동하지 않습니다.
2. 폴더 이름에 띄어쓰기가 있는 경우
"내 프로젝트"라는 폴더로 이동하려면 cd 내 프로젝트가 아니라 따옴표로 감싸야 합니다:
cd "내 프로젝트"
Plain Text
복사
따옴표 없이 입력하면 터미널은 "내"라는 폴더와 "프로젝트"라는 폴더 두 개를 찾으려고 시도합니다.
폴더 이름 짓기 팁 한국어 폴더 이름이라서 더 신경 써야 합니다. 처음부터 폴더 이름을 영어로, 띄어쓰기 없이 만들면 이런 문제를 피할 수 있습니다. 예를 들어 my-project나 work_files 같은 이름이 터미널에서 다루기 편합니다.
3. 어디 있는지 모르겠을 때
길을 잃었다고 느끼면 pwd를 입력하세요. 현재 위치가 표시됩니다. 그래도 원하는 폴더를 못 찾겠으면 cd ~로 홈 폴더에 돌아간 다음 다시 시작하면 됩니다.
폴더 드래그 꿀팁 Finder에서 폴더를 찾은 다음 경로를 확인하는 방법도 있습니다. Finder에서 폴더를 열고, 터미널에 cd (cd + 스페이스)를 입력한 뒤 해당 폴더를 터미널 창에 드래그하면 경로가 자동으로 입력됩니다. 복잡한 경로를 입력할 때 편리합니다.
직접 해보기
이 장을 읽은 후 실제로 시도해볼 수 있는 것들입니다. 3장으로 넘어가기 전에 체크해보세요.
터미널 앱 열기 (Mac: iTerm2, Windows: Windows Terminal)
cd ~/Desktop 실행해서 바탕화면으로 이동하기
pwd로 현재 위치가 바탕화면인지 확인하기
cd ~로 홈 폴더로 돌아가기
cd ..로 상위 폴더로 이동해보기
정리
•
터미널은 Claude Code를 실행하는 입구입니다. 명령어를 많이 알 필요는 없습니다.
•
Mac에서는 iTerm2, Windows에서는 Windows Terminal을 사용합니다.
•
Homebrew (Mac): 프로그램 설치를 쉽게 해주는 도구. Claude Code가 자동으로 필요한 도구를 설치할 때 사용합니다.
•
`cd`: 폴더 이동. Claude Code를 실행할 위치로 이동합니다.
•
`pwd`: 현재 위치 확인. 길을 잃었을 때 유용합니다.
•
폴더 이름 팁: 영어, 띄어쓰기 없이 만드는 것이 편합니다.
•
비상 키 조합: Ctrl + C (명령 중단), cd ~ (홈 복귀), pwd (위치 확인)