Claude Code 설치
PowerShell에서 Claude Code를 설치하고 확인합니다
이제 바이브코딩의 핵심 도구인 Claude Code를 설치합니다. Windows에서는 PowerShell 명령어 한 줄로 간편하게 설치할 수 있습니다.
설치 전 확인
Claude Code를 설치하려면 앞서 설치한 도구들이 필요합니다:
| 도구 | 확인 명령어 | 최소 버전 |
|---|---|---|
| Git | git --version | 2.x 이상 |
| Node.js | node --version | 18.x 이상 (npm 설치 시에만 필요) |
네이티브 설치는 Node.js가 필요 없습니다
권장하는 네이티브 설치(irm ... | iex)는 Node.js 없이도 동작합니다.
단, Next.js 프로젝트를 만들고 실행하려면 Node.js가 여전히 필요하므로 이전 챕터에서 설치한 Node.js를 유지하세요.
네이티브 설치 (권장)
PowerShell을 열고 아래 명령어를 입력합니다:
irm https://claude.ai/install.ps1 | iex이 명령어는 Claude Code 설치 스크립트를 다운로드하고 자동으로 실행합니다.
명령어 설명
irm: Invoke-RestMethod의 약어. 웹에서 스크립트를 다운로드합니다iex: Invoke-Expression의 약어. 다운로드한 스크립트를 실행합니다
ExecutionPolicy 오류가 발생할 때
아래와 같은 오류가 나타날 수 있습니다:
이 시스템에서 스크립트를 실행할 수 없습니다...이 경우 PowerShell을 관리자 권한으로 열고 다음 명령어를 먼저 실행합니다:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned확인 메시지가 나오면 Y를 입력하고 Enter를 누릅니다. 그 다음 설치 명령어를 다시 실행합니다:
irm https://claude.ai/install.ps1 | iexnpm으로 설치하기 (비권장)
네이티브 설치가 안 될 경우 npm으로도 설치할 수 있습니다. 단, npm 방식은 공식적으로 deprecated(지원 중단 예정)되었으므로 가능하면 네이티브 설치를 사용하세요.
npm install -g @anthropic-ai/claude-code네이티브 설치 vs npm 설치
네이티브 설치는 Node.js 없이도 동작하며, 백그라운드에서 자동 업데이트됩니다.
npm 설치는 별도로 npm update -g @anthropic-ai/claude-code를 실행해야 합니다.
설치 확인
PowerShell을 새로 열고 아래 명령어를 입력합니다:
claude --version버전 번호가 표시되면 정상적으로 설치된 것입니다.
PATH 문제 해결
claude 명령어를 찾을 수 없다고 나오면, 환경 변수 PATH에 Claude Code 경로가 추가되지 않은 것입니다.
PowerShell 재시작
현재 PowerShell을 닫고 새로 엽니다.
컴퓨터 재시작
새 PowerShell에서도 안 되면 컴퓨터를 재시작합니다.
수동 PATH 추가
그래도 안 되면 환경 변수를 수동으로 설정합니다:
Win + S로 검색을 열고 **"환경 변수"**를 입력합니다- **"시스템 환경 변수 편집"**을 클릭합니다
- 환경 변수 버튼을 클릭합니다
- 사용자 변수에서
Path를 선택하고 편집을 클릭합니다 - Claude Code가 설치된 경로를 추가합니다 (보통
%USERPROFILE%\.local\bin또는%USERPROFILE%\.claude\bin)
PowerShell 도구 opt-in (v2.1.78+)
Claude Code v2.1.78부터 Windows에서 PowerShell 도구 opt-in 프리뷰가 추가되었습니다. 기본적으로 Claude Code는 Git Bash를 통해 명령어를 실행하지만, PowerShell을 직접 사용하도록 전환할 수 있습니다.
claude config set preferredShell powershellPowerShell 도구는 프리뷰 단계입니다
아직 프리뷰 기능이므로, 일부 명령어에서 예상과 다른 동작이 발생할 수 있습니다. 문제가 생기면 다시 Git Bash로 되돌리세요:
claude config set preferredShell bashclaude doctor로 점검
설치가 완료되면 아래 명령어로 환경을 점검할 수 있습니다:
claude doctor모든 항목에 체크 표시가 나오면 정상입니다. 문제가 있는 항목이 있다면 해당 항목의 안내를 따라 해결합니다.