강동민
Windows 설치 가이드

Windows에서 Claude Code
설치하기

다운로드부터 로그인, Git 설정, 첫 코딩까지. 터미널을 몰라도 화면을 그대로 따라 하면 끝나는 초보자용 전 과정 안내입니다.

소요 시간 약 15분 Windows 10 / 11 터미널 지식 불필요 화면 캡처 포함

시작하기 전에 준비할 것

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

설치 파일 내려받기

웹 브라우저에서 공식 다운로드 페이지 code.claude.com/docs/en/desktop를 엽니다. 상단에서 운영체제별 다운로드 카드 중 Download for Windows를 누르면 설치 파일이 내려받아집니다.

  • 대부분의 PC는 x64용 Download for Windows를 누르면 됩니다.
  • Surface Pro X처럼 ARM 기반 PC라면 페이지 안내의 ARM64 installer 링크를 사용합니다.
공식 다운로드 페이지에서 Windows 다운로드 버튼
[ 화면 ]
다운로드 페이지code.claude.com/docs/en/desktop 화면에서 "Download for Windows" 카드가 보이는 상태. 그 버튼을 강조 표시.
그림 1. 공식 문서 페이지의 Windows 다운로드 버튼.
내 PC가 x64인지 ARM64인지 모르겠다면? Windows + Pause를 누르거나 설정 > 시스템 > 정보에서 "시스템 종류"를 확인하세요. "x64 기반"이면 x64, "ARM 기반"이면 ARM64입니다.
여기까지 확인

다운로드 폴더에 설치 파일이 하나 받아져 있습니다.

2

설치 프로그램 실행

내려받은 설치 파일은 보통 다운로드 폴더에 있습니다. 파일을 더블클릭해 실행합니다.

다운로드 폴더의 Claude 설치 파일
[ 화면 ]
다운로드 폴더의 설치 파일다운로드 폴더에서 Claude 설치 실행 파일(.exe)을 더블클릭하기 직전 화면.
그림 2. 내려받은 설치 파일을 더블클릭합니다.
"Windows의 PC 보호" 경고가 뜨면 정상입니다. 새로 배포된 프로그램에서 흔히 나오는 화면입니다. 추가 정보를 누른 뒤 나타나는 실행 버튼을 누르면 됩니다. (공식 설치 파일은 대부분 이 경고 없이 바로 실행됩니다.)
"이 앱이 디바이스를 변경하도록 허용하시겠습니까?" 창(사용자 계정 컨트롤, UAC)이 뜨면 예를 누릅니다. 프로그램을 설치할 때 Windows가 항상 확인하는 정상 절차입니다. 화면이 어두워지면서 이 창이 뜨고, 2분 안에 예를 누르지 않으면 설치가 자동으로 취소됩니다. 취소되면 "Administrator access is required..." 안내가 나오므로, 설치 파일을 다시 실행해 이번에는 예를 누르면 됩니다.

승인하면 설치 파일을 내려받아 설치가 자동으로 진행되고, 끝나면 Claude 앱이 실행됩니다.

Claude 설치 진행 화면
[ 화면 ]
설치 진행설치가 진행되는 화면 또는 설치 완료 직후 Claude 첫 실행 화면.
그림 3. 설치 파일을 내려받아 설치가 자동으로 진행됩니다.
여기까지 확인

설치가 끝나고 Claude 앱 창이 화면에 떠 있습니다.

3

Claude 실행하고 로그인

설치 후에는 시작 메뉴에서 Claude를 실행할 수 있습니다. 앱이 열리면 Anthropic 계정으로 로그인합니다. 로그인 버튼을 누르면 브라우저가 열리며 인증을 진행하고, 끝나면 자동으로 앱으로 돌아옵니다.

로그인이 끝나면 앱 왼쪽 위에 홈과 Code 탭이 보입니다. 홈은 일반 대화, Code는 코드 작업용입니다. (관리자 권한으로 설치하면 긴 자동 작업을 맡기는 Cowork 탭이 함께 표시됩니다.)

