Claude Code 처음 설치하는 법: 맥·윈도우 단계별 가이드

요즘 "바이브 코딩"이라는 말이 자주 보입니다. 코드를 한 줄도 모르는 사람이 AI에게 "이런 거 만들어줘"라고 말로 시키면 그럴듯한 결과물이 나오는 흐름인데요. 그 중심에 있는 도구 중 하나가 바로 Claude Code입니다. 저도 처음 설치할 때 검은 화면(터미널)을 보고 살짝 겁먹었지만, 막상 해보니 순서만 맞으면 30분이면 끝나는 작업이었습니다. 이 글에서는 개발 경험이 전혀 없는 분도 따라할 수 있도록 맥과 윈도우 양쪽 모두 Claude Code 설치 과정을 단계별로 정리했습니다. 어려운 용어는 그때그때 풀어 설명하니 부담 없이 따라오셔도 됩니다.

 

Claude Code가 뭐야?

Claude Code는 Anthropic(클로드를 만든 회사)이 공식적으로 내놓은 터미널용 AI 코딩 도구입니다. 우리가 평소 쓰는 Claude 챗봇은 웹 브라우저 안에서 대화만 주고받지만, Claude Code는 한 단계 더 들어갑니다. 내 컴퓨터의 폴더와 파일에 직접 접근해서 코드를 읽고, 수정하고, 실행까지 시켜볼 수 있거든요.

쉽게 비유하면 이렇습니다.

구분	Claude (웹)	Claude Code (터미널)
사용 위치	브라우저	내 컴퓨터 안
파일 접근	업로드해야 함	폴더 통째로 가능
코드 실행	불가	바로 실행 가능
주 용도	대화·문서 작업	프로젝트 단위 작업

예를 들어 "내 블로그 폴더에 있는 글 50개의 제목을 다 짧게 다듬어줘" 같은 작업을 시키면, Claude Code는 폴더를 직접 열어보고 파일을 하나씩 고쳐줍니다. 비개발자에게도 충분히 매력적인 이유죠.

설치 전에 알아둘 것 두 가지

본격 설치 전에 짚고 갈 게 두 개 있습니다.

첫째, 터미널이 필요합니다. 터미널은 검은 화면에 글자로 명령을 입력하는 프로그램입니다. 마우스 클릭 대신 키보드로 컴퓨터에게 직접 말을 거는 창구라고 생각하시면 됩니다. 맥에는 "터미널"이라는 앱이 기본으로 있고, 윈도우에는 "PowerShell" 또는 "명령 프롬프트"가 있습니다.

둘째, Node.js가 필요합니다. Node.js는 자바스크립트라는 프로그래밍 언어를 컴퓨터에서 돌릴 수 있게 해주는 엔진입니다. Claude Code가 이 위에서 동작하기 때문에 먼저 깔아야 합니다. Anthropic 공식 문서 기준으로 Node.js 18 버전 이상이 필요합니다(글 작성 시점 기준).

💡 Node.js를 설치한다고 해서 컴퓨터가 무거워지거나 다른 프로그램이 느려지지 않습니다. 백그라운드에 조용히 있다가 필요할 때만 동작하는 부품 같은 존재입니다.

준비물 체크리스트부터 보시죠.

• [ ] 맥 또는 윈도우 10/11 컴퓨터
• [ ] 인터넷 연결
• [ ] Anthropic 계정 (claude.ai에서 가입 가능)
• [ ] 결제 수단 또는 API 크레딧 (유료 사용 시)

맥에서 Claude Code 설치하기

맥은 절차가 비교적 단순합니다. 터미널 앱은 Launchpad → 기타 폴더 안에 있거나, Cmd + Space를 눌러 "터미널"을 검색하면 나옵니다.

1단계. Node.js 설치 확인

터미널을 열고 아래를 입력합니다.

node -v

이 명령은 "지금 설치된 Node.js 버전 알려줘"라는 뜻입니다. v18.0.0 같은 숫자가 나오면 통과입니다. command not found가 뜨면 아직 설치가 안 된 상태이니 다음 단계로 갑니다.

2단계. Node.js 설치

가장 쉬운 방법은 Node.js 공식 홈페이지(nodejs.org)에서 LTS 버전 설치 파일을 다운받아 더블클릭하는 것입니다. 그래픽 설치 화면이 나오니 "다음, 다음" 누르시면 됩니다. 설치 후 터미널을 한 번 닫았다가 다시 열어주세요.

3단계. Claude Code 설치

터미널에 아래를 입력합니다.

npm install -g @anthropic-ai/claude-code

이 명령은 "npm이라는 도구를 통해 Claude Code를 내 컴퓨터 전체에 설치해줘"라는 뜻입니다. npm은 Node.js와 함께 자동으로 깔리는 패키지 매니저(앱스토어 같은 것)이니 따로 설치할 필요 없습니다. 1~2분 기다리면 끝납니다.

4단계. 실행

작업하고 싶은 폴더로 이동한 뒤 claude라고 입력합니다.

cd ~/Documents/내폴더
claude

