클로드 코드 윈도우 설치, 네이티브로 할지 WSL로 할지 고르는 기준

클로드 코드는 윈도우에서 WSL 없이 바로 설치할 수 있어요. PowerShell이라면 irm https://claude.ai/install.ps1 | iex, CMD라면 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd 한 줄을 실행하면 되고, Anthropic 설치 문서는 관리자로 실행할 필요가 없다고 적어요. WSL을 고를 이유는 따로 있어요. 문서의 윈도우 설정 표는 리눅스 도구 체인이 필요하거나 샌드박스 안에서 명령을 실행하고 싶을 때 WSL 2를 쓰라고 안내하고, 네이티브 윈도우와 WSL 1은 샌드박스를 지원하지 않는다고 적어요. WSL에서 쓴다면 프로젝트를 윈도우 파일 시스템(/mnt/c/)이 아니라 리눅스 파일 시스템(/home/)에 두라는 안내도 문제 해결 문서에 있어요.

계정 조건은 설치 방식에 따라 나뉘지 않아요. 설치 문서의 인증 항목은 클로드 코드에 Pro, Max, Team, Enterprise, Console 계정 중 하나가 필요하고, 무료 claude.ai 플랜에는 클로드 코드 접근이 포함되지 않는다고 적어요.

이 글은 윈도우 사용자 기준으로 이 순서로 정리했어요. 네이티브와 WSL을 가르는 표, 설치 전 조건, 세 가지 설치 명령과 업데이트 차이, Git for Windows가 바꾸는 것, WSL에서 달라지는 점, 실제 설치 위치, 그리고 '설치 안됨' 오류 문구별 해결이에요.

아래 내용은 2026년 10월 9일 오후 4시 37분부터 5시 7분 사이(한국 시각)에 Anthropic의 클로드 코드 공식 문서 다섯 편(설치, 설치 문제 해결, 문제 해결, 샌드박스, 도구 참조)과 GitHub 저장소 README, GitHub 이슈 한 건의 상태를 받아 해당 문장을 옮긴 거예요. 설치, 설치 문제 해결, 문제 해결 문서는 한국어판과 영어판을 함께 봤어요. 이 글을 쓴 윈도우 11 PC에 네이티브로 설치된 클로드 코드도 같은 날 오후 4시 38분에 PowerShell로 확인했어요. WSL에는 설치해 보지 않았기 때문에 WSL 이야기는 모두 문서 문장이에요.

클로드 코드 윈도우 설치, 네이티브와 WSL 중 고르는 기준

설치 문서의 'Windows에서 설정' 절은 프로젝트가 위치한 곳과 필요한 기능을 기준으로 고르라고 하면서 선택지 세 개를 표로 적어요. 한국어판 표를 그대로 옮기면 이래요.

표에서 네이티브와 WSL 2를 가르는 칸은 샌드박스예요. 샌드박스 문서는 이 기능을 클로드가 내 컴퓨터에서 실행하는 셸 명령 주변에 운영체제가 강제하는 경계라고 설명해요. 명령이 닿을 수 있는 파일과 네트워크 도메인을 정해 두면 운영체제가 실행 중에 그 범위를 지키기 때문에, 클로드 코드가 샌드박스 안 명령은 하나하나 승인을 묻지 않고 실행할 수 있다는 설명이에요.

같은 문서는 샌드박스가 macOS, 리눅스, WSL2에서 돌고, 네이티브 윈도우에서는 클로드 코드가 명령을 샌드박스 없이 실행한다고 적어요. 윈도우 PC에서 샌드박스를 쓰려면 WSL2 배포판 안에서 클로드 코드를 실행하라는 안내가 바로 붙어 있어요.

프로젝트를 어디에 두느냐와 관련된 안내는 설치 문서가 아니라 클로드 코드 문제 해결 문서에 한 항목 더 있어요. 'WSL에서 느리거나 불완전한 검색 결과' 항목은 WSL에서 파일 시스템을 넘나들며 작업할 때 생기는 디스크 읽기 성능 저하 때문에 검색 결과가 예상보다 적게 나올 수 있다고 적어요. 검색은 동작하지만 네이티브 파일 시스템보다 적은 결과를 돌려주고, 이때 claude doctor는 검색 항목을 OK로 표시한다고 해요. 그래서 진단 명령만으로는 알아차리기 어려워요.

