클로드 코드 설치 윈도우와 맥은 명령어가 다르다. 검색하면 윈도우와 맥의 명령어가 따로 나온다. 어떤 명령을 어디에 입력해야 하는지 모르면 여기서 막힌다. 이 글은 공식 설치 문서에 나온 명령을 운영체제별로 정리한다.
설치 전에 확인할 것
| 항목 | 요구 사항 |
|---|---|
| 운영체제 | macOS 13.0 이상, Windows 10(1809) 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine 3.19 이상 |
| 메모리 | 4GB 이상 |
| 인터넷 | 설치와 로그인에 필요 |
| 계정 | Pro, Max, Team, Enterprise, Console 계정. 무료 claude.ai 요금제에는 포함되지 않음 |
클로드 코드 설치 맥과 리눅스에서 하는 법
터미널을 열고 아래 명령을 입력한다. 맥은 터미널 앱, 리눅스는 기본 터미널에서 실행한다.
curl -fsSL https://claude.ai/install.sh | bash
설치가 끝나면 새 터미널 창을 열고 claude --version을 입력한다. 버전 번호가 나오면 설치가 된 것이다.
클로드 코드 입력창에서 claude --version을 실행한 결과다. 버전 번호 2.1.289가 나온다.
클로드 코드 설치 윈도우에서 하는 법
윈도우는 PowerShell과 CMD에 따라 명령이 다르다. 프롬프트 모양으로 구분할 수 있다. 프롬프트에 PS가 붙어 있으면 PowerShell이고, PS 없이 C:\만 보이면 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
공식 문서에 따르면 PowerShell에서 CMD 명령을 입력하면 “&&” 오류가 나고, CMD에서 PowerShell 명령을 입력하면 “irm” 오류가 난다. 오류 메시지가 나오면 프롬프트 모양부터 확인하면 된다.
윈도우에서 Git for Windows를 권하는 이유
공식 문서는 윈도우에서 Git for Windows 설치를 권한다. 설치되어 있으면 클로드 코드가 Bash 도구를 쓸 수 있다. 설치하지 않으면 PowerShell을 대신 쓴다. WSL 환경에서는 Git for Windows가 필요하지 않다.
명령 없이 VS Code 확장으로 설치하는 법
명령을 입력하는 것이 어렵다면 VS Code 확장으로 설치할 수 있다. 나도 이 방법으로 설치했다. 확장 목록을 열고(맥은 Cmd+Shift+X, 윈도우는 Ctrl+Shift+X), “클로드 코드”를 검색해서 설치하면 된다.
공식 문서에는 확장을 설치할 수 없는 편집기라면 CLI를 설치하고, 편집기 안의 터미널에서 claude를 실행하라고 나와 있다. 설치 후 확장 목록에 클로드 코드가 보이지 않으면 VS Code를 다시 시작하거나, 명령 팔레트에서 “Developer: Reload Window”를 실행하면 된다.
설치가 안 될 때
명령을 실행했는데 claude를 찾을 수 없다고 나오면 실행 경로(PATH) 문제일 수 있다. 공식 문서에는 “Fix your PATH” 항목이 따로 있다. 설치 오류가 “403”이나 “curl” 오류로 나오면 공식 문제 해결 페이지에서 증상별 해결 방법을 확인하면 된다.
설치 후 claude doctor를 실행하면 설치 상태와 설정 파일의 문제를 읽기 전용으로 점검할 수 있다.
클로드 코드 입력창에서 claude doctor를 실행한 결과다. “설치 문제는 발견되지 않았습니다”라고 나온다.
맥에서는 Homebrew로도 설치할 수 있다
공식 문서에는 Homebrew 설치 방법도 나온다. brew install --cask claude-code를 입력하면 된다. 공식 문서에 따르면 claude-code는 안정 채널이라 보통 일주일 정도 늦게 나오고, claude-code@latest는 새 버전이 나오면 바로 받는다.
설치 후 업데이트는 자동으로 된다
공식 문서에 따르면 네이티브 설치는 백그라운드에서 자동으로 업데이트되어 최신 버전을 유지한다. 업데이트를 직접 관리하고 싶으면 공식 문서의 자동 업데이트 설정 항목을 확인하면 된다.
설치 명령과 요구 사항의 원문은 클로드 코드 공식 설치 문서에서 볼 수 있다. 설치와 관련해 다른 글도 있다. 올라마 연동, 왜 아직 안 깔았나 설치 전 계정 준비와 VS Code 확장 설치 과정은 클로드 코드 설치, 무료로는 안 되고 Pro와 확장 2가지가 필요했다에 정리했다.
정리
- 맥과 리눅스는 curl 명령 한 줄로 설치한다.
- 윈도우는 PowerShell과 CMD에 따라 명령이 다르다.
- 설치 후
claude --version으로 확인한다. - 무료 요금제로는 쓸 수 없다. Pro 이상이 필요하다.
