Claude Code Windows 설치 방법 2026 — WSL 없이도 되나? 완전 가이드

Windows에서 Claude Code, 생각보다 까다롭지 않다

Claude Code를 설치하려고 공식 문서를 찾아보면 macOS와 Linux 기준 설명이 먼저 나옵니다. Windows 사용자 입장에서는 “나는 어떻게 하면 되지?”라는 의문이 생길 수 있습니다.

결론부터 말하면 Windows에서도 Claude Code를 충분히 사용할 수 있습니다. 다만 macOS나 Linux보다 사전 준비가 조금 더 필요합니다. 이 글에서는 Windows 환경에서 Claude Code를 설치하는 방법을 2026년 기준으로 단계별로 정리합니다. WSL이 무엇인지, 꼭 필요한지도 함께 설명합니다.

WSL이란 무엇인가?

Claude Code Windows 설치를 검색하면 WSL이라는 단어가 반드시 등장합니다. WSL은 Windows Subsystem for Linux의 약자로, Windows 안에서 Linux 환경을 사용할 수 있게 해주는 기능입니다.

Claude Code는 기본적으로 Linux와 macOS 환경을 기준으로 설계된 CLI 도구입니다. Windows에서 바로 실행하려면 Linux 환경이 필요하기 때문에 WSL을 먼저 설치해야 합니다.

쉽게 말하면 Windows 컴퓨터 안에 작은 Linux 컴퓨터를 하나 설치하는 개념입니다. 복잡하게 들릴 수 있지만 설치 자체는 명령어 몇 줄로 끝납니다.

WSL 없이도 설치할 수 있을까?

많은 분들이 궁금해하는 부분입니다. WSL 없이 Windows에서 바로 Claude Code를 설치하는 방법도 있습니다.

PowerShell을 사용하는 방법입니다.

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

PowerShell을 관리자 권한으로 실행한 뒤 위 명령어를 입력하면 WSL 없이도 설치가 가능합니다. 다만 WSL 방식에 비해 일부 기능에서 제한이 생길 수 있고, 안정성 면에서도 WSL 환경이 더 권장됩니다.

간단하게 체험해보고 싶다면 PowerShell 방식으로 시작해도 되지만, 장기적으로 실무에서 활용할 계획이라면 WSL 환경을 구성하는 것이 좋습니다.

WSL 설치 방법 — 단계별 가이드

1단계 — PowerShell 관리자 권한으로 실행

Windows 검색창에 PowerShell을 입력한 뒤 마우스 오른쪽 버튼을 클릭해 관리자 권한으로 실행을 선택합니다.

2단계 — WSL 설치 명령어 입력

wsl --install

위 명령어를 입력하고 엔터를 누르면 WSL과 기본 Linux 배포판(Ubuntu)이 자동으로 설치됩니다. 인터넷 연결 상태에 따라 수 분이 소요될 수 있습니다.

3단계 — 컴퓨터 재시작

설치가 완료되면 컴퓨터를 재시작하라는 메시지가 나타납니다. 반드시 재시작해야 WSL이 정상적으로 활성화됩니다.

4단계 — Ubuntu 초기 설정

재시작 후 Ubuntu 터미널이 자동으로 열립니다. 처음 실행 시 Linux 사용자 이름과 비밀번호를 설정하라는 메시지가 나타납니다. 원하는 이름과 비밀번호를 입력하면 초기 설정이 완료됩니다.

비밀번호 입력 시 화면에 아무것도 표시되지 않는 것이 정상입니다. 입력 후 엔터를 누르면 됩니다.

5단계 — WSL 정상 설치 확인

PowerShell에서 아래 명령어로 WSL이 정상적으로 설치되었는지 확인할 수 있습니다.

wsl --list --verbose

Ubuntu가 Running 상태로 표시되면 정상입니다.

Claude Code 설치 — WSL 환경에서

WSL 설치가 완료되면 Ubuntu 터미널을 열고 아래 명령어를 입력합니다.

curl -fsSL https://claude.ai/install.sh | bash

설치가 자동으로 진행되며 완료 메시지가 표시됩니다. 설치 후 아래 명령어로 정상 설치 여부를 확인합니다.

claude --version

버전 번호가 출력되면 설치가 완료된 것입니다.