문서가 든 해결책은 세 가지예요.

1. 디렉터리나 파일 유형을 지정해 검색할 파일 수를 줄이기
2. 가능하면 프로젝트를 윈도우 파일 시스템(/mnt/c/)이 아니라 리눅스 파일 시스템(/home/)에 두기
3. 더 나은 파일 시스템 성능을 위해 WSL 대신 네이티브 윈도우에서 클로드 코드를 실행하는 것을 고려하기

이 항목이 다루는 범위는 파일 시스템을 넘나들 때의 성능이에요. 네이티브와 WSL 가운데 어느 쪽이 모든 작업에서 빠른지 순위를 매긴 문장은 아니니, 윈도우 폴더에 있는 프로젝트를 WSL에서 다룰 때의 주의점으로 읽으면 돼요.

그러니 고르는 기준은 이렇게 정리돼요.

• 윈도우 폴더에 있는 프로젝트를 윈도우 도구로 다루고 샌드박스가 필요 없다면 네이티브 윈도우
• 리눅스 도구 체인이 필요하거나 샌드박스 안에서 명령을 실행하고 싶다면 WSL 2
• WSL에서 쓴다면 프로젝트는 가능하면 /mnt/c/ 아래 윈도우 폴더가 아니라 WSL 안의 리눅스 파일 시스템(/home/)에 두기
• WSL 1은 WSL 2를 쓸 수 없을 때의 선택지

WSL 2를 골랐다고 샌드박스가 저절로 켜지지는 않아요. 문서는 샌드박스가 기본으로 꺼져 있고, 세션에서 /sandbox를 실행하거나 설정 파일에서 켜야 한다고 적어요.

설치 전에 확인할 윈도우 조건

설치 문서의 시스템 요구 사항 가운데 윈도우에 해당하는 줄은 이래요.

• 운영체제: Windows 10 1809 이상 또는 Windows Server 2019 이상
• 하드웨어: RAM 4GB 이상, x64 또는 ARM64 프로세서
• 셸: PowerShell 또는 CMD(문서는 Bash, Zsh도 함께 적어요)
• 네트워크: 인터넷 연결 필요
• 위치: Anthropic 지원 국가

설치 문제 해결 문서는 여기에 하나를 더 적어요. 클로드 코드는 64비트 운영체제가 필요하고, 32비트 윈도우는 지원하지 않아요.

계정은 앞에서 말한 대로 Pro, Max, Team, Enterprise, Console 중 하나예요. 문서는 아마존 베드록, 구글 클라우드의 에이전트 플랫폼, 마이크로소프트 파운드리 같은 외부 API 제공자로 클로드 코드를 쓰는 방법도 같은 문단에 적어요. 무료로 쓸 수 있는 터미널 코딩 도구를 찾는 중이라면 클로드 코드와 코덱스, 제미나이 CLI의 무료 범위를 비교한 글에서 계정별 진입 경로를 이어 볼 수 있어요.

윈도우 클로드 코드 설치 명령어, PowerShell·CMD·WinGet

설치 문서의 첫 탭 이름은 영어판이 'Native Install (Recommended)', 한국어판이 '기본 설치 (권장)'예요. 이 탭 안에 PowerShell 명령과 CMD 명령이 함께 들어 있어요. WinGet은 별도 탭이고 '권장' 표시가 붙어 있지 않아요.

지금 열린 창이 어느 셸인지는 프롬프트로 구분해요. PowerShell에서는 프롬프트 앞에 PS C:\가 보이고, CMD에서는 PS 없이 C:\만 보여요. 문서는 PowerShell에서 설치하든 CMD에서 설치하든 달라지는 건 실행하는 설치 명령뿐이라고 적어요.

PowerShell 창이라면 이 명령이에요.

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

CMD 창이라면 이 명령이에요.

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

WinGet을 쓴다면 이 명령이에요.

