한줄 요약
CLI는 Windows PowerShell·CMD, macOS·Linux·WSL의 공식 네이티브 설치를 권장합니다. Windows는 WinGet, macOS는 Homebrew도 지원하지만 이 방식은 수동 업데이트가 필요합니다. 터미널이 낯설면 Claude 데스크톱 앱의 Code 탭을 사용할 수 있으며 지원 구독 또는 API 계정이 필요합니다.
1. 기본 정보
- 권장 방법
- 공식 설치 스크립트 — Windows·macOS·Linux 자동 업데이트
- macOS Homebrew
- brew install --cask claude-code
- Windows WinGet
- winget install Anthropic.ClaudeCode
- GUI 방법
- Claude 데스크톱 Code 탭 — macOS·Windows·Linux(베타)
- npm 대안
- 현재 npm 패키지는 Node.js 22 이상 필요
2. 설치 단계
-
1. 터미널 열기
Windows는 시작 메뉴에서 PowerShell을 검색해 실행합니다. macOS는 Spotlight(⌘+Space)에서 터미널을 찾습니다. 터미널이 처음이라면 아래 GUI 방법을 먼저 확인하세요.
-
2. 설치 스크립트 실행
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
macOS·Linux·WSL:curl -fsSL https://claude.ai/install.sh | bash
명령어를 붙여넣고 Enter를 누르면 자동으로 설치됩니다. -
3. 설치 확인
터미널에
claude --version을 입력해 버전 번호가 나타나면 설치 완료입니다. 오류가 나면 터미널을 완전히 닫았다 다시 열고 재시도하세요. -
4. 프로젝트 폴더에서 실행
작업할 프로젝트 폴더로 이동한 뒤
claude를 입력합니다. 처음 실행하면 브라우저가 열리며 로그인 화면이 나타납니다. -
5. 계정 로그인
Claude Code를 지원하는 구독 계정으로 로그인하거나 Anthropic API 결제 계정을 연결합니다. 환경 변수에 API 키가 있으면 구독보다 API 방식이 우선될 수 있으므로 로그인 후
/status를 확인합니다.
3. 터미널 없이 설치하는 법
터미널이 낯설다면 Claude Code 다운로드 버튼에서 Claude 데스크톱 앱을 받아 Code 탭을 여세요. macOS·Windows와 Linux 베타에서 제공되며 데스크톱 Code 탭만 쓰는 경우 Node.js나 CLI를 별도로 설치할 필요가 없습니다.
4. 패키지 매니저로 설치
macOS에 Homebrew가 설치되어 있다면 brew install --cask claude-code로 설치할 수 있습니다. Windows에서 WinGet을 사용한다면 winget install Anthropic.ClaudeCode를 실행합니다. 두 방법 모두 자동 업데이트가 되지 않으므로 주기적으로 수동 업데이트가 필요합니다.
5. Windows 추가 팁
Windows 네이티브 CLI는 Git for Windows 없이도 PowerShell 도구로 실행할 수 있습니다. Git for Windows를 설치하면 Bash 도구를 사용할 수 있습니다. Linux 도구 체인이나 샌드박스가 필요하다면 WSL 2 환경을 선택하세요.
6. 자주 묻는 질문
설치 후 claude 명령을 찾을 수 없다고 나와요
+
터미널을 완전히 닫았다 새로 열고 다시 시도해보세요. 그래도 안 되면 공식 문서의 설치 문제 해결 페이지를 확인하세요.
Node.js가 없어도 설치할 수 있나요?
+
네, 공식 네이티브 설치와 데스크톱 Code 탭은 Node.js가 필요 없습니다. npm 대안을 선택할 때는 현재 Claude Code npm 패키지 기준 Node.js 22 이상이 필요합니다.
업데이트는 어떻게 하나요?
+
공식 스크립트로 설치한 경우 백그라운드에서 자동 업데이트됩니다. 즉시 업데이트하려면 터미널에서 claude update를 실행하면 됩니다.
Linux에서도 설치할 수 있나요?
+
네, Ubuntu 20.04·Debian 10·Alpine Linux 3.19 이상에서 지원합니다. macOS와 같은 curl 스크립트를 사용하면 됩니다. apt·dnf·apk 패키지 매니저도 지원합니다.
7. 참고 자료
관련 가이드
함께 보면 좋은
Claude Code
Claude Code는 Anthropic의 AI 코딩 에이전트입니다. 터미널·데스크톱 Code 탭·IDE·웹에서 프로젝트를 읽고 파일 편집, 명령 실행과 테스트를 수행합니다. 무료 플랜이 아닌 지원 구독이나 API 종량제 계정이 필요합니다.
클로드
클로드는 Anthropic이 개발한 AI 대화형 어시스턴트입니다. 질문 답변, 글쓰기, 번역, 코딩, 문서 분석 등 다양한 작업을 자연어로 요청할 수 있으며, PC와 모바일 앱에서 무료로 사용할 수 있습니다.
VS Code
VS Code는 Microsoft가 제공하는 Windows·macOS·Linux용 코드 편집기입니다. 확장, 소스 제어, 터미널, 디버깅 기능을 한 작업 환경에서 구성할 수 있습니다.