Claude Code 설치 및 실행 (Windows 환경)

Claude Code는 기본적으로 터미널(CLI) 기반 도구이며, Windows에서는 네이티브 설치가 가능합니다.

 

 

1. 사전 준비물 (Prerequisites)

 

Git for Windows 

(Git Bash 포함)

 

 

Anthropic API Key -> Claude Pro/Max 구독

: Anthropic Console에서 발급받은 키가 필요합니다.

Claude Pro/Max 구독 시, API 키 입력 불필요. (더 저렴)
CLI 콘솔에서 로그인

 

 

Node.js

: 버전 18 이상이 필요합니다. (20 이상 권장)

공식 Anthropic 네이티브 인스톨러를 사용하면 Node.js 없이 설치 가능합니다.
PowerShell 5.1+ 또는 PowerShell 7.x에서 공식 인스톨러 명령어를 실행하면 자동으로 ~/.local/bin에 설치됩니다.

 

 

2. 설치 단계

 

Git for Windows 

 

PowerShell을 관리자 권한으로 열기
(Win 키 → "PowerShell" 검색 → 관리자 권한으로 실행)

 

# winget으로 설치
winget install --id Git.Git -e --source winget

 

 

현재 열려 있는 모든 PowerShell 창을 닫고 새로 열기

# 버전 확인
git --version

# 줄바꿈 설정
git config --global core.autocrlf true
# 줄바꿈 설정 확인 (true -> 정상)
git config --global core.autocrlf

# 
Git 기본 정보 설정 (최초 1회)
git config --global user.name "이름입력"
git config --global user.email "이메일입력"

 

 

Claude Code 설치 (네이티브 방식)

 

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

# PATH에 경로 등록
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")

 

설치가 끝나면 PowerShell 창을 닫고 다시 열어야 claude 명령어가 인식

 

# 설치 확인
claude --version

# (로그인)
claude login

 

(우선 테마 선택)

브라우저에서 claude.ai 계정으로 로그인

 

설치 상태 최종 확인
로그인 후, 모든 인프라(Git, Node, Claude 환경)가 완벽한지 확인하기 위해 아래 명령어를 입력합니다.

claude doctor

모든 항목에 초록색 체크표시가 뜨면 정상

 

 

프로젝트 폴더 생성 및 이동 (중요!)

Claude Code는 현재 디렉토리(폴더) 를 기반으로 코드베이스를 읽고 작업합니다.
새로운 프로젝트 코드를 작업할 거라면 그 폴더로 이동하세요.

mkdir ~\Desktop\Projects\my-project
cd ~\Desktop\Projects\my-project

 

claude 실행 (Powershell)

claude

 

실행 후 ">" 프롬프트가 뜨면, 자연어 명령어(한글)로 작업 실행 가능

 

 

3. TroubleShooting

 

줄 넘김 깨짐 현상 fix

 

Windows 환경에서는 claude cli 화면에서 줄넘김 환경차이로 인해 화면 깨짐이 발생할 가능성이 높다.

Windows Terminal 앱을 이용하면 가장 안정적으로 표현된다.

 

설치 및 실행

winget install Microsoft.WindowsTerminal

Win + S 누름 → '터미널' 검색 후 실행.

(powershell 모드로 cluade 실행)

pwsh
claude

 

맨 우측이 Windows Terminal 앱의 아이콘이다. (비슷해 보여도 다름!)