winget install Anthropic.ClaudeCode

PowerShell과 CMD 설치 명령은 내려받는 동안 진행 상황을 보여 주지 않아요. 끝나면 새 터미널 창을 열고 claude --version을 실행하세요. 버전 번호가 나오면 설치된 거예요. 문서는 설치를 실행한 창이 예전 PATH를 그대로 갖고 있다고 적어요. 같은 창에서 바로 치면 명령을 못 찾을 수 있다는 뜻이에요.

세 경로의 차이는 설치 뒤 업데이트에서 갈려요.

네이티브 설치는 시작할 때와 실행 중에 주기적으로 업데이트를 확인하고, 백그라운드에서 받아 둔 새 버전은 다음에 클로드 코드를 시작할 때 적용돼요. 기다리지 않고 바로 올리려면 claude update를 실행하면 돼요. 업데이트 채널은 기본값이 latest이고, 보통 1주일쯤 지난 버전을 받으면서 큰 문제가 있던 릴리스를 건너뛰는 stable로 바꿀 수 있어요.

WinGet으로 설치했다면 업데이트를 직접 챙겨야 해요. 문서는 WinGet 설치가 기본적으로 자동 업데이트되지 않으니 winget upgrade Anthropic.ClaudeCode를 주기적으로 실행하라고 적어요. 클로드 코드가 대신 업그레이드 명령을 실행하게 하려면 환경 변수 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE를 1로 두면 돼요. 다만 클로드 코드가 실행 중이면 윈도우가 실행 파일을 잠가서 WinGet 업그레이드가 실패할 수 있고, 그때는 수동 명령을 대신 보여 준다고 적혀 있어요.

터미널을 쓰고 싶지 않다면 설치 문서의 안내처럼 데스크톱 앱으로 클로드 코드를 쓰는 길도 있어요.

Git for Windows는 꼭 깔아야 하나요

네이티브 설치에 꼭 필요한 건 없어요. 설치 문서의 표와 '네이티브 Windows에 설치' 절은 Git for Windows를 선택 사항으로 적고, 설치 탭 문장은 클로드 코드가 Bash 도구를 쓸 수 있도록 네이티브 윈도우에 권장한다고 적어요. 설치 여부가 바꾸는 건 클로드 코드가 셸 명령을 어디로 보내느냐예요.

• Git for Windows가 없으면 클로드 코드는 PowerShell 도구로 셸 명령을 실행해요. 도구 참조 문서에 따르면 PowerShell 7 이상(pwsh.exe)을 먼저 찾고, 없으면 PowerShell 5.1(powershell.exe)을 써요.
• Git for Windows가 있으면 Bash 도구가 Git Bash를 써요. claude.ai와 Console 계정이라면 PowerShell 도구도 기본으로 함께 켜져 있어요.
• Monitor 도구는 윈도우에서 Git Bash가 있을 때만 쓸 수 있어요. 백그라운드에서 명령을 돌리며 출력 줄을 클로드에게 넘겨 로그나 파일 변화에 반응하게 하는 도구예요.

PowerShell 도구는 문서에 미리보기 단계로 표시돼 있어요. 알려진 제한으로 적힌 건 두 가지예요. PowerShell 프로필을 불러오지 않는다는 점, 그리고 윈도우에서는 샌드박스가 지원되지 않는다는 점이에요.

Git을 설치했는데 클로드 코드가 Git Bash를 못 찾는다면 settings.json의 env 항목에 CLAUDE_CODE_GIT_BASH_PATH를 넣고 bash.exe 경로를 값으로 적어요. JSON 파일이라 문서 예시도 역슬래시를 두 번씩 써서 C:\\Program Files\\Git\\bin\\bash.exe로 적어요. 이 값이 없을 때 클로드 코드는 C:\Program Files\Git과 C:\Program Files (x86)\Git을 먼저 보고, 그다음 PATH에 잡히는 git의 설치 폴더 안 bin 폴더에서 bash.exe를 찾아요. 이 값에는 bash.exe, sh.exe, bash, sh라는 이름의 파일만 받아서, git-bash.exe를 적으면 무시하고 자동 탐색으로 돌아가요.

