클로드 코드 윈도우 설치: PowerShell에서 첫 웹페이지 만들기

Windows에서 Claude Code를 처음 설치할 때는 비슷하게 생긴 창 때문에 헷갈리기 쉽습니다. PowerShell, CMD, Git Bash, WSL이 모두 “터미널”이라는 이름으로 등장하기 때문입니다. 이 글은 Windows의 PowerShell 한 경로로 진행합니다. 설치 뒤에는 작은 카페 메뉴판을 만들고, 분류 버튼을 붙이고, 다음 날 같은 작업을 이어가봅니다.

완성 파일부터 눌러보세요

이 글의 카페 메뉴 요청을 실제 Claude Code에 전달해 HTML 파일을 만들었습니다. 크림색 바탕에 진한 초록색 글자, 음료 네 개와 디저트 두 개가 나왔습니다. ‘디저트’를 누르면 두 카드만 남습니다. 예제를 읽기 전에 아래 페이지에서 먼저 눌러보세요.

Windows 새 설치는 이번 실습 환경에서 실행하지 못했습니다. 설치와 PowerShell 명령은 공식 안내를 따르며, 결과물 제작과 화면 확인은 맥에서 했습니다. 같은 HTML 파일을 제공하므로 Windows에서 열어 비교할 수 있지만, 이 사실을 Windows 검증 완료로 바꿔 적지는 않겠습니다.

시작 경로 정하기: PowerShell로 충분한가요?

Claude Code의 공식 Windows 지원 기준은 Windows 10 1809 이상 또는 Windows Server 2019 이상이며, x64·ARM64 환경을 지원합니다. 이 글은 일반 Windows PC에서 직접 실행하는 경우를 다룹니다. 시작 메뉴에서 PowerShell을 열고, 이름 뒤에 (x86)이 붙은 창은 고르지 마세요.

오래된 설치 글에서는 Git Bash부터 필수로 설치하라고 안내하기도 합니다. 현재 공식 문서는 Git for Windows를 선택 사항으로 안내하며, 설치되어 있지 않으면 Claude Code가 PowerShell 도구를 사용한다고 설명합니다. 이미 Git을 사용 중이라면 유지해도 됩니다.

1. PowerShell을 열고 공식 설치 명령 실행하기

시작 메뉴에서 PowerShell을 검색해 실행합니다. Windows Terminal이 열렸다면 선택한 탭의 종류도 보세요. 기본 입력 줄이 PS C:\Users\이름>처럼 보이면 PowerShell입니다. 글의 명령 상자에 있는 내용만 붙여 넣고, 앞의 PS나 > 표시는 함께 입력하지 않습니다.

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

Anthropic의 설치 스크립트를 내려받아 실행하는 명령입니다. 관리자 권한으로 열 필요는 없습니다. 회사 PC에서 설치를 제한한다면 표시된 정책 오류를 담당자에게 전달하세요. 관리자 실행이나 보안 설정 변경이 모든 설치 오류의 해결책은 아닙니다.

설치가 끝나면 PowerShell 창을 새로 열고 다음 명령을 실행합니다. 버전 번호가 나오면 프로그램 실행이 확인된 것입니다. 성공 문구만 봤더라도 새 창에서 이 확인을 한 번 거치세요. 설치가 끝난 창과 새 창에서 환경변수 적용 상태가 다를 수 있습니다.

claude --version

2. 작업 폴더와 저장 위치 정하기

실습 파일은 다운로드 폴더 곳곳에 만들지 않고 한 폴더에 모읍니다. 아래 명령은 현재 Windows 계정의 사용자 폴더에 dayable-menu-board를 만들고 이동합니다. 계정 이름이 한글이거나 공백을 포함해도 경로 전체를 따옴표로 감싸면 됩니다. 같은 폴더에 기존 작업이 있다면 이름을 바꿔서 진행하세요.

New-Item -ItemType Directory -Force "$env:USERPROFILE\dayable-menu-board"
Set-Location "$env:USERPROFILE\dayable-menu-board"
Get-Location

