Claude Code CLI 설치하기 (Windows, 처음부터 끝까지)

시작하기 전에 준비할 것

1. Windows 10 또는 11 PC. 64비트여야 합니다. 요즘 나온 PC는 대부분 해당합니다.
2. 인터넷 연결. 설치 파일을 받고 로그인하는 데 씁니다.
3. Claude 유료 계정. Pro, Max, Team, Enterprise 중 하나입니다. 무료 계정으로는 열리지 않습니다.
4. 관리자 권한은 필요 없습니다. 설치가 내 사용자 폴더 안에서만 일어납니다. 회사 노트북에서도 대개 그대로 됩니다.

1. 터미널 열기

시작 메뉴를 열고 PowerShell을 검색해 실행합니다. 관리자 권한으로 열지 않아도 됩니다.

검은 창이 뜨고 PS C:\Users\이름> 같은 줄 뒤에 커서가 깜빡이면 제대로 여신 것입니다.

이 창이 무엇인지 몰라도 됩니다. 컴퓨터에 글자로 말을 거는 창입니다. 이 가이드에서 여기에 칠 것은 아래에 나오는 명령 세 줄뿐입니다.

2. 설치 명령 한 줄 붙여넣기

방금 연 창에 아래 한 줄을 붙여넣고 Enter를 누릅니다.

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

엔터를 누른 직후에는 방금 친 줄 하나만 보입니다. 여기서 창을 닫지 않습니다.

[화면] 엔터를 누른 직후. 여기서 창을 닫지 않습니다.

여기서 1분에서 3분쯤 아무 글자도 안 나올 수 있습니다. 설치 파일을 받아오는 중이라 정상입니다. 받아오기가 끝나면 진행 중이라는 줄이 지나갑니다.

3. 설치가 끝난 화면 확인하기

설치가 끝나면 초록색 문구가 뜹니다. 초록색 Claude Code successfully installed!과 버전, 설치된 자리가 보입니다.

버전 숫자와 설치된 자리(C:\Users\이름\.local\bin\claude.exe)가 함께 표시됩니다.

그 아래 노란 Setup notes는 오류가 아닙니다. 설치는 됐는데 컴퓨터가 아직 그 자리를 모른다는 뜻입니다. 다음 단계에서 알려 줍니다. 창을 닫지 마십시오.

4. 설치한 자리를 등록하고 확인하기

같은 창에 아래 한 줄을 붙여넣고 Enter를 누릅니다. 아무 글자도 안 나오는 것이 정상입니다.

$b="$HOME\.local\bin"; [Environment]::SetEnvironmentVariable('Path',"$([Environment]::GetEnvironmentVariable('Path','User'));$b",'User'); $env:Path="$b;$env:Path"

길어 보이지만 하는 일은 하나입니다. 방금 설치한 자리를 컴퓨터에 등록해서, 앞으로 어느 창에서든 claude 한 마디로 부를 수 있게 만듭니다. 한 번만 하면 됩니다.

이어서 아래 한 줄로 확인합니다.

claude --version

숫자와 (Claude Code)가 함께 나오면 설치가 끝난 것입니다. 버전 숫자는 계속 올라가므로 화면과 조금 달라도 괜찮습니다.

숫자 대신 빨간 글씨가 나오면 아직 자리를 못 찾은 것입니다. 위 등록 줄을 한 번 더 붙여넣습니다.

5. 작업 폴더 만들고 들어가기

바탕화면에 myfirst라는 빈 폴더를 하나 만듭니다. 영문 소문자로, 띄어쓰기 없이 씁니다.

그다음 터미널에 아래 한 줄을 붙여넣습니다.

cd $env:USERPROFILE\Desktop\myfirst

줄 앞 경로가 myfirst로 끝나면 들어간 것입니다. Claude Code는 자기를 켠 폴더만 봅니다. 이 폴더 안에서 켜면 이 폴더 안에만 파일을 만듭니다.

경로 치기가 번거로우면 cd까지만 치고 한 칸 띄운 뒤, 탐색기에서 폴더를 터미널 창으로 끌어다 놓으십시오. 경로가 저절로 적힙니다.

6. claude 실행하고 글자 색 고르기

같은 창에 아래 한 마디를 칩니다.

claude

처음 켜면 글자 색부터 고르라고 합니다. 위아래 화살표로 고르고 Enter를 누릅니다. 나중에 /theme로 바꿀 수 있으니 여기서 오래 고민하지 않아도 됩니다.

7. 로그인하기

어떤 계정으로 쓸지 묻는 화면이 이어서 나옵니다. 맨 위 Claude account with subscription이 이미 골라져 있으니 그대로 Enter를 누릅니다.

브라우저가 저절로 열리고 로그인 화면이 뜹니다. 구독 중인 계정으로 로그인합니다. 로그인이 끝나면 터미널로 돌아옵니다. 초록색 Login successful이 보이면 Enter를 누릅니다.

