Claude Code 다운로드 및 Windows 설치: Desktop App, CLI, WSL 선택 가이드(2026)

Claude Code download를 검색할 때 가장 흔히 빠지는 함정은 다운로드 실패가 아니라, 먼저 어떤 것을 설치해야 할지 파악하지 못하는 것입니다.

• 그래픽 인터페이스를 원하고 여러 작업을 나란히 관리하려면 Claude Desktop을 다운로드하고 그 안의 Code 탭을 사용합니다.
• PowerShell, CMD, Git Bash 또는 IDE 터미널에서 claude를 입력하려면 Claude Code CLI를 설치합니다.
• 프로젝트와 툴체인이 주로 Linux에서 실행되거나 샌드박스가 필요하면 WSL 2에 설치합니다.
• Desktop과 CLI는 동시에 설치할 수 있으며, 서로 배타적인 선택이 아닙니다.

이 글은 2026년 8월 기준 공식 문서를 정리한 것입니다. 공식 다운로드 경로는 다음 두 곳뿐입니다.

• Claude 공식 다운로드 페이지
• Claude Code 공식 설치 문서

이른바 "Claude Code 설치 패키지"를 웹하드, 소프트웨어 다운로드 사이트 또는 낯선 GitHub Release에서 다운로드하지 마세요.

결론 먼저: Claude Code Desktop, CLI, WSL 어떻게 선택할까

가장 간단한 판단 기준:

• Claude Code를 처음 접한다면 Desktop을 먼저 설치합니다.
• 이미 터미널에 익숙하다면 CLI를 바로 설치합니다.
• 개발 환경이 이미 WSL에 있다면 파일 시스템을 넘나들며 애쓰지 말고 WSL 2에 바로 설치합니다.

Claude Code Desktop App 다운로드 및 설치

Claude Code의 데스크톱 버전은 'Claude Code.exe'라는 독립적인 제품이 아닙니다. Claude Desktop 앱의 Code 탭에 포함되어 있습니다.

1단계: 공식 다운로드 페이지에서 버전 선택

claude.com/download를 열고 Windows 사용자는 프로세서에 따라 선택합니다:

• 대부분의 Intel/AMD 컴퓨터: Windows x64 다운로드;
• Windows on ARM 기기: Windows ARM64 다운로드.

설치 후 시작 메뉴에서 Claude를 실행하고 Anthropic 계정에 로그인한 다음 상단의 Code를 클릭합니다.

2단계: 실행 환경 선택

새 Code 세션을 만들 때 데스크톱 버전은 일반적으로 세 가지 환경을 제공합니다:

• Local: 이 컴퓨터의 프로젝트를 직접 읽고 수정합니다.
• Remote: Anthropic의 클라우드 환경에서 실행합니다.
• SSH: 직접 관리하는 원격 Linux 또는 macOS 시스템에 연결합니다.

Claude가 로컬 프로젝트를 수정하게 하려면 Local을 선택하고 프로젝트 폴더를 선택하면 됩니다. Windows 로컬 세션에는 Git이 필요하므로 Git for Windows를 먼저 설치하는 것이 좋습니다.

Desktop 버전은 어떤 사람에게 적합한가

Desktop의 장점은 '터미널을 창에 넣는 것'이 아니라 여러 세션, 파일 편집기, 터미널, Diff 검토, 앱 미리보기, PR 상태를 하나의 인터페이스에 담는 것입니다. 터미널 탭을 계속 전환하지 않고 여러 Agent를 나란히 실행할 수 있습니다.

하지만 스크립트 기반 실행, 기존 터미널 사용, slash command를 자주 사용한다면 CLI가 더 직접적입니다.

Claude Code Desktop에는 Pro, Max, Team 또는 Enterprise 요금제가 필요합니다. 앱은 설치했는데 Code가 보이지 않으면 로그인 계정과 구독 권한을 먼저 확인하세요.

Claude Code CLI: Windows 네이티브 설치

이제 공식적으로 네이티브 설치 프로그램을 권장하며, Claude Code를 위해 Node.js를 전역으로 먼저 설치할 필요가 없습니다.

방법 1: PowerShell 설치(권장)

PowerShell을 열고 다음을 실행합니다:

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

설치가 완료되면 터미널을 닫고 다시 연 다음 확인합니다:

claude --version
claude

