윈도우에 Claude Code CLI 설치하기: 완전 초보용 순서 가이드

윈도우에서 Claude Code CLI를 설치하는 방법을 초보자 기준으로 정리합니다.

Windows에 Claude Code CLI 설치하기

Claude Code는 터미널에서 실행하는 Anthropic의 코딩 에이전트입니다. 프로젝트 폴더를 읽고, 코드를 설명하고, 파일을 수정하고, 필요한 명령어를 실행하는 방식으로 쓸 수 있습니다. 처음에는 터미널이라는 단어부터 낯설지만, 설치 순서는 복잡하지 않습니다.

이 글은 개발자가 아닌 분도 따라 할 수 있게 구성했습니다.

공식 설치 명령은 Anthropic Claude Code Docs 기준으로 확인했습니다. Windows에서는 PowerShell 설치 스크립트 또는 WinGet 설치를 사용할 수 있습니다.
참고: Claude Code Advanced setup →, Claude Code Quickstart →

ChatGPT 계정을 주로 쓰는 분은 윈도우 Codex CLI 설치 가이드를, Google Antigravity를 써보고 싶은 분은 윈도우 Antigravity CLI 설치 가이드를 함께 보면 됩니다.

설치가 끝난 뒤에는 AI 코딩 CLI 설치 후 처음 세팅할 것 7가지를 먼저 확인하는 편이 안전합니다.

바로 결과물을 만들어보고 싶다면 AI 코딩 CLI로 첫 홈페이지 만들기 실습으로 이어가면 됩니다.

준비물

먼저 아래 3가지만 확인합니다.

Windows 10 1809 이상 또는 Windows 11 PC
Claude Pro, Max, Team, Enterprise 또는 Claude Console 계정
인터넷 연결

Claude Code는 무료 Claude.ai 계정만으로는 사용할 수 없습니다. 처음 시작하는 분이라면 Claude 구독 계정으로 로그인하는 방식이 가장 쉽습니다.

1단계: PowerShell 열기

Windows 검색창에 PowerShell을 입력합니다.

그다음 Windows PowerShell을 엽니다.

Claude Code 공식 문서 기준으로는 기본 설치에 관리자 권한이 필수는 아닙니다. 다만 회사 PC이거나 권한 제한이 있는 PC라면 관리자 권한이 필요할 수 있습니다.

$PSVersionTable.PSVersion

숫자가 나오면 PowerShell이 정상으로 열린 것입니다.

2단계: Claude Code CLI 설치

PowerShell에 아래 명령어를 그대로 붙여넣고 Enter를 누릅니다.

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

설치가 진행됩니다.

중간에 확인을 묻는 문구가 나오면 화면 안내에 따라 Y 또는 Enter를 누릅니다.

3단계: 설치 확인

설치가 끝났으면 PowerShell 창을 닫았다가 다시 엽니다.

그다음 아래 명령어를 입력합니다.

claude --version

버전 숫자가 나오면 설치가 된 것입니다.

더 자세히 점검하고 싶다면 아래 명령어도 사용할 수 있습니다.

claude doctor

claude doctor는 설치, 설정, 로그인 상태에 문제가 있는지 진단해주는 명령어입니다.

4단계: 첫 실행 전 확인

설치는 끝났지만, 아직 아무 폴더에서나 claude를 입력하지 않습니다.

Claude Code는 현재 폴더를 기준으로 파일을 읽고 수정합니다. 그래서 처음 실행은 다음 단계에서 만드는 연습용 폴더 안에서 하는 편이 안전합니다.

5단계: 바탕화면에 작업 폴더 만들기

먼저 터미널 명령어로 폴더를 만들지 말고, 눈에 보이는 곳에서 직접 만듭니다.

바탕화면으로 갑니다.
빈 곳에서 마우스 오른쪽 버튼을 누릅니다.
새로 만들기 → 폴더를 누릅니다.
폴더 이름을 claude-practice로 바꿉니다.

그다음 바탕화면 위치에서 PowerShell을 엽니다.

파일 탐색기에서 바탕화면을 엽니다.
위쪽 주소창을 클릭합니다.
powershell을 입력하고 Enter를 누릅니다.

PowerShell 창이 열리면 아래처럼 입력합니다.

cd claude-practice
claude

처음 실행하면 로그인 화면이 나옵니다.

브라우저가 열리면 Claude 계정으로 로그인합니다.

로그인이 끝나면 이후에는 같은 PC에서 매번 다시 로그인할 필요가 없습니다.

이제 Claude Code에게 간단히 요청해볼 수 있습니다.

이 폴더에 hello.txt 파일을 만들고, 안에 "처음 실행한 Claude Code 테스트"라고 적어줘.

Claude Code가 파일을 만들겠다고 하면 내용을 확인한 뒤 진행하면 됩니다.

6단계: WinGet 방식 대안

PowerShell 설치 스크립트가 잘 안 될 때는 WinGet 방식도 있습니다.

winget install Anthropic.ClaudeCode

