Claude Code 시작하기

Windows 환경에서 Claude Code를 설치하고 실행하는 완벽 가이드

Step 1Node.js 준비하기

Claude Code는 Node.js 환경에서 작동합니다. 가장 쉬운 방법은 Windows 터미널(PowerShell)을 관리자 권한으로 열고 아래 명령어를 입력하는 것입니다.

winget install OpenJS.NodeJS.LTS
참고: 설치가 완료되면, 환경 변수 적용을 위해 열려있는 모든 터미널 창을 껐다가 다시 켜주세요.

Step 2Git 설치하기 (선택 사항)

Claude Code는 프로젝트(Repository)의 변경 사항이나 버전 관리를 돕기 위해 Git을 필요로 합니다. 터미널(PowerShell)에서 다음 명령어로 Git을 설치할 수 있습니다.

winget install Git.Git

Step 3Python 설치하기 (선택 사항)

Claude Code가 복잡한 스크립트 작성이나 데이터 처리를 돕기 위해 Python 환경을 요구할 수 있습니다. 아래 명령어로 최신 Python(3.12 기준)을 설치할 수 있습니다.

winget install Python.Python.3.12
참고: 언어 및 환경(Node.js, Git, Python) 설치가 모두 완료되면, 시스템에 터미널 환경 변수가 정상적으로 등록되도록 **열려있는 모든 터미널 창(PowerShell)을 닫고 다시 실행**해 주세요.

Step 4Claude Code 전역 설치

터미널(PowerShell 등)을 열고 npm을 사용하여 Claude Code를 전역 공간에 설치합니다.

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

Step 5PowerShell 실행 정책 변경 (Windows 전용)

설치 후 claude 명령어 입력 시 PSSecurityException 스크립 실행 권한 오류가 발생한다면, PowerShell의 실행 정책을 변경해야 합니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
참고: 위 명령어는 현재 로그인한 사용자에 한해 로컬 스크립트 실행을 허용하도록 설정하여 권한 문제를 해결합니다.

Step 6실행 및 로그인

이제 터미널에서 아래 명령어를 입력하여 Claude Code를 시작할 수 있습니다. 초기 실행 시 브라우저가 열리며 Anthropic 콘솔을 통한 로그인이 진행됩니다.

claude