홈과 Code 탭이 있는 앱 왼쪽 위 화면
[ 화면 ]
앱 상단의 탭로그인 후 왼쪽 위에 홈 / Code 탭이 보이는 화면.
그림 4. 왼쪽 위의 탭. 개발 작업은 Code 탭에서 합니다.
여기까지 확인

앱 왼쪽 위에 홈과 Code 두 탭이 보입니다.

4

Code 탭 열기

왼쪽 위의 Code 탭을 누릅니다. 이 탭이 실제 코드 작업을 하는 곳입니다.

Code 탭을 누른 화면
[ 화면 ]
Code 탭Code 탭을 눌러 코드 작업 화면으로 들어온 상태.
그림 5. Code 탭을 누릅니다. (왼쪽 목록은 개인 정보 보호를 위해 흐리게 처리했습니다.)
"업그레이드"나 로그인 안내가 뜨면 유료 구독이 없거나 온라인 로그인이 더 필요한 경우입니다. 유료 플랜(Pro 이상)을 구독한 뒤, 로그인을 마치고 앱을 다시 시작하세요. 403 오류가 보이면 잠시 후 다시 로그인하면 대개 해결됩니다.
여기까지 확인

Code 탭 화면이 열리고 아래쪽에 입력창이 보입니다. 업그레이드 안내가 떠 있다면 그 안내부터 해결하고 옵니다.

5

Git for Windows 설치 (Windows는 필수)

Windows에서 Code 탭을 처음 열면 Git이 필요하다는 안내가 나올 수 있습니다. Git은 코드 작업에 쓰이는 무료 프로그램으로, 로컬 세션이 동작하려면 반드시 설치해야 합니다. (Mac은 대부분 기본 포함이라 이 단계가 없습니다.)

  1. git-scm.com/downloads/win에서 Windows용 Git 설치 파일을 내려받습니다.
  2. 설치 파일을 실행하고, 특별한 이유가 없으면 기본값(Next)으로 끝까지 진행합니다.
  3. 설치가 끝나면 Claude 앱을 완전히 종료했다가 다시 실행합니다.
git-scm.com 다운로드 페이지
[ 화면 ]
Git 다운로드 페이지git-scm.com/downloads/win 화면에서 Windows용 설치 파일 다운로드 버튼.
그림 6. Git for Windows 다운로드 페이지.
Git for Windows 설치 마법사
[ 화면 ]
Git 설치 (기본값)Git 설치 마법사 화면. 기본값 Next로 진행하는 모습.
그림 7. 기본값(Next)으로 설치를 진행합니다.
재시작이 핵심입니다. Git을 설치한 뒤 Claude 앱을 껐다 켜야 앱이 Git을 인식합니다. 재시작 없이 Code 탭이 계속 막혀 보인다면 이 단계를 놓친 경우가 많습니다.
여기까지 확인

Claude 앱을 껐다 켠 뒤 Code 탭에서 로컬을 고를 수 있습니다.

6

첫 세션: 작업 폴더 열기

Code 탭 아래쪽에서 실행 위치로 로컬(내 컴퓨터)을 고른 뒤, 옆의 폴더 추가 버튼을 눌러 작업할 폴더를 선택합니다. Claude는 여기서 고른 폴더 안의 파일만 보고 다룹니다.

세션에 폴더를 추가하는 선택 창
[ 화면 ]
작업 폴더 선택"세션에 폴더 추가" 창에서 폴더를 고르는 화면.
그림 8. 폴더를 고르고 폴더 선택을 누릅니다.

이어서 입력창 오른쪽 아래의 모델 이름을 눌러 사용할 모델을 고릅니다. 나중에 같은 자리에서 언제든 바꿀 수 있습니다.

