오늘의 목표
오늘 할 일은 하나입니다.
터미널을 열고, Claude Code를 실행하는 첫 화면까지 도착하기.
아직 코드를 잘 몰라도 괜찮습니다. 오늘 터미널은 "명령어를 붙여 넣는 메모장"이라고 생각하세요. 직접 외울 필요 없습니다. 복사하고, 붙여 넣고, 엔터를 누르면 됩니다.
오늘 사용할 핵심 명령어는 딱 네 줄입니다.
node -v
npm -v
npm install -g @anthropic-ai/claude-code
claude이 네 줄이 오늘의 입장권입니다.
다만 Windows 사용자는 한 가지를 먼저 기억해 주세요. Claude Code는 macOS나 Linux 터미널에서 가장 자연스럽게 동작합니다. Windows에서는 환경에 따라 PowerShell에서 바로 되는 경우도 있지만, 초보자에게는 오류가 많을 수 있습니다. 그래서 이 책에서는 Windows 사용자는 WSL의 Ubuntu 터미널 또는 VS Code의 WSL 터미널에서 진행하는 방식을 권장합니다.
먼저 "어느 터미널에서 할지" 정합니다
Claude Code는 "지금 내가 열어 둔 폴더"를 기준으로 일합니다. 그래서 아무 터미널에서 아무 폴더나 열고 시작하면 금방 헷갈립니다.
오늘은 아래 중 하나를 고르세요.
macOS 사용자: 기본 Terminal 앱 또는 VS Code 터미널
Windows 사용자: WSL의 Ubuntu 터미널 또는 VS Code의 WSL 터미널
Windows에서 아직 WSL을 설치하지 않았다면, 시작 메뉴에서 PowerShell을 관리자 권한으로 열고 아래 명령어를 실행한 뒤 안내에 따라 재부팅합니다.
wsl --install재부팅 후 시작 메뉴에서 Ubuntu를 열 수 있다면 준비가 된 것입니다. 처음 Ubuntu를 열면 사용자 이름과 비밀번호를 만들라고 할 수 있습니다. 화면 안내대로 입력하면 됩니다. 비밀번호를 입력할 때 글자가 보이지 않아도 정상입니다.
이미 WSL이나 Ubuntu를 쓰고 있다면 이 단계는 건너뛰어도 됩니다.
Windows에서 터미널 열기
Windows에서는 이 책을 Ubuntu 터미널 기준으로 따라옵니다.
방법 1. Ubuntu 터미널 열기
키보드에서
Windows키를 누릅니다.Ubuntu를 검색합니다.Ubuntu 앱을 엽니다.
아래처럼
$표시가 있는 터미널이 열리면 성공입니다.
myname@DESKTOP:~$여기에 이 책의 명령어를 붙여 넣으면 됩니다.
방법 2. VS Code에서 WSL 터미널 열기
VS Code를 쓰고 있다면 WSL 확장을 설치해 Ubuntu 폴더를 VS Code로 열 수 있습니다.
VS Code를 엽니다.
확장 탭에서 WSL을 설치합니다.
왼쪽 아래 초록색 원격 창 아이콘을 누릅니다.
Connect to WSL 또는 비슷한 항목을 선택합니다.
VS Code가 WSL에 연결되면 Terminal → New Terminal을 엽니다.
아래쪽에 이런 모양의 터미널이 열리면 좋습니다.
myname@DESKTOP:~$앞부분 이름은 사람마다 다릅니다. 중요한 건 커서가 깜빡이고 있다는 것. 이제 붙여 넣을 준비가 된 상태입니다.
Windows PowerShell에서
'claude' is not recognized또는 스크립트 실행 정책 오류가 반복된다면, PowerShell에서 억지로 고치려고 오래 붙잡지 마세요. Ubuntu 터미널로 넘어가는 편이 보통 더 빠릅니다.
macOS에서 터미널 열기
macOS에서는 두 가지 방법 중 편한 것을 고르면 됩니다.
방법 1. Terminal 앱 열기
Command + Space를 누릅니다.Terminal을 입력합니다.Terminal 앱을 엽니다.
화면에 이런 줄이 보이면 성공입니다.
myname@MacBook ~ %여기에 명령어를 붙여 넣으면 됩니다.
방법 2. VS Code 안에서 터미널 열기
VS Code를 엽니다.
상단 메뉴에서 File → Open Folder를 누릅니다.
원하는 작업 폴더를 엽니다.
상단 메뉴에서 Terminal → New Terminal을 누릅니다.
아래쪽에 이런 터미널이 열립니다.
myname@MacBook project-name %이제 준비됐습니다.
명령어를 입력하는 법
이 책에서는 명령어를 이렇게 보여줍니다.
node -v터미널에는 node -v만 입력하세요.
앞에 $, %, > 같은 기호가 보이더라도 따라 치지 않습니다. 그 기호들은 터미널이 "입력하세요"라고 보여주는 표시일 뿐입니다.
예를 들어 이런 화면이라면,
myname@MacBook ~ %여기에 node -v를 붙여 넣고 엔터를 누릅니다.
myname@MacBook ~ % node -v이게 전부입니다.
Node.js가 있는지 확인하기
Claude Code를 설치하려면 먼저 Node.js와 npm이 필요합니다.
어려운 설명은 건너뛰겠습니다.
Node.js: JavaScript 도구를 실행하게 해주는 프로그램
npm: 필요한 도구를 설치해주는 설치 관리자
터미널에 아래 명령어를 입력합니다.
node -v정상이라면 이런 식으로 버전 숫자가 나옵니다.
v20.11.1숫자는 달라도 됩니다. v로 시작하는 숫자가 나오면 통과입니다. 가능하면 현재 LTS 버전을 쓰는 것이 좋습니다.
이어서 npm도 확인합니다.
npm -v정상이라면 이런 식으로 나옵니다.
10.2.4여기까지 숫자가 두 번 나왔다면 아주 좋습니다.
node -v
# v20.11.1
npm -v
# 10.2.4이제 Claude Code를 설치할 수 있습니다.
Node.js가 없다고 나오면
만약 이런 메시지가 나오면 아직 Node.js가 설치되지 않은 상태입니다.
macOS 또는 Ubuntu 터미널에서는 이렇게 나올 수 있습니다.
command not found: node또는 이렇게 보일 수 있습니다.
zsh: command not found: node당황하지 마세요. 설치하면 됩니다.
macOS에서 가장 쉬운 설치 방법
브라우저를 엽니다.
nodejs.org에 접속합니다.LTS라고 적힌 버전을 다운로드합니다.
설치 프로그램을 실행합니다.
설치가 끝나면 터미널을 완전히 닫았다가 다시 엽니다.
다시 확인합니다.
node -v
npm -v두 줄 모두 숫자가 나오면 통과입니다.
Windows WSL Ubuntu를 쓰는 경우
Windows에 Node.js를 설치했더라도 Ubuntu 터미널 안에서는 node -v가 안 나올 수 있습니다. Windows와 Ubuntu는 서로 다른 작업 공간처럼 생각하면 됩니다.
Ubuntu 터미널에서 node -v가 안 나온다면, Ubuntu 안에 Node.js LTS를 따로 설치해야 합니다. 설치 방법은 시간이 지나며 바뀔 수 있으니, 브라우저에서 nodejs.org에 접속해 Linux 또는 WSL용 LTS 설치 안내를 확인한 뒤 따라 하세요.
설치가 끝나면 Ubuntu 터미널을 닫았다가 다시 열고 확인합니다.
node -v
npm -v두 줄 모두 숫자가 나오면 통과입니다.
설치 안내 중
curl ... | bash처럼 인터넷에서 받은 스크립트를 바로 실행하는 명령이 보일 수 있습니다. 공식 Node.js 안내를 보고 따라 하는 경우가 아니라면 함부로 실행하지 마세요. 모르는 블로그의 명령어를 그대로 붙여 넣는 것은 위험할 수 있습니다.
버전이 너무 낮다면
설치 중에 이런 메시지가 보일 수 있습니다.
npm WARN EBADENGINE Unsupported engine또는 Node 버전이 맞지 않는다는 안내가 나올 수 있습니다.
이때도 해결 방향은 같습니다.
Node.js LTS 버전으로 업데이트하세요. 설치 후에는 터미널을 꼭 닫았다가 다시 열어야 합니다.
연습용 폴더 만들기
이제 Claude Code가 작업할 작은 폴더를 만듭니다.
터미널에 아래 명령어를 그대로 입력합니다.
mkdir claude-first
cd claude-first뜻은 간단합니다.
mkdir claude-first:claude-first라는 새 폴더를 만든다cd claude-first: 그 폴더 안으로 들어간다
현재 위치가 헷갈리면 아래 명령어를 입력합니다.
pwd결과 끝에 claude-first가 보이면 잘 들어온 것입니다.
이제 이 폴더는 오늘의 작은 작업실입니다.
Claude Code 설치하기
이제 오늘의 핵심 명령어를 입력합니다.
npm install -g @anthropic-ai/claude-code조금 기다리면 여러 줄이 지나갑니다. 설치 중에는 글자가 많이 움직여도 괜찮습니다. 터미널이 일하는 중입니다.
정상적으로 끝나면 이런 느낌의 메시지가 나옵니다.
added 123 packages in 12s또는 이렇게 나올 수 있습니다.
changed 123 packages in 10s정확히 같은 숫자가 아니어도 됩니다.
중요한 건 마지막에 에러 없이 입력 줄로 돌아오는 것입니다.
myname@MacBook claude-first %또는 Ubuntu라면 이렇게 보일 수 있습니다.
myname@DESKTOP:~/claude-first$다시 명령어를 입력할 수 있는 상태로 돌아왔다면 설치가 끝난 것입니다.
설치 중 권한 오류가 나면
가장 자주 만나는 오류입니다.
npm ERR! code EACCES
npm ERR! permission denied뜻은 간단합니다.
"이 위치에 설치할 권한이 없어요."
초보자에게는 sudo npm install -g ...로 밀어붙이는 방법을 추천하지 않습니다. 나중에 권한 문제가 더 꼬일 수 있기 때문입니다.
macOS 또는 Ubuntu 터미널에서는 아래 명령어를 한 줄씩 입력해 npm 전역 설치 위치를 내 사용자 폴더 안으로 바꿔 봅니다.
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrcUbuntu에서 source ~/.zshrc가 안 된다면 아래처럼 입력합니다.
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc그리고 다시 설치합니다.
npm install -g @anthropic-ai/claude-code그래도 안 되면 터미널을 닫고 다시 연 뒤, 한 번 더 실행합니다.
npm install -g @anthropic-ai/claude-code"명령어를 찾을 수 없음"이 나오면
설치는 된 것 같은데 claude가 안 되는 경우가 있습니다.
macOS나 Ubuntu에서는 이렇게 나올 수 있습니다.
command not found: claude또는 이렇게 보일 수 있습니다.
zsh: command not found: claude먼저 가장 쉬운 해결부터 합니다.
터미널을 닫습니다.
새 터미널을 엽니다.
연습 폴더로 다시 들어갑니다.
다시 입력합니다.
cd claude-first
claude그래도 안 되면 설치 경로가 터미널에 연결되지 않은 상태일 수 있습니다.
아래를 입력합니다.
npm config get prefix만약 결과가 이렇게 나온다면,
/Users/myname/.npm-global또는 이렇게 나온다면,
/home/myname/.npm-global아래 명령어를 다시 적용합니다.
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrcUbuntu에서 zsh가 아니라 bash를 쓰고 있다면 이렇게 입력합니다.
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc그리고 다시 실행합니다.
claude임시로 아래 명령어를 사용할 수도 있습니다.
npx @anthropic-ai/claude-codenpx는 설치된 도구를 직접 찾아 실행해주는 우회 버튼처럼 생각하면 됩니다.
Claude Code 실행하기
드디어 첫 실행입니다.
연습용 폴더 안에 있는지 확인합니다.
pwdmacOS에서는 이런 식으로 현재 위치가 나옵니다.
/Users/myname/claude-firstUbuntu에서는 이런 식으로 보일 수 있습니다.
/home/myname/claude-first현재 위치가 claude-first 폴더라면 좋습니다.
이제 입력합니다.
claude처음 실행하면 로그인, 인증, 권한 확인 같은 안내가 나올 수 있습니다. 화면의 안내에 따라 진행하세요.
처음 보는 질문이 나와도 겁먹지 않아도 됩니다. 오늘 목표는 "첫 화면에 도착하기"입니다.
예를 들어 이런 식의 흐름이 나올 수 있습니다.
Welcome to Claude Code
? Sign in to continue
? Do you trust the files in this folder?로그인이 필요하면 브라우저가 열릴 수 있습니다. 안내대로 로그인한 뒤 터미널로 돌아오면 됩니다.
폴더를 신뢰하겠냐는 질문이 나오면, 오늘 만든 claude-first 폴더이므로 승인해도 괜찮습니다.
첫 화면에 도착하면 성공입니다
Claude Code가 실행되면 이제 터미널은 단순한 검은 화면이 아닙니다.
Claude에게 일을 부탁하는 작업실입니다.
아직 아무것도 만들지 않아도 됩니다. 오늘은 여기까지면 충분합니다.
마지막으로 아래처럼 한 문장만 입력해 봅니다.
안녕, 지금 이 폴더에서 연습을 시작할 거야.Claude가 답을 하면 성공입니다.
종료하고 싶다면 보통 아래 키를 누르면 됩니다.
Ctrl + C한 번 눌러도 안 나가면 한 번 더 누릅니다.
오늘 만든 감각
오늘 배운 것은 많지 않습니다. 하지만 아주 중요합니다.
node -v
npm -v
npm install -g @anthropic-ai/claude-code
claude이 네 줄을 지나오면 Claude Code의 문 앞에 선 것입니다.
터미널은 무서운 곳이 아닙니다.
붙여 넣고, 엔터를 누르고, 메시지를 읽는 곳입니다.
Windows 사용자라면 한 가지를 더 기억하세요.
PowerShell에서 오래 막히면, WSL Ubuntu 터미널로 간다.다음 장에서는 Claude에게 첫 부탁을 건네겠습니다. "웹사이트 만들어줘"가 아니라, Claude가 바로 이해할 수 있는 문장으로 말하는 법을 익힙니다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.