강동민
Windows 설치 가이드

Claude Code CLI
설치하기

터미널에 claude 한 마디를 치면 열리는 상태까지 만듭니다. 명령 세 줄을 붙여넣고 화면을 따라가면 끝납니다. 코드는 한 줄도 쓰지 않습니다.

소요 시간 약 15분 Windows 10 / 11 관리자 권한 불필요 실제 화면 15장

시작하기 전에 준비할 것

데스크톱 앱을 찾으시는 것이라면 이 문서가 아닙니다. 창이 뜨고 마우스로 쓰는 앱은 Windows에서 Claude Code 설치하기를 보십시오. 이 문서는 검은 터미널 창에서 쓰는 CLI를 다룹니다.
1

터미널 열기

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

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

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

검은 창이 열려 있고 커서가 깜빡입니다.

2

설치 명령 한 줄 붙여넣기

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

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

엔터를 누른 직후에는 방금 친 줄 하나만 보입니다.

설치 명령을 실행한 직후의 PowerShell 화면
그림 1. 엔터를 누른 직후. 여기서 창을 닫지 않습니다.

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

받아오기가 끝나면 진행 중이라는 줄이 지나갑니다.

설치가 진행 중인 PowerShell 화면
그림 2. 설치 파일을 받아 설치하는 중입니다. 기다립니다.
붙여넣기가 두 줄로 끊겨 들어가면 실패합니다. 화면에 보이는 명령이 위 그림처럼 한 줄인지 확인하십시오. 끊겼으면 Ctrl + C로 빠져나온 뒤 다시 붙여넣습니다.
여기까지 확인

명령을 넣었고 창이 무언가 하는 중입니다. 아직 창을 닫지 않았습니다.

3

설치가 끝난 화면 확인하기

설치가 끝나면 초록색 문구가 뜹니다.

설치 완료 문구와 Setup notes가 보이는 화면
그림 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 --version이 버전을 출력한 화면
그림 4. 숫자와 (Claude Code)가 함께 나오면 설치가 끝난 것입니다.

버전 숫자는 계속 올라가므로 화면과 조금 달라도 괜찮습니다.

숫자 대신 빨간 글씨가 나오면 아직 자리를 못 찾은 것입니다.

claude 명령을 찾지 못한다는 빨간 오류 화면
그림 5. 이 화면이 나오면 위 등록 줄을 한 번 더 붙여넣습니다.
여기까지 확인

claude --version이 숫자를 뱉었습니다.

5

작업 폴더 만들고 들어가기

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

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

cd $env:USERPROFILE\Desktop\myfirst
cd 명령으로 myfirst 폴더에 들어간 화면
그림 6. 줄 앞 경로가 myfirst로 끝나면 들어간 것입니다.

Claude Code는 자기를 켠 폴더만 봅니다. 이 폴더 안에서 켜면 이 폴더 안에만 파일을 만듭니다.

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

줄 앞 경로가 myfirst로 끝납니다.

6

claude 실행하고 글자 색 고르기

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

claude

처음 켜면 글자 색부터 고르라고 합니다.

첫 실행에서 글자 색 테마를 고르는 화면
그림 7. 위아래 화살표로 고르고 Enter를 누릅니다.

나중에 /theme로 바꿀 수 있으니 여기서 오래 고민하지 않아도 됩니다.

여기까지 확인

색을 고르고 엔터를 눌러 다음 화면으로 넘어갔습니다.

7

로그인하기

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

로그인 방식을 고르는 화면
그림 8. 유료 구독 계정으로 쓰는 1번을 그대로 둡니다.

브라우저가 저절로 열리고 로그인 화면이 뜹니다. 구독 중인 계정으로 로그인합니다.

브라우저에 열린 Claude 로그인 화면
그림 9. 브라우저에서 로그인을 마칩니다.

로그인이 끝나면 터미널로 돌아옵니다.

로그인이 끝나 터미널로 돌아온 화면
그림 10. 초록색 Login successful이 보이면 Enter를 누릅니다.
브라우저가 안 열리면 터미널에 긴 주소가 하나 나와 있습니다. 그 주소를 복사해 브라우저 주소창에 붙여넣으면 같은 화면이 나옵니다.

로그인은 한 번만 하면 다음부터 묻지 않습니다.

여기까지 확인

터미널에 초록색 Login successful이 떴습니다.

8

안내 넘기고 폴더 신뢰하기

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

보안 주의사항 안내 화면
그림 11. 읽고 Enter로 넘어갑니다.

이어서 이 폴더를 믿어도 되느냐고 묻습니다. 남의 폴더에서 잘못 켰을 때를 막는 안전장치입니다.

폴더를 신뢰하겠느냐고 묻는 화면
그림 12. Yes, I trust this folder가 이미 골라져 있습니다. 그대로 Enter를 누릅니다.

방금 내가 만든 빈 폴더이므로 1번이 맞습니다. 화살표를 내려 2번을 고르면 그 자리에서 종료되고, 그때는 claude를 다시 치면 같은 화면이 나옵니다.

넘어가면 입력을 기다리는 화면이 뜹니다.

Claude Code가 입력을 기다리는 화면
그림 13. 가운데 상자에 지금 열려 있는 폴더 이름이 보입니다.
여기까지 확인

맨 아래 > 옆에 커서가 깜빡이고, 가운데 상자에 myfirst가 보입니다.

9

첫 지시 내리고 결과 보기

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

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

답이 바로 오지 않고, 폴더 안을 들여다봐도 되느냐고 먼저 묻습니다.

명령 실행을 허용하겠느냐고 묻는 화면
그림 14. Yes가 이미 골라져 있습니다. Enter를 누릅니다.

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

허용하면 답이 돌아옵니다.

폴더가 비어 있다는 답이 한국어로 돌아온 화면
그림 15. 비어 있다는 답이 오면 성공입니다. 아직 아무것도 안 만들었으니 정상입니다.

끄실 때는 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입니다.


더 해 보고 싶다면

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

태그클로드코드CLI터미널ClaudeCode설치명령줄윈도우맥AI코딩npm셸
최종 수정: 2026-08-19
무료 AI 활용 진단 내 AI 활용 수준, 상위 몇 %일까요? 진단하면 내 점수와 지금 무엇부터 할지 알려드립니다.