클로드 코드 설치 | 윈도우에서 한 줄 명령으로 시작하는 법

클로드 코드 설치는 Windows PowerShell에 공식 명령 한 줄을 붙여넣는 것으로 끝나요.
설치 뒤 프로젝트 폴더에서 claude를 실행해 로그인하면 바로 쓸 수 있고, 무료 Claude.ai 플랜만으로는 접근할 수 없습니다.

클로드 코드 설치, PowerShell 한 줄이면 돼요

Windows에서는 PowerShell이나 CMD로 네이티브 설치를 진행할 수 있어요.
공식 설치 문서가 제시하는 PowerShell 명령은 irm https://claude.ai/install.ps1 | iex 한 줄입니다.

설치 프로그램을 따로 내려받아 더블클릭하는 방식이 아니라, 명령 한 줄이 설치 파일을 가져와 깔아 주는 방식이에요. 그래서 클로드 코드 다운로드를 찾으셨다면 검색 결과의 설치 파일 대신 위 명령을 쓰면 됩니다.

PowerShell 열기시작 메뉴에서 PowerShell을 검색해 실행해요.

설치 명령 붙여넣기위 명령을 붙여넣고 Enter를 눌러요.

설치 확인끝나면 claude --version을 입력해 버전이 나오는지 봐요.

설치 때 sudo npm install -g는 쓰지 마세요. 권한 문제와 보안 위험이 있어 공식 문서에서도 피해야 하는 방법입니다.

클로드 코드 요구 사양, 윈도우 10 이상에 RAM 4GB예요

운영체제는 macOS 13 이상, Windows 10 버전 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상이에요.
메모리는 최소 4GB RAM이고, 인증과 AI 처리 때문에 인터넷 연결도 필요합니다.

예시 1 · RAM 4GB 노트북을 쓰는 지훈 씨(가정)최소 기준이 4GB이니 설치는 가능해요.
여유를 두고 싶어 RAM을 8GB로 늘리면 최소 기준보다 4GB, 즉 2배의 메모리 여유가 생깁니다. 윈도우 버전은 설정의 시스템 정보에서 확인해요. 윈도우 설치가 필요하면 윈도우설치 방법을 먼저 보세요.

클로드 코드 WSL과 Git, 꼭 필요한 건 아니에요

Windows에서는 WSL 1이나 WSL 2 안에서도 클로드 코드를 실행할 수 있어요.
이미 WSL 1을 쓰고 있다면 클로드 코드만을 위해 WSL 2로 바꿀 필요는 없습니다.

Git for Windows는 선택 사항이에요.
설치하지 않으면 클로드 코드는 PowerShell 도구로 셸 명령을 실행합니다.

Windows 네이티브PowerShell·CMDWindows 10 버전 1809 이상, Git for Windows는 선택

WSL 1·2WSL 터미널WSL 안에서 설치하고 claude 실행, WSL 2는 샌드박스 명령 실행을 지원

Git for Windows를 깔았는데 Git Bash를 찾지 못하면 settings.json의 env.CLAUDE_CODE_GIT_BASH_PATH에 C:\\Program Files\\Git\\bin\\bash.exe 같은 경로를 적어 주세요.

클로드 코드 맥·리눅스 설치와 npm 방식은 이렇게 달라요

macOS와 Linux는 터미널에서 설치 명령을 실행해요.
공식 안내의 셸 설치 예시는 curl -fsSL claude.ai/install.sh | bash입니다.

npm으로 설치하는 길을 고르면 Node.js 22 이상이 필요해요.
최신 npm 패키지의 엔진 조건이 >=22.0.0이며, 네이티브 설치에는 해당하지 않습니다. 파이썬 개발환경도 같이 쓴다면 python 설치도 이어서 보세요.

예시 2 · Node.js가 이미 깔린 맥 사용자 수빈 씨(가정)Node.js 버전이 22보다 낮으면 npm 설치 전에 버전부터 올려야 해요.
번거로우면 터미널의 네이티브 설치 명령을 쓰면 Node.js 버전과 상관없이 진행할 수 있습니다.

