가이드
Claude Code 설치하기
macOS·Linux·WSL은 `curl -fsSL https://claude.ai/install.sh | bash` 한 줄이면 됩니다. Windows PowerShell은 `irm https://claude.ai/install.ps1 | iex`입니다. 설치 후 프로젝트 폴더에서 `claude`를 실행하고 브라우저에서 로그인하면 끝입니다. 먼저 알아둘 전제가 하나 있습니다. Claude Code는 Pro·Max·Team·Enterprise·Console 계정 중 하나가 필요하며, 무료 Claude.ai 요금제에는 포함되지 않습니다(공식 문서, 2026-09-05 확인).
시스템 요구사항
공식 문서가 밝힌 지원 환경은 macOS 13.0 이상, Windows 10 빌드 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상입니다. 하드웨어는 RAM 4GB 이상과 x64 또는 ARM64 프로세서가 필요하고, 인터넷 연결이 있어야 합니다. 셸은 Bash·Zsh·PowerShell·CMD를 지원합니다.
방법 1: 네이티브 설치 프로그램(권장)
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd네이티브 설치는 백그라운드에서 자동으로 업데이트됩니다. PowerShell에서 "&& 토큰은 올바른 문 구분 기호가 아닙니다" 같은 오류가 뜬다면 CMD용 명령을 PowerShell에 붙여넣은 것입니다. 프롬프트 앞에 `PS`가 붙어 있으면 PowerShell, 없으면 CMD입니다.
방법 2: 패키지 관리자
# Homebrew(macOS / Linux)
brew install --cask claude-code
# WinGet(Windows)
winget install Anthropic.ClaudeCode
# npm(Node.js 22 이상 필요)
npm install -g @anthropic-ai/claude-code실무에서 시간을 잡아먹는 지점이 두 개 있습니다. 첫째, Homebrew에는 cask가 두 개입니다. `claude-code`는 stable 채널로 보통 일주일 정도 뒤처지고 중대한 회귀가 있는 릴리스를 건너뜁니다. `claude-code@latest`는 릴리스 즉시 받습니다. 둘째, npm 버전은 v2.1.198부터 Node.js 22 이상을 요구합니다. 구버전 Node.js에서는 EBADENGINE 경고만 출력되고 설치는 완료되는데, 이 패키지는 네이티브 바이너리를 내려받아 실행 시 Node.js를 쓰지 않기 때문입니다. `sudo npm install -g`는 공식이 명확히 권장하지 않습니다.
설치 확인
claude --version
# 출력 예: 2.1.211 (Claude Code)
claude doctor로그인
`claude`를 실행하면 브라우저가 열리고 거기서 인증합니다. 환경 변수 `ANTHROPIC_API_KEY`가 설정되어 있으면 브라우저 대신 그 키를 쓸지 한 번 묻습니다. 회사 도입에서 가장 중요한 대목은 여기입니다. 공식 문서는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry를 지원 제3자 제공자로 명시합니다. 이미 클라우드 계약이 있는 조직이라면 새 구독을 기안하는 것보다 기존 계약에 얹는 편이 승인이 훨씬 빠른 경우가 많습니다.
Windows: 네이티브냐 WSL이냐
| 선택지 | 사전 준비 | 샌드박스 | 적합한 상황 |
|---|---|---|---|
| 네이티브 Windows | 없음(Git for Windows는 선택) | 미지원 | Windows 네이티브 프로젝트와 도구 |
| WSL 2 | WSL 2 활성화 | 지원 | Linux 툴체인, 격리 실행이 요건일 때 |
| WSL 1 | WSL 1 활성화 | 미지원 | WSL 2를 쓸 수 없는 환경 |
제거
# 네이티브(macOS / Linux / WSL)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
# Homebrew
brew uninstall --cask claude-code
# WinGet
winget uninstall Anthropic.ClaudeCode
# npm
npm uninstall -g @anthropic-ai/claude-code본체를 지워도 설정은 남습니다. 사용자 설정은 `~/.claude`와 `~/.claude.json`, 프로젝트 쪽은 `.claude`와 `.mcp.json`입니다. 주의할 점은 VS Code 확장, JetBrains 플러그인, 데스크톱 앱도 `~/.claude`에 쓰기 때문에, 그중 하나라도 남아 있으면 다음 실행 때 폴더가 다시 만들어진다는 것입니다.
자주 묻는 질문
- Claude Code는 무료로 쓸 수 있나요?
- 아닙니다. CLI 설치 자체는 무료지만 실행하려면 Pro·Max·Team·Enterprise·Console 계정 중 하나가 필요하고, 무료 Claude.ai 요금제에는 Claude Code 접근 권한이 포함되지 않습니다(공식 문서, 2026-09-05 확인). 무료 터미널 에이전트를 찾는다면 Gemini CLI나 OpenCode가 대안입니다.
- Claude Code에 Node.js가 필요한가요?
- npm으로 설치할 때만 필요하고, v2.1.198부터는 Node.js 22 이상을 요구합니다. 네이티브 설치 프로그램, Homebrew, WinGet, apt/dnf/apk는 모두 같은 네이티브 바이너리를 설치하며 실행 시 Node.js를 사용하지 않습니다.
- Windows에서는 어떻게 설치하나요?
- PowerShell은 `irm https://claude.ai/install.ps1 | iex`, CMD는 `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`, WinGet은 `winget install Anthropic.ClaudeCode`입니다. 관리자 권한은 필요하지 않습니다. Git for Windows를 설치하면 Bash 도구가 활성화됩니다.
- 업데이트는 어떻게 하나요?
- 네이티브 설치는 백그라운드에서 자동 업데이트되며 `claude update`로 즉시 갱신할 수도 있습니다. Homebrew와 WinGet은 자동 업데이트되지 않으므로 `brew upgrade claude-code` 또는 `winget upgrade Anthropic.ClaudeCode`를 실행합니다. 설정 `autoUpdatesChannel`로 `"latest"`와 `"stable"`을 전환할 수 있고 stable은 대략 일주일 뒤처집니다.
출처
- Claude Code 공식 문서 — 설치 — 최종 확인: 2026-09-05
- Claude 요금 페이지(claude.com/pricing) — 최종 확인: 2026-09-05