WSL에 설치한다면 Git for Windows는 필요 없어요. 설치 문서가 이 점을 따로 적어 두었어요.

WSL에 클로드 코드를 설치할 때 달라지는 점

WSL에서는 설치 명령부터 달라요. 문서는 WSL 배포판을 열고 리눅스 설치 프로그램을 실행하라고 하면서, 설치와 실행 모두 PowerShell이나 CMD가 아니라 WSL 터미널 안에서 하라고 적어요. WSL 터미널에서 실행할 명령은 macOS, 리눅스와 같은 이 명령이에요.

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

이 명령을 윈도우 PowerShell에 그대로 붙여 넣으면 뒤의 오류 표에 나오는 'fsSL' 매개변수 오류가 나요. PowerShell에서 curl은 Invoke-WebRequest의 별칭이라 -fsSL 옵션을 받지 못한다고 문서는 설명해요.

샌드박스를 쓰려고 WSL 2를 골랐다면 추가로 설치할 게 있어요. 샌드박스 문서는 리눅스와 WSL2의 샌드박스가 bubblewrap과 socat에 기대고, Ubuntu나 Debian에서는 sudo apt-get install bubblewrap socat으로 설치한다고 적어요. 빠진 게 있는지는 세션에서 /sandbox를 실행하면 의존성 탭에 표시돼요. 의존성 확인은 시작할 때 이뤄지기 때문에 패키지를 설치한 뒤에는 클로드 코드를 다시 시작해야 /sandbox가 인식한다고 문서는 적어요.

배포판이 Ubuntu 24.04 이후 버전이라면 하나를 더 봐야 해요. 문서는 Ubuntu 24.04 이후의 기본 AppArmor 정책이 bubblewrap의 사용자 네임스페이스 생성을 막는다고 적어요. WSL2 안에서 sysctl kernel.apparmor_restrict_unprivileged_userns를 실행해 1이 나오면 bwrap용 AppArmor 프로필을 추가해야 하고, 0이 나오거나 해당 키가 없다는 오류가 나오면 이 단계를 건너뛰면 돼요.

WSL 버전은 PowerShell에서 wsl -l -v로 확인해요. 'Sandboxing requires WSL2'라는 문구가 보이면 그 배포판이 WSL1에서 돌고 있다는 뜻이에요. 문서는 WSL2로 올리거나 샌드박스 없이 쓰라고 안내해요.

WSL1에서 claude를 실행했는데 cannot execute binary file: Exec format error가 나오면, 문서가 GitHub 이슈 #38788과 연결해 설명하는 알려진 회귀예요. 바이너리의 프로그램 헤더가 WSL1 로더가 처리하지 못하는 방식으로 바뀌었다는 설명이에요. 다만 2026년 10월 9일에 확인한 이 이슈는 7월 31일 GitHub 봇이 '계획 없음(not planned)'으로 닫았고, 9월 23일에 잠겼어요. 닫을 때 남긴 사유는 수정 완료가 아니라 오래 활동이 없었다는 것이에요.

문서가 적은 가장 깔끔한 해결은 PowerShell에서 배포판을 WSL2로 바꾸는 거예요. 배포판 이름이 Ubuntu라면 이렇게 실행해요.

wsl --set-version Ubuntu 2

WSL1에 머물러야 한다면 문서는 WSL 안의 .bashrc 파일에 claude를 동적 링커(/lib64/ld-linux-x86-64.so.2)로 실행하는 함수를 넣고, 그 파일을 다시 불러온 뒤 claude를 실행하는 우회법도 적어요. 함수 내용은 설치 문제 해결 문서의 'WSL1에서 Exec format error' 항목에 있어요.

로그인도 네이티브와 조금 달라요. 문서는 WSL2에서 브라우저가 보통 다른 호스트에서 열려서 로그인 뒤 자동으로 돌아오지 못하고 브라우저에 로그인 코드가 표시될 수 있다고 적어요. 그 코드를 터미널의 'Paste code here if prompted' 자리에 붙여 넣으면 로그인이 끝나요. 붙여 넣기가 먹지 않으면 claude auth login을 쓰라고 하고, 브라우저가 아예 열리지 않으면 BROWSER 환경 변수에 윈도우 브라우저 경로를 넣는 방법을 안내해요.

