[Prologue]
Claude Code : Anthropic이 개발한 터미널 기반의 AI 코딩 에이전트 도구. 단순히 코드를 제안하는 것을 넘어, 개발자의 터미널에서 로컬 파일을 직접 읽고, 수정하며, 테스트 실행 및 깃(Git) 커밋까지 자동으로 수행하는 'AI 소프트웨어 엔지니어' 역할.
설치이유 : 웹기반이 아닌 나의 데스크탑이나 노트북 환경들(폴더, 파일 등)을 Claude를 이용하여 직접 활용하고 싶어서.
윈도우에서 Claude Code를 설치하기 위해 필요한 프로그램들과 설치 과정을 기록으로 남겨두려 작성해본다.
[설치 프로그램]
- VS Code
- Python 3.14.4
- Node.js
- Git for Windows
- Claude Code
- [Download for Windows] 클릭 후 다운로드한 설치파일 실행 (이후 모든 설치파일은 오른클릭 후 관리자 권한으로 실행 추천)
- 기본설정 변경 없이 '동의', '다음', '설치' 진행. 추가작업 선택 단계에서 "PATH에 추가" 항목이 체크되어 있는지 확인.
code --version[Python 3.14.4]
https://www.python.org/downloads/
VS Code 실행후 Extensions(Ctrl+Shift+X) 왼쪽사이드바 5번째 아이콘 선택후 검색창에 python 검색 & install
- 최신 버전 다운로드 후 설치파일 실행. 첫 화면에서 반드시 확인할 것: "Add python.exe to PATH" 체크
- 체크 후 [Install Now] 클릭.
설치 완료 후 확인
python --version[Node.js]
- [Windows 설치 프로그램 (.msi)] 클릭 후, 다운로드한 설치파일 오른 클릭후 관리자 권한으로 실행
- 기본설정사항 변경 할 것 없이 설치 진행
node --version
npm --version기본설정으로 설치해도 되지만, 옵션 선택 화면에서 화면캡처(Win+Shift+S) 후 Claude와 대화하며 진행 추천.
Claude 추천 설정:
- Add a Git Bash Profile to Windows Terminal 체크
- Use Visual Studio Code as Git's default editor 선택 (VS Code 사용자)
- Override the default branch name → main 입력
- Fast-forward or merge 선택 (기본값 유지)
설치 완료 후 확인
git --version[Claude Code]
- VS Code 재실행 후 터미널(Ctrl+`)에서 아래 명령어 입력. (Ctrl+C로 복사 후 터미널에서 오른클릭 → 붙여넣기)
npm install -g @anthropic-ai/claude-code
- PowerShell 보안정책 오류 발생 시 아래 명령어 먼저 입력:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned- 이후 다시 설치 명령어 실행.
설치 완료 후 확인
claude --version
끝!
[Review]
설치 자체는 어렵지 않다. 그런데 생각보다 많은 사람이 비슷한 지점에서 막힌다.
"분명히 설치했는데 명령어가 안 먹혀요" 가장 흔한 경우.
Python이나 VS Code 설치할 때 PATH 추가 옵션을 그냥 넘긴 거다. 설치 화면이 길다 보면 체크박스를 놓치기 쉽다. 해결은 두 가지. 재설치하면서 이번엔 체크하거나, 윈도우 환경변수에 직접 경로를 추가하면 된다. 재설치가 훨씬 빠르다.
"설치 직후에는 됐는데 터미널 껐다 키니까 또 안 돼요"
PATH 변경은 터미널을 새로 열어야 반영된다. 설치 후엔 VS Code를 완전히 껐다가 다시 켜는 걸 습관으로 만들어두면 편하다.
"npm 설치는 됐는데 claude --version이 안 나와요"
Node.js 버전이 낮은 경우 발생한다. Claude Code는 Node.js 18 이상을 요구한다. 설치 전에 node --version으로 버전 먼저 확인하는 게 순서다.
첫 실행에서 API 키를 묻는다
claude를 처음 실행하면 Anthropic API 키 입력 화면이 나온다. 당황하지 않아도 된다. claude.ai 계정의 API 설정 페이지에서 키를 발급받아 붙여넣으면 된다. 설치보다 이 과정에서 멈추는 사람이 더 많다.