Claude Code 설치
PowerShell 한 줄 네이티브 설치(irm install.ps1)로 Claude Code를 설치하고, ExecutionPolicy·PATH 문제를 해결하며 claude doctor로 환경을 점검합니다.
핵심 요약
- 권장 방식은 PowerShell에서
irm https://claude.ai/install.ps1 | iex로 실행하는 네이티브 설치이며, Node.js 없이도 동작하고 자동 업데이트됩니다. - "스크립트를 실행할 수 없습니다" 오류가 나면
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned를 먼저 실행합니다. - 대체로
npm install -g @anthropic-ai/claude-code도 가능하지만, 이 경우 업데이트를 직접 해야 합니다. claude --version이 인식되지 않으면 PowerShell 재시작·재부팅 후%USERPROFILE%\.local\bin을 PATH에 수동 추가합니다.- 설치 후
claude doctor로 환경을 점검하고, Git Bash 경로 문제가 있으면CLAUDE_CODE_GIT_BASH_PATH로 지정합니다.
이제 바이브코딩의 핵심 도구인 Claude Code를 설치합니다. Windows에서는 PowerShell 명령어 한 줄이면 됩니다.
설치 전 확인
Claude Code를 설치하려면 앞서 설치한 도구들이 필요합니다:
| 도구 | 확인 명령어 | 최소 버전 |
|---|---|---|
| Git for Windows | git --version | 권장 |
| Node.js | node --version | 20.9 이상 (Next.js 실행에 필요) |
네이티브 설치는 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에서 다음 명령어를 먼저 실행합니다. -Scope CurrentUser는 현재 사용자 범위 설정입니다:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned확인 메시지가 나오면 Y를 입력하고 Enter를 누릅니다. 그 다음 설치 명령어를 다시 실행합니다:
irm https://claude.ai/install.ps1 | iexnpm으로 설치하기 (대체 방법)
네이티브 설치가 안 되면 npm으로도 설치할 수 있습니다. Claude Code 공식 문서도 npm 설치를 안내하지만, Windows 초보자라면 자동 업데이트가 되는 네이티브 설치를 먼저 권합니다.
npm install -g @anthropic-ai/claude-code네이티브 설치 vs npm 설치
네이티브 설치는 Node.js 없이도 동작하며, 백그라운드에서 자동 업데이트됩니다.
npm 설치는 별도로 npm install -g @anthropic-ai/claude-code@latest를 실행해 업데이트해야 합니다.
설치 확인
PowerShell을 새로 열고 아래 명령어를 입력합니다:
claude --version버전 번호가 표시되면 정상적으로 설치된 것입니다.
PATH 문제 해결
claude 명령어를 찾을 수 없다고 나오면 환경 변수 PATH에 Claude Code 경로가 빠진 것입니다.
PowerShell 재시작
현재 PowerShell을 닫고 새로 엽니다.
컴퓨터 재시작
새 PowerShell에서도 안 되면 컴퓨터를 재시작합니다.
수동 PATH 추가
그래도 안 되면 환경 변수를 수동으로 설정합니다:
Win + S로 검색을 열고 **"환경 변수"**를 입력합니다- **"시스템 환경 변수 편집"**을 클릭합니다
- 환경 변수 버튼을 클릭합니다
- 사용자 변수에서
Path를 선택하고 편집을 클릭합니다 - Claude Code가 설치된 경로를 추가합니다 (보통
%USERPROFILE%\.local\bin또는%USERPROFILE%\.claude\bin)
Windows에서 셸 선택 이해하기
Git for Windows가 설치되어 있으면 Claude Code는 내부 명령 실행에 Git Bash를 사용할 수 있습니다. Git Bash가 없으면 PowerShell을 사용합니다.
Git Bash를 설치했는데도 Claude Code가 찾지 못한다면 사용자 설정 파일에 경로를 직접 지정하면 됩니다:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}PowerShell 도구
공식 문서 기준 PowerShell 도구는 점진적으로 제공되는 선택 옵션입니다. 초보자는 기본값을 그대로 두고, Git Bash 관련 문제가 있을 때만 설정을 조정하세요.
claude doctor로 점검
설치가 완료되면 아래 명령어로 환경을 점검할 수 있습니다:
claude doctor모든 항목에 체크 표시가 나오면 정상입니다. 문제가 있는 항목이 있다면 해당 항목의 안내를 따라 해결합니다.