1.CLI 환경설정 - [MacOS] Claude CLI 설정하기

0. 시작 전 확인

Claude Code는 유료 플랜(Pro / Max / Team / Enterprise)에서만 사용 가능합니다.
계정 만들기 → https://claude.ai

 

1. macOS 설치 가이드

Claude.ai 계정 & 유료 플랜

STEP 1. claude.ai (https://claude.ai) 에 접속해서 계정을 만든다.

• Pro / Max / Team / Enterprise 중 하나의 유료 플랜이 필요해요.

• 계정에 로그인 한다.

Node.js 설치

STEP 2. nodejs.org (https://nodejs.org) 에 접속한다. 

• 사이트에서 "macOS Installer (.pkg)" — LTS 버전 버튼을 클릭하여 다운로드한다. 

STEP 3. 다운로드한 .pkg 파일 설치

• 다운로드 폴더에서 .pkg 파일을 더블클릭한다. 
• 설치 안내에 따라 계속 → 계속 → 설치 를 눌러 완료한다. 
• 설치 중에 Mac 비밀번호를 입력하라면, 로그인 비밀번호를 입력한다.

터미널 열기

STEP  4. 터미널(Terminal) 앱 열기

• 키보드에서 [Command(⌘) + Space]를 누르면 Spotlight 검색창이 열린다.
• "Terminal" 또는 "터미널" 을 입력하고 Enter를 누른다.
• ※ Finder → 응용 프로그램 → 유틸리티 → 터미널 로 찾을 수 있다. 

STEP  5. Node.js 설치 확인

터미널에 아래를 입력하고 Enter를 누른다. 

$ node --version

• v22.0.0 같은 숫자가 나오면 성공! 
• 오류가 뜨면 CMD를 닫고 다시 열어 버전 정보 확인
• 그래도 오류가 뜨면 Node.js 설치가 안 된 것이니 STEP 2로 이동

Claude Code 설치

STEP  6. 터미널에 아래를 복사해서 붙여넣고 Enter를 누른다. 

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

• 설치는 1~2분 걸린다. 화면에 글자가 올라가는 건 정상

STEP  7. 권한 오류(EACCES)가 날 경우
   "EACCES: permission denied" 오류가 나면 cmd 창에 아래 스크립트를 복사해 넣고 enter를 누른다. (아래 스크립트로 대신 설치한다.)

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

 

로그인 & 최종 확인

 

STEP  8. Claude 계정으로 로그인

아래 명령어를 실행하면 브라우저가 자동으로 열린다.  Claude.ai 로그인 후 브라우저 창을 닫는다. 

$ claude login

 

STEP  9. 설치 상태 최종 확인

$ claude --version
$ claude doctor

• 버전 숫자가 나오면 설치 완료!

프로젝트에서 시작하기

STEP  10. 내 프로젝트 폴더로 이동 후 실행

$ cd ~/Desktop/my-project
$ claude

 

Finder에서 해당 폴더를 터미널 창으로 드래그하면 경로가 자동 입력된다.