클로드 코드 윈도우 설치 방법: PowerShell 한 줄이면 끝

"클로드 코드 설치"를 검색하면 방법이 여러 갈래로 나옵니다. npm으로 깔라는 글, WSL을 먼저 설치하라는 글, 공식 스크립트를 쓰라는 글이 섞여 있습니다. 결론부터 말하면 윈도우에서는 PowerShell에 아래 한 줄이면 끝입니다.

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

그런데 명령어를 치기 전에 반드시 확인할 게 하나 있습니다. Claude Code(클로드 코드)는 무료 플랜으로는 쓸 수 없습니다. 설치는 되지만 로그인 단계에서 막힙니다. 이 이야기부터 먼저 하고 설치로 넘어가겠습니다.

터미널을 한 번도 안 열어보셨어도 괜찮습니다. 이 글은 다섯 단계를 그대로 따라 하도록 만들었습니다. PowerShell 실행, 설치 명령어 입력, 설치 확인, 로그인, 첫 부탁까지입니다. 단계마다 "이렇게 보이면 성공"을 적어 두었으니 화면과 비교하며 내려가시면 됩니다. 설치 명령어는 유통기한이 짧은 정보라 막히면 공식 문서를 한 번 더 확인해 보세요.

Claude Code

Claude Code란 터미널에서 말로 일을 시키는 Anthropic(앤트로픽)의 AI 도구입니다. 내 컴퓨터 안의 파일을 직접 읽고 정리하고 고쳐 줍니다.

요금: 무료 플랜 불가, Pro 이상 필요

먼저 짚고 갑니다. 이 부분에서 헛걸음하는 분이 많습니다.

공식 문서는 이렇게 못 박습니다. Claude Code는 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 Claude.ai 플랜에는 Claude Code 접근이 포함되지 않습니다. 브라우저에서 claude.ai에 무료로 로그인해 대화하던 것과는 다른 이야기입니다.

여기서 헷갈리기 쉬운 지점이 있습니다. 설치 자체는 무료 계정이어도 됩니다. 명령어는 잘 돌아가고 claude --version도 정상으로 뜹니다.

막히는 건 그다음, 로그인해서 실제로 일을 시키려는 순간입니다. 설치가 됐다고 해서 쓸 수 있다는 뜻은 아닙니다.

같은 계열 도구인 Codex CLI(코덱스 CLI)도 무료 플랜에서는 쓸 수 없습니다. OpenAI 요금표에 Plus 플랜부터 올라 있습니다.

두 도구의 진입선은 월 20달러로 같습니다. 무료로 먼저 겪어 보고 싶다면 무료 사용량이 있는 Antigravity CLI(안티그래비티 CLI) 쪽이 문턱이 낮습니다.

준비물: 유료 구독과 윈도우 10 1809 이상

준비물은 세 가지입니다. 어느 하나라도 안 맞으면 설치가 막히니 먼저 훑어 두세요.

두 번째 줄에 조건이 하나 더 붙습니다. 64비트 윈도우여야 합니다. 32비트는 설치 스크립트가 아예 거부합니다. 요즘 나온 PC는 대부분 64비트지만 오래된 사무용 PC라면 같은 정보 화면의 시스템 종류에서 미리 확인해 두세요.

관리자 권한은 필요 없습니다. Claude Code는 내 계정 폴더 안에 설치되기 때문입니다. 회사 PC라 관리자 권한이 없는 경우에도 대개 설치가 됩니다.

회사 보안 정책이 걱정된다면 하나는 덜어도 됩니다. 공식 문서는 이 글에서 쓰는 irm | iex 방식이 PowerShell 실행 정책의 제한을 받지 않는다고 밝힙니다. 실행 정책은 .ps1 파일에 걸리는데 이 명령어는 파일로 저장하지 않고 받은 내용을 곧바로 실행하기 때문입니다.

맥을 쓰고 계시다면 설치 명령어가 다릅니다. 맥 명령어는 아래 FAQ에 적어 두었습니다.

스텝 1: PowerShell 실행

윈도우 11이면 시작 버튼을 마우스 오른쪽 버튼으로 클릭하고 「터미널」을 선택합니다.