클로드 코드 설치 위치, 이 PC에서 확인한 모습

네이티브 설치 프로그램은 실행 파일을 %USERPROFILE%\.local\bin\claude.exe에 두고, 버전 파일은 %USERPROFILE%\.local\share\claude 아래에 둬요. 설치 문서의 윈도우 제거 명령도 이 두 경로를 지우는 명령이에요. VS Code 확장만 설치했다면 이 경로에 claude가 없어요. 문제 해결 문서는 확장이 자체 CLI 사본을 확장 폴더 안에 두고 PATH에 추가하지 않는다고 적어요.

이 글을 쓴 윈도우 11 Pro(64비트) PC에서 2026년 10월 9일 오후 4시 38분에 PowerShell로 확인한 값은 이래요. 사용자 폴더 이름은 %USERPROFILE%로 바꿔 적었어요.

버전 숫자는 확인한 시점의 값이에요. 네이티브 설치는 자동으로 업데이트되기 때문에, 이 PC의 versions 폴더 파일도 수정 시각으로 보면 10월 7일, 8일, 9일에 하나씩 들어왔어요. 설치 문서의 서명 항목은 윈도우 바이너리가 'Anthropic, PBC'로 서명돼 있고 Get-AuthenticodeSignature로 확인할 수 있다고 적는데, 이 PC의 claude.exe도 같은 서명자로 유효하게 나왔어요.

bin 폴더의 claude.exe.old. 파일 두 개는 업데이트 흔적이에요. 문제 해결 문서는 윈도우에서 업데이트할 때 기존 claude.exe의 이름을 바꿔 백업으로 돌려 두고 새 버전을 그 자리로 옮긴다고 적어요. 파일 이름의 첫 숫자를 시각으로 바꾸면 10월 8일 오전 10시 43분과 10월 9일 오후 3시 4분이었고, 두 파일의 해시는 versions 폴더의 2.1.292, 2.1.293 파일과 같았어요. 업데이트 직전 버전이 백업으로 남아 있는 거예요.

용량도 확인했어요. bin 폴더 세 파일과 versions 폴더 세 파일을 합치면 1,541,048,256바이트, 약 1.5GB였어요. 설치 문서는 네이티브 설치 프로그램이 versions 폴더의 이전 버전을 스스로 지운다고 적어요. 런처가 가리키는 버전과 같은 PC에서 실행 중인 세션이 쓰는 버전 말고는, 최신 두 버전을 남기고 나머지를 지운다는 문장이에요. 백업 파일에 대해 문서가 안내하는 사용법은 업데이트 뒤 claude.exe가 사라졌을 때 가장 최근 백업의 이름을 되돌리는 것 하나예요.

클로드 코드 설치 안됨, 윈도우 오류 문구별 해결

설치 문제 해결 문서의 오류 표와 윈도우 관련 절에서 윈도우, PowerShell, CMD, WSL이 걸린 항목을 모으면 이래요. 화면에 왼쪽 문구가 보이면 오른쪽부터 해 보세요.

32비트 오류가 나왔다면 같은 창에서 [Environment]::Is64BitOperatingSystem을 먼저 실행해 보세요. True가 나오면 운영체제는 문제가 없고 창만 잘못 연 거예요. False가 나오면 32비트 윈도우예요. 문서는 클로드 코드에 64비트 운영체제가 필요하다고 적어요.

PATH에 설치 폴더가 있는지 확인하고 추가하기

PowerShell에서 아래 명령으로 PATH에 설치 폴더가 있는지 봐요.

$env:PATH -split ';' | Select-String '\.local\\bin'

아무것도 나오지 않으면 사용자 PATH에 설치 폴더를 추가해요.

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

