클로드 코드 설치부터 첫 실행까지: Mac, Windows 완전 가이드 (2026)

클로드 코드 설치를 검색해보면 글마다 명령어가 다 달라서 어떤 걸 써야 할지 헷갈리신 적 있으신가요? npm install 쓰라는 글이 있고 curl 한 줄짜리도 있고 노드(Node.js)부터 깔라는 글도 섞여 있습니다.

결론부터 말씀드리면 2026년 기준으로는 네이티브 설치가 가장 깔끔합니다. 노드 설치 같은 사전 준비가 필요 없고 자동 업데이트도 백그라운드로 알아서 돕니다. 다만 회사 정책상 npm을 써야 하는 분은 그쪽 경로도 살아 있습니다.

이 글은 클로드 코드를 처음 깔아보시는 분 기준으로 Mac과 Windows 환경별 설치, 인증, 첫 명령어까지 한 번에 정리해 드립니다. 설치 후 바로 마주치는 토큰 관리 이야기는 클로드 코드 토큰 기초 글에 따로 정리해 두었습니다.

어떤 설치 방식을 골라야 할까요

설치 방법은 크게 세 갈래입니다. 본인 환경에 맞춰 하나만 고르시면 됩니다.

방식	장점	단점
네이티브 설치 (curl/PowerShell)	노드 불필요, 자동 업데이트	일부 회사 보안 정책에서 막힘
Homebrew (Mac)	macOS 패키지 관리 통합	brew를 안 쓰면 의미 없음
npm 글로벌 설치	버전 고정, 개발 환경 통합	Node.js 18+ 사전 설치 필요

대부분의 개인 사용자분께는 네이티브 설치가 정답입니다. 회사 노트북이거나 노드를 이미 깊게 쓰고 계신다면 npm 쪽이 자연스럽습니다.

Mac에서 클로드 코드 설치하기

방법 A, 네이티브 설치 (권장)

터미널을 열고 아래 한 줄을 붙여넣으시면 됩니다.

curl -fsSL https://claude.ai/install.sh | bash

스크립트가 실행되면서 사용자 홈 디렉터리 아래에 바이너리를 깔고 PATH도 알아서 잡아줍니다. 설치가 끝나면 새 터미널 창을 하나 열어서 버전을 확인합니다.

claude --version

버전 번호가 출력되면 정상입니다. command not found가 뜨면 셸 설정 파일(~/.zshrc 또는 ~/.bash_profile)을 한 번 다시 읽어주시면 됩니다.

source ~/.zshrc

방법 B, Homebrew

브루(Homebrew)를 평소에 쓰시는 분이라면 이쪽이 더 친숙합니다.

brew install --cask claude-code

브루로 깔면 나중에 brew upgrade로 다른 도구들과 함께 한 번에 업데이트할 수 있다는 장점이 있습니다.

방법 C, npm

노드 환경이 이미 깔려 있고 버전을 직접 관리하고 싶다면 npm을 쓰시면 됩니다.

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

설치 전 node --version으로 18 이상이 잡혀 있는지 확인해 주세요. 노드가 없으시면 nvm이나 공식 인스톨러로 먼저 깔아두셔야 합니다.

Windows에서 클로드 코드 설치하기

윈도우는 두 가지 갈림길이 있습니다. PowerShell 네이티브로 깔 것이냐, WSL(Windows Subsystem for Linux)에서 리눅스처럼 쓸 것이냐입니다. 개발 환경이 이미 WSL이라면 두 번째 방법이 자연스럽습니다.

방법 A, PowerShell 네이티브 설치 (권장)

PowerShell을 관리자 권한으로 열고 아래 한 줄을 입력합니다.

irm https://claude.ai/install.ps1 | iex

irm은 Invoke-RestMethod, iex는 Invoke-Expression의 별칭입니다. 스크립트를 받아 즉시 실행하는 구조입니다. 설치가 끝나면 새 PowerShell 창에서 버전을 확인합니다.

claude --version

실행 정책 때문에 막히는 경우가 있는데 그때는 한 번만 정책을 풀어주시면 됩니다.

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

방법 B, WSL 사용

