얼마 전에 서피스 프로8 의 초기화를 진행했습니다.
타입패드 키보드가 먹통이 되어서 진행했는데 결과적으로 키보드는 못살리고 블루투스 키보드를 하나 더 장만했습니다.
마우스랑 세트로 로지텍으로 장만했으니 소비의 합당성을 제공하고 제 타입패드는 사망했다고 볼 수 있겠습니다.
근데 그렇게 되면 서피스 펜의 충전을 위한 충전기를 따로 구매해야 하는건지…
아이패드를 주로 사용해서 서피스 펜은 잘 사용하지도 않는데 정말 열이 받습니다.
아무튼 그렇게 초기화 한 덕분에 제 컴퓨터는 매우 깔끔해졌구요, 그래서 깔린 것들이 아무것도 없습니다.
가장 급한건 지불하고 있는 디지털 월세를 날리지 않는 것이겠지요.
클로드 맥스 요금제 결제해버린 사람이 바로 접니다.
바로 클로드 코드부터 급하게 설치하려구요!!!
Windows에서 클로드코드 설치하기
PowerShell 열기
시작 메뉴에서 “PowerShell”을 타이핑해서 실행합니다. PowerShell이란 Windows에 기본으로 설치된 터미널입니다. 별도로 설치할 필요가 없습니다.
설치 명령어 입력
irm https://claude.ai/install.ps1 | iex이 한 줄이 클로드 코드 설치에 필요한 모든 것을 자동으로 다운로드하고 설치해 줍니다.
claude.ai: 앤스로픽의 클로드 공식 웹사이트 도메인입니다.install.ps1: 윈도우 환경(PowerShell)에서 클로드 코드 CLI를 설치하도록 앤스로픽이 미리 작성해 둔 공식 설치 파일(스크립트)입니다.irm(Invoke-RestMethod): 해당 웹 주소에 접속해 설치 파일을 다운로드합니다.iex(Invoke-Expression): 다운로드한 설치 파일을 즉시 실행하여 컴퓨터에 클로드 코드를 설치합니다.
설치 확인
claude --version
이잉? 오류가 납니다?
클로드 코드는 내부적으로 윈도우의 기본 프로그램이 아니라, Git Bash라는 프로그램이나 최신 버전의 PowerShell 7을 이용해 작동하도록 설계되어 있습니다.
윈도우 기본 파워쉘(PowerShell 5.1)을 사용 중이라 컴퓨터에 아직 Git이 설치되어 있지 않거나 경로가 연결되지 않아서 클로드 코드가 실행 준비를 마치지 못한 것입니다. 또한, 설치 직후 같은 창에서는 새로 설치된 명령어를 인식하지 못합니다.
클로드 코드를 설치하는 2가지 방법
여기서 하나 확인할 것이 이전에 클로드 코드를 설치할 때는 이 방식으로 하지 않았었거든요.
이렇게 한줄로 설치하는 방식이 아니고 Node.js + Git + npm 설치을 사용했었습니다.
따라서 두 방식의 차이점을 알아보았습니다.
1. 한 줄 명령어 설치 (irm ... | iex)
앤스로픽에서 제공하는 독립 실행형(Standalone) 자동 설치 방식입니다.
- 장점 (매우 편리함):
- 컴퓨터에 Node.js나 Git이 설치되어 있지 않아도, 스크립트가 알아서 필요한 환경을 세팅하고 클로드 코드를 설치해 줍니다.
- 초보자나 당장 도구만 빠르게 써보고 싶은 사용자에게 가장 빠르고 간편합니다.
- 기존에 깔려 있는 다른 개발 환경(버전 등)과 충돌할 확률이 적습니다.
- 단점:
- 내부적으로 어디에 무엇이 설치되는지 과정이 숨겨져 있어(블랙박스), 시스템 환경을 깐깐하게 통제하고 싶은 개발자에게는 답답할 수 있습니다.
2. Node.js + Git + npm 설치 (npm install -g @anthropic-ai/claude-code)
자바스크립트 생태계의 표준 패키지 관리자인 npm을 이용한 수동 설치 방식입니다.
- 장점 (통제력 및 버전 관리):
- 평소 자바스크립트(Node.js) 개발을 하던 사람들에게 매우 익숙한 방식입니다.
- 패키지의 업데이트(
npm update), 삭제(npm uninstall), 버전 관리 등을 npm 명령어 하나로 명확하게 통제할 수 있습니다.
- 단점 (번거로움):
- 사전에 Node.js와 Git을 직접 다운로드하고 설치해야 하며, 환경 변수 설정 등 사전 준비 작업이 필요합니다.
- 개발자가 아니라면 이 과정 자체가 진입 장벽이 될 수 있습니다.
중요: 현재는 npm 설치 방식을 권장하지 않습니다!
혹시 과거의 블로그 글이나 튜토리얼을 보셨다면 npm 설치를 안내할 수 있지만, 사실 한 줄 명령어 방식(irm [https://claude.ai/install.ps1](https://claude.ai/install.ps1) | iex)이 현재 앤스로픽 공식 문서에서 가장 강력하게 밀고 있는 “최신 권장(Recommended) 설치법”입니다.
- 왜 방식이 바뀌었을까?: 초기에는 npm(
npm install -g @anthropic-ai/claude-code)을 주로 썼으나, 사용자마다 Node.js 버전이 다르고 권한(Permission) 오류가 너무 자주 발생했습니다. 그래서 앤스로픽이 이런 스트레스 없이 한 번에 설치되도록 전용 스크립트(한 줄 명령어)를 직접 개발해 배포한 것입니다. - 버전 관리는 어떻게?: 한 줄 명령어로 설치하더라도 패키지 관리가 전혀 불편하지 않습니다. 터미널에서
claude update라는 명령어 하나만 치면 알아서 최신 버전으로 스스로 업데이트합니다.
어떤 설치 방식을 선택할까?
저는 git을 찾을 수 없어서 Git을 설치해야하는 상황인데, git만 추가로 설치할지, 아니면 기존의 Node.js + Git + npm 설치를 진행할지 고민이 되었습니다.
전 개발자는 아니지만은 클로드 코드로 mcp는 사용할 생각이거든요.
결론부터 말씀드리면, MCP(Model Context Protocol)를 적극적으로 활용하시려면 컴퓨터에 Node.js(npm) 환경이 깔려 있어야 할 확률이 매우 높습니다.
1. 클로드 코드 ‘설치’와 ‘MCP 서버 실행’은 별개입니다.
클로드 코드 자체를 구동하는 데는 npm이 필요 없지만, 클로드 코드가 외부 데이터나 도구(예: 로컬 데이터베이스, 슬랙, 구글 드라이브, 깃허브 등)와 소통하기 위해 띄우는 ‘MCP 서버’ 프로그램들 중 대다수가 Node.js 기반(npm 패키지)으로 만들어져 있습니다.
2. 왜 MCP를 쓸 때 npm 환경이 필요할까?
클로드 코드에 공식 MCP 서버를 연결할 때, 보통 설정 파일에 다음과 같은 명령어를 입력하게 됩니다.
npx -y @modelcontextprotocol/server-sqlite
여기서 쓰이는 npx라는 명령어가 바로 Node.js(npm)를 설치하면 함께 제공되는 패키지 실행 명령어입니다. 따라서 컴퓨터에 Node.js가 깔려있지 않다면, 클로드 코드가 저 명령어를 알아듣지 못해 MCP 서버를 켤 수 없게 되는 것입니다. (참고로 파이썬으로 만들어진 MCP 서버를 구동하려면 Python 환경이 필요합니다.)
파이썬 환경도 우선 구축하게 생겼네요. 연휴동안 할 일이 많겠습니다.
충돌 없이 확실하게 다시 시작하기 위해, 기존에 설치된 클로드 코드를 완전히 삭제
# 1. 클로드 코드 실행 파일 삭제
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude" -Force -ErrorAction SilentlyContinue
# 2. 클로드 코드 설정 및 데이터 폴더 삭제 (완전 초기화)
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force -ErrorAction SilentlyContinue
Write-Host "클로드 코드 삭제가 완료되었습니다!" -ForegroundColor Green
다시 처음부터 클로드코드 환경 설정하기
node.js와 git을 설치하고 cmd 명령 프롬프트로 들어갔습니다.
npm install -g @anthropic-ai/claude-code
이제 명령 프롬프트에 ‘claude’라고 입력해 클로드를 실행할 수 있습니다.
계정 승인을 받아서 연결하면 이제 클로드코드 세팅은 끝났습니다!
아휴 이제 파이썬 환경 세팅을 해야겠네요. 으아아아아