모델 선택 드롭다운
[ 화면 ]
모델 선택프롬프트 입력창 옆 모델 선택 드롭다운을 연 화면.
그림 9. 사용할 모델을 고릅니다.
처음에는 잘 아는 작은 폴더로 시작하세요. 내용을 이미 아는 폴더라야 Claude가 무엇을 어떻게 바꾸는지 한눈에 확인할 수 있습니다.
여기까지 확인

입력창 근처에 내가 고른 폴더 이름과 모델 이름이 보입니다.

7

첫 지시하고 결과 확인

입력창에 하고 싶은 일을 한국어로 적고 보냅니다. 예: 이 폴더에 CLAUDE.md를 만들어줘 또는 README에 오타가 있으면 고쳐줘.

입력창 왼쪽 아래의 모드를 수동으로 두면, Claude가 파일을 바꾸기 전에 무엇을 하려는지 보여주고 승인을 기다립니다. 바꿀 파일 경로와 함께 거부, 항상 허용, 한 번만 허용 버튼이 나옵니다. 승인하기 전에는 파일이 실제로 바뀌지 않습니다.

첫 지시에 대한 파일 쓰기 승인 화면
[ 화면 ]
첫 지시와 변경 승인지시를 보낸 뒤 바꿀 파일과 허용 버튼이 보이는 화면.
그림 10. 바꿀 파일을 확인하고 한 번만 허용으로 진행합니다.

승인하면 파일이 실제로 만들어집니다. 결과 줄의 파일 이름을 누르면 만들어진 내용을 바로 열어 확인할 수 있습니다.

첫 작업이 완료되어 파일이 생성된 화면
[ 화면 ]
완료 확인승인 후 파일이 실제로 생성/수정되어 결과가 보이는 화면.
그림 11. 승인하면 파일이 실제로 만들어집니다.
여기까지 확인

지시한 파일이 실제로 만들어졌고, 그 이름을 눌러 내용을 열어 봤습니다.

설치와 첫 실행 완료

여기까지 왔다면 Windows에 Claude Code가 정상 설치되었고, 첫 작업까지 성공한 것입니다. 이제 같은 방식으로 원하는 폴더를 열어 실제 작업을 시작하면 됩니다.


자주 막히는 곳

"Windows의 PC 보호" 경고 때문에 설치가 안 돼요

새 프로그램에서 흔히 나오는 SmartScreen 화면입니다. 파란 창의 추가 정보를 누르면 실행 버튼이 나타납니다. 그 버튼을 누르면 설치가 진행됩니다.

Code 탭이 계속 막혀 있거나 폴더를 못 열어요

Windows에서는 Git for Windows가 설치돼 있어야 로컬 세션이 동작합니다. git-scm.com/downloads/win에서 설치한 뒤, Claude 앱을 껐다 다시 켜세요. 재시작을 빠뜨리는 경우가 가장 많습니다.

Code 탭을 누르니 "업그레이드"를 요구해요

Claude Code는 유료 구독(Pro, Max, Team, Enterprise)이 있어야 씁니다. 구독한 계정으로 로그인했는지 확인하고, 방금 구독했다면 로그인을 다시 하거나 앱을 재시작하세요.

로그인이 안 되거나 403 오류가 나요

로그인 창에서 인증을 끝까지 마친 뒤 앱을 재시작해 보세요. 그래도 403 오류가 남으면 잠시 후 다시 로그인하면 대개 풀립니다. 회사 네트워크라면 방화벽이 원인일 수 있으니 다른 네트워크에서 시도해 보세요.

회사 PC라 설치 권한이 없어요

프로그램 설치가 막혀 있으면 IT 담당자에게 Claude 데스크톱 앱과 Git for Windows 설치 허용을 요청하세요. 설치형이 어려우면 관리자와 상의해 다른 방식(예: 웹/클라우드 세션)을 검토할 수 있습니다.

태그클로드코드데스크톱앱ClaudeCode설치윈도우AI코딩Git초보앱
최종 수정: 2026-08-19
무료 AI 활용 진단 내 AI 활용 수준, 상위 몇 %일까요? 진단하면 내 점수와 지금 무엇부터 할지 알려드립니다.