클로드 코드(Claude Code) 설치방법: 윈도우·맥·리눅스 설치 명령과 로그인

Q: 클로드 코드 설치에 Node.js 가 필요한가요?

기본 권장 방식인 네이티브 설치 명령과 Homebrew, WinGet 은 Node.js 가 필요 없습니다. npm 으로 설치할 때만 최신 Node.js 가 필요하며, sudo npm install -g 는 권한 문제와 보안 위험 때문에 쓰지 말라고 공식 문서가 안내합니다.

Q: 클로드 코드 다운로드 파일은 어디서 받나요?

별도의 설치 파일 다운로드 페이지 대신 공식 문서의 설치 명령으로 설치합니다. 명령이 공식 서버에서 실행 파일을 받아 설치까지 처리합니다.

Q: 관리자 권한이 필요한가요?

아닙니다. 네이티브 설치는 사용자 폴더에 설치되므로 관리자 권한 없이 설치할 수 있습니다. 리눅스 패키지 저장소로 설치할 때만 sudo 가 필요합니다.

2026년 10월 7일 · AI 도구 · 클로드 코드 공식 다운로드 안내

설치 전에 확인할 것

클로드 코드는 터미널에서 실행하는 CLI 프로그램입니다. 설치 파일을 내려받아 더블 클릭하는 방식이 아니라, 공식 문서에 나온 설치 명령 한 줄을 터미널에 붙여 넣어 설치합니다. 터미널이 처음이라면 공식 문서의 터미널 안내를 먼저 읽거나, 터미널 없이 쓰는 Claude 데스크톱 앱을 이용하세요.

사용하려면 계정이 필요합니다. Claude 무료 요금제에는 클로드 코드가 포함되지 않으므로 Pro·Max·Team·Enterprise 요금제나 Claude Console(API) 계정을 준비해야 합니다.

운영체제: 윈도우 10(1809 이상) 또는 윈도우 서버, macOS 13 이상, 우분투·데비안·알파인 등 주요 리눅스
하드웨어: 메모리 4GB 이상, x64 또는 ARM64 프로세서(32비트 윈도우 미지원)
셸: Bash, Zsh, PowerShell, CMD 중 하나
인터넷 연결과 Anthropic 서비스 지원 국가
Claude 유료 요금제 또는 Console 계정

⚠ 주의설치 명령은 반드시 공식 문서에서 복사하세요. 블로그나 영상 댓글에 올라온 '빠른 설치 스크립트'는 다른 주소에서 악성 코드를 받아 실행할 수 있습니다.

맥·리눅스·WSL 에서 설치하기

맥은 터미널 앱, 리눅스는 기본 터미널, 윈도우의 WSL 은 WSL 배포판 터미널을 열고 공식 설치 명령을 실행합니다. 관리자 권한(sudo)은 필요 없습니다.

터미널을 열고 curl -fsSL https://claude.ai/install.sh | bash 를 붙여 넣은 뒤 Enter 를 누릅니다.
설치가 끝나면 터미널 창을 닫고 새 창을 엽니다.
claude --version 을 입력해 버전 번호와 (Claude Code) 가 표시되는지 확인합니다.
Homebrew 를 쓴다면 brew install --cask claude-code 로도 설치할 수 있습니다. 이 경우 자동 업데이트가 되지 않으므로 brew upgrade claude-code 로 직접 업데이트합니다.

💡 팁데비안·우분투·페도라·알파인은 공식 apt, dnf, apk 저장소로 설치하는 방법도 있습니다. 서명 키 지문 확인 절차가 문서에 함께 나와 있으니 순서대로 따르세요.

윈도우에서 설치하기

윈도우에서는 PowerShell 과 CMD(명령 프롬프트) 중 어디서 설치하느냐에 따라 명령이 다릅니다. 프롬프트가 PS C:\ 로 시작하면 PowerShell, PS 없이 C:\ 로 시작하면 CMD 입니다. 관리자 권한으로 실행할 필요는 없습니다.

시작 메뉴에서 Windows PowerShell 또는 터미널 을 엽니다.
PowerShell 에서는 irm https://claude.ai/install.ps1 | iex 를 실행합니다.
CMD 에서는 공식 문서의 CMD 용 명령(curl 로 install.cmd 를 받아 실행하는 한 줄)을 그대로 복사해 실행합니다.
WinGet 을 쓴다면 winget install Anthropic.ClaudeCode 로 설치할 수 있으며, 이 경우 winget upgrade Anthropic.ClaudeCode 로 직접 업데이트합니다.
새 터미널 창에서 claude --version 으로 설치를 확인합니다.