claude를 처음 실행하면 로그인을 안내합니다. 프로젝트 디렉터리로 이동한 후 실행해야 올바른 작업 디렉터리에서 코드를 읽습니다:

cd D:\Projects\my-app
claude

방법 2: WinGet 설치

Windows 패키지 관리자를 사용하는 경우:

winget install Anthropic.ClaudeCode

WinGet 버전은 네이티브 설치 프로그램처럼 자동으로 백그라운드 업데이트되지 않으므로, 나중에 수동으로 실행해야 합니다:

winget upgrade Anthropic.ClaudeCode

방법 3: CMD 설치

프롬프트가 C:\Users\...>이고 앞에 PS가 없다면 CMD를 사용하는 것입니다. 다음을 실행합니다:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

PowerShell과 CMD 명령은 혼용할 수 없습니다. '설치 스크립트 구문 오류'의 대부분은 본질적으로 CMD 명령을 PowerShell에 붙여넣었거나 그 반대인 경우입니다.

Claude Code Windows: 네이티브인가 WSL 2인가

Claude Code는 이제 네이티브 Windows를 지원하므로 더 이상 'Windows에는 반드시 WSL을 설치해야 한다'가 아닙니다. 그러나 두 환경에는 각각 장단점이 있습니다.

네이티브 Windows를 선택하는 경우:

• 프로젝트가 C:\ 또는 D:\에 있습니다.
• Visual Studio, PowerShell, Windows SDK 등 네이티브 도구에 의존합니다.
• 설치가 가장 간단하기를 원합니다.
• Claude Code 샌드박스가 필요 없습니다.

네이티브 모드에서는 Git for Windows 설치를 권장합니다. Claude Code는 Bash 도구 실행 시 Git Bash를 우선 사용하며, Git Bash가 없으면 PowerShell 도구를 사용할 수도 있습니다.

WSL 2를 선택하는 경우:

• 프로젝트가 주로 Linux, Docker, Node/Python 서버 툴체인으로 구성됩니다.
• 샌드박스가 필요합니다.
• 배포 환경이 Linux입니다.
• 이미 오랫동안 WSL 터미널에서 개발하고 있습니다.

WSL 2에 진입한 후 Linux 설치 명령을 실행합니다:

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

그런 다음 WSL 내에서 확인합니다:

claude --version
claude

Windows PowerShell에서 실행했다가 WSL에서 실행했다가 하면서 양쪽의 경로, Git, 환경 변수가 완전히 동일하길 기대하지 마세요. 프로젝트가 있는 환경에서 Claude Code를 설치하고 실행하세요.

Claude Code Desktop App과 CLI의 차이점

실용적인 조합은 평소에는 Desktop으로 여러 세션과 Diff를 확인하고, 자동화나 터미널 컨텍스트가 필요할 때 CLI를 사용하는 것입니다. CLI 설치 여부는 Desktop의 Code 탭이 정상적으로 작동하는 데 영향을 주지 않습니다.

Windows 설치 시 흔한 오류

1. `The token '&&' is not a valid statement separator`

CMD 명령을 PowerShell에 붙여넣었습니다. 위의 PowerShell 방법으로 돌아가 다음을 사용하세요:

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

2. `'irm' is not recognized`

현재 CMD를 사용 중이며 PowerShell이 아닙니다. Windows PowerShell을 열거나 CMD 설치 명령을 사용하세요.

3. `claude`은(는) 내부 또는 외부 명령이 아닙니다

먼저 터미널을 닫고 다시 엽니다. 여전히 찾을 수 없다면 %USERPROFILE%\.local\bin이 PATH에 있는지 확인한 후 다음을 실행합니다:

Get-Command claude

공식 진단 명령도 실행할 수 있습니다:

claude doctor

4. Git Bash를 찾을 수 없음

Git for Windows를 설치하세요. 사용자 지정 디렉터리에 설치한 경우 Claude Code 설정에서 지정할 수 있습니다:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

5. Desktop에 Code 탭이 없거나 403 오류가 발생

다음 순서로 확인하세요:

1. 현재 로그인한 계정이 Claude 요금제를 구매한 계정인지 확인합니다.
2. Claude Desktop이 최신 버전으로 업데이트되었는지 확인합니다.
3. 계정에서 로그아웃하고 앱을 다시 시작한 후 로그인합니다.
4. 팀 계정에서 관리자가 Claude Code를 제한했는지 확인합니다.