윈도우 10이면 시작 메뉴 검색창에 PowerShell을 입력하고 「Windows PowerShell」을 실행합니다. 우클릭 메뉴에 「터미널」이 없는 것이 정상입니다.

이렇게 보이면 성공입니다. 까만(또는 파란) 창이 뜨고 프롬프트가 PS C:\Users\내이름>처럼 PS로 시작합니다. 이 창이 오늘의 작업대입니다.

이 PS 두 글자는 꼭 확인하고 넘어가세요. 윈도우에는 비슷하게 생긴 까만 창이 두 종류 있습니다. PowerShell과 명령 프롬프트(CMD)입니다.

둘은 알아듣는 명령어가 다릅니다. PS가 있으면 PowerShell, 없이 C:\Users\내이름>으로 시작하면 명령 프롬프트입니다. 이 글은 PowerShell 기준입니다.

잘못된 창을 열면 다음 단계에서 에러가 납니다. 그 에러를 알아보는 법은 아래 「막히면 여기부터」에 정리해 두었습니다.

스텝 2: 설치 명령어 입력

아래 한 줄을 그대로 복사해 PowerShell 창에 붙여넣고 Enter를 누릅니다.

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

짧아 보여도 하는 일은 두 가지입니다. irm이 Anthropic의 공식 설치 스크립트를 내려받습니다. 그다음 iex가 그걸 실행합니다.

스크립트는 이런 순서로 움직입니다. 먼저 내 PC가 64비트인지 확인합니다. 그다음 최신 버전 정보를 받아 와 그에 맞는 파일을 내려받습니다.

마지막으로 받은 파일이 진짜 Anthropic이 배포한 것인지 체크섬으로 대조합니다. 그 확인을 통과해야 설치로 넘어갑니다. 택배를 받으면 송장 번호를 대조해 보고 뜯는 것과 같습니다.

설치가 끝나면 어느 창에서든 claude라고만 쳐도 실행되도록 위치 등록(PATH 등록)까지 스크립트가 처리합니다. 본체는 내 계정 폴더 아래 .local\share\claude에 들어가고, 실행 파일은 .local\bin\claude.exe에 생깁니다.

이렇게 보이면 성공입니다. Setting up Claude Code...라는 줄이 지나간 뒤 아래 안내가 뜹니다.

✅ Installation complete!

진행률 막대는 나오지 않으니 화면이 잠시 조용해도 정상입니다. 바탕화면이나 시작 메뉴에 아이콘은 생기지 않습니다. 터미널에서만 쓰는 도구라 원래 없습니다.

다만 오래 조용하면 백신 때문일 수 있습니다. 윈도우 디펜더의 실시간 검사가 다운로드 속도를 초당 0.3메가바이트까지 떨어뜨린 사례가 보고돼 있습니다. 300메가바이트를 이 속도로 받으면 십수 분이 걸립니다.

10분까지는 정상 범위로 보고 기다립니다. 오류 문구 없이 조용하기만 하다면 창을 닫지 마세요. 오류가 떴다면 아래 「막히면 여기부터」로 가시면 됩니다.

스텝 3: 새 창에서 설치 확인

지금 열려 있는 PowerShell 창을 완전히 닫고 스텝 1과 같은 방법으로 새 창을 엽니다. 방금 한 위치 등록이 새로 여는 창부터 적용되기 때문입니다. 새 창에 아래를 입력합니다.

claude --version

이렇게 보이면 성공입니다.

2.1.238 (Claude Code)

버전 숫자는 설치 시점마다 다릅니다. 숫자는 달라도 괜찮습니다. 괄호 안에 Claude Code라는 문구가 뜨면 설치는 정상입니다.

버전 이야기가 나온 김에 하나 덧붙이면, Claude Code는 업데이트를 따로 챙길 필요가 없습니다. 공식 스크립트로 깔면 백그라운드에서 알아서 최신 버전으로 올라갑니다.

스텝 4: Claude 계정 로그인

같은 창에 이번엔 이렇게만 입력합니다.

claude

브라우저가 자동으로 열립니다. 평소 쓰는 Claude 계정으로 로그인하면 창이 다시 PowerShell로 이어집니다. 한 번 로그인하면 컴퓨터에 저장되니 다음부터는 이 단계가 없습니다.

