Claude Code 설치
PowerShell 한 줄 네이티브 설치(irm install.ps1)로 Claude Code를 설치하고, ExecutionPolicy·PATH 문제를 해결하며 claude doctor로 환경을 점검합니다.
핵심 요약
- 권장 방식은 PowerShell에서
irm https://claude.ai/install.ps1 | iex로 실행하는 네이티브 설치이며, Node.js 없이도 동작하고 자동 업데이트됩니다. - 스크립트 오류가 있을 때만
Get-ExecutionPolicy -List로 확인하고, 필요하면 현재 Process에 한정해 조정합니다. - npm 설치도 자동 업데이트를 지원합니다. global 디렉터리 권한 때문에 실패하면
claude doctor안내로 원인을 확인합니다. claude --version이 인식되지 않으면 PowerShell 재시작·재부팅 후%USERPROFILE%\.local\bin을 PATH에 수동 추가합니다.- 설치 후
claude doctor로 환경을 점검하고, Git Bash 경로 문제가 있으면CLAUDE_CODE_GIT_BASH_PATH로 지정합니다.
2026-10-23 확인
공식 Changelog 기준 Claude Code는 2.1.308이며 latest·stable·next가 같습니다. 설치한 버전은
claude --version으로 확인합니다. Node.js는 Next.js 실행용이고 native Claude Code 자체의 필수 조건은 아닙니다.
이제 바이브코딩의 핵심 도구인 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 오류가 발생할 때
아래와 같은 오류가 나타날 수 있습니다:
이 시스템에서 스크립트를 실행할 수 없습니다...먼저 적용 정책을 확인합니다.
Get-ExecutionPolicy -List조직 관리 정책이면 허용된 설치 경로를 사용합니다. 개인 PC에서 필요한 경우에만 다음처럼 현재 PowerShell 창에 한정합니다. 창을 닫으면 Process 범위 설정은 사라집니다:
Set-ExecutionPolicy -Scope Process -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 없이도 동작하며, 백그라운드에서 자동 업데이트됩니다.
현재 공식 문서는 native·npm 설치의 자동 업데이트를 모두 안내합니다. npm global 경로가 쓰기 불가라면 자동 갱신이 실패할 수 있어 claude doctor로 확인합니다.
설치 확인
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·CMD·Bash·Zsh를 지원 셸로 안내하며 Git for Windows를 선택 의존성으로 설명합니다. Bash·Monitor 도구에는 Git Bash가 필요합니다. Claude를 시작한 터미널과 내부 실행 도구의 셸을 구분하고 기본값을 유지하세요.
claude doctor로 점검
설치가 완료되면 아래 명령어로 환경을 점검할 수 있습니다:
claude doctor모든 항목에 체크 표시가 나오면 정상입니다. 문제가 있는 항목이 있다면 해당 항목의 안내를 따라 해결합니다.