💡 팁Git for Windows 를 함께 설치해 두면 클로드 코드가 Git Bash 로 셸 명령을 실행합니다. 설치하지 않으면 PowerShell 을 셸 도구로 사용합니다. 리눅스 도구 체인이나 샌드박스 기능이 필요하면 WSL 2 에 설치하는 방법을 고려하세요.

처음 실행하고 로그인하기

설치가 끝났다면 작업할 프로젝트 폴더에서 클로드 코드를 실행합니다. 처음 실행하면 로그인 안내가 나타납니다.

터미널에서 cd 로 프로젝트 폴더로 이동한 뒤 claude 를 입력합니다.
브라우저가 열리면 Claude 유료 계정 또는 Console 계정으로 로그인하고 권한을 승인합니다.
브라우저가 자동으로 열리지 않으면 로그인 화면에서 c 를 눌러 로그인 주소를 복사한 뒤 브라우저에 붙여 넣습니다.
로그인이 끝나면 프롬프트 위에 버전, 현재 모델, 작업 폴더가 표시됩니다. /help 로 사용 가능한 명령을 확인하세요.
나중에 계정을 바꾸려면 세션 안에서 /login 을 입력합니다.

IDE 와 데스크톱 앱에서 쓰기

VS Code 에서는 확장 보기(Ctrl+Shift+X, 맥은 Cmd+Shift+X)에서 'Claude Code' 를 검색해 설치하면 편집기 오른쪽 위 스파크 아이콘으로 클로드 코드를 열 수 있습니다. 커서 같은 VS Code 기반 편집기에서도 설치할 수 있고, JetBrains IDE 용 플러그인도 제공됩니다.

터미널이 부담스럽다면 클로드 데스크톱 앱에서 Claude Code 를 실행하는 방법도 있습니다. 같은 계정으로 로그인하면 됩니다.

클로드 코드 설치 오류가 날 때

설치 중이나 직후에 자주 보이는 오류와 해결 방향은 다음과 같습니다. 더 자세한 내용은 오류 해결 가이드를 참고하세요.

command not found: claude 또는 'claude'은(는) 내부 또는 외부 명령...이 아닙니다 → 설치 폴더가 PATH 에 없습니다. 새 터미널을 열고, 그래도 안 되면 문서의 PATH 설정 안내를 따릅니다.
The token '&&' is not a valid statement separator → CMD 용 명령을 PowerShell 에 입력했습니다. PowerShell 용 명령을 쓰세요.
'irm' is not recognized → PowerShell 용 명령을 CMD 에 입력했습니다. CMD 용 명령을 쓰세요.
syntax error near unexpected token '<' 또는 403 → 네트워크나 프록시가 설치 스크립트 대신 웹 페이지를 돌려준 경우입니다. 회사 네트워크라면 IT 담당자에게 문의하세요.
claude doctor 를 실행하면 설치 상태와 설정 오류를 한 번에 점검할 수 있습니다.

⬇ 공식 사이트에서 클로드 코드 다운로드

claude.com 공식 페이지로 이동합니다 · 유료 구독 · Windows · macOS · Linux · 웹

자주 묻는 질문

Q. 클로드 코드 설치에 Node.js 가 필요한가요?

기본 권장 방식인 네이티브 설치 명령과 Homebrew, WinGet 은 Node.js 가 필요 없습니다. npm 으로 설치할 때만 최신 Node.js 가 필요하며, sudo npm install -g 는 권한 문제와 보안 위험 때문에 쓰지 말라고 공식 문서가 안내합니다.

Q. 클로드 코드 다운로드 파일은 어디서 받나요?

별도의 설치 파일 다운로드 페이지 대신 공식 문서의 설치 명령으로 설치합니다. 명령이 공식 서버에서 실행 파일을 받아 설치까지 처리합니다.

Q. 관리자 권한이 필요한가요?

아닙니다. 네이티브 설치는 사용자 폴더에 설치되므로 관리자 권한 없이 설치할 수 있습니다. 리눅스 패키지 저장소로 설치할 때만 sudo 가 필요합니다.

작성·관리 공식유틸 다운로드 운영자 · 작성 기준과 정정 절차 · 오류 제보