Claude Code 설치·사용법·가격: Windows에서 첫 프로젝트 시작

Windows에서 Claude Code는 PowerShell에 irm https://claude.ai/install.ps1 | iex를 입력해 설치하고, 프로젝트 폴더에서 claude를 실행해 로그인하면 바로 쓸 수 있다. 무료 요금제로는 쓸 수 없고, Pro(월 $22, 부가세 포함)·Max·Team·Enterprise 구독이나 선불 크레딧이 있는 Claude Console 계정이 필요하다. 화면으로 쓰고 싶다면 Claude 데스크톱 앱의 Code 탭도 있다. (빠른 시작)

Claude Code는 무엇을 하나

프로젝트 폴더를 읽고, 파일을 고치고, 테스트와 Git 명령까지 실행하는 코딩 에이전트다. 저장소에서 버그를 찾아 실제 파일을 바꾸는 일에 맞다. 코딩이 아닌 문서·파일 정리는 Claude Cowork가 맞다. (작동 방식)

설치

PowerShell 또는 Windows Terminal에서 다음 중 하나를 실행한다.

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

winget install Anthropic.ClaudeCode

방식	업데이트	비고
네이티브 설치(첫 번째)	백그라운드 자동 업데이트	Anthropic이 권장
WinGet	winget upgrade Anthropic.ClaudeCode로 직접	패키지 관리자를 선호할 때
npm	자동 업데이트	Node.js 22 이상 필요. 공식 권장은 네이티브

원격 스크립트를 실행하는 명령이니 주소가 공식 claude.ai인지 확인하고 쓴다. 설치 후 새 터미널에서 claude --version으로 확인한다. 관리자 권한은 필요 없다. Git for Windows는 권장이지만 필수는 아니다. 없으면 Claude Code가 PowerShell을 셸로 쓰고, 설치하면 Git Bash로 Bash 도구를 쓴다. (설치 문서)

첫 실행과 로그인

cd C:\path\to\your-project
claude

1. 브라우저 로그인 창에서 쓸 계정을 고른다. 구독 요금제를 쓸지, Console의 API 과금 계정을 쓸지 여기서 정해진다.
2. 브라우저가 저절로 열리지 않으면 c를 눌러 로그인 주소를 복사해 브라우저에 붙여 넣는다. 환경 변수 ANTHROPIC_API_KEY가 있으면 로그인 창 대신 그 키를 쓸지 묻는다. (인증 문서)
3. 다른 계정으로 바꾸려면 Claude Code 안에서 /login을 입력한다. (구독으로 쓰기)
4. 처음 여는 폴더는 신뢰할지 묻는다. 모르는 사람이 만든 저장소는 설정 파일과 스크립트를 먼저 본다. 홈 폴더에서 실행하면 이 선택이 저장되지 않아 매번 물으니 프로젝트 폴더에서 실행한다. (보안 문서)

첫 요청은 파일을 바꾸지 않는 읽기 작업으로 시작한다.

이 프로젝트 구조를 읽고 실행 방법과 핵심 폴더를 설명해줘. 아직 파일은 수정하지 마.

그다음 대상·유지할 부분·확인 방법을 적어 작은 작업을 맡긴다. “버그 고쳐줘”보다 이렇게 써야 쓸데없는 수정과 검토 시간이 준다.

회원가입 폼의 이메일 검증 오류를 고쳐줘. 화면 디자인은 바꾸지 말고 관련 테스트를 실행한 뒤 변경 파일과 결과를 알려줘.

권한 모드

Shift+Tab을 누를 때마다 Manual → Accept Edits → Plan 순서로 바뀐다. Auto는 쓸 수 있는 세션에서 Plan 뒤에 붙고, Bypass Permissions는 그 모드를 허용하는 옵션으로 시작한 세션에만 나온다. v2.1.283 이상의 터미널 세션은 Auto로 시작하고, Auto에서 한 번 누르면 Manual로 간다. (권한 모드)

