클로드 코드 윈도우에서 네이티브 설치하는 방법 (cmd, 파워쉘, 환경 변수 설정)

클로드 코드 윈도우 설치는 파워쉘에서 irm https://claude.ai/install.ps1 | iex 명령 한 줄과 설치 후 인증을 위한 브라우저 로그인 한 번으로 끝납니다.

예전에는 Node.js와 Git을 먼저 설치하고 npm install -g @anthropic-ai/claude-code로 패키지를 받아야 했지만, 지금은 네이티브 설치 스크립트가 실행 파일을 직접 내려받아 Node.js 없이 동작합니다.

설치 직후 claude 명령어가 인식되지 않는 경우가 있습니다. 이때는 설치 위치인 %USERPROFILE%.local\bin 경로가 PATH 환경 변수에 등록됐는지 확인해야 합니다.

명령 프롬프트(CMD)를 위주로 쓰는 사용자는 파워쉘 전용 명령 대신 install.cmd 방식을 실행하며, 두 방법 모두 같은 실행 파일을 설치합니다.

이 글에서는 파워쉘과 CMD 네이티브 설치 명령어, claude 명령어가 인식되지 않을 때 세션 PATH로 확인하는 방법, 윈도우 환경 변수에 설치 경로를 영구 등록하는 방법을 정리합니다.

1. 파워쉘 한 줄 명령으로 윈도우에 클로드 코드 설치하기

가장 빠른 설치 방식이며 관리자 권한 없이 실행됩니다. 네이티브 설치 스크립트가 윈도우 아키텍처(x64, ARM64)를 감지해 알맞은 실행 파일을 내려받습니다.

클로드 코드를 설치하려면, 파워쉘에 다음 명령을 입력합니다.

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

irm은 파워쉘의 Invoke-RestMethod 명령으로 스크립트를 내려받고, iex(Invoke-Expression)가 그 스크립트를 실행합니다.

설치가 끝나면 실행 파일이 %USERPROFILE%\.local\bin\claude.exe에 위치합니다.

다만 네이티브 설치는 이 경로를 PATH 환경 변수에 자동으로 등록하지 않아, 설치 직후 claude를 입력해도 “claude : ‘claude’ 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.” 오류가 발생합니다.

설치가 정상적으로 끝났는지 확인하려면, 파워쉘에 다음 명령을 입력합니다.

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

True가 출력되면 실행 파일이 제자리에 설치된 것이고, 남은 작업은 이 경로를 PATH 환경 변수에 등록하는 것뿐입니다. False가 나오면 설치가 완료되지 않은 상태이므로 설치 명령을 다시 실행합니다.

설치가 정상 완료되었으면 이후 백그라운드에서 자동으로 최신 버전으로 업데이트됩니다.

2. CMD에서 install.cmd로 클로드 코드 설치하기

irm은 파워쉘 전용 명령이므로 명령 프롬프트(CMD)에서는 동작하지 않습니다. CMD에서는 curl로 설치 스크립트를 내려받아 실행하는 별도 명령을 사용합니다.

CMD에서 클로드 코드를 설치하려면, 다음 명령을 입력합니다.

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

이 명령은 설치 스크립트를 install.cmd 파일로 내려받아 실행한 뒤 설치 완료 후 설치 패키지를 자동으로 삭제합니다. 설치 위치는 파워쉘 방식과 같으며, 두 명령 모두 실행 파일을 %USERPROFILE%\.local\bin\claude.exe에 저장하고 환경 변수는 자동으로 등록하지 않습니다.

설치가 정상적으로 끝났는지 확인하려면, CMD에 다음 명령을 입력합니다.

if exist "%USERPROFILE%\.local\bin\claude.exe" (echo installed) else (echo missing)

installed가 출력되면 실행 파일이 제자리에 설치된 것이고, 남은 작업은 이 경로를 PATH 환경 변수에 등록하는 것뿐입니다. missing이 나오면 설치가 완료되지 않은 상태이므로 설치 명령을 다시 실행합니다.

참고 : 파워쉘에서 CMD 명령을 실행하면 The token '&&' is not a valid statement separator 오류가, CMD에서 irm을 실행하면 'irm' is not recognized as an internal or external command 오류가 나타납니다.

3. 윈도우 환경 변수에 클로드 코드 설치 경로 등록하기

앞 단계에서 실행 파일이 %USERPROFILE%\.local\bin에 설치된 것을 확인했다면, 남은 작업은 이 경로를 PATH 환경 변수에 등록해 터미널, cmd에서 claude 명령어를 찾게 만드는 것입니다.

열린 세션에서 임시로 등록해 즉시 확인하기

영구 등록에 앞서 현재 창에서만 경로를 추가해, claude가 실행되는지 곧바로 확인합니다.

$env:PATH += ";$env:USERPROFILE\.local\bin"

이 명령은 지금 열려 있는 파워쉘 창에서만 유효하며, 터미널을 닫으면 사라집니다. 이어서 claude --version을 실행해 버전이 출력되면 경로가 올바른 것이므로, 아래 영구 등록으로 넘어갑니다.

환경 변수에 영구 등록하기

세션에 임시로 추가한 경로는 터미널을 다시 시작하면 사라지므로, 윈도우 사용자 환경 변수에 설치 경로를 직접 기록해야 매번 claude가 실행됩니다.

파워쉘에서 사용자 PATH에 경로를 영구 등록하려면, 다음 두 줄을 입력합니다.

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

