Microsoft Store 없이 winget + Windows Terminal 복구하고 Claude Code 설치하기

Claude Code를 Windows 11 PC에 설치하려 했습니다. Node.js를 설치해야 하고, winget이 있으면 편할 것 같아서winget --version을 쳤습니다. “'winget'은 내부 또는 외부 명령이 아닙니다.” Microsoft Store를 열었더니 “이 링크를 열려면 장치에 새 앱이 필요합니다” 오류가 떴습니다.wsreset.exe를 실행해도 같은 결과였습니다. Store가 아예 없는 상태였습니다. winget, Windows Terminal 업데이트, Claude Code 설치 모두 막힌 상황에서 의존성 패키지 3개를 수동으로 설치해 winget을 살리고 최종적으로 Claude Code를 설치한 과정을 기록합니다.

초기 상태 진단

먼저 현재 상태를 정확히 파악했습니다. 무작정 고치려다 더 꼬이는 경우가 많기 때문입니다.

정품 인증 확인

설정 → 시스템 → 정품 인증으로 들어가니 정품으로 확인됐습니다. 라이선스 문제가 아니라는 뜻입니다. Store가 깨진 건 별개의 문제입니다.

Store 상태 확인

# 실행 → wsreset.exe
# 결과: "이 링크를 열려면 장치에 새 앱이 필요합니다"
# Store 앱 자체가 시스템에 없는 상태

winget 상태 확인

# PowerShell에서
winget --version
# 결과: 'winget'은 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
#       배치 파일이 아닙니다.

Get-AppxPackage Microsoft.DesktopAppInstaller
# 결과: (아무것도 출력 안 됨) — 완전히 없는 상태

1단계: 의존성 패키지 3개 다운로드

winget(App Installer)을 설치하려면 먼저 두 가지 의존성 패키지가 필요합니다. 이 순서를 지켜야 합니다. 역순으로 설치하면 App Installer 설치 자체가 실패합니다.

VCLibs 다운로드

브라우저 주소창에 다음 URL을 입력하면 바로 다운로드됩니다.

https://aka.ms/Microsoft.VCLibs.x64.14.00.Desktop.appx

UI.Xaml 2.8 다운로드

NuGet에서 다운로드합니다. 검색창에 Microsoft.UI.Xaml을 입력하고 2.8.x 버전을 선택한 다음 오른쪽의 “Download package”를 클릭합니다. .nupkg 파일이 내려옵니다.

https://www.nuget.org/packages/Microsoft.UI.Xaml/

App Installer 다운로드

https://aka.ms/getwinget

.msixbundle 파일이 다운로드됩니다. 파일명은Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle형태입니다. 세 파일 모두 다운로드 폴더에 저장합니다.

2단계: .nupkg 파일 다루는 법

.nupkg는 ZIP 파일입니다. 확장자를 .zip으로 바꾸면 압축 해제가 됩니다.

3단계: PowerShell로 패키지 설치

PowerShell을 관리자 권한으로 실행합니다. 시작 버튼 우클릭 → “Windows PowerShell(관리자)” 또는 “터미널(관리자)”를 선택합니다.

cd $env:USERPROFILEDownloads

# 1. UI.Xaml 먼저
Add-AppxPackage .Microsoft.UI.Xaml.2.8.appx

# 2. VCLibs
Add-AppxPackage .Microsoft.VCLibs.x64.14.00.Desktop.appx

# 3. App Installer (winget)
Add-AppxPackage .Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle

예상 결과

설치 확인

Get-AppxPackage -AllUsers Microsoft.DesktopAppInstaller

# 출력 예시:
# Name              : Microsoft.DesktopAppInstaller
# Publisher         : CN=Microsoft Corporation, ...
# Architecture      : X64
# ResourceId        :
# Version           : 1.27.470.0
# ...

버전이 출력되면 App Installer가 정상 설치된 것입니다. 하지만 아직 끝이 아닙니다.

4단계: winget PATH 문제 해결

App Installer가 설치됐음에도 winget --version이 여전히 실패할 수 있습니다. 설치는 됐지만 PATH에 등록되지 않은 상태입니다.

winget --version
# 여전히: 'winget'은 내부 또는 외부 명령이 아닙니다.

직접 경로로 실행하기

winget 실행 파일의 경로를 직접 찾아서 실행합니다.C:\Program Files\WindowsApps\ 안에 있습니다.

# 버전 번호는 본인 설치 버전에 맞게 변경
$wg = "C:Program FilesWindowsAppsMicrosoft.DesktopAppInstaller_1.27.470.0_x64__8wekyb3d8bbwewinget.exe"
& $wg --version
# 출력: v1.12.470

Get-AppxPackage -AllUsers Microsoft.DesktopAppInstaller | Select-Object Version, InstallLocation

재부팅으로 PATH 등록

PC를 재부팅하면 대부분 PATH가 자동으로 잡힙니다. 재부팅 후 새 PowerShell 창을 열고 winget --version을 다시 시도합니다. 여전히 안 되면 직접 경로 방식($wg 변수)으로 계속 진행해도 됩니다.

5단계: Windows Terminal + PowerShell 설치

winget이 작동하면 나머지는 간단합니다. Windows Terminal 최신 버전과 PowerShell 7을 설치합니다.

# winget이 PATH에 잡혔을 때
winget install --id Microsoft.WindowsTerminal -e
winget install --id Microsoft.PowerShell -e

# PATH가 아직 안 잡혔을 때 ($wg 변수 사용)
& $wg install --id Microsoft.WindowsTerminal -e
& $wg install --id Microsoft.PowerShell -e

설치가 끝나면 전체 업그레이드도 한 번 실행해 두면 좋습니다.

winget upgrade --all

새로 설치된 Windows Terminal을 열면 탭, 화면 분할, GPU 가속 렌더링이 다 됩니다. 이 상태에서 Claude Code 설치로 넘어갑니다.

Claude Code 설치

Claude Code는 Node.js npm 패키지입니다. 먼저 Node.js를 설치합니다.

Node.js 설치

winget install --id OpenJS.NodeJS.LTS -e

설치 후 PowerShell 창을 닫았다가 다시 열어야 PATH가 적용됩니다.

node --version
# v22.x.x 또는 v24.x.x

npm --version
# 10.x.x

Claude Code 설치

npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

첫 실행

# 작업할 폴더로 이동
cd C:UsersAdministratorProjectsmy-project

# Claude Code 시작
claude

처음 실행하면 Anthropic 계정 로그인이 필요합니다. 브라우저가 열리고 인증이 완료되면 터미널로 돌아와 바로 사용할 수 있습니다.

시행착오 정리

이 과정에서 막혔던 지점들을 카드로 정리합니다.

전체 순서 요약

마무리

Store 없이 winget을 살리는 방법은 문서로 잘 정리되어 있지 않습니다. Microsoft 공식 GitHub에 절차가 있긴 하지만 .nupkg 처리나 PATH 문제는 직접 부딪혀 봐야 알 수 있는 것들입니다.

핵심은 간단합니다. App Installer는 파일 3개를 순서대로 설치해야 작동합니다.VCLibs 오류는 무시해도 되고, winget이 PATH에 안 잡히면 직접 경로로 실행하면 됩니다. 재부팅하면 대부분 해결됩니다.

Claude Code가 설치된 이후의 워크플로우가 궁금하다면 터미널 하나로 개발하는 실사용 워크플로우를, SSH 원격 서버에서 Claude Code를 끊김 없이 쓰고 싶다면 tmux 세션 관리 가이드를 참고하세요.