클로드 코드(Claude Code) 윈도우 설치 가이드

클로드 코드(Claude Code)는 대화로 요청을 받아 컴퓨터의 파일을 읽고 수정하는 AI 도구입니다. 윈도우에서는 PowerShell이라는 명령 입력 프로그램에 설치 명령 한 줄을 넣어 설치합니다.

설치한 뒤에는 웹 채팅처럼 평소 말로 요청합니다. 다만 클로드 코드는 실제 파일을 만들고 바꾸므로, 어느 폴더에서 일하는지와 무엇을 허용했는지, 결과 파일이 요청대로인지까지 함께 봐야 합니다. 이 글은 설치부터 첫 작업의 결과 파일을 여는 데까지 다룹니다.

이 글은 2026년 10월 4일 공식 안내 기준입니다. 맥 사용자는 맥 설치 가이드를 봅니다.

터미널에서 AI 도구를 쓰면 달라지는 세 가지

터미널은 글자로 명령을 입력해 컴퓨터를 조작하는 프로그램이고, 윈도우에서는 PowerShell이 이 일을 합니다. 윈도우 11의 터미널 앱을 열면 그 안에서 PowerShell이 실행되기도 합니다. CLI(Command Line Interface)는 이렇게 터미널에서 실행하는 프로그램을 말하며, 클로드 코드도 CLI 프로그램입니다.

AI가 글을 읽고 분석하고 쓰는 능력은 웹 채팅과 같습니다. 달라지는 것은 자료가 들어가는 길, 결과가 남는 곳, AI가 실행할 수 있는 일입니다.

웹 채팅과 터미널의 클로드 코드

구분	웹 채팅	터미널의 클로드 코드
자료가 들어가는 길	사람이 첨부하거나 붙여 넣음	작업 폴더의 파일을 직접 읽음
결과가 남는 곳	대화창에 남음 파일 저장은 직접	작업 폴더에 파일로 저장
실행할 수 있는 일	서비스가 제공하는 기능 안에서	허용한 범위의 파일 수정, 명령 실행

웹 채팅도 드라이브 같은 서비스를 연결하면 파일을 다룹니다. 터미널 도구의 가장 큰 차이는 내 컴퓨터의 폴더 하나를 작업 공간으로 정하고 그 안에서 일한다는 점입니다.

요청 한 번이 진행되는 순서

요청 하나는 다섯 단계로 끝납니다. 마지막 단계가 빠지면 AI가 다른 폴더에 저장했거나 요청과 다르게 쓴 경우를 놓칩니다.

클로드 코드에 요청 하나를 맡길 때

1. 11. 요청할 일을 평소 말로
   명령어는 외우지 않아도 됨
2. 22. 읽기작업 폴더에서
   필요한 파일을 엶
3. 33. 작업과 저장Manual 모드는
   저장 전에 승인을 물음
4. 44. 완료 보고읽은 파일과
   만든 파일을 알려 줌
5. 55. 사람의 확인실제 파일을 열어
   요청과 대조

입력하는 곳이 두 군데입니다

같은 PowerShell 창 안에서 claude를 실행하면 입력하는 곳이 PowerShell 명령 입력줄에서 클로드 코드 입력창으로 바뀝니다. AI에게 할 요청을 명령 입력줄에 넣거나 PowerShell 명령을 클로드 코드 입력창에 넣으면 의도와 다르게 동작합니다.

Windows PowerShell

> claude --permission-mode default

여기부터 클로드 코드 입력창입니다. /exit를 넣으면 PowerShell로 돌아갑니다.

입력줄 앞에 PS C:\Users\사용자이름>가 보이면 PowerShell 명령을 넣는 곳입니다

> meeting.txt를 읽고 할 일을 표로 정리해 줘

아래 단계마다 어디에 입력하는지 함께 적었습니다.

한눈에 보는 순서

설치부터 첫 작업까지

1. 11. 사양과 계정시스템 정보와
   이용 계정 확인
2. 22. 설치PowerShell에
   설치 명령 한 줄
3. 33. 작업 폴더PowerShell에서
   폴더 만들고 이동
4. 44. 로그인과 첫 작업claude 실행 뒤
   클로드 코드 입력창
5. 55. 결과 확인PowerShell이나
   메모장으로 열기