터미널을 다시 열어야 적용돼요. CMD에서는 echo %PATH% | findstr /i "local\bin"으로 확인하고, 아무것도 나오지 않으면 시스템 설정의 환경 변수 화면에서 사용자 PATH에 %USERPROFILE%\.local\bin을 추가하라고 문서는 적어요. PATH에 설치가 여러 개 잡히는지도 where.exe claude로 함께 보세요. 문서는 설치가 여러 개면 버전이 엇갈릴 수 있으니 하나만 남기고, 윈도우에서는 %USERPROFILE%\.local\bin\claude.exe 네이티브 설치를 권한다고 적어요.

업데이트 직후 claude가 사라졌을 때

먼저 %USERPROFILE%\.local\bin에 claude.exe가 남아 있는지 봐요. 없고 claude.exe.old.로 시작하는 파일만 있다면 PowerShell에서 가장 최근 백업의 이름을 되돌려요.

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

그다음 claude --version으로 버전 번호가 나오는지 확인해요. 백업 파일이 없거나 이름을 되돌려도 실패하면 설치 명령을 다시 실행하라고 문서는 적어요. 문서에는 v2.1.281 이전 버전에서는 claude.exe가 없는 상태에서 백업까지 지워질 수 있었다는 문장도 있어요.

설치 명령이 웹 페이지나 403을 돌려줄 때

설치 명령이 HTML 조각을 실행하려다 오류를 내거나 403이 나오면, 설치 주소가 스크립트 대신 웹 페이지나 오류를 돌려준 거예요. 페이지에 'App unavailable in region'이 보이면 지원 국가 문제예요. 본문 없는 403도 대개 같은 원인이지만, 회사 프록시나 방화벽이 내려받기를 막은 경우일 수도 있다고 문서는 적어요. 지원 국가인데도 403이 계속되면 대체 설치 방법보다 네트워크 연결 확인을 먼저 하라고 하는데, 대체 설치 방법도 같은 서버에 접속하기 때문이에요. 그 밖의 경우에 쓰는 대체 설치 방법으로는 윈도우에서 winget install Anthropic.ClaudeCode를 안내해요.

PowerShell에서 'Could not create SSL/TLS secure channel' 같은 TLS 오류가 나면 TLS 1.2를 켠 뒤 설치 명령을 다시 실행해요.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

CMD 명령이 CRYPT_E_NO_REVOCATION_CHECK나 CRYPT_E_REVOCATION_OFFLINE로 실패하면 서버에는 닿았지만 네트워크가 인증서 폐기 확인을 막은 경우예요. 문서는 CMD에서 curl에 --ssl-revoke-best-effort를 붙여 다시 실행하거나, PowerShell 설치 명령이나 WinGet으로 바꾸는 방법을 적어요.

npm으로 설치해도 되나요

설치 문서는 npm 설치를 고급 설치 옵션 가운데 하나로 두고, npm 패키지에는 Node.js 22 이상이 필요하다고 적어요. 더 낮은 Node.js에서는 설치가 실패하지 않고 EBADENGINE 경고만 나온 뒤 설치가 끝난다고 해요. npm 패키지가 내려받는 것도 독립 설치 프로그램과 같은 네이티브 바이너리라서, 설치된 claude는 실행할 때 Node를 쓰지 않아요.

표현이 갈리는 곳도 있어요. GitHub 저장소 README는 'Installation via npm is deprecated'라는 안내를 달고 npm 항목에 Deprecated 표시를 붙였어요. 같은 날 받은 설치 문서는 npm을 고급 옵션으로 남겨 두었고요. 두 문서가 공통으로 윈도우에서 '권장' 표시를 붙인 설치는 PowerShell 설치 명령이에요.

윈도우에서 npm 경로를 쓰면 PowerShell 실행 정책 때문에 running scripts is disabled on this system 오류가 날 수 있어요. 문서는 이 정책이 스크립트 파일에 적용되기 때문에 PowerShell 설치 명령에는 영향을 주지 않는다고 적어요. 이미 npm으로 설치해 둔 PC라면 위의 where.exe claude로 설치가 겹치지 않았는지부터 보세요.

설치 뒤 확인 순서

설치 명령이 끝났다면 이 순서로 확인해 보세요.

