Claude Code 설치 방법 — 윈도우·맥 명령어와 로그인까지

Claude Code(클로드 코드)는 Anthropic의 터미널 AI 에이전트입니다. 결론부터 — 설치는 아래 한 줄이고, 윈도우와 맥 공통입니다. 이 글의 모든 명령은 직접 설치해 실행까지 확인했습니다.

npm install -g @anthropic-ai/claude-code

설치 — 윈도우와 맥

위 npm 명령을 쓰려면 Node.js 18 이상이 필요합니다. 없다면 윈도우는 winget install OpenJS.NodeJS.LTS, 맥은 brew install node로 먼저 설치하고 터미널을 다시 여세요.

Node.js를 쓰고 싶지 않다면 공식 네이티브 설치 스크립트가 있습니다. 윈도우 PowerShell:

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

맥·리눅스(우분투 포함):

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

설치 확인은 claude --version. 버전 번호가 나오면 성공입니다.

설치 후 첫 실행 — 로그인

작업할 폴더로 이동해 claude를 입력하면 시작됩니다. 처음에는 브라우저가 열리며 Claude 계정으로 로그인하고(Pro 또는 Max 구독, 혹은 API 크레딧 필요), 이어서 아래처럼 “이 폴더를 신뢰하느냐”고 묻습니다. Claude Code가 그 폴더의 파일을 읽고 수정할 수 있기 때문에 확인하는 절차입니다.

기본 사용법 — 이것만 알면 시작됩니다

• 그냥 한국어로 시키면 됩니다 — “이 폴더 정리해줘”, “이 코드 버그 찾아줘” 같은 식입니다.
• Shift+Tab — 매번 승인을 묻는 기본 모드와 자동 진행 모드를 전환합니다.
• Esc 두 번 — 대화를 이전 시점으로 되감습니다. 잘못 시켰을 때 유용합니다.
• claude –resume — 지난 세션을 이어서 합니다. 대화는 자동 저장됩니다.

설치가 안 될 때

• “claude를 찾을 수 없습니다” — 터미널을 완전히 껐다 다시 여세요. PATH 갱신 문제가 대부분입니다.
• npm 오류 — node --version이 18 이상인지 확인하세요.
• 맥 권한 오류(EACCES) — sudo 대신 Homebrew로 Node를 설치하면 해결됩니다.

같이 보면 좋은 글

Codex·Gemini·Grok까지 네 가지 CLI의 설치 명령을 비교하려면 AI 코딩 CLI 설치 총정리를, 클로드 웹에서 결과물을 페이지로 뽑는 기능이 궁금하면 클로드 아티팩트 사용법을 참고하세요.

참고: @anthropic-ai/claude-code — npm 공식 패키지