1. 사양과 이용 계정 확인

윈도우 설정의 시스템 정보에서 윈도우 버전과 시스템 종류를 봅니다.

클로드 코드 설치에 필요한 사양

• 1809이상윈도우 10 버전Windows Server는 2019 이상
• 4GB 이상메모리
• 64비트CPU 종류x64나 ARM64, 32비트 미지원

무료 Claude 웹 계정으로는 클로드 코드를 쓸 수 없습니다. Pro, Max, Team, Enterprise 구독이나, 개발자가 API 사용량을 관리하는 Claude Console 계정이 필요합니다. Console의 API 사용료는 Claude 구독료와 따로 청구됩니다. 회사 계정이면 조직에서 허용한 로그인 방식을 따릅니다.

Git은 변경 기록을 관리하는 도구이고 Node.js는 자바스크립트 프로그램을 실행하는 도구입니다. 아래 기본 설치는 둘 다 없어도 진행됩니다. 윈도우 안의 리눅스 환경인 WSL도 쓰지 않습니다.

2. 일반 PowerShell에서 설치

설치하고 버전 번호 보기

1. 11. PowerShell 열기Windows 키에서 검색
   관리자 권한 없이
2. 22. 설치 명령한 줄 붙여 넣고
   Enter
3. 33. 완료 안내끝나면
   설치한 창 닫기
4. 44. 새 창에서 확인claude --version
   버전 번호가 나오면 성공

Windows 키를 누르고 PowerShell을 검색해 엽니다. 관리자 권한으로 열지 않아도 되고, 이름에 (x86)이 붙은 32비트용 창은 고르지 않습니다. 입력줄 앞에 PS와 현재 폴더 경로가 보이면 PowerShell입니다.

아래 코드 블록의 한 줄만 복사해 붙여 넣고 Enter를 누릅니다. 코드 블록 위의 powershell이라는 언어 이름은 입력하지 않습니다.

앤트로픽이 제공하는 설치 스크립트를 내려받아 실행하는 명령이므로 인터넷에서 찾은 다른 주소로 바꾸지 않습니다. 오류가 뜨면 마지막 오류 문장을 복사해 두고, 글 뒤쪽의 오류 메시지별 표에서 같은 낱말을 찾습니다.

완료 안내가 나오면 설치한 창을 닫고 새 PowerShell 창을 엽니다. PowerShell은 새로 연 창에서만 방금 등록된 claude 명령을 찾습니다.

버전 번호가 출력되면 설치가 끝난 것입니다. 숫자는 설치 시점에 따라 다르고, 계정 로그인은 4단계에서 합니다.

3. 작업 폴더 만들기

클로드 코드는 실행한 폴더를 기준으로 일하므로, 중요한 자료가 없는 폴더를 하나 만들어 그 안에서 시작합니다. 같은 PowerShell에서 아래 명령을 한 줄씩 입력합니다.

$HOME은 현재 윈도우 사용자 폴더입니다. 첫 줄에서 이미 있는 폴더라고 나오면 그 안에 중요한 자료가 없는지 먼저 보고, 자료가 있으면 첫째 줄과 둘째 줄의 claude-practice를 모두 claude-practice-2처럼 새 이름으로 바꿉니다.

Windows PowerShell

> Get-Location

C:\Users\사용자이름\claude-practice

경로 끝이 claude-practice인지 봅니다

같은 PowerShell에 explorer .를 입력하면 이 폴더가 탐색기로 열립니다. 맡길 업무 파일이 있다면 원본이 아니라 복사본을 이 폴더에 넣습니다. 요청이 잘못돼도 원본은 그대로 남습니다. 회사 자료라면 외부 AI 서비스에 넣어도 되는지 조직의 기준을 먼저 봅니다.

4. 로그인하고 첫 작업 맡기기

작업 폴더에 있는 상태에서 다음 명령을 입력합니다. 이번 세션을 Manual 권한 모드로 시작하는 명령이고, Manual 모드는 파일을 저장하거나 명령을 실행하기 전에 승인을 묻습니다.

처음 실행할 때 나오는 화면

1. 11. 폴더 신뢰경로가 claude-practice인지
   보고 허용