출력 경로의 끝이 dayable-menu-board인지 확인합니다. $env:USERPROFILE은 내 Windows 사용자 폴더를 가리킵니다. 브라우저에서 보게 될 파일도 이 안에 만들어집니다. 이후 설명에서 “프로젝트 폴더”라고 하면 이 폴더를 뜻합니다.

claude

3. 로그인하고 첫 대화 시작하기

첫 실행의 안내에 따라 인증 방식을 선택하고 브라우저에서 로그인합니다. Claude Code를 포함한 구독 또는 Console 계정이 필요합니다. 무료 Claude 계정만으로는 사용할 수 없습니다. 업무용 계정은 회사의 SSO나 지정된 연결 방식으로 인증할 수 있습니다.

인증을 끝냈으면 PowerShell로 돌아옵니다. 현재 작업 폴더 신뢰 여부를 물으면 방금 만든 폴더인지 확인하세요. 로그인만 바꿔야 하는 경우는 Claude Code 안에서 /login을 쓰면 됩니다. 이미 설치된 프로그램을 지우고 다시 설치할 이유는 없습니다.

4. 메뉴판 페이지를 만드는 첫 요청

아래 요청은 서버 설치 없이 브라우저로 열 수 있는 실습입니다. 실제 상품이 아닌 가상의 메뉴를 사용합니다. 한국어 요청문은 Claude Code의 입력 칸에 붙여 넣으세요. 일반 PowerShell 명령줄에 넣으면 프로그램 실행 명령으로 해석됩니다.

현재 폴더에 index.html 하나로 카페 메뉴판을 만들어줘.
가게 이름은 “느린 오후”야.
샘플 메뉴는 가상의 음료 4개, 디저트 2개로 총 6개를 넣어줘.
각 카드에 메뉴 이름, 분류, 가격, 한 줄 설명을 보여줘.
가격은 원 단위로 표시하고 샘플 데이터라고 작게 적어줘.
바탕은 크림색, 글자는 진한 초록색으로 해줘.
좁은 화면에서 카드와 글자가 겹치지 않게 만들어줘.
CSS와 JavaScript는 같은 파일에 넣어줘.
외부 패키지, 이미지 다운로드, 서버, 로그인 기능은 쓰지 마.
완료되면 생성한 파일 경로와 Windows에서 여는 방법을 알려줘.

파일을 만드는 동안 필요한 권한 안내가 나올 수 있습니다. 허용하려는 작업이 이 연습 폴더의 파일 생성인지 읽어보세요. 버전이나 설정에 따라 일상적인 편집은 확인창 없이 진행될 수도 있습니다. “완료되었다”는 답을 받으면 이제 실제 파일을 엽니다.

새 PowerShell 창을 열어 다음 두 줄을 실행하세요. 첫 줄은 위치를 다시 맞추고, 둘째 줄은 HTML 파일을 기본 연결 앱으로 엽니다. 텍스트 편집기에서 열린다면 파일 탐색기에서 index.html을 우클릭하고 “연결 프로그램”으로 Edge나 Chrome을 선택하세요.

Set-Location "$env:USERPROFILE\dayable-menu-board"
Start-Process .\index.html

파일 탐색기로 보고 싶다면 Win + E를 눌러 사용자 폴더의 dayable-menu-board로 이동하면 됩니다. Windows 11에서는 보기 > 표시 > 파일 이름 확장명을 켜두세요. 화면에 index.html로 보이지만 실제 이름이 index.html.txt인 경우를 구분할 수 있습니다.

5. 분류 버튼을 붙이고 동작 확인하기

첫 화면이 열렸다면 “전체 / 음료 / 디저트” 버튼을 추가해봅니다. 새 기능을 넣을 때는 원하는 모양뿐 아니라 클릭했을 때 보일 결과도 적습니다. 아래 요청은 현재 디자인을 유지하면서 분류 동작만 추가하도록 범위를 좁혔습니다.