로그인 설정

설치 완료 후 아래 명령어로 Claude Code를 실행합니다.

claude

처음 실행하면 브라우저가 자동으로 열리면서 Claude.ai 로그인 화면이 나타납니다. Pro 플랜 이상의 계정으로 로그인하면 터미널과 자동으로 연동됩니다.

브라우저가 자동으로 열리지 않는 경우에는 터미널에 표시된 URL을 복사해서 브라우저에 직접 입력하면 됩니다.

Windows Terminal 설치 권장

WSL을 사용한다면 Windows Terminal을 함께 설치하는 것을 권장합니다. Windows Terminal은 Microsoft에서 공식 제공하는 터미널 앱으로, WSL Ubuntu 탭을 기본으로 지원합니다.

Microsoft Store에서 Windows Terminal을 검색해 설치하면 됩니다. 기본 PowerShell 창보다 훨씬 편하게 WSL 환경을 사용할 수 있습니다.

설치 후 Windows Terminal을 열면 상단 탭에서 Ubuntu를 선택할 수 있습니다. 이 탭에서 Claude Code를 실행하면 됩니다.

VS Code와 연동하기

Windows 환경에서 Claude Code를 VS Code와 함께 사용하고 싶다면 VS Code에 WSL 확장 프로그램을 설치하면 됩니다.

VS Code 확장 프로그램 탭에서 WSL을 검색해 Microsoft에서 제공하는 공식 확장 프로그램을 설치합니다. 설치 후 VS Code 왼쪽 하단의 연결 버튼을 클릭하면 WSL 환경에 연결된 VS Code가 실행됩니다.

이 상태에서 VS Code 내장 터미널을 열면 WSL Ubuntu 환경의 터미널이 열립니다. 여기서 Claude Code를 실행하면 VS Code 에디터와 Claude Code를 함께 사용할 수 있습니다.

Windows 설치 시 자주 겪는 문제

WSL 설치 중 가상화 오류가 발생한다

BIOS에서 가상화 기능이 비활성화된 경우 발생하는 문제입니다. 컴퓨터를 재시작해 BIOS 설정에 진입한 뒤 Intel VT-x 또는 AMD-V 옵션을 활성화하면 해결됩니다. BIOS 진입 방법은 컴퓨터 제조사마다 다르므로 제조사 홈페이지를 참고하세요.

claude 명령어를 입력했는데 찾을 수 없다고 나온다

터미널을 완전히 닫고 다시 열어서 시도해보세요. 그래도 해결되지 않는다면 아래 명령어로 경로를 직접 확인합니다.

which claude

경로가 출력되지 않는다면 설치가 정상적으로 완료되지 않은 것이므로 설치 명령어를 다시 실행해보세요.

브라우저 로그인 후 터미널에 반응이 없다

로그인 완료 후 브라우저를 닫고 터미널로 돌아오면 자동으로 연동됩니다. 잠시 기다려도 반응이 없다면 터미널을 재시작하고 claude 명령어를 다시 입력해보세요.

WSL에서 인터넷 연결이 안 된다

Windows 방화벽 설정에서 WSL 관련 네트워크 접근이 차단된 경우 발생할 수 있습니다. Windows Defender 방화벽 설정에서 WSL의 네트워크 접근을 허용해주면 해결됩니다.

마무리

Windows에서 Claude Code를 설치하는 과정은 macOS보다 단계가 조금 더 많지만, 하나씩 따라하면 어렵지 않게 완료할 수 있습니다. WSL 설치가 처음에는 낯설게 느껴질 수 있지만 한 번만 설정해두면 이후에는 macOS와 거의 동일한 환경으로 사용할 수 있습니다.

빠르게 시작해보고 싶다면 PowerShell 방식으로 먼저 설치해보고, 안정적인 환경이 필요하다면 WSL을 구성하는 것을 권장합니다. 다음 글에서는 Claude Code를 macOS에서 설치하는 방법을 M1, M2, M3 칩별 주의사항과 함께 정리해드리겠습니다.

다음 글 예고: Claude Code macOS 설치 방법 2026 — M1, M2, M3 칩별 주의사항 정리

7번 글로 바로 이어서 작성할까요? “네”라고 답해주시면 진행하겠습니다.