2. 22. 계정 종류구독 계정이나
   Console 계정 선택
3. 33. 브라우저 로그인안 열리면 터미널의
   로그인 링크 사용
4. 44. 입력창메시지 입력칸이 보이면
   준비 완료

다른 계정으로 로그인했다면 클로드 코드 입력창에서 /login으로 바꿉니다. Manual 모드에서도 이미 허용 규칙을 만든 작업과 파일을 읽기만 하는 작업은 묻지 않고 진행하므로, 요청할 때 작업 범위를 좁게 적습니다.

이제부터는 PowerShell 명령이 아니라 AI에게 하는 요청을 입력합니다. 첫 작업으로는 결과가 맞는지 바로 대조할 수 있는 일이 좋습니다. 예를 들어 회의록 텍스트 파일의 복사본을 meeting.txt라는 이름으로 작업 폴더에 넣었다면 이렇게 요청합니다.

Claude Code, claude-practice

> meeting.txt를 읽고 담당자, 할 일, 마감을 표로 정리해서 todo.md에 UTF-8로 저장해줘.

Do you want to create todo.md?
1. Yes 2. No

파일 이름과 위치가 요청과 맞는지 읽고 승인합니다

meeting.txt를 읽고 todo.md를 만들었습니다.

허가 창에 요청과 관계없는 파일이 나오면 거절하고 범위를 다시 적어 요청합니다. 작업을 멈추려면 Esc를 누릅니다.

5. 결과 파일을 열고 한 줄 고치기

완료 답변이 나오면 클로드 코드 입력창에 /exit를 넣어 PowerShell로 돌아온 뒤 파일 내용을 엽니다. 클로드 코드를 닫지 않고 보려면 PowerShell 창을 하나 더 열어 Set-Location "$HOME\claude-practice"로 같은 폴더에 들어갑니다.

표의 줄 수가 회의록의 항목 수와 같은지, 원문에 담당자나 날짜가 없는 항목이 '미정'으로 남았는지 봅니다. 원문에 없는 이름이나 날짜가 채워졌다면 그 항목을 짚어 "이 항목의 담당자와 마감은 원문에 없으니 미정으로 고쳐줘"라고 다시 요청합니다. 메모장으로 보려면 notepad .\todo.md를 입력합니다.

파일을 못 찾으면 Get-Location으로 지금 폴더를 보고, 클로드 코드가 어디에 저장했다고 답했는지 다시 읽습니다. 일부만 고칠 때는 고칠 곳과 그대로 둘 곳을 함께 적습니다. 예를 들어 todo.md에서 첫 번째 할 일의 마감만 바꿔 줘. 나머지 줄과 다른 파일은 그대로 둬.라고 요청한 뒤, 같은 Get-Content 명령으로 나머지 줄이 그대로인지 봅니다.

같은 방식으로 맡기기 좋은 일은 공지나 계약서의 이전 판과 새 판에서 바뀐 줄만 정리하기, 폴더 안 파일마다 이름과 한 줄 설명을 붙인 목록 만들기입니다. 둘 다 결과를 원문이나 Get-ChildItem -Name으로 본 실제 파일 목록과 바로 대조할 수 있습니다.

오류가 나면 메시지부터 구분하기

메시지에 따라 원인이 다릅니다. 마지막 오류 문장에서 아래 낱말을 찾습니다.

오류 메시지별 원인과 할 일

메시지나 증상	흔한 원인	할 일
irm is not recognized	CMD에 입력함	PowerShell에서 같은 명령
&& 관련 오류	다른 셸용 명령 PowerShell 5.1은 미지원	2단계의 한 줄 명령 사용
fsSL 관련 오류	맥용 명령을 붙임	윈도우용 명령으로 교체
32비트 윈도우 오류	(x86) 창이나 32비트 운영체제	창 이름과 시스템 종류 보기
claude를 찾을 수 없음	창을 새로 열지 않음 실행 파일 없음	새 창에서 다시 아래 순서로 확인
running scripts is disabled	npm 설치의 실행 스크립트 문제	npm.ps1, claude.ps1 있는지 보기

새 창에서도 claude를 못 찾으면 실행 파일이 있는지부터 봅니다.

claude를 찾을 수 없을 때 확인 순서