현재 메뉴판의 색과 카드 디자인을 유지해줘.
제목 아래에 전체 / 음료 / 디저트 버튼을 추가해줘.
음료를 누르면 음료 4개만, 디저트를 누르면 디저트 2개만 보여줘.
전체를 누르면 메뉴 6개를 다시 보여줘.
선택된 버튼은 배경색과 텍스트로 구분해줘.
분류를 바꿔도 메뉴 데이터 자체는 삭제하지 마.
키보드 Tab으로 버튼에 이동하고 Enter로 선택할 수 있게 해줘.

작업이 끝나면 브라우저에서 Ctrl + R로 새로고침합니다. 음료, 디저트, 전체 순서로 눌러보고 카드 수가 4, 2, 6으로 바뀌는지 확인하세요. 마우스만 사용하지 말고 Tab 키로 버튼에 도달하는지도 한 번 살펴봅니다. 이 확인 순서는 DAYABLE이 정한 실습 기준입니다.

버튼은 생겼는데 클릭해도 아무 변화가 없다면 오류 문장을 확인할 수 있습니다. Edge에서는 Ctrl + Shift + J로 Console을 엽니다. 클릭한 직후 새로 나타난 오류가 있다면 그 문장과 파일 이름을 함께 전달하세요. Console에 코드를 붙여 넣어 실행할 필요는 없습니다.

메뉴판에서 디저트 버튼을 눌러도 카드 6개가 그대로 보여.
전체→디저트 순서로 클릭했어.
아래는 그때 Console에 나온 오류야.
[실제로 표시된 오류 문장을 여기에 붙여 넣기]
현재 index.html에서 원인을 찾아 고치고 확인 순서를 알려줘.

공개한 파일은 첫 메뉴판 요청과 분류 버튼 요청을 한 세션에 함께 전달해 생성했습니다. 처음 연습한다면 위 안내처럼 메뉴판을 먼저 열어 본 뒤 버튼을 추가하는 순서로 나눠도 됩니다. 화면이 나오는지와 클릭이 되는지를 따로 보면 어느 요청에서 문제가 생겼는지 찾기 쉽습니다.

6. 이 프로젝트의 규칙을 파일로 남기기

기능을 더하다 보면 기존의 색이나 파일 구성이 자꾸 달라질 수 있습니다. 다음 요청에도 유지할 내용은 프로젝트 폴더의 CLAUDE.md에 적어둡니다. Claude Code가 작업 문맥으로 읽는 파일입니다. 현재 프로젝트를 분석해 초안을 만드는 /init도 사용할 수 있습니다.

프로젝트 폴더에 CLAUDE.md를 만들고 다음 내용을 정리해줘.
이 프로젝트는 가상의 카페 “느린 오후” 메뉴판 연습이다.
index.html 한 파일로 동작하며 외부 패키지와 서버는 사용하지 않는다.
메뉴는 음료 4개와 디저트 2개로 구성한다.
한국어 문구, 크림색 바탕, 진한 초록색 글자를 유지한다.
Windows에서 Start-Process .\index.html로 확인한다.
수정 후 전체 6개, 음료 4개, 디저트 2개 표시를 확인한다.
프로젝트 밖의 파일은 수정하지 않는다.

“이번에는 버튼 간격만 바꾼다”는 요청은 대화에, “외부 패키지를 쓰지 않는다”는 공통 조건은 파일에 남깁니다. 나중에 서버를 붙이기로 했다면 지침도 함께 고칩니다.

7. 큰 변경은 계획으로, 대화는 이름을 붙여 보관하기

다음 단계로 메뉴 입력 폼을 만들고 싶다면 먼저 설계를 받아볼 수 있습니다. 아래는 일반 PowerShell에서 계획 모드로 시작하는 명령입니다. 진행 중인 세션에서는 Shift + Tab으로 모드를 바꾸고 Plan 표시를 확인할 수 있습니다.

