Claude Code 설치 방법: Mac, Windows, Linux 5분 완성 가이드

Claude Code 설치는 터미널 명령 한 줄이면 끝납니다. Mac과 Linux는 curl 스크립트, Windows는 PowerShell 스크립트를 실행하면 되고, 세 운영체제 모두 npm으로도 설치할 수 있습니다. 설치 후 claude를 실행해 Anthropic 계정으로 로그인하면 바로 사용할 수 있습니다.

설치 전에 확인할 것

먼저 계정부터 확인합니다. Claude Code는 Claude Pro나 Max 구독, 또는 Anthropic Console의 API 키 중 하나가 있어야 동작합니다. 어떤 플랜이 Claude Code를 포함하는지는 공식 요금 페이지 기준으로 확인하는 것이 정확합니다.

다음은 설치 방식입니다. 2026년 9월 기준으로 세 가지가 있습니다.

방식	명령	Node.js 필요	추천 대상
네이티브 설치	curl 또는 PowerShell 스크립트	아니요	대부분의 사용자
npm 설치	`npm install -g @anthropic-ai/claude-code`	예 (18 이상)	Node 환경이 이미 있는 개발자
Homebrew	`brew install --cask claude-code`	아니요	Mac에서 brew로 도구를 관리하는 사람

저는 네이티브 설치를 권합니다. Node.js 버전 충돌이 없고, 자동 업데이트가 안정적으로 동작합니다. 이 글의 순서도 네이티브 설치 기준입니다.

Mac 설치 순서

터미널(Terminal 또는 iTerm)을 엽니다.
아래 명령을 붙여 넣고 실행합니다.

curl -fsSL https://claude.ai/install.sh | bash

설치가 끝나면 터미널을 닫았다가 다시 엽니다. PATH가 갱신되어야 claude 명령을 찾습니다.
설치를 확인합니다.

claude --version

버전 번호가 나오면 성공입니다. Homebrew를 쓰는 분은 brew install --cask claude-code로 같은 결과를 얻습니다.

Windows 설치 순서

Windows는 PowerShell을 기본으로 씁니다. WSL을 쓰는 분은 아래 Linux 순서를 따르면 됩니다.

시작 메뉴에서 PowerShell 또는 Windows Terminal을 엽니다.
아래 명령을 실행합니다.

irm https://claude.ai/install.ps1 | iex

창을 닫고 새로 연 다음 claude --version으로 확인합니다.

npm 방식으로 설치하려면 Git for Windows가 먼저 설치되어 있어야 합니다. Claude Code가 내부에서 Git Bash를 사용하기 때문입니다. 네이티브 설치는 이 조건이 없습니다.

Linux 설치 순서

Ubuntu, Debian, Fedora 등 배포판과 관계없이 같은 스크립트를 씁니다.

curl -fsSL https://claude.ai/install.sh | bash

설치 후 셸 설정을 다시 읽습니다.

source ~/.bashrc
claude --version

zsh를 쓰면 ~/.zshrc를 읽습니다. WSL2의 Ubuntu에서도 이 순서가 그대로 동작합니다.

첫 실행과 로그인

설치가 끝났으면 실제 프로젝트 폴더에서 실행합니다. Claude Code는 현재 폴더를 작업 공간으로 삼기 때문에 위치가 중요합니다.

cd ~/my-project
claude

처음 실행하면 로그인 방식을 고르는 화면이 나옵니다. 선택지는 두 가지입니다.

Claude 계정으로 로그인: Pro 또는 Max 구독자가 고릅니다. 브라우저가 열리고 승인하면 끝납니다.
Anthropic Console로 로그인: API 키로 사용량만큼 결제하는 방식입니다. Console에 결제 수단이 등록되어 있어야 합니다.

로그인이 끝나면 프롬프트가 나타납니다. 첫 질문은 이렇게 해 보십시오.

이 프로젝트 구조를 설명해 줘