WSL에서는 Mac과 동일한 curl 한 줄을 쓰시면 됩니다.

curl -fsSL https://claude.ai/install.sh | bash

WSL을 쓰면 셸 환경, 패키지 관리, 파일 경로가 모두 리눅스 표준이라 클로드 코드와 다른 CLI 도구들의 궁합이 좋습니다. 윈도우 IT 개발자 사이에서 WSL 채택이 빠르게 늘어난 이유입니다.

첫 실행과 인증 절차

설치가 끝났다면 작업할 폴더로 이동해서 클로드를 띄웁니다. 보통은 본인 프로젝트 폴더 또는 새로 만든 빈 폴더에서 시작하시면 됩니다.

cd ~/projects/my-app
claude

처음 실행하면 인증 화면이 뜹니다. 두 가지 경로 중 하나를 고르시면 됩니다.

• 구독 로그인 — Pro(20달러) 또는 Max(100, 200달러) 플랜을 결제 중이라면 이쪽이 가장 단순합니다. 브라우저가 열리면서 클로드 계정에 로그인하고 권한을 승인합니다.
• API 키 입력 — 종량제로 쓰시는 분은 콘솔에서 받은 API 키를 직접 붙여넣습니다. 키는 ~/.claude/credentials 또는 환경변수 ANTHROPIC_API_KEY에 저장됩니다.

개인 작업용으로 매일 쓰신다면 구독이 비용 예측이 쉬워서 편합니다. 가끔만 쓰시면 API 종량제가 더 저렴할 수도 있습니다. 이 둘의 비용 차이는 사용량 패턴에 따라 갈리는데 토큰 소모가 빠른 이유는 토큰 기초 글에서 자세히 정리해 두었습니다.

첫 명령어 다섯 개로 감 잡기

인증까지 끝났으면 클로드 프롬프트가 떠 있을 겁니다. 처음 마주치는 분께 가장 유용한 명령어 다섯 개만 추려 드립니다.

/help       — 사용 가능한 명령어 전체 목록
/usage      — 현재 토큰 사용량과 5시간 리셋까지 남은 시간
/model      — 사용 모델 변경 (Haiku / Sonnet / Opus)
/clear      — 대화 초기화 (토큰 절약 핵심)
/compact    — 대화 요약 후 압축 (긴 작업 중 사용)

특히 /usage는 처음 며칠은 자주 들여다보시는 게 좋습니다. 어떤 작업이 토큰을 많이 먹는지 감이 잡히면 모델 선택과 대화 정리 타이밍이 자연스러워집니다. 본격 절약 루틴은 토큰 줄이는 7가지 방법 글에서 다룹니다.

설치 후 흔히 막히는 지점들

처음 설치하시면 한두 군데서 막히는 게 보통입니다. 자주 나오는 케이스만 짚어드립니다.

claude 명령이 안 잡힐 때: PATH 문제입니다. 새 터미널을 열거나 source ~/.zshrc를 실행해 보세요.

Windows에서 PowerShell 정책으로 막힐 때: 위에서 다룬 Set-ExecutionPolicy 한 줄로 해결됩니다.

API 키를 매번 묻는다: 환경변수가 새 셸에서 안 먹히는 경우입니다. ~/.zshrc에 export ANTHROPIC_API_KEY="sk-..." 형태로 영구 등록하시면 됩니다.

자주 묻는 질문

정리하며

오늘 정리한 핵심은 세 가지입니다. 첫째 2026년 기준 가장 깔끔한 설치는 네이티브 방식(curl 또는 irm)입니다. 둘째 인증은 구독 로그인이 가장 단순하고 종량제 API는 가끔 쓰는 분께 적합합니다. 셋째 첫 일주일은 /usage 명령으로 토큰 흐름을 자주 확인하셔야 비용이 예측 가능해집니다.

설치까지 끝내셨다면 이제 토큰이 어떻게 빠지는지 이해할 차례입니다. 클로드 코드 토큰이 뭔가요 글에서 컨텍스트 윈도우와 5시간 리셋 구조를 먼저 잡으시고 토큰 줄이는 7가지 방법으로 실전 절약 루틴까지 이어가시면 첫 달 청구서가 한결 가벼워집니다.