claude --permission-mode plan

메뉴를 직접 추가하는 입력 폼을 넣으려고 해.
아직 파일을 바꾸지 말고 필요한 입력값과 화면 배치를 제안해줘.
가격이 비어 있거나 문자가 입력된 경우 어떻게 안내하면 좋을지도 적어줘.
이 단계에서는 결제나 회원가입 기능은 필요 없어.

설명한 범위가 맞으면 제안 중 이번에 구현할 부분을 선택해 진행합니다. 권한 규칙은 /permissions에서 확인할 수 있습니다. 작업 방향이 달라졌다면 Esc로 멈추고 범위를 다시 말하세요. 전체 권한을 해제하는 설정을 켜야 실습이 진행되는 것은 아닙니다.

실행 중인 Claude Code에서 아래 명령으로 대화 이름을 붙입니다. 폴더는 파일을 보관하는 위치, 세션은 작업을 주고받은 대화입니다.

/rename cafe-menu-first

exit로 대화를 종료한 뒤 다시 작업할 때는 같은 폴더로 돌아와 최근 세션을 이어갑니다. 목록에서 고르고 싶다면 claude --resume을 사용하세요. 대화가 길어지면 /compact로 요약하면서 이어갈 수 있고, 완전히 다른 일을 할 때는 새 세션을 여는 편이 구분하기 쉽습니다.

Set-Location "$env:USERPROFILE\dayable-menu-board"
claude --continue

8. Windows에서 막히는 지점 빠르게 찾기

설치 뒤 실행 파일을 찾지 못하면 아래 두 명령으로 위치를 확인할 수 있습니다. where.exe는 PATH에서 찾은 실행 파일을 보여주고, Test-Path는 네이티브 설치 경로에 파일이 있는지를 True 또는 False로 알려줍니다. True인데 명령을 못 찾으면 공식 문서의 사용자 PATH 설정을 확인하세요.

where.exe claude
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

업데이트는 설치 방식에 맞춰 진행합니다. 이 글의 네이티브 설치는 자동 업데이트를 지원하며 claude update로 즉시 확인할 수도 있습니다. WinGet으로 설치했다면 공식 WinGet 업데이트 경로를 따르세요. 원인을 모른 채 설치 폴더나 대화 데이터 폴더부터 지우지는 않습니다.

claude doctor

WSL을 쓰게 된다면 폴더 위치도 달라집니다

나중에 Linux 도구나 샌드박스 실행이 필요해 WSL 2를 선택할 수 있습니다. 그때는 Windows의 설치를 그대로 쓰는 방식으로 생각하지 말고 WSL 터미널 안에서 설치·실행 경로를 확인하세요. PowerShell 예제와 Linux용 셸 명령을 한 창에서 섞지 않는 것이 좋습니다.

Microsoft는 Linux 명령줄에서 주로 작업한다면 프로젝트도 WSL의 Linux 파일시스템에 두도록 권장합니다. PowerShell로 작업한다면 Windows 폴더를 사용합니다. Windows의 C:\ 경로와 WSL의 /home/ 경로를 구분하면 같은 이름의 파일을 서로 다른 곳에서 수정하는 일을 줄일 수 있습니다.

첫 실습을 마친 뒤 해볼 일

새 PowerShell을 열어 프로젝트로 이동하고 이전 대화를 이어갑니다. “디저트 가격 글자만 한 단계 크게 해줘”처럼 눈으로 확인할 수 있는 변경을 하나 요청해보세요. 수정한 파일을 브라우저에서 다시 열고, 기존 분류 버튼도 여전히 작동하는지 눌러봅니다.

메뉴판을 실제 매장에서 쓰려면 다음에는 메뉴를 누가 수정하고 어디에서 보여줄지 정해보세요. 단순 안내판과 주문·결제 서비스는 필요한 기능이 다릅니다. 사용 장면을 정한 뒤 지금 만든 파일에 필요한 기능을 더하면 됩니다.