Claude Code 설치하기: Mac 터미널 편
터미널 열기부터 공식 네이티브 설치, 버전 확인까지. Node.js를 먼저 설치하는 경로와 구분합니다.
시작 전 확인
이 글은 macOS 터미널용 Claude Code 설치 과정입니다. 인터넷 연결, 지원되는 Mac, 로그인에 사용할 Claude 계정이 필요합니다. 운영체제 조건은 공식 설치 문서에서 먼저 확인하세요.
이 과정은 공식 네이티브 설치 경로입니다. Claude Code 설치를 위해 Node.js나 npm을 먼저 설치하는 과정이 아닙니다. 이후 만드는 프로젝트가 Node.js를 필요로 하면 그때 따로 준비합니다.
1. 터미널 열고 설치 명령 확인하기
- Command+Space를 누르고
Terminal을 검색해 엽니다. - 아래 명령을 입력하기 전 다운로드 주소가
https://claude.ai/install.sh인지 확인합니다. - 이 명령은 설치 스크립트를 내려받아 실행합니다. 설명을 이해하고 설치를 진행할 때만 입력합니다.
curl -fsSL https://claude.ai/install.sh | bash
- Enter를 한 번 누르고 기다립니다. 다운로드 중 진행 표시가 없을 수 있습니다. 같은 명령을 여러 창에서 동시에 실행하지 마세요.
- 설치가 끝나면 성공 또는 오류 안내를 읽습니다. 끝부분에 PATH 관련 설명이 있으면 기록해둡니다.
2. 새 창에서 설치 확인하기
터미널 새 창을 열고 다음을 실행합니다.
claude --version
정상 결과: 버전 번호가 나옵니다. 예시 버전과 숫자가 같아야 하는 것은 아닙니다.
작업 폴더를 만들었다면 해당 위치로 이동한 뒤 실행합니다.
cd ~/code6office-practice
claude
로그인이나 초기 설정 화면이 나오면 설치 단계는 통과한 것입니다. 다음 글에서 로그인과 첫 대화를 진행하세요.
여기에서 막혔다면
command not found: claude: 새 터미널 창에서도 같은지 확인합니다. 계속 같으면 명령어를 찾을 수 없을 때로 이동합니다.- 인터넷·인증서 오류: 오류 원문을 기록합니다. 설치 URL과 네트워크를 확인하고 공식 문제 해결 문서를 참고합니다. 인증서 검증을 끄는 옵션을 임의로 붙이지 않습니다.
- 권한 오류:
sudo를 무조건 앞에 붙이지 않습니다. 오류가 어떤 파일에서 발생했는지부터 확인합니다.
완료 기준: 새 터미널에서 버전이 표시되고, 실습 폴더에서 claude를 시작했습니다. 로그인 성공은 별도의 다음 단계입니다.