WinGet 방식으로 설치한 경우 업데이트는 자동으로 되지 않을 수 있습니다. 시간이 지나 새 버전으로 올리고 싶으면 아래 명령어를 실행합니다.

winget upgrade Anthropic.ClaudeCode

설치 후 다시 버전만 확인합니다.

claude --version

실제 실행은 위 5단계처럼 바탕화면의 claude-practice 폴더로 들어간 뒤 claude를 입력합니다.

7단계: Git for Windows는 선택사항

Windows에서 Claude Code를 더 편하게 쓰려면 Git for Windows를 설치해두는 것이 좋습니다.

공식 문서에서도 Windows 네이티브 환경에서는 Git for Windows 설치를 권장합니다. Git Bash가 있으면 Claude Code가 Bash 도구를 사용할 수 있기 때문입니다.

다만 Git for Windows가 없어도 Claude Code 자체를 실행할 수는 있습니다. 이 경우 Claude Code는 PowerShell 도구를 사용합니다.

처음 설치만 확인하려는 단계라면 Git for Windows는 나중에 설치해도 됩니다.

자주 막히는 지점

증상	해결
`claude` 명령어를 찾을 수 없음	PowerShell을 닫았다가 다시 열기
설치 스크립트 실행이 막힘	회사 PC 보안 정책 확인 또는 WinGet 방식 사용
로그인 창이 안 뜸	기본 브라우저를 열어둔 상태에서 `claude` 다시 실행
무료 Claude 계정으로 안 됨	Claude Pro, Max, Team, Enterprise 또는 Console 계정 필요
아무 폴더에서 실행해서 불안함	바탕화면에 만든 `claude-practice` 폴더 안에서 먼저 테스트
Git 관련 기능이 어색함	Git for Windows 설치 후 다시 실행

초보자가 조심할 점

Claude Code는 파일을 읽고 수정할 수 있습니다.

처음부터 중요한 업무 폴더, 계약서 폴더, 개인정보가 들어 있는 폴더에서 실행하지 않는 편이 좋습니다.

처음에는 반드시 연습용 폴더에서 테스트합니다.

그리고 Claude Code가 제안하는 변경사항을 바로 승인하지 말고, 어떤 파일을 바꾸는지 먼저 확인합니다.

처음 시켜볼 만한 요청

아래처럼 작게 시작하면 됩니다.

이 폴더 구조를 설명해줘.

README.md 파일을 만들고, 이 프로젝트의 목적을 초보자도 이해하게 정리해줘.

index.html 파일을 하나 만들고, 간단한 자기소개 페이지를 만들어줘.

방금 만든 파일을 더 깔끔하게 정리해줘. 단, 내 허락 없이 파일을 삭제하지 마.

처음에는 코딩보다 파일 정리, 설명, 작은 HTML 만들기부터 해보는 편이 좋습니다.

index.html로 첫 홈페이지를 만들어보는 전체 과정은 AI 코딩 CLI로 첫 홈페이지 만들기에서 이어서 볼 수 있습니다.

Codex CLI와 헷갈리는 점

Codex CLI와 Claude Code CLI는 둘 다 터미널에서 쓰는 코딩 에이전트입니다.

하지만 로그인 계정과 설치 명령어가 다릅니다.

구분	설치 확인 명령어	실행 명령어	계정
Codex CLI	`codex --version`	`codex`	ChatGPT 계정
Claude Code CLI	`claude --version`	`claude`	Claude 계정

둘 중 하나만 써도 됩니다. 이미 ChatGPT를 주로 쓴다면 Codex CLI부터, Claude 구독을 쓰고 있다면 Claude Code부터 시작하는 편이 자연스럽습니다.

설치보다 중요한 것

Claude Code 설치 자체는 어렵지 않습니다.

진짜 중요한 것은 어디에 적용할지 정하는 일입니다.

예를 들면 이런 식입니다.

반복되는 문서 정리
엑셀 데이터를 웹 화면으로 보기
간단한 내부 업무 도구 만들기
홈페이지 문구와 FAQ 정리
기존 코드 설명 받기
자동화 아이디어를 실제 파일로 만들기

도구를 먼저 설치하고 끝내기보다, 작은 업무 하나를 골라 실제로 줄여보는 것이 좋습니다.

Boilerplate AI 컨설팅

Boilerplate는 AI 도구 설치만 설명하는 곳이 아니라, 실제 업무에 맞게 AI를 적용하는 AI 업무자동화 컨설팅을 진행합니다.

Claude Code, Codex CLI, ChatGPT, Gemini 같은 도구를 어디에 써야 하는지부터 정리하고, 필요한 경우 업무자동화 흐름이나 작은 웹앱 제작까지 연결합니다.

윈도우 PC에 Claude Code를 설치하고 싶거나, 조직 안에서 AI 코딩 도구를 어떻게 써야 할지 정리하고 싶다면 아래 페이지로 연락주세요.

AI 컨설팅 문의하기