1. 새 터미널 창을 열고 claude --version을 실행해요. 버전 번호가 나와야 해요.
2. where.exe claude를 실행해요. 결과가 여러 줄이면 설치가 겹친 거예요.
3. claude doctor를 실행해요. 세션을 시작하지 않고 설치 상태, 설정 파일 검증 오류, 경고와 해결책을 읽기 전용으로 보여 줘요.
4. 작업할 프로젝트 폴더의 터미널에서 claude를 실행하고 브라우저 안내를 따라 로그인해요.
5. 필요하면 claude.exe가 있는 폴더에서 Get-AuthenticodeSignature .\claude.exe로 서명자를 확인해요.

예전에 ANTHROPIC_API_KEY 환경 변수를 설정해 둔 PC라면, 클로드 코드가 그 키를 쓸지 물을 때 승인하면 로그인 화면을 건너뛴다고 문서는 적어요. 설치 뒤 첫 세션에서 프로젝트 규칙을 CLAUDE.md에 적고 작업을 맡기는 흐름은 클로드 코드 사용법과 실전 워크플로를 정리한 글에서 이어 볼 수 있어요.

주의할 점과 한계

• 이 글의 버전 숫자는 2026년 10월 9일 오후 4시 38분에 이 PC에서 확인한 값이에요. 자동 업데이트로 계속 바뀌니 현재 버전으로 읽지 마세요.
• 문제 해결 문서의 WSL 성능 안내는 파일 시스템을 넘나들 때의 디스크 읽기 성능과 그로 인한 검색 결과에 관한 것이에요. 이 글은 네이티브와 WSL의 속도를 직접 재지 않았어요.
• WSL 쪽 내용은 모두 문서 문장이에요. 이 PC에서는 WSL 설치, 로그인, 샌드박스를 해 보지 않았어요.
• 한국어판 문제 해결 문서의 오류 표 한 줄은 영어판의 '업데이트 직후'(right after an update)를 '설치 후'로 옮겨 놓았어요. 이 글은 영어판 문장과 연결된 절 제목을 따랐어요.
• 같은 설치 문서 안에서도 Git for Windows는 표와 네이티브 절에서 '선택 사항', 설치 탭에서 '권장'으로 적혀 있어요. 필요한 이유로 Bash 도구를 드는 건 같아요.
• CLAUDE_CODE_GIT_BASH_PATH에 맞는 경로와 받아 주는 파일 이름(bash.exe 등)을 적었는데도 클로드 코드가 Git Bash를 쓰지 않으면, 문서는 AppLocker, 그룹 정책 소프트웨어 제한, EDR 같은 보안 소프트웨어가 끼어들었을 수 있다고 적어요. 이때는 claude.exe와 그 하위 프로세스(cmd.exe, bash.exe 포함)를 허용 목록에 넣어 달라고 IT 팀에 요청하라고 안내해요.

원문은 클로드 코드 설치 문서, 설치 문제 해결 문서, 문제 해결 문서에서 볼 수 있어요.

이 글이 확인하지 않은 것

제가 한 일은 2026년 10월 9일 오후에 클로드 코드 공식 문서 다섯 편과 GitHub 저장소 README, 이슈 #38788의 상태를 받아 해당 문장을 옮기고, 이 PC의 네이티브 설치를 PowerShell로 조회한 것까지예요. 아래는 확인하지 않았어요.

• WSL 2나 WSL 1에 실제로 설치하고 로그인하는 과정, 샌드박스가 켜진 상태의 동작
• WinGet이나 npm으로 설치하는 과정과 WinGet 자동 업그레이드 옵션의 동작
• ARM64 윈도우 기기, Windows 10, Windows Server에서의 설치
• 회사 프록시나 보안 소프트웨어가 있는 환경
• 네이티브와 WSL의 실행 속도 차이, 프로젝트를 /mnt/c/와 /home/에 둘 때의 검색 결과 차이

클로드 무료 플랜에서 되는 것과 안 되는 것을 먼저 보고 싶다면 클로드 무료 사용량과 초기화 기준을 정리한 글을 함께 보세요.