Skip to main content
Claude Code는 터미널에서 코딩 작업을 수행하는 CLI 도구입니다.

사전 준비

설치 과정

1

Claude Code 설치

아래 명령어를 실행합니다.
npm install -g @anthropic-ai/claude-code
2

Claude Code 실행

설치 후 아래 명령어로 실행합니다.
claude
처음 실행 시 로그인 또는 인증 절차가 진행됩니다.

설치 확인하기

claude --version
which claude
git --version
버전 정보와 경로가 출력되면 정상입니다.

문제 해결

  • claude: command not found: 터미널을 재시작하고 npm config get prefix 경로를 확인합니다.
  • Git 관련 경고: git --version이 정상 출력되는지 먼저 확인합니다.

설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: Ubuntu 24.04 개발 환경

다음 설치 단계를 이어서 진행합니다.