cd는 "change directory", 즉 폴더를 옮기라는 명령입니다. 처음 실행하면 로그인 안내 화면이 뜨는데, 안내대로 브라우저에서 Anthropic 계정에 로그인하면 자동 연결됩니다.

윈도우에서 Claude Code 설치하기

윈도우는 살짝 갈래가 있습니다. 가장 안정적인 방법은 WSL을 쓰는 것입니다. WSL(Windows Subsystem for Linux)은 윈도우 안에서 리눅스 환경을 흉내내주는 마이크로소프트 공식 기능인데, 개발자 도구들이 대부분 리눅스/맥 기준으로 만들어져 있어 호환성이 좋습니다.

사용자
  ↓
PowerShell (윈도우 기본)
  ↓
WSL 설치 → 우분투 환경 실행
  ↓
Node.js 설치 → Claude Code 설치
  ↓
claude 실행 🎉

1단계. WSL 설치

시작 버튼을 우클릭 → 터미널(관리자) 또는 PowerShell(관리자)을 엽니다. 그리고 입력합니다.

wsl --install

이 한 줄로 WSL과 우분투(리눅스 종류 중 하나)가 함께 설치됩니다. 설치 후 컴퓨터를 재시작하면 시작 메뉴에 "Ubuntu"라는 앱이 새로 생깁니다.

2단계. 우분투 첫 실행

Ubuntu 앱을 켜면 사용자 이름과 비밀번호를 만들라고 합니다. 이건 윈도우 계정과는 별개로 리눅스 안에서만 쓰는 계정입니다.

💡 비밀번호 입력 시 화면에 아무 글자도 나타나지 않습니다. 고장난 게 아니라 보안상 일부러 숨기는 겁니다. 그냥 타이핑하고 Enter를 누르세요.

3단계. Node.js 설치

우분투 안에서 아래를 차례대로 입력합니다.

sudo apt update
sudo apt install -y nodejs npm

sudo는 "관리자 권한으로 실행"이라는 뜻입니다. 처음 한 번 비밀번호를 묻고 진행됩니다. 단, 이 방법으로 설치되는 Node.js는 버전이 낮을 수 있어서, 더 안전하게는 nvm(Node Version Manager)이라는 도구를 쓰는 것이 좋습니다. 공식 문서 링크대로 따라가시면 됩니다.

4단계. Claude Code 설치 및 실행

npm install -g @anthropic-ai/claude-code
claude

맥과 동일합니다. 첫 실행 시 브라우저로 로그인 절차가 안내됩니다.

첫 실행과 로그인, API 키 이야기

claude 명령을 처음 치면 두 가지 로그인 방식 중 하나를 고르게 됩니다.

방식	특징	추천 대상
Claude 계정 로그인	Pro/Max 구독에 포함된 사용량 활용	이미 Claude 유료 구독 중인 분
API 키 사용	사용한 만큼 후불 결제	가끔만 쓰거나 개발 용도

API 키는 일종의 출입증입니다. "이 사람이 결제 가능한 정식 사용자입니다"라는 걸 증명하는 긴 문자열이죠. console.anthropic.com에 로그인해서 발급받을 수 있고, 이 키를 터미널에 한 번 등록해두면 그 다음부터는 자동으로 인증됩니다.

처음에는 Claude 계정 로그인 쪽이 훨씬 쉽습니다. 브라우저 창이 자동으로 열리고, 로그인만 하면 끝입니다.

설치가 안 될 때 자주 보는 문제들

저도 처음에 두어 군데서 막혔습니다. 자주 나오는 케이스만 정리합니다.

증상	원인	해결
command not found: claude	설치 경로가 인식 안 됨	터미널 재시작 또는 npm 전역 경로 확인
EACCES permission denied	권한 문제 (주로 맥)	명령 앞에 sudo 붙이기
node: 버전이 낮음	구버전 Node.js	nodejs.org에서 LTS 재설치
윈도우에서 한글 깨짐	인코딩 문제	WSL 환경에서 실행 권장

특히 권한 오류가 자주 보이는데, 영어로 길게 빨간 글자가 뜨면 당황하기 쉽습니다. 차분히 메시지 첫 줄만 복사해서 검색하면 대부분 답이 나옵니다(저도 그렇게 해결했습니다).

마무리

여기까지 따라오셨다면 이제 터미널에서 claude를 치는 것만으로 AI와 함께 파일을 다룰 수 있는 환경이 갖춰졌습니다. 처음에는 검은 화면이 어색하지만, 막상 "이 폴더 정리해줘", "이 텍스트 파일들 표로 합쳐줘" 같은 요청을 던져보면 의외로 금방 익숙해집니다.

다음 단계로 추천드리는 것:

• 빈 폴더 하나를 만들어 거기서 claude를 실행하고, 간단한 텍스트 파일을 만들어달라고 시켜보기
• 자주 쓰는 명령어 5개 정도 메모해두기 (/help, /clear 등 슬래시 명령)
• 공식 문서(docs.anthropic.com)의 Claude Code 섹션 한 번 훑어보기

설치는 시작일 뿐입니다. 다음 글에서는 Claude Code로 비개발자가 실제로 해볼 만한 작업 5가지를 다뤄볼 예정입니다.