Windows에 Claude Code 설치하기 — 실제 쓰는 머신 기준 5분 가이드

설치하는 로봇 캐릭터 (GPT 이미지 생성)

이 글은 이론이 아니다. 지금 이 블로그를 만들고 있는 Windows 11 머신에 실제로 설치돼 돌아가는 구성 그대로를, 공식 문서와 교차 확인해 정리했다. (이 머신: Windows 11, Claude Code 2.1.229, winget 설치)

결론 요약

제일 간단한 방법: PowerShell 한 줄 — irm https://claude.ai/install.ps1 | iex (공식 권장, 자동 업데이트)
시작 전 필요한 것: Claude 유료 플랜(Pro 이상) — 무료 계정으로는 못 쓴다
설치 후: 터미널 재시작 → claude 실행 → 브라우저 로그인. 끝

📋 0. 시작 전 체크리스트

항목	요구사항
OS	Windows 10 1809 이상 (이 글은 Windows 11에서 검증)
메모리	4GB 이상
계정	Claude Pro/Max/Team/Enterprise 또는 API Console 계정 — 무료 플랜 불가
Git for Windows	선택 (권장 — 설치하면 Bash 명령을 더 잘 다룬다)
Node.js	필요 없음 (npm 방식으로 설치할 때만 필요)

아직 플랜을 안 골랐다면: ChatGPT Plus vs Claude Pro 비교

⚙️ 1. 설치 — 방법 4가지 중 하나만

30초 안에 고르자. 고민되면 A다.

설치 방법 선택 가이드 (직접 제작)

방법 A. PowerShell 한 줄 (공식 권장)

PowerShell을 열고:

irm https://claude.ai/install.ps1 | iex

자동 백그라운드 업데이트까지 해줘서 이후 신경 쓸 게 없다. irm is not recognized 오류가 나면 CMD에서 실행한 것이다 — PowerShell에서 다시 하자.

방법 B. winget (내가 쓰는 방법)

winget install Anthropic.ClaudeCode

이 머신이 이 방법으로 설치돼 있다. 단점 하나: 업데이트가 자동이 아니라서 가끔 winget upgrade Anthropic.ClaudeCode를 직접 돌려야 한다.

방법 C. CMD 파

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

방법 D. npm (Node.js 22+ 있는 개발자)

npm install -g @anthropic-ai/claude-code

뭘 고를까? 고민되면 A. 이미 winget으로 프로그램을 관리하고 있다면 B.

🔑 2. 설치 확인과 첫 로그인

새 터미널을 열고(중요 — 기존 터미널은 PATH를 모른다):

claude --version

버전이 찍히면 성공이다. 이 머신에서는 2.1.229 (Claude Code)가 나온다. 이제 작업할 폴더로 이동해서:

cd 내-프로젝트-폴더
claude

첫 실행 시 브라우저가 열리며 Claude 계정 로그인(OAuth)을 요청한다. API 키를 발급받거나 환경변수를 만질 필요 없다 — 로그인 한 번이면 끝. 실제로 뜨는 화면은 이렇다:

첫 실행 시 열리는 로그인 화면 — 상단에 Claude Code 안내 배너가 보인다 (직접 캡처)

🧩 3. VS Code에서 쓰려면

VS Code(1.94.0+) 마켓플레이스에서 “Claude Code” 확장을 설치하면 에디터 안에서 바로 쓸 수 있다. 지금 이 글도 그 환경에서 작성되고 있다.

🚑 4. 안 될 때 — Windows에서 흔한 문제 3가지

① 'claude' is not recognized — 십중팔구 PATH 문제거나 터미널을 재시작 안 한 것.

# 사용자 PATH에 설치 경로 추가
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

추가 후 터미널을 완전히 닫고 새로 열자.

② irm is not recognized / && is not valid — PowerShell 명령을 CMD에서(또는 그 반대로) 실행한 것. 방법 A는 PowerShell, 방법 C는 CMD 전용이다.

③ TLS/SSL 연결 오류 — 오래된 환경에서 TLS 1.2가 꺼져 있는 경우:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

🚀 5. 설치 다음은?

설치는 시작일 뿐이다. 실제로 일을 시키는 방법은 다음 편에 정리했다: Claude Code 사용법 — 설치 다음에 알아야 할 것 전부 · 이 도구로 뭘 할 수 있는지 궁금하다면, AI에게 블로그 운영 시스템 전체를 맡긴 기록: 바이브 코딩이 뭐길래

공식 문서 기준: code.claude.com/docs (setup, authentication, vs-code, troubleshoot-install — 2026-09-05 확인). 설치 방식은 바뀔 수 있으니 문제가 생기면 공식 문서를 함께 확인하자. 다이어그램은 직접 제작, 캐릭터 삽화는 GPT 이미지 생성입니다.