1. 11. 파일 있는지Test-Path로
   claude.exe 확인
2. 22. False면설치 실패나
   백신 격리 의심
3. 33. True면전체 경로로
   --version 실행
4. 44. 전체 경로만 되면PATH에
   경로 등록

True가 나오면 전체 경로로 실행합니다.

이 명령은 되는데 claude --version만 실패하면 PATH 문제입니다. PATH는 윈도우가 명령을 찾아보는 폴더 목록이고, 등록 방법은 설치 오류 해결 글에 있습니다. 파일이 없을 때는 PATH를 추가해도 해결되지 않습니다.

백신이 막았다면 백신의 보호 기록에서 막힌 파일과 이유를 봅니다. 설치 프로그램이 이미 실행 중이라 파일이 잠긴 경우도 있습니다. 백신을 모두 끄거나 컴퓨터 전체의 실행 정책을 바꾸기 전에 이 기록부터 보고, 회사 PC라면 관리자에게 오류 문장을 그대로 전달합니다. claude 명령이 실행되는 상태라면 claude doctor로 설치와 설정을 진단합니다.

필요할 때 추가할 것과 업데이트

기본 설치만으로 첫 작업까지 할 수 있습니다. 아래 도구는 해당 기능이 필요할 때 추가합니다.

나중에 추가하는 도구

도구	설치하면	없으면
Git for Windows	Bash 도구 사용	PowerShell 도구 사용
Node.js	Node.js 기반 프로젝트 실행	기본 설치와 첫 작업에는 영향 없음
스킬과 플러그인	반복 작업 묶기	첫 작업에는 영향 없음

Git으로 기록을 남기는 방법은 Git 입문 글에서 이어집니다.

위의 네이티브 설치는 자동으로 업데이트됩니다. 예전에 WinGet으로 설치했다면 기본 설정에서는 직접 업데이트해야 하므로 winget upgrade Anthropic.ClaudeCode를 입력합니다. 처음 설치하는 분은 두 방식 가운데 위의 설치 명령 하나만 씁니다.

터미널 대신 데스크톱 앱으로 시작하려면

Claude 데스크톱 앱의 Code 탭에서도 폴더를 골라 같은 작업을 맡길 수 있습니다. 앱만 설치하면 되고 CLI와 Node.js는 따로 설치하지 않습니다. 다만 앱을 설치해도 PowerShell의 claude 명령은 생기지 않습니다.

데스크톱 앱 Code 탭에서 첫 작업

1. 11. 로그인Claude 데스크톱 앱에
   구독 계정으로
2. 22. 폴더 선택Code 탭에서 Local을
   고르고 작업 폴더 지정
3. 33. Manual 모드권한 모드를
   Manual로
4. 44. 요청4단계와 같은
   회의록 정리 요청
5. 55. 적용과 확인제안된 변경 적용 뒤
   탐색기에서 열기

Git처럼 특정 기능에 필요한 도구가 있으면 앱이 안내를 띄우고, 그 안내에 따라 설치합니다.

다음부터 실행하는 순서

설치는 한 번이면 됩니다. 다음부터는 새 PowerShell을 열고 작업 폴더로 이동한 뒤 클로드 코드를 실행합니다. Get-Location 결과가 작업 폴더일 때만 마지막 줄을 입력합니다.

PowerShell에서 쓰는 claude --version과 클로드 코드 입력창에서 쓰는 /help, /exit는 입력하는 곳이 다릅니다.

Sources

• Claude Code 설치와 계정 조건
• Claude Code 권한 모드
• Claude Code 설치 오류 해결
• Claude Code 데스크톱 시작하기

3줄 요약

1. 클로드 코드는 윈도우 10 1809 이상과 메모리 4GB 이상에서 일반 PowerShell의 공식 설치 명령 한 줄로 설치하며 관리자 권한과 Node.js는 필요하지 않습니다.

2. 설치 뒤 새 PowerShell 창에서 버전 번호를 보고 작업 폴더에서 claude를 실행해 Pro 이상 구독이나 Console 계정으로 로그인합니다.

3. claude를 찾을 수 없다고 나오면 사용자 폴더의 .local\bin에 claude.exe가 있는지부터 보고, 파일이 있는데 명령만 안 되면 PATH 문제입니다.