Claude Code 설치하기: Windows PowerShell 편
PowerShell과 CMD를 구분하고 Windows용 공식 명령으로 설치한 뒤 실행을 확인합니다.
이 글은 어떤 창을 사용하나요?
Windows PowerShell에서 진행합니다. CMD, Git Bash, WSL용 명령과 섞지 않습니다. 지원되는 Windows 버전과 시스템 종류는 공식 요구 사항에서 먼저 확인합니다.
회사 PC의 설치 제한이 있다면 관리자의 안내를 따르세요. 설치할 수 없는 상태를 해결하려고 보안 정책을 임의로 낮추지는 않습니다.
1. PowerShell에서 설치하기
- 시작 메뉴에서 PowerShell을 검색합니다.
- 일반 PowerShell을 엽니다. 입력 줄 앞에
PS가 있는지 확인하세요. - 다음 한 줄의 주소를 확인합니다. 공식 설치 스크립트를 내려받아 실행하는 명령입니다.
irm https://claude.ai/install.ps1 | iex
- Enter를 누르고 완료 안내를 기다립니다. 진행 표시가 없다고 여러 번 실행하지 않습니다.
- 설치가 끝나면 PowerShell을 새로 엽니다.
Git for Windows는 무엇인가요?
Git for Windows는 Bash 도구 사용을 위해 공식 안내에서 권장하는 선택 사항입니다. 현재 공식 문서에서는 Git Bash가 없을 때 PowerShell을 사용하는 경로도 설명합니다. 오래된 글의 “Git·WSL이 무조건 먼저 필요하다”는 안내와 구분하세요. 필요하다면 공식 Git 다운로드에서 설치하고, 설정을 이해하기 어려우면 별도 안내를 확인합니다.
2. 버전 확인과 실행
새 PowerShell 창에서 다음을 실행합니다.
claude --version
버전 번호가 나오면 프로그램을 찾을 수 있는 상태입니다. 미리 만든 실습 폴더로 이동합니다.
cd ~
cd code6office-practice
claude
로그인 안내가 나오면 로그인·첫 대화로 이동합니다. 프로그램 실행과 계정 이용 권한 확인은 서로 다른 단계입니다.
오류를 이렇게 구분하세요
irm을 인식하지 못함: CMD 등 다른 창에 입력했는지 확인합니다.claude를 인식하지 못함: 새 PowerShell에서도 같은지 확인한 뒤 PATH 안내를 읽습니다.- 스크립트 실행 정책 오류: 오류 원문과 실제 실행 명령을 확인합니다. 모든 사용자의 실행 정책을 느슨하게 바꾸는 명령을 바로 실행하지 않습니다.
- 권한 또는 설치 중 파일 사용 오류: 관련 설치 창을 여러 개 열었는지 확인하고 공식 문제 해결의 같은 오류 항목을 찾습니다.
완료 기준: PowerShell에서 버전이 나오고 실습 폴더 안에서 실행됩니다. 이 사이트는 해당 Windows 환경에서의 실제 설치를 대행하거나 모든 PC의 설치 결과를 검증한 것은 아닙니다.