모드	동작	언제
Manual	읽기는 바로 하고, 파일 수정·명령 실행은 묻는다	처음 쓸 때
Accept Edits	파일 편집과 일부 파일 명령은 자동 승인, 다른 명령은 묻는다	수정 범위를 믿을 때
Plan	조사하고 계획만 제안한다	낯선 프로젝트
Auto	분류기 모델이 사람 대신 작업을 검토해 질문을 줄인다. Opus·Sonnet 4.6 이상이나 Fable 모델에서 쓸 수 있고, Team·Enterprise는 관리자가 끌 수 있다	방향을 믿는 긴 작업
Bypass Permissions	거의 모든 승인을 건너뛴다	격리된 컨테이너·VM에서만

낯선 저장소는 Plan으로 변경 범위를 먼저 보고, 계획을 승인한 뒤 필요한 모드로 넘어간다. Plan에서도 Claude는 조사하려고 셸 명령을 실행하지만, 계획을 승인하기 전까지 소스 파일은 고치지 않는다.

설치 오류

증상	원인·조치
irm을 찾을 수 없음	명령 프롬프트(CMD)에서 실행했다. PowerShell을 연다
claude를 찾을 수 없음	모든 터미널을 닫고 새로 연다. 그래도 안 되면 %USERPROFILE%\.local\bin이 PATH에 있는지 본다
PSSecurityException	실행 정책이 npm 설치본의 claude.ps1을 막았다. Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser로 허용하거나, claude.cmd로 실행하거나, 첫 번째 설치 명령으로 네이티브 설치한다
Git Bash를 찾지 못함	settings.json의 env에 CLAUDE_CODE_GIT_BASH_PATH를 C:\Program Files\Git\bin\bash.exe로 넣는다

(설치 문제 해결) 어떤 방식으로 설치됐는지 모르겠으면 다음을 실행한다.

Get-Command claude | Select-Object Source
claude --version

Techies Note PC(Windows 11 Home)에서 9월 29일 실행하니 경로가 %APPDATA%\npm\claude.ps1, 버전이 2.1.245였다. 예전에 npm으로 설치했다는 뜻이다. 이 PC는 Get-ExecutionPolicy -List의 CurrentUser가 RemoteSigned라 문제없이 실행됐다. 경로가 %USERPROFILE%\.local\bin이면 네이티브 설치다. 두 방식이 섞였으면 npm uninstall -g @anthropic-ai/claude-code로 npm 쪽을 지우고 네이티브로 다시 설치한다.

변경 후 확인

• 작업이 끝나면 git diff와 테스트 결과를 본다. 자동으로 진행된 작업도 결과로 검토한다.
• 삭제·배포·DB 변경은 실행 전에 영향 범위를 확인한다. 외부 서버에 반영된 변경은 로컬에서 되돌릴 수 없다.

자주 묻는 질문

가격은 얼마이고, 무료로 쓸 수 있나? Claude Code만 따로 파는 요금제는 없다. Pro 월 $22(부가세 포함, 연간 결제 시 월 $18)부터 포함되고, Max는 월 $110부터다. 아이폰 앱으로 결제하면 Pro가 월 33,000원이다. 무료 요금제로는 쓸 수 없다. 구독 대신 Console에 크레딧을 충전하면 쓴 만큼 API 요금이 나간다. 요금제별 한도는 클로드 요금제·가격 비교에 있다.

데스크톱 앱의 Code 탭과는 무엇이 다른가? Code 탭도 Claude Code를 화면에서 쓰는 방식이다. 터미널이 익숙하지 않거나 변경 내용을 화면으로 보고 싶으면 그쪽이 편하고, 스크립트나 자동화와 함께 쓰려면 터미널이 낫다.

WSL에서도 쓸 수 있나? 쓸 수 있다. WSL 배포판을 열고 리눅스용 설치 명령(curl -fsSL https://claude.ai/install.sh | bash)으로 설치한 뒤, PowerShell이나 CMD가 아니라 WSL 터미널에서 claude를 실행한다. Git for Windows는 필요 없다.

모델을 바꾸려면? 대화창에서 /model로 바꾼다. 요금제에 따라 고를 수 있는 모델이 다르다. 최신 모델은 클로드 오퍼스 5.5 정리를 본다.