클로드 코드 설치법, 윈도우·맥 완벽 정리
“클로드 코드, 설치부터 막힌다”는 분들 많으시죠? 터미널이라는 낯선 화면 앞에서 무엇부터 눌러야 할지 몰라 포기하셨다면, 이 글이 딱입니다. 이번 편에서는 클로드 코드 설치를 윈도우와 맥 두 환경에서 각각 단계별로 정리해 드립니다. 예전에는 Node.js와 npm 설치가 필수였지만, 지금은 훨씬 간단해진 방법도 생겼으니 끝까지 따라오시면 5분 만에 준비를 마칠 수 있습니다.
클로드 코드 설치, 방법이 몇 가지인가요?
클로드 코드는 크게 두 가지 방식으로 설치할 수 있습니다. 하나는 최근 권장되는 네이티브 설치(Native installer), 다른 하나는 기존의 npm 설치입니다.
| 설치 방법 | 특징 | 추천 대상 |
|---|---|---|
| 네이티브 설치 | Node.js 없이 명령어 한 줄로 설치, 자동 업데이트 | 대부분의 초보자 |
| npm 설치 | Node.js 기반, 개발 환경에 익숙한 분 | 이미 Node.js를 쓰는 분 |
| Homebrew(맥) | 맥 패키지 관리자로 간편 설치 | 맥 사용자 |
핵심 정의: 네이티브 설치는 시스템에 맞는 실행 파일(바이너리)을 자동으로 내려받아 설치하는 방식으로, 별도의 Node.js 설치가 필요 없습니다.
참고로 npm 패키지도 같은 네이티브 바이너리를 설치하며, 설치된 claude 실행 파일 자체는 Node.js를 사용하지 않고 동작합니다. 즉 어떤 방식이든 최종 실행 파일은 동일하니, 편한 방법을 고르시면 됩니다.
윈도우에서 클로드 코드 설치하는 법
클로드 코드 윈도우 설치는 PowerShell 한 줄로 끝낼 수 있습니다.
1) 네이티브 설치 (권장)
- 시작 메뉴에서 PowerShell을 검색해 실행합니다.
- 아래 명령어를 붙여넣고 엔터를 누릅니다.
irm https://claude.ai/install.ps1 | iex
- 설치가 끝나면
claude --version을 입력해 버전이 나오는지 확인합니다.
한 가지 팁을 드리면, ‘irm’이 인식되지 않는다는 오류가 뜨면 지금 CMD 창에 있는 것이고, PowerShell에서는 프롬프트에 PS C:\ 가 표시됩니다. 명령어는 반드시 PowerShell에서 실행해 주세요.
또한 윈도우에서는 Git for Windows 설치를 권장하는데, 이것이 있어야 클로드 코드가 Bash 도구를 사용할 수 있고, 없으면 PowerShell을 셸 도구로 대신 사용합니다. 원활한 사용을 위해 Git for Windows도 함께 설치해 두시길 추천합니다.
2) npm으로 설치하기
이미 개발 환경이 갖춰진 분이라면 npm 방식도 좋습니다. 먼저 Node.js 공식 사이트에서 LTS 버전을 설치한 뒤, 아래 명령어를 실행합니다.
npm install -g @anthropic-ai/claude-code
여기서 주의할 점! v2.1.198 기준으로 npm 패키지는 Node.js 22 이상을 요구하며, 더 낮은 버전에서는 설치 시 EBADENGINE 경고가 표시됩니다. 그러니 Node.js는 22 버전 이상으로 설치하시는 것이 안전합니다.
맥에서 클로드 코드 설치하는 법
클로드 코드 맥 설치도 명령어 한 줄이면 충분합니다.
1) 네이티브 설치 (권장)
- 터미널(Terminal) 앱을 실행합니다. (스포트라이트에서 “터미널” 검색)
- 아래 명령어를 입력합니다.
curl -fsSL https://claude.ai/install.sh | bash
- 설치 후
claude --version으로 정상 설치를 확인합니다.
2) Homebrew로 설치하기
맥에서 Homebrew를 쓰신다면 아래 한 줄로도 설치됩니다.
brew install --cask claude-code
3) npm으로 설치하기
윈도우와 동일하게 Node.js 22 이상을 설치한 뒤 다음을 실행합니다.
npm install -g @anthropic-ai/claude-code
설치 후 꼭 확인할 것
설치가 끝났다면 아래 두 가지를 체크해 주세요.
- 버전 확인:
claude --version입력 시 버전 번호가 뜨면 성공입니다. - 실행 테스트: 프로젝트 폴더로 이동한 뒤
claude를 입력하면 클로드 코드가 시작됩니다.
만약 명령어가 인식되지 않는다면 터미널을 완전히 껐다가 다시 켜 보세요. 그래도 안 되면 12편의 오류 해결 편에서 자세히 다루겠습니다. 설치가 잘 되었다면, 다음 편(3편)에서 요금제와 API 키 발급을 함께 진행하겠습니다.
자주 묻는 질문(FAQ)
Q1. 꼭 Node.js를 설치해야 하나요?
아니요. 네이티브 설치(윈도우 irm, 맥 curl)를 사용하면 Node.js 없이 설치할 수 있습니다. 이는 패키지가 런타임에 Node.js를 사용하지 않는 네이티브 바이너리를 내려받기 때문입니다. 다만 npm 방식으로 설치할 때는 Node.js 22 이상이 필요합니다.
Q2. 윈도우와 맥 설치 방법이 많이 다른가요?
핵심 개념은 같고, 첫 명령어만 다릅니다. 윈도우는 PowerShell에서 irm ... | iex를, 맥은 터미널에서 curl ... | bash를 실행하시면 됩니다. 이후 claude --version으로 확인하는 과정은 동일합니다.
Q3. 설치가 실패하면 어떻게 하나요?
가장 흔한 원인은 잘못된 창(CMD/PowerShell 혼동)이나 오래된 Node.js 버전입니다. 명령어 실행 위치를 다시 확인하고, npm 설치라면 Node.js를 최신 LTS로 업데이트해 보세요. 그래도 안 되면 기존 설치를 지우고 네이티브 방식으로 새로 설치하는 것이 가장 확실합니다.
한 줄 요약: 윈도우는 PowerShell irm, 맥은 터미널 curl 명령어 한 줄이면 Node.js 없이도 클로드 코드를 설치할 수 있습니다.