Claude가 폴더를 훑고 요약해 주면 설치와 인증이 모두 정상입니다. 계정을 바꾸고 싶으면 대화 중에 /login을 입력합니다. 환경 점검은 claude doctor로 합니다.

자주 나는 오류 3가지

1. command not found: claude

설치는 됐는데 명령을 못 찾는 경우입니다. 대부분 PATH 문제입니다. 네이티브 설치는 실행 파일을 ~/.local/bin에 둡니다. 셸 설정 파일에 아래 줄을 추가하고 터미널을 다시 엽니다.

export PATH="$HOME/.local/bin:$PATH"

npm 설치라면 npm config get prefix로 나온 경로 아래 bin 폴더를 PATH에 추가합니다.

2. npm 설치 중 EACCES 권한 오류

sudo npm install -g로 해결하려는 분이 많은데, 권하지 않습니다. 이후 자동 업데이트가 권한 문제로 계속 실패합니다. npm 전역 경로를 사용자 폴더로 바꾸거나, 더 간단하게 네이티브 설치로 갈아타는 것이 낫습니다.

npm uninstall -g @anthropic-ai/claude-code
curl -fsSL https://claude.ai/install.sh | bash

3. Windows에서 Git Bash를 찾을 수 없다는 메시지

npm 방식에서 나오는 오류입니다. Git for Windows를 설치한 뒤 PowerShell을 다시 엽니다. 그래도 같은 메시지가 나오면 CLAUDE_CODE_GIT_BASH_PATH 환경 변수에 bash.exe 경로를 지정합니다. 네이티브 설치로 바꾸면 이 문제 자체가 사라집니다.

업데이트와 삭제

Claude Code는 실행할 때 새 버전을 확인하고 자동으로 업데이트합니다. 수동으로 하려면 이렇게 합니다.

claude update

npm으로 설치한 경우는 npm update -g @anthropic-ai/claude-code를 씁니다. 삭제는 설치 방식에 따라 다릅니다. 네이티브 설치는 ~/.local/bin/claude 실행 파일과 ~/.claude 폴더를 지우면 되고, npm은 npm uninstall -g, Homebrew는 brew uninstall --cask claude-code를 씁니다.

자주 묻는 질문

Claude Code를 무료로 쓸 수 있나요?

이 글을 쓰는 시점에는 유료 구독 또는 API 결제가 필요합니다. 무료 플랜 포함 여부는 바뀔 수 있으니 공식 요금 페이지를 확인하십시오. 비용이 고민이면 요금제 정리 글과 계산기를 먼저 보는 것을 권합니다.

Node.js를 꼭 설치해야 하나요?

아닙니다. 네이티브 설치와 Homebrew 설치는 Node.js가 필요 없습니다. npm 방식을 고를 때만 Node.js 18 이상이 필요합니다.

VS Code나 Cursor 안에서도 쓸 수 있나요?

가능합니다. VS Code 마켓플레이스에서 Claude Code 확장을 설치하면 편집기 안에서 같은 기능을 씁니다. Cursor는 VS Code 기반이라 같은 확장이 동작합니다. 터미널 설치와 병행해서 쓸 수 있습니다.

회사 컴퓨터라 브라우저 로그인이 막혀 있습니다

Console API 키 방식을 쓰면 브라우저 없이 인증할 수 있습니다. ANTHROPIC_API_KEY 환경 변수에 키를 넣고 실행하면 됩니다. 키 값은 채팅이나 저장소에 절대 올리지 마십시오.

다음 단계

설치가 끝났다면 사용법을 익힐 차례입니다.

Claude Code 사용법: 처음 30분에 익힐 핵심
Claude Code 가격과 요금제 정리
Claude Code 비용 계산기로 내 사용량에 맞는 요금제를 확인하십시오.
실제 제품을 만들면서 배우고 싶다면 AI Creator Lab 강의와 수강료 안내를 확인하십시오.