한줄 요약
Windows는 PowerShell, macOS·Linux는 터미널에서 공식 설치 스크립트 한 줄로 설치합니다. 터미널이 낯설면 Claude 데스크톱 앱으로 GUI에서 사용할 수 있습니다. 설치 전 Claude Pro 이상 플랜이 필요합니다.
1. 기본 정보
- 권장 방법
- 공식 설치 스크립트 — Windows·macOS·Linux 자동 업데이트
- macOS Homebrew
- brew install --cask claude-code
- Windows WinGet
- winget install Anthropic.ClaudeCode
- GUI 방법
- Claude 데스크톱 앱 설치 — 터미널 불필요
- 시스템 요구사항
- macOS 13+ / Windows 10(1809)+ / Ubuntu 20.04+ / RAM 4GB+
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 Pro·Max·Team·Enterprise 계정으로 로그인합니다. 무료 계정은 Claude Code를 지원하지 않습니다. 로그인 후 인증 정보가 저장되어 다음부터는 자동으로 시작됩니다.
3. 터미널 없이 설치하는 법
터미널이 낯설다면 Claude Code 공식 다운로드 페이지에서 Windows·macOS용 데스크톱 앱을 받아 실행하면 됩니다. GUI에서 Claude Code 기능을 그대로 사용할 수 있습니다.
4. 패키지 매니저로 설치
macOS에 Homebrew가 설치되어 있다면 brew install --cask claude-code로 설치할 수 있습니다. Windows에서 WinGet을 사용한다면 winget install Anthropic.ClaudeCode를 실행합니다. 두 방법 모두 자동 업데이트가 되지 않으므로 주기적으로 수동 업데이트가 필요합니다.
5. Windows 추가 팁
Windows에서 Git for Windows가 설치되어 있으면 Bash 도구가 활성화되어 Claude Code가 더 많은 기능을 사용할 수 있습니다. Linux 기반 개발 환경이 필요하다면 WSL(Windows Subsystem for Linux)에서 설치하는 방법도 있습니다.
6. 자주 묻는 질문
설치 후 claude 명령을 찾을 수 없다고 나와요
+
터미널을 완전히 닫았다 새로 열고 다시 시도해보세요. 그래도 안 되면 공식 문서의 설치 문제 해결 페이지를 확인하세요.
Node.js가 없어도 설치할 수 있나요?
+
네, 공식 설치 스크립트(curl 또는 PowerShell 방식)는 Node.js가 필요 없습니다. npm으로 설치할 때만 Node.js 18 이상이 필요합니다.
업데이트는 어떻게 하나요?
+
공식 스크립트로 설치한 경우 백그라운드에서 자동 업데이트됩니다. 즉시 업데이트하려면 터미널에서 claude update를 실행하면 됩니다.
Linux에서도 설치할 수 있나요?
+
네, Ubuntu 20.04·Debian 10·Alpine Linux 3.19 이상에서 지원합니다. macOS와 같은 curl 스크립트를 사용하면 됩니다. apt·dnf·apk 패키지 매니저도 지원합니다.
7. 참고 자료
함께 보면 좋은
Claude Code
Anthropic의 AI 코딩 에이전트. 터미널 또는 IDE에서 자연어로 코드 작성·버그 수정·리팩토링을 지시하면 AI가 직접 파일을 수정합니다. Pro 이상 플랜 필요.
클로드
클로드는 Anthropic이 개발한 AI 대화형 어시스턴트입니다. 질문 답변, 글쓰기, 번역, 코딩, 문서 분석 등 다양한 작업을 자연어로 요청할 수 있으며, PC와 모바일 앱에서 무료로 사용할 수 있습니다.
VS Code
Visual Studio Code는 마이크로소프트가 개발한 무료 소스 코드 편집기입니다. 가볍고 빠르면서도 강력한 기능을 제공하여 전 세계 개발자들이 가장 많이 사용하는 코드 편집기입니다.