AI 루트
레벨 진단
← Claude Code

Claude Code 시작하기 — 설치·로그인·첫 작업 (터미널)

처음 써도 쉬움약 15분5단계Claude Code 제대로 쓰기 코스 1/4

Claude Code는 내 프로젝트 파일을 읽고 고치고 명령을 실행하는 코딩 에이전트예요. 터미널·VS Code·데스크톱 앱·웹에서 쓸 수 있는데, 이 가이드는 터미널 기준이에요. VS Code에서만 쓸 거라면 'VS Code에서 Claude Code 쓰기'로 바로 가도 됩니다.

따라 하기

1단계 / 5

설치하기

  1. ›터미널을 열고(Spotlight에서 Terminal 검색) 아래 명령을 붙여넣어 실행합니다.
Claude Code 열기
Terminal
curl -fsSL https://claude.ai/install.sh | bash

이해를 돕는 예시 그림이에요. 실제 화면과 다를 수 있어요.

Terminal
➜ ~ node -v
v20.11.0
➜ ~ npm -v
10.2.4
# 버전이 표시되면 설치 완료

팁 Claude Code 공식 문서(2026-09-15 확인) 기준 명령이에요. Mac은 Homebrew(brew install --cask claude-code), Windows는 WinGet(winget install Anthropic.ClaudeCode)으로도 설치할 수 있지만 이 둘은 자동 업데이트가 안 돼요.

막히면 볼 것

자주 하는 실수 3가지
  1. 1옛 글을 보고 Node.js부터 설치함 — 공식 설치 명령(아래 1단계)은 Node.js가 없어도 돼요
  2. 2Windows에서 PowerShell 명령을 CMD에 붙여넣음(또는 반대) — 'irm'을 모른다고 나오면 CMD, '&&'가 잘못됐다고 나오면 PowerShell이에요
  3. 3무료 claude.ai 계정으로 로그인하려 함 — 공식 문서: Pro·Max·Team·Enterprise 구독이나 Claude Console(API) 계정이 필요해요