여기가 앞에서 말한 갈림길입니다. 무료 계정으로 로그인하면 이 지점에서 막힙니다. 구독이 없다면 claude.ai에서 Pro 이상으로 올린 뒤 다시 시도하시면 됩니다.

이렇게 보이면 성공입니다. PowerShell 창 안에 아래처럼 입력줄이 생기고 커서가 깜박입니다.

> 

까만 창에 명령을 치던 화면에서 말을 걸 수 있는 화면으로 바뀐 것입니다.

스텝 5: 첫 부탁 한 문장

입력창에 코드가 아니라 그냥 말을 적으면 됩니다. 이렇게 물어보세요.

이 폴더에 어떤 파일이 있는지 정리해 줘

여기서 말하는 「이 폴더」는 지금 창이 열려 있는 곳입니다. 시작 메뉴에서 그냥 열었다면 내 계정 폴더(C:\Users\내이름)입니다. 다른 폴더에서 쓰고 싶으면 Claude를 끄고 cd 폴더경로로 옮긴 뒤 다시 실행하면 됩니다.

이렇게 보이면 성공입니다. 파일 이름 목록이 나오고 그 아래에 무슨 파일인지 정리한 설명이 붙습니다. 여기까지 오셨으면 오늘 할 일은 끝났습니다.

터미널 환경 자체를 기초부터 쌓고 싶으시면 AI CLI 트랙이 여섯 편으로 준비돼 있습니다.

막히면 여기부터: 오류 메시지별 대처

화면에 뜬 문구와 같은 줄을 찾아 그 아래만 보시면 됩니다.

'irm' is not recognized as an internal or external command이 뜹니다. 창을 잘못 여셨습니다. PowerShell이 아니라 명령 프롬프트(CMD)에 명령어를 치신 겁니다. 스텝 1로 돌아가 프롬프트가 PS로 시작하는 창을 여시면 됩니다.

굳이 명령 프롬프트에서 설치하고 싶다면 명령어가 아래로 바뀝니다.

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

The token '&&' is not a valid statement separator가 뜹니다. 반대 경우입니다. 명령 프롬프트용 명령어를 PowerShell에 치신 겁니다. 위쪽의 irm 한 줄로 바꿔 실행하시면 됩니다.

claude를 쳤는데 명령을 찾을 수 없다고 나옵니다. 대부분 창 때문입니다. 위치 등록은 새로 여는 창부터 적용되므로 설치할 때 쓰던 창에서는 못 찾습니다. PowerShell을 완전히 닫고 새 창을 열어 다시 쳐보세요.

설치 중 The process cannot access the file이 뜹니다. 이전 설치 시도가 아직 끝나지 않았거나 백신이 다운로드 폴더를 검사하고 있는 경우입니다.

열려 있는 PowerShell 창을 모두 닫고 백신 검사가 끝나길 잠시 기다립니다. 그다음 %USERPROFILE%\.claude\downloads 폴더를 지우고 설치 명령어를 다시 실행하면 해결됩니다.

32비트라 설치가 거부됩니다. Claude Code는 64비트 윈도우만 지원합니다. 설정에서 시스템, 정보 순으로 들어가 시스템 종류를 확인해 보세요.

시스템 종류가 64비트인데도 이 오류가 난다면 Windows PowerShell (x86)을 연 것입니다. 시작 메뉴에는 Windows PowerShell과 Windows PowerShell (x86)이 따로 있습니다. 뒤쪽은 PC가 64비트여도 32비트로 동작합니다. (x86)이 없는 쪽을 새로 열어 다시 시도하세요.

로그인이 안 되고 계정이 거부됩니다. 무료 플랜일 가능성이 큽니다. Claude Code는 Pro 이상 구독이 필요합니다.

원인을 모르겠습니다. claude doctor를 치면 설치 상태를 점검해 줍니다. 세션을 시작하지 않고 진단만 출력하므로 부담 없이 쳐도 됩니다. 설치 방식, 버전, 자동 업데이트 상태, 그리고 문제가 있으면 그 원인과 해결 방법까지 같이 알려 줍니다.