설치 후, 휴대폰이나 브라우저에서 Claude Code를 계속 사용하는 방법

설치는 'Claude Code가 어디에서 실행되는지'를 해결하고, 원격 제어는 '사람이 컴퓨터 앞에 없을 때 어떻게 계속할지'를 해결합니다.

Anthropic은 이미 Desktop, Web, Remote Control, 휴대폰 Dispatch 등의 공식 방법을 제공합니다. 공식 Claude 계정과 공식 모델만 사용한다면 이러한 기능을 우선 시도하는 것이 좋습니다.

다음과 같은 시나리오가 추가로 필요하다면 PandaNpc를 고려할 수 있습니다:

• 하나의 인터페이스에서 Claude Code, OpenAI Codex 및 PandaCode를 원격 제어합니다.
• Agent가 자신의 Windows / macOS / Linux 개발 머신에서 계속 실행됩니다.
• 사용자 지정 모델 또는 자체 API endpoint를 사용합니다.
• iPhone, 모든 브라우저, 다른 데스크톱 컴퓨터 또는 Chrome 사이드바에서 동일한 세션을 계속합니다.
• 스트리밍 출력, 도구 호출 승인, 질문에 대한 답변, 코드 변경 사항을 원격으로 확인합니다.
• 공용 포트를 열지 않으며, 개발 머신과 제어 단말 모두 아웃바운드 연결만 설정합니다.

공식 Claude Code가 정상적으로 실행되는지 먼저 확인한 후, 개발 머신에 pandapaw를 설치하세요:

Windows PowerShell:

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

macOS / Linux:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

설치 후 PandaNpc Agent를 열면 개발 머신의 연결이 목록에 나타납니다. Windows / macOS / Linux 클라이언트 또는 iOS App도 사용할 수 있습니다.

자주 묻는 질문

Claude Code는 데스크톱 소프트웨어인가요, 명령줄 도구인가요?

둘 다입니다. Claude Desktop의 Code 탭은 그래픽 인터페이스를 제공하고, Claude Code CLI는 터미널에서 시작합니다. 서로 다른 워크플로를 지원하며 동시에 설치할 수 있습니다.

Claude Code Windows에서 반드시 WSL을 사용해야 하나요?

반드시 그렇지는 않습니다. 네이티브 Windows가 지원됩니다. Windows 프로젝트는 네이티브 설치를 우선하고, Linux 툴체인 또는 샌드박스가 필요할 때 WSL 2를 선택하세요.

Claude Code download에 Node.js가 필요한가요?

Desktop은 필요 없습니다. 공식 네이티브 CLI 설치 프로그램도 필요 없습니다. 여전히 이전 방식인 npm install -g @anthropic-ai/claude-code를 사용할 때만 Node.js가 필요합니다.

Claude Code에 Windows ARM64 버전이 있나요?

Claude Desktop 공식 다운로드 페이지에서 Windows ARM64 설치 패키지를 제공합니다. CLI는 공식 설치 스크립트가 현재 인식하는 플랫폼을 기준으로 하세요.

Claude Code Desktop이 Linux를 지원하나요?

Claude Code의 데스크톱 Code 경험은 현재 macOS와 Windows를 대상으로 합니다. Linux 사용자는 CLI를 사용하거나 Web/원격 클라이언트를 통해 Linux에서 실행되는 세션을 조작할 수 있습니다.

Desktop과 CLI 중 어느 것이 더 나은가요?

절대적인 답은 없습니다. 시각적 인터페이스, 다중 세션, Diff와 미리보기를 원하면 Desktop을, 터미널 효율성, 스크립트화, 기존 개발 툴체인을 원하면 CLI를 선택하세요. Linux 환경과 샌드박스가 필요하면 WSL 2를 우선합니다.

한 줄 요약

빠르게 시작하고 싶다면 Claude 공식 다운로드 페이지에서 Desktop을 설치하고 Code 탭을 엽니다.

Windows 터미널에서 사용하려면 PowerShell에서 다음을 실행합니다:

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

프로젝트가 Linux 툴체인에 있다면 WSL 2에 진입하여 다음을 실행합니다:

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

먼저 공식 Claude Code를 올바르게 설치한 다음, Desktop과 CLI를 동시에 사용할지, 그리고 PandaNpc로 휴대폰, 브라우저 또는 다른 컴퓨터에서 원격으로 세션을 계속할지 결정하세요.