첫 줄은 기존 사용자 PATH 값을 읽어 오고, 둘째 줄은 그 뒤에 설치 경로를 이어 붙여 사용자 범위(User)로 저장합니다. 시스템 전체가 아닌 사용자 계정에만 적용되므로 관리자 권한이 필요 없습니다.

클로드 코드 공식 설치 문제 해결 문서도 이 방식을 PATH 복구 명령으로 안내합니다. 등록한 뒤에는 터미널을 다시 시작해야 값이 적용됩니다.

명령어 대신 GUI 환경에서 등록하려면, 시스템 속성 > 고급 > 환경 변수 > 사용자 변수 Path > 편집 > 새로 만들기에 진입합니다.

변수 이름을 PATH, 변수 값에 %USERPROFILE%\.local\bin을 입력하고 저장한 뒤 터미널을 다시 시작합니다. CMD 사용자는 파워쉘 명령을 쓸 수 없으므로 이 환경 변수 추가 방식을 사용합니다.

4. 클로드 코드를 처음 실행하고 로그인하기

환경 변수 등록까지 마쳤으면 claude 명령이 어느 경로에서나 실행됩니다. 처음 실행하면 화면 테마와 로그인을 설정하는 초기 단계를 거친 뒤 대화형 세션이 열립니다.

작업할 프로젝트 폴더에서 첫 세션을 시작하려면, 터미널에 claude를 입력합니다.

claude

처음 실행하면 터미널 배경에 맞는 화면 테마를 고르는 화면이 나타납니다. 라이트 모드와 다크 모드, 색각 이상을 배려한 변형 가운데 방향키로 하나를 선택합니다.

테마를 고르면 로그인 단계로 넘어가면서 브라우저 창이 열립니다. 클로드 코드는 Pro, Max, Team, Enterprise 구독 계정이나 Claude Console(API 크레딧) 계정으로 로그인하며, 무료 Claude.ai 플랜으로는 로그인할 수 없습니다. 브라우저에서 인증을 마치면 자격 증명이 기기에 저장돼, 이후 실행에서는 다시 로그인하지 않아도 됩니다.

로그인한 뒤에는 현재 폴더의 파일을 신뢰할지 묻는 보안 확인이 한 번 표시됩니다. 신뢰를 선택하면 클로드 코드가 프로젝트 파일을 읽어 작업을 준비하고, 상단에 버전과 현재 모델, 작업 디렉터리가 표시된 대화 프롬프트가 열립니다. 계정을 바꾸려면 세션 안에서 /login을, 사용할 수 있는 명령을 보려면 /help를 입력합니다.

5. 클로드 코드 설치 직후 정상 동작 점검하고 오류 대응하기

설치 명령이 끝났다는 표시가 떠도, 새 터미널에서 실행되는지와 셸 도구가 연결됐는지 확인해야 실제 작업 중에 멈추지 않습니다. 아래 세 가지를 점검합니다.

• 새 터미널을 열고 claude --version을 실행해, 재시작한 창에서도 버전이 출력되는지 확인합니다. 여기서 출력되면 환경 변수 등록이 세션을 넘어 유지된 것입니다.
• claude doctor를 실행해 설치 상태, 설정 파일 오류, 가장 최근 자동 업데이트 결과를 한 화면에서 확인합니다.
• Git for Windows를 설치했다면 클로드 코드가 Git Bash로 Bash 도구를 사용하고, 설치하지 않았다면 파워쉘 도구로 셸 명령을 실행합니다. 어느 도구가 연결됐는지는 claude doctor 출력에서 확인합니다.

클로드 코드가 설치 후 실행되지 않는다면 원인은 대부분 몇 가지로 좁혀집니다. 아래 표는 클로드 코드 공식 설치 문제 해결 문서의 오류 매칭을 윈도우 설치 상황에 맞춰 증상별로 정리한 것입니다.

증상	원인	해결
설치는 끝났는데 'claude' is not recognized	설치 경로 %USERPROFILE%.local\bin이 PATH에 미등록	5번 방식으로 사용자 환경 변수에 경로를 등록하고 새 터미널을 엽니다
'irm' is not recognized as an internal or external command	CMD에서 파워쉘 전용 명령을 실행	2번의 CMD install.cmd 명령으로 다시 설치합니다
The token '&&' is not a valid statement separator	파워쉘에서 CMD 명령을 실행	1번의 파워쉘 irm https://claude.ai/install.ps1 \| iex 명령을 사용합니다
claude --version이 예전 버전을 출력	이전 npm 전역 설치본이 PATH에서 먼저 검색됨	where.exe claude로 중복 설치 위치를 찾아 제거합니다
syntax error near unexpected token '<' 또는 403 오류	프록시나 네트워크가 스크립트 대신 HTML을 반환	네트워크와 프록시 설정을 확인한 뒤 설치 명령을 다시 실행합니다
로그인 단계에서 접근이 거부됨	무료 Claude.ai 플랜으로 로그인 시도	Pro, Max, Team, Enterprise 계정으로 로그인합니다

마치며

클로드 코드 윈도우 설치의 핵심은 네이티브 스크립트 한 줄로 실행 파일을 받고, 그 실행 파일이 놓인 %USERPROFILE%\.local\bin 경로를 PATH가 찾도록 환경 변수를 등록하는 것입니다.

claude가 인식되지 않는 문제는 대부분 설치 실패가 아니라 PATH 미등록이 원인이므로, 세션에 임시로 경로를 넣어 실행 여부를 먼저 가른 뒤 환경 변수에 영구 등록하면 해결됩니다. 사용자 변수로 등록하면 관리자 권한 없이도 새 터미널마다 claude 명령이 그대로 실행됩니다.

FAQ