브라우저가 안 열리면 터미널에 긴 주소가 하나 나와 있습니다. 그 주소를 복사해 브라우저 주소창에 붙여넣으면 같은 화면이 나옵니다. 로그인은 한 번만 하면 다음부터 묻지 않습니다.

8. 안내 넘기고 폴더 신뢰하기

주의사항 두 줄이 나옵니다. Claude도 틀릴 수 있으니 결과를 사람이 확인하라는 것과, 믿을 수 있는 폴더에서만 쓰라는 것입니다. 읽고 Enter로 넘어갑니다.

이어서 이 폴더를 믿어도 되느냐고 묻습니다. Yes, I trust this folder가 이미 골라져 있습니다. 그대로 Enter를 누릅니다. 방금 내가 만든 빈 폴더이므로 1번이 맞습니다. 화살표를 내려 2번을 고르면 그 자리에서 종료되고, 그때는 claude를 다시 치면 같은 화면이 나옵니다.

넘어가면 입력을 기다리는 화면이 뜹니다. 가운데 상자에 지금 열려 있는 폴더 이름이 보입니다.

9. 첫 지시 내리고 결과 보기

아래 문장을 그대로 적고 Enter를 누릅니다. 한국어 문장 그대로가 맞습니다.

이 폴더에 뭐가 있는지 알려 줘.

답이 바로 오지 않고, 폴더 안을 들여다봐도 되느냐고 먼저 묻습니다. Yes가 이미 골라져 있습니다. Enter를 누릅니다.

앞으로 파일을 읽거나 만들 때마다 이 물음이 나옵니다. 내가 시킨 일이 맞으면 엔터, 아니면 화살표를 내려 No입니다. 묻지 않고 알아서 하는 도구가 아니라, 손이 나갈 때마다 사람에게 확인받는 도구입니다.

허용하면 답이 돌아옵니다. 비어 있다는 답이 오면 성공입니다. 아직 아무것도 안 만들었으니 정상입니다.

끄실 때는 Ctrl + C를 두 번 누릅니다. 하던 일만 멈추고 싶으면 Esc 한 번입니다.

설치 완료

이제 어느 폴더에서든 그 폴더로 들어가 claude를 치면 됩니다. 다음에 쓸 때는 이 문서의 5단계와 6단계 두 줄만 다시 하면 됩니다.

자주 막히는 곳

창을 새로 여니 claude를 못 찾는다고 나와요

설치 위치가 등록되지 않은 것입니다. 4단계의 첫 줄을 다시 붙여넣고 claude --version으로 확인하십시오. 설치 프로그램은 이 등록을 대신해 주지 않습니다.

설치 명령을 넣었는데 몇 분째 아무것도 안 나와요

정상입니다. 설치 파일을 받아오는 동안 화면에 아무 글자도 안 나옵니다. 1분에서 3분쯤 걸리며, 네트워크가 느리면 더 걸립니다. 창을 닫지 말고 기다리십시오.

Get-FileHash를 인식할 수 없다고 나와요

PC에 PowerShell 7이 따로 깔려 있을 때 생깁니다. 아래 한 줄을 먼저 넣고, 같은 창에서 설치 명령을 다시 넣으십시오. 지금 열려 있는 창에만 적용되고 PC 설정을 바꾸지 않습니다.

$env:PSModulePath='C:\Program Files\WindowsPowerShell\Modules;C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules'

로그인 창이 떴다 닫히거나 계속 로그인하라고 나와요

다른 브라우저를 기본 브라우저로 바꾸고 다시 시도해 보십시오. 그래도 안 되면 터미널에 나온 긴 주소를 복사해 브라우저에 직접 붙여넣습니다.

로그인은 됐는데 쓸 수 없다고 나와요

무료 계정입니다. Claude Code는 Pro, Max, Team, Enterprise 중 하나의 유료 요금제가 있어야 열립니다. 구독한 계정으로 로그인했는지 확인하십시오.

맥에서 설치한다면

화면 모양만 다르고 나오는 문구와 순서는 위와 같습니다. 다른 것은 두 가지입니다. 터미널은 Command + Space를 누르고 터미널을 검색해 열고, 설치 명령이 아래 한 줄입니다.

curl -fsSL https://claude.ai/install.sh | bash

맥은 설치 위치가 저절로 등록되므로 4단계의 첫 줄이 필요 없습니다. 터미널을 닫았다 다시 열고 claude --version부터 확인하십시오. 폴더로 들어가는 줄은 cd ~/Desktop/myfirst입니다.

더 해 보고 싶다면 클로드코드 완전가이드에 명령 전량, 규칙 파일, 권한 모드, 확장까지 정리돼 있습니다.

전체 소요 시간 숫자는 원문에 없습니다. [확인 필요]