클로드 코드 계정, 무료 플랜은 안 돼요

클로드 코드에는 Pro·Max·Ultra·Team·Enterprise 또는 Console 계정이 필요해요.
무료 Claude.ai 플랜에는 클로드 코드 접근 권한이 포함되지 않습니다. 무료 범위가 궁금하면 클로드 무료와 클로드 ai 무료 글에서 정리했어요.

Pro나 Max 가입자는 Claude.ai 계정으로 로그인해 클로드 코드와 웹을 하나의 구독으로 쓸 수 있어요.
회사에서는 Amazon Bedrock이나 Google Vertex AI 인증으로 구성하기도 합니다.

구독 계정 로그인Pro·MaxClaude.ai 계정 하나로 클로드 코드와 웹을 함께 사용

API 키 인증토큰 종량 과금세션 비용은 /cost 명령으로 확인

클로드 코드 사용법, 폴더에서 claude만 치면 시작돼요

설치가 끝나면 작업할 프로젝트 폴더로 이동한 뒤 터미널에서 claude를 실행해요.
처음이면 로그인 화면이 나오고, 계정을 인증하면 대화창이 열립니다. 코드를 편집할 에디터는 vscode 설치 글을 참고하세요.

폴더로 이동작업할 프로젝트 폴더를 터미널에서 열어요.

claude 실행명령을 입력하고 로그인 방식을 골라요.

모델 확인/model을 입력하면 내 계정에서 쓸 수 있는 모델을 보고 바꿀 수 있어요.

설치 상태가 걱정되면 claude doctor를 실행해 보세요. 자동차 정기점검처럼 설치 유형을 한 번 훑어 줍니다.

클로드 코드 업데이트와 로그인 문제, 이 명령으로 풀어요

클로드 코드는 시작할 때와 실행 중에 주기적으로 업데이트를 확인하고, 파일을 백그라운드에서 내려받아요.
적용은 다음에 다시 시작할 때 되고, 바로 하려면 claude update를 입력합니다.

이미 다른 계정으로 로그인돼 있다면 /login으로 로그인 방식을 다시 고를 수 있어요.
원하는 조직 계정이 보이지 않으면 /logout으로 완전히 로그아웃하고 claude update를 실행한 뒤 터미널을 다시 켜 보세요.

예시 3 · 회사 Team 계정으로 바꾸려는 민아 씨(가정)개인 계정으로 로그인돼 있으면 /login을 입력해 Claude 계정 구독을 고르고 조직 플랜을 승인해요.
그래도 조직이 안 보이면 위 순서대로 로그아웃과 업데이트를 거치면 됩니다.

자주 묻는 질문

Windows 10에서도 클로드 코드를 쓸 수 있나요?

네, Windows 10 버전 1809 이상이면 돼요. PowerShell이나 CMD에서 바로 설치하거나 WSL 1·2 안에서 실행할 수 있습니다.

Git for Windows를 꼭 설치해야 하나요?

선택 사항이에요. 설치하지 않으면 클로드 코드는 PowerShell 도구로 셸 명령을 실행합니다.

npm 설치 중 권한 오류가 나면 sudo를 써도 되나요?

쓰지 마세요. 권한 문제와 보안 위험이 있어서 sudo npm install -g는 공식 문서에서도 피해야 하는 방법이에요.

무료 클로드 계정으로도 클로드 코드를 쓸 수 있나요?

안 돼요. Pro·Max·Ultra·Team·Enterprise 또는 Console 계정이 필요하고, 무료 Claude.ai 플랜에는 접근 권한이 없어요.

클로드 코드를 수동으로 업데이트하는 명령은 무엇인가요?

claude update 입니다. 평소에는 백그라운드로 내려받고 다음에 다시 시작할 때 적용돼요.

설치를 마쳤다면 이어서 준비하세요

클로드 코드와 함께 쓰는 프로그램을 같이 깔아 두면 작업이 편해요.
설치·다운로드 글은 모두 모아 두었습니다.