Claude Code 설치 방법: Mac, Windows, Linux 가이드
Claude Code 네이티브 설치는 Mac·Linux는 curl, Windows는 PowerShell 또는 CMD입니다. Homebrew/WinGet은 기본이 수동 업데이트이고, CLI에서 Git Bash는 필수가 아닙니다.
Claude Code 설치는 운영체제에 맞는 공식 설치 명령을 한 번 실행하는 것이 기본입니다. 2026년 9월 10일 기준 공식 설치 문서는 네이티브 설치를 권장합니다. Mac·Linux·WSL은 curl 스크립트, Windows는 PowerShell 또는 CMD 스크립트를 씁니다. Homebrew와 WinGet도 있지만 기본은 수동 업데이트입니다.
설치 전에 확인할 것
계정부터 확인합니다. 공식 문서는 Pro, Max, Team, Enterprise 또는 Console 계정이 필요하다고 적습니다. 무료 Claude.ai 플랜에는 Claude Code가 포함되지 않습니다. 어떤 플랜이 포함되는지는 claude.com/pricing에서 확인하는 것이 정확합니다. API 키만으로도 쓸 수 있습니다. 구독 한도와 API 토큰 과금은 다릅니다. 구분은 비용 문서를 보십시오.
요구 사항(같은 문서): macOS 13+, Windows 10 1809+ 또는 Windows Server 2019+, Ubuntu 20.04+/Debian 10+/Alpine 3.19+, RAM 4GB 이상, Bash·Zsh·PowerShell·CMD.
| 방식 | 명령 | 자동 업데이트 | 추천 대상 |
|---|---|---|---|
| 네이티브 | curl 또는 PowerShell/CMD 스크립트 | 예, 백그라운드 | 대부분의 사용자 |
| Homebrew | brew install --cask claude-code | 아니요. brew upgrade 또는 환경 변수로 선택 옵트인 | Mac에서 brew로 도구를 관리하는 사람 |
| WinGet | winget install Anthropic.ClaudeCode | 아니요. winget upgrade 또는 같은 옵트인 | Windows에서 패키지 관리를 쓰는 사람 |
| npm | npm install -g @anthropic-ai/claude-code | npm 전역 경로 권한에 따라 다름 | 이미 Node가 있는 개발자 |
| Linux 패키지 | apt / dnf / apk | 배포판 업그레이드 절차 | 서버·배포판 정책을 따르는 환경 |
네이티브 설치는 Node.js가 필요 없습니다. npm 방식은 확인일 기준 문서가 Node.js 22 이상(v2.1.198부터)을 요구합니다.
Mac·Linux·WSL
터미널을 열고 공식 명령을 실행합니다.
curl -fsSL https://claude.ai/install.sh | bash
설치가 끝나면 터미널을 다시 엽니다. PATH가 갱신되어야 claude를 찾습니다.
claude --version
버전 번호가 나오면 성공입니다. 자세한 점검은 claude doctor입니다. Homebrew를 쓰면 brew install --cask claude-code입니다. 안정 채널 cask와 claude-code@latest cask가 따로 있습니다.
Linux에서 zsh를 쓰면 설치 후 source ~/.zshrc가 필요할 수 있습니다. Alpine은 bash·curl이 기본이 아니므로 패키지를 먼저 깔아야 공식 설치 명령이 동작합니다.
Windows: 셸은 PowerShell 또는 CMD
네이티브 Windows는 PowerShell과 CMD를 모두 지원합니다. 프롬프트가 PS C:\이면 PowerShell, C:\만 있으면 CMD입니다.
PowerShell:
irm https://claude.ai/install.ps1 | iex
CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
&&가 안 된다는 메시지는 PowerShell에서 CMD 명령을 실행한 경우입니다. irm을 못 찾으면 CMD에서 PowerShell 명령을 실행한 경우입니다.
Git for Windows는 CLI 네이티브 설치에서 필수가 아닙니다. 없으면 PowerShell 도구로 셸 명령을 실행하고, 있으면 Git Bash로 Bash 도구를 씁니다. WSL에서는 Git for Windows가 필요 없습니다. Git Bash 경로를 못 찾으면 설정에 CLAUDE_CODE_GIT_BASH_PATH를 넣을 수 있습니다.
WSL을 쓰는 분은 WSL 터미널 안에서 Linux 설치 명령을 실행합니다. PowerShell에서 claude를 실행하는 것과는 별개입니다.
Desktop과 CLI를 섞지 말 것
Desktop Code 탭은 Windows에서 처음 Code 탭을 열 때 Git for Windows가 필요하고, 설치 후 앱을 다시 시작하라고 적습니다. 세션 격리가 Git을 쓰기 때문입니다. 이 요구를 CLI 설치에 그대로 적용하지 마십시오.
첫 실행과 로그인
프로젝트 폴더에서 실행합니다. 현재 폴더가 작업 공간입니다.
cd ~/my-project
claude
처음이면 브라우저로 로그인합니다. ANTHROPIC_API_KEY가 있으면 브라우저 대신 키 사용 여부를 한 번 묻습니다. 키가 채팅이나 저장소에 들어가지 않게 하십시오.
첫 질문 예:
이 프로젝트 구조를 설명해 줘
계정을 바꾸려면 /login입니다. 환경 점검은 claude doctor입니다.
자주 나는 오류
1. command not found: claude
대부분 PATH입니다. 네이티브 설치는 ~/.local/bin(Windows는 %USERPROFILE%\.local\bin)에 실행 파일을 둡니다. 셸 설정에 그 경로를 넣고 터미널을 다시 엽니다.
2. npm EACCES
sudo npm install -g는 공식 문서가 권하지 않습니다. 권한 문제와 보안 위험이 있습니다. 전역 경로를 사용자 폴더로 바꾸거나 네이티브 설치로 바꾸는 편이 낫습니다.
npm uninstall -g @anthropic-ai/claude-code
curl -fsSL https://claude.ai/install.sh | bash
3. Windows에서 Git Bash를 찾을 수 없음
CLI에서 Git for Windows를 설치했거나, Desktop Code 탭을 쓰는 중인지를 먼저 가릅니다. CLI만 쓴다면 Git 없이 PowerShell 도구로도 동작합니다. Desktop이면 Git for Windows를 설치하고 앱을 다시 시작합니다.
업데이트와 삭제
네이티브 설치는 실행 중 백그라운드에서 새 버전을 받습니다. 채널은 latest(기본)와 stable(약 일주일 지연)입니다. 수동은 claude update입니다.
Homebrew와 WinGet은 기본이 수동 업데이트입니다.
brew upgrade claude-code
winget upgrade Anthropic.ClaudeCode
선택적으로 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1을 주면 Claude Code가 Homebrew/WinGet 업그레이드를 대신 실행합니다. apt/dnf/apk는 계속 수동입니다.
삭제는 설치 방식별로 다릅니다. 네이티브는 ~/.local/bin/claude와 ~/.local/share/claude를 지웁니다. 설정 폴더 ~/.claude를 지우면 세션 기록도 사라집니다.
자주 묻는 질문
무료로 쓸 수 있나요?
이 글을 확인한 시점의 공식 문서는 유료 구독 또는 Console/서드파티 API가 필요하다고 합니다. 무료 플랜 포함 여부는 요금 페이지를 다시 여십시오.
Node.js를 꼭 설치해야 하나요?
네이티브·Homebrew·WinGet은 필요 없습니다. npm만 Node가 필요합니다.
VS Code나 Cursor 안에서도 쓸 수 있나요?
가능합니다. 마켓플레이스에서 Claude Code 확장을 설치합니다. Cursor는 VS Code 기반이라 같은 확장을 씁니다. 터미널 설치와 병행할 수 있습니다. Desktop 앱은 CLI를 따로 설치하지 않아도 Code 탭을 씁니다.
회사 컴퓨터라 브라우저 로그인이 막혀 있습니다
Console API 키를 환경 변수로 넣는 방법이 있습니다. 키 값은 채팅이나 저장소에 올리지 마십시오.
다음 단계
- Claude Code 사용법
- 가격과 요금제
- 비용 계산기
- 강의 안내는 홈과 수강료