Claude Code를 Windows와 macOS에 설치하는 방법 (2026): 단계별 가이드
Claude Code를 설치하는 가장 빠른 방법은 네이티브 설치 프로그램(Node.js 불필요)을 쓰는 것이고, 이미 Node 생태계에 익숙하다면 npm install -g @anthropic-ai/claude-code를 실행해도 돼요. Windows에는 WinGet과 WSL2, macOS에는 Homebrew도 있어요. 사용하려면 유료 Claude 계정(Pro, Max, Team/Enterprise 또는 Console API)이 필요하며, 무료 claude.ai 플랜으로는 열리지 않아요. 설치가 끝나면 claude --version으로 확인한 뒤, 프로젝트 폴더 안에서 claude를 실행해 첫 세션을 시작하세요.
Anthropic은 변경 사항을 빠르게 배포하므로, 따라 하기 전에 모든 명령어와 버전 번호를 공식 문서 code.claude.com/docs에서 다시 한번 확인하세요.
저는 Jasmine이고, Windows와 macOS 양쪽에서 매일 Claude Code를 쓰는 개발자예요. 이 가이드는 두 운영체제를 한 페이지에 담아, 각 단계의 복사·붙여넣기 명령어는 물론 알맞은 방법 고르기, 설치 확인하기, 사람들이 가장 많이 겪는 오류 해결법까지 다뤄요. 이 도구가 정확히 무엇인지 아직 잘 모르겠다면, 먼저 Claude Code란 무엇인가를 읽고 다시 돌아오세요.
설치 전에 필요한 것 (시스템 요구 사항)
명령어를 입력하기 전에, 설치를 마치고 나서야 실행되지 않는다는 걸 알게 되는 일이 없도록 이 간단한 체크리스트를 확인해 두세요.
- 운영체제: Windows 10(빌드 1809 이상) 또는 Windows 11, 아니면 macOS(Apple Silicon과 Intel 모두 지원).
- 유료 Claude 계정 - 필수: Claude Code에는 Pro(월 $20), Max 5x(월 $100), Max 20x(월 $200), Team/Enterprise 플랜, 또는 Anthropic Console(API)을 통한 토큰 기반 과금 중 하나가 필요해요. claude.ai의 무료 플랜으로는 Claude Code가 열리지 않아요.
- 터미널: PowerShell 또는 Windows Terminal(Windows), Terminal 또는 iTerm2(macOS).
- 방법에 따라: npm으로 설치한다면 Node.js 22 이상이 필요해요. 네이티브 설치 프로그램은 Node가 전혀 필요 없어요. Windows에서는 WSL2나 Git for Windows를 설치하면 명령줄 사용 경험이 한결 매끄러워져요.
중요: 여기서 많은 초보자가 막혀요. 무료 플랜으로도 Claude Code를 내려받아 설치할 수는 있지만, 계정에 권한이 없어 로그인이 막혀요. 먼저 유료 플랜으로 업그레이드하거나, Console에서 발급받은 API 키를 미리 준비해 두세요.
시작하기 전 짧은 팁 하나. 이미 Node가 설치돼 있다면 node --version을 실행해 어떤 버전인지 확인하세요. 오래된 버전(18이나 20)이라면 npm으로 설치하기 전에 업그레이드해야 하고, 아니면 네이티브 설치 프로그램으로 바꿔 Node를 아예 건너뛰어도 돼요. 용량 면에서 Claude Code는 디스크나 RAM을 많이 요구하지 않는 가벼운 명령줄 도구예요. 실제로 속도를 좌우하는 건 하드웨어가 아니라 네트워크 연결이에요.
알맞은 설치 방법 고르기
흔히 쓰는 방법은 네 가지예요. 고민된다면 그냥 네이티브 설치 프로그램을 고르세요. 가장 가볍고 자동으로 업데이트돼요. 아래 표를 보면 30초 정도면 결정할 수 있어요.
| 방법 | 필요한 것 | 추천 대상 | 장점 / 단점 |
|---|---|---|---|
| 네이티브 설치 프로그램 | 터미널만 (Node 불필요) | 대부분의 사람, 초보자 | + 가볍고 백그라운드에서 자동 업데이트 / - 수동 버전 관리는 어려움 |
| npm | Node.js 22+ | 이미 Node에 익숙한 개발자 | + 익숙한 도구 / - Node와 전역 권한을 직접 관리해야 함 |
| WSL2 + npm | Windows + WSL2 + Ubuntu 내부의 Node | Linux 환경을 원하는 Windows 사용자 | + 최고의 POSIX 경험 / - 설정이 다소 번거로움 |
| Homebrew | macOS + Homebrew | 이미 brew를 쓰는 macOS 사용자 | + 다른 도구들과 함께 동기화됨 / - macOS 전용 |
Windows에 Claude Code 설치하기
2026년의 Windows에는 네이티브 설치 프로그램과 WinGet이 있어서, 예전처럼 WSL이 더 이상 필수가 아니에요. 그래도 WSL2는 여전히 가장 매끄러운 Linux 스타일 명령줄을 제공해요. 아래 세 가지 방법 중 하나를 고르세요.
방법 1 - 네이티브 설치 프로그램 (추천)
PowerShell을 열고 Anthropic의 한 줄 설치 명령을 실행하세요. 이 방법은 Node.js가 필요 없고 이후 자동으로 업데이트돼요.
irm https://claude.ai/install.ps1 | iex 이 명령은 사용자의 OS와 아키텍처에 맞는 안정 버전 빌드를 내려받아 바이너리를 사용자 디렉터리에 설치하고 자동으로 PATH에 추가해요. 끝나면 터미널을 닫았다 다시 열어 PATH를 새로 고친 뒤 claude --version으로 확인하세요. 실행 정책 때문에 PowerShell이 스크립트를 막는다면, Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass로 현재 세션에서만 제한을 풀고 다시 실행하면 돼요.
방법 2 - WinGet
이미 WinGet으로 소프트웨어를 관리하고 있다면 바로 설치할 수 있어요.
winget install Anthropic.ClaudeCode WinGet은 winget upgrade로 Claude Code를 다른 소프트웨어와 함께 계속 업데이트하고 싶은 사람에게 잘 맞아요.
방법 3 - WSL2 + npm (Linux 환경)
이건 Windows에서 진짜 Linux 환경을 원하는 사람을 위한 선택이에요. PowerShell을 관리자 권한으로 열고 WSL2를 활성화하세요.
wsl --install메시지가 뜨면 재시작하고 Ubuntu를 연 뒤, WSL 안에 Node.js 22 LTS를 설치하세요(nvm이나 공식 NodeSource 저장소 사용). 그다음 npm으로 Claude Code를 설치해요.
npm install -g @anthropic-ai/claude-codeWSL2에서 유의할 점 몇 가지가 있어요:
sudo npm install -g는 실행하지 마세요. sudo로 전역 설치하면 나중에 권한 문제로 골치 아파지기 쉬워요. npm prefix를 사용자 디렉터리로 설정하거나 nvm을 쓰세요.- 코드는 WSL 파일 시스템 안에 두세요(예:
~/projects). 마운트된/mnt/c/...경로 대신 WSL 안에 두면 I/O가 훨씬 빨라져요. - Git for Windows(또는 WSL 안의 git)를 설치하세요. Claude Code는 git이 있을 때 가장 잘 동작해요. git 없이 순수 PowerShell만 쓰면 일부 작업이 제한돼요.
macOS에 Claude Code 설치하기
macOS에는 깔끔한 방법이 두 가지 있어요. 네이티브 설치 프로그램/Homebrew(Node 불필요)이나, 이미 Node가 있다면 npm이에요. 둘 다 Apple Silicon(M1/M2/M3 이상)과 Intel Mac에서 잘 동작해요. 설치 프로그램이 알맞은 아키텍처를 자동으로 감지하므로 직접 고를 필요가 없어요. Mac에서 Terminal을 써본 적이 없다면 Spotlight(Cmd+Space를 누르고 "Terminal" 입력)로 열면 준비 끝이에요.
방법 1 - 네이티브 설치 프로그램 / Homebrew
Node.js가 필요 없는 가장 빠른 방법은 Terminal에서 실행해요:
curl -fsSL https://claude.ai/install.sh | bash이미 Homebrew를 쓰고 있고 다른 도구들과 함께 관리하고 싶다면:
brew install --cask claude-code방법 2 - npm
Node에 익숙하다면 먼저 Node.js 22 이상을 설치하고(nodejs.org에서 LTS를 받거나 brew install node 실행), 그다음 Claude Code를 설치하세요:
brew install node
npm install -g @anthropic-ai/claude-codenode --version으로 Node가 충분히 최신인지 확인하세요(반드시 22 이상이어야 해요). 전역 설치 중 권한 오류가 나면 sudo를 쓰지 말고, 대신 npm prefix를 사용자 디렉터리로 다시 설정하세요.
인증과 첫 세션
설치만으로는 부족하고, 로그인해야 사용할 수 있어요. 아무 프로젝트 폴더로 이동한 뒤 실행하세요:
cd path-to-your-project
claude처음 실행하면 Claude Code가 브라우저를 열어 Anthropic 계정 로그인을 요청해요(Console을 쓴다면 API 키를 붙여넣어요). 로그인하고 나서 터미널로 돌아오면 세션이 시작돼요. Pro/Max 계정으로 로그인하면 사용 한도가 구독에 따라 정해지고, API 키를 쓰면 토큰 단위로 과금돼요. 둘은 별개이니 필요와 예산에 맞는 쪽을 고르세요.
바로 "이 디렉터리 구조를 나열해 줘" 같은 간단한 프롬프트를 시도해 Claude Code가 프로젝트를 읽을 수 있는지 확인해 보세요. 익숙해지기에도 좋은 순간이에요. 요청은 영어(또는 어떤 언어로든) 입력할 수 있고, 파일 쓰기를 승인하기 전에 항상 변경 사항을 미리 볼 수 있어요.
Claude Code는 현재 폴더를 신뢰하는지도 물어봐요. 이건 안전장치예요. 도구는 허용한 폴더 안의 파일만 읽고 써요. 방금 클론한 낯선 프로젝트라면 접근을 허용하기 전에 한 번 생각해 보세요.
설치가 잘 됐는지 확인하기
대부분의 가이드는 이 단계를 건너뛰지만, 확인해 두면 PATH나 버전 문제를 일찍 잡을 수 있어요. 다음 명령어를 실행하고 예상 결과와 비교해 보세요:
| 명령어 | 용도 | 예상 결과 |
|---|---|---|
claude --version | 설치된 버전을 출력 | 버전 문자열이 표시됨(오류 없음) |
claude doctor | 설치 환경을 진단 | 핵심 항목이 "OK"로 표시되는 체크리스트 |
where.exe claude (Windows) | 실행 파일 경로를 표시 | 유효한 경로가 반환됨 |
which claude (macOS) | 실행 파일 경로를 표시 | 유효한 경로가 반환됨 |
claude --version이 실행되고 claude doctor에 빨간 오류가 없으면 설치가 성공했다고 봐도 돼요.
자주 발생하는 설치 오류와 빠른 해결법
두 운영체제에서 설치할 때 제가 가장 자주 겪는 오류와 각각의 빠른 해결법을 소개할게요:
'claude' is not recognized/ command not found: 실행 파일이 PATH에 없어요. 터미널을 닫았다 다시 열고, 그래도 안 되면 설치 디렉터리(보통~/.local/bin)를 PATH에 추가한 뒤 터미널을 재시작하세요.- Node가 너무 오래됨: Node가 필요한 버전보다 낮으면 npm이 오류를 내요. nvm으로 업그레이드하거나 nodejs.org에서 LTS를 다시 설치해 Node를 22 이상으로 올리세요.
npm install -g중 권한 오류(EACCES):sudo로 때우지 마세요. npm prefix를 사용자 디렉터리로 다시 설정하거나, 네이티브 설치 프로그램으로 바꾸면 전역 권한 문제를 통째로 피할 수 있어요.- WSL이 활성화되지 않음(Windows):
wsl --install이 오류를 내면 Windows 기능에서 "가상 머신 플랫폼"과 "Linux용 Windows 하위 시스템"을 모두 켠 뒤 재시작하세요. - 터미널을 새로 열지 않음: 설치 후 새 환경 변수는 새 터미널 세션에만 적용돼요. 다시 시도하기 전에 항상 새 터미널을 여세요.
다른 문제가 생겼거나 더 깊이 파고들고 싶나요? 상황별 전체 해결법을 모아 둔 전용 가이드 Claude Code의 자주 발생하는 오류 해결하기를 확인하세요.
업데이트와 제거
업데이트:
- 네이티브 설치 프로그램: 백그라운드에서 알아서 업데이트되니 할 일이 없어요. 수동으로 확인하려면
claude update를 실행하면 돼요. - npm:
npm update -g @anthropic-ai/claude-code를 실행하세요.
제거:
- npm:
npm uninstall -g @anthropic-ai/claude-code. - Homebrew:
brew uninstall --cask claude-code. - 네이티브 설치 프로그램:
~/.local/bin의 바이너리와 관련 설정 디렉터리를 삭제하세요.
설치 후 다음 단계
이제 Claude Code가 실행되니, 진짜로 써 볼 차례예요. 추천하는 진행 순서예요:
- 초보자라면 초보자를 위한 시작 10단계를 읽고 기본 워크플로를 익히세요.
- VS Code로 코딩한다면 에디터 연동을 위해 VS Code에서 Claude Code 사용하기를 확인하세요.
- 개념이 아직 흐릿한가요? Claude Code란 무엇인가로 다시 돌아가 보세요.
손에 익으면 미리 만들어진 skill과 subagent 번들로 더 빠르게 작업할 수 있어요. 예를 들어 Claude Code용 AgentKit 번들(ak CLI(링크로 20% 할인)을 통해 활성화)을 쓰면 각 skill을 일일이 손으로 설정하는 수고를 덜 수 있어요. 이건 선택 사항이에요. 키트를 쓰지 않아도 Claude Code는 충분히 잘 작동해요.
자주 묻는 질문 (FAQ)
Claude Code 설치에 돈이 드나요?
설치 자체는 무료지만, 사용하려면 유료 Claude 계정이 필요해요. Pro(월 $20), Max 5x(월 $100), Max 20x(월 $200), Team/Enterprise 플랜, 또는 Anthropic Console을 통한 토큰 기반 과금 중 하나예요. claude.ai의 무료 플랜으로는 Claude Code가 열리지 않아요.
코딩을 할 줄 알아야 하나요?
기본적인 프로그래밍 지식이 있으면 효율적으로 작업할 수 있지만, 전문가일 필요는 없어요. 터미널을 열고, 폴더 사이를 이동하고, 출력을 읽을 줄 알면 돼요. 완전 초보자도 단계를 차근차근 따라가면 쓸 수 있어요.
Windows에서 WSL이 꼭 필요한가요?
아니요. 2026년의 Windows에는 네이티브 설치 프로그램과 WinGet이 있어서 WSL 없이 바로 설치할 수 있어요. 그래도 WSL2는 여전히 가장 매끄러운 Linux 스타일 경험을 주니, 프로젝트가 POSIX 환경을 전제로 한다면 잘 맞아요.
어떤 Node.js 버전이 필요한가요?
Node는 npm으로 설치할 때만 필요하고, Node.js 22 이상을 써야 해요. 네이티브 설치 프로그램을 쓴다면 Node.js는 전혀 필요 없어요.
저사양 컴퓨터에서도 실행할 수 있나요?
네. Claude Code는 처리의 대부분을 Anthropic 서버에서 실행하므로 고사양 컴퓨터가 필요 없어요. 진짜 필요한 건 안정적인 네트워크 연결과 유료 계정이에요. 소박한 사양으로도 잘 돌아가요.
Claude Code는 어떻게 제거하나요?
설치 방법에 따라 달라요. npm은 npm uninstall -g @anthropic-ai/claude-code를, Homebrew는 그에 맞는 brew uninstall을 쓰고, 네이티브 설치 프로그램은 ~/.local/bin의 바이너리를 설정 디렉터리와 함께 삭제하면 돼요.
마무리
Windows나 macOS에 Claude Code를 설치하는 건 결국 세 가지예요. 방법을 고르고(초보자에겐 네이티브 설치 프로그램이 가장 안전해요), 유료 계정으로 로그인한 다음, claude --version과 claude doctor로 확인하는 거예요. 막히면 위의 자주 발생하는 오류 섹션이나 전용 가이드 Claude Code 오류 해결하기를 다시 살펴보세요. 설치가 끝나면 초보자를 위한 10단계로 시작해 첫 세션을 정말 생산적으로 만들어 보세요.
설치 명령어와 시스템 요구 사항 출처: Anthropic 공식 문서 code.claude.com/docs(2026년 8월 접속).