클로드 코드 설치 — mac·윈도우 명령어와 안 될 때
클로드 코드(Claude Code)는 공식 설치 스크립트 한 줄로 설치합니다. mac·리눅스·WSL은 curl -fsSL https://claude.ai/install.sh | bash, 윈도우 PowerShell은 irm https://claude.ai/install.ps1 | iex를 실행하면 됩니다. 설치 후 claude --version으로 확인하고 claude를 치면 시작됩니다. 예전에 널리 쓰이던 npm 설치도 되지만, 지금 공식이 권장하는 건 위의 네이티브 설치(자동 업데이트됨)입니다. 아래에 OS별 명령, 다른 설치법, 그리고 "설치가 안 될 때"까지 정리했습니다. (2026년 7월 27일 기준, 클로드 코드 2.1.x)
1. 빠른 설치 — 네이티브 설치 (권장)
운영체제에 맞는 한 줄을 터미널에 붙여넣습니다. 관리자 권한(sudo)은 필요 없습니다.
# macOS · 리눅스 · WSL
curl -fsSL https://claude.ai/install.sh | bash
# 윈도우 PowerShell
irm https://claude.ai/install.ps1 | iex
# 윈도우 CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdclaude update를 씁니다.
2. 설치 확인
설치가 끝나면 버전을 찍어 확인합니다.
claude --version
# 예: 2.1.202 (Claude Code) ← 이렇게 버전이 찍히면 정상설치·설정 상태를 더 자세히 보려면 claude doctor를 실행합니다. 세션을 시작하지 않고 설치 상태, 설정 파일 오류, 경고와 권장 조치를 읽기 전용으로 보여줍니다.
3. 실행과 로그인
작업할 프로젝트 폴더에서 claude를 치면 대화형 세션이 열립니다.
cd 내-프로젝트-폴더
claude처음 실행하면 브라우저로 로그인 창이 뜹니다. 클로드 코드는 Pro·Max·Team·Enterprise 또는 Console(API) 계정이 필요합니다. 무료 Claude.ai 플랜으로는 쓸 수 없습니다. 로그인까지 마치면 바로 대화가 됩니다. 처음이라면 자주 쓰는 클로드 코드 슬래시 명령어부터 익혀 두면 편합니다.
4. 다른 설치 방법 (Homebrew · WinGet · npm)
패키지 관리자를 이미 쓰고 있다면 그쪽이 익숙할 수 있습니다. 다만 아래 세 방법은 자동 업데이트가 안 되므로 수동으로 올려야 합니다.
| 방법 | 설치 | 업데이트 |
|---|---|---|
| Homebrew (mac) | brew install --cask claude-code |
brew upgrade claude-code |
| WinGet (윈도우) | winget install Anthropic.ClaudeCode |
winget upgrade Anthropic.ClaudeCode |
| npm | npm install -g @anthropic-ai/claude-code |
npm install -g @anthropic-ai/claude-code@latest |
sudo npm install -g는 쓰지 마세요 — 권한 문제와 보안 위험이 생깁니다. 권한 오류가 나면 sudo 대신 네이티브 설치나 npm 전역 경로 권한을 고치는 쪽으로 해결합니다.
5. 시스템 요구사항
| 항목 | 요구사항 |
|---|---|
| 운영체제 | macOS 13.0+, Windows 10 1809+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+ |
| 메모리 | 4GB 이상, x64 또는 ARM64 |
| 셸 | Bash, Zsh, PowerShell, CMD |
6. 윈도우에서 알아둘 점
- Git for Windows를 함께 깔면 좋습니다(선택). Git Bash가 있으면 클로드 코드가 Bash 도구를 쓸 수 있고, 없으면 PowerShell을 셸 도구로 씁니다.
- WSL을 쓴다면 PowerShell/CMD가 아니라 WSL 터미널 안에서 리눅스용 설치 명령을 실행하고
claude도 거기서 띄웁니다. - PowerShell과 CMD는 명령이 다릅니다. 프롬프트가
PS C:\로 시작하면 PowerShell,PS없이C:\면 CMD입니다.
7. 설치 위치 (네이티브)
mac·리눅스에서 네이티브로 설치하면 실행 파일은 ~/.local/bin/claude에 심볼릭 링크로 놓이고, 실제 버전들은 ~/.local/share/claude/versions/ 아래에 쌓입니다. 자동 업데이트가 새 버전을 이 폴더에 설치합니다. (Homebrew·npm 설치는 각 패키지 관리자의 경로에 들어가므로 위치가 다릅니다.)
8. 설치가 안 될 때
claude: command not found→ 설치는 됐는데 PATH에 안 잡힌 경우입니다. 터미널을 새로 열거나, 위 설치 위치가 PATH에 있는지 확인하세요. 그래도 안 되면claude doctor가 진단을 줍니다.'irm' is not recognized ...→ PowerShell 명령을 CMD에서 친 것입니다. PowerShell을 열어 다시 실행하세요. 반대로The token '&&' is not a valid statement separator가 나오면 CMD 명령을 PowerShell에서 친 것입니다.- npm 권한 오류(EACCES 등) →
sudo로 우회하지 말고, 네이티브 설치로 바꾸거나 npm 전역 디렉토리 권한을 고치세요.
자주 묻는 질문 (FAQ)
Q. npm으로 설치해도 되나요?
됩니다. 다만 지금 공식 권장은 네이티브 설치(자동 업데이트)입니다. npm 설치는 Node.js 22 이상이 필요하고 자동 업데이트가 안 됩니다.
Q. 무료 계정으로 쓸 수 있나요?
아니요. 무료 Claude.ai 플랜은 클로드 코드를 포함하지 않습니다. Pro·Max·Team·Enterprise 또는 Console(API) 계정이 필요합니다.
Q. 최신 버전으로 어떻게 올리나요?
네이티브 설치는 백그라운드로 자동 업데이트되며, 즉시 올리려면 claude update를 씁니다. Homebrew·WinGet·npm은 각 관리자의 upgrade 명령으로 수동 업데이트합니다.
마무리
정리하면, 가장 간단한 건 OS에 맞는 네이티브 설치 스크립트 한 줄이고(mac은 install.sh, 윈도우는 install.ps1), 끝나면 claude --version으로 확인한 뒤 claude로 시작하면 됩니다. 문제가 생기면 claude doctor가 대부분의 원인을 짚어 줍니다. 설치 명령은 버전에 따라 바뀔 수 있으니 공식 문서를 한 번 확인하세요.
📚 참고 출처 (2026년 7월 27일 확인)
· Claude Code — Advanced setup
· 로컬 실행 확인: claude --version → 2.1.202 (Claude Code)
COMMENTS