Claude Code 설치 튜토리얼(npm 전역 설치)

아직 Claude Code를 설치하지 않았다면 먼저 이 단계를 완료하세요. 설치가 완료되면 이어서 뒤의 CC-Switch 또는 수동 설정 튜토리얼을 확인하세요.

설치 단계

1. 먼저 로컬에 Node.js가 설치되어 있는지 확인

Claude Code는 Node.js에서 실행됩니다. Node.js 18 이상 버전을 권장하며, 먼저 터미널에서 아래 명령어를 실행하여 확인하세요:

node -v
npm -v

2. Claude Code 전역 설치

터미널에서 아래 명령어를 실행하여 공식 Claude Code CLI를 전역 설치하세요:

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

sudo 사용 금지

sudo npm install -g를 사용하지 마세요. 그렇지 않으면 이후에 권한 문제가 발생하기 쉽습니다.

3. Claude Code 설치 성공 여부 확인

설치가 완료되면 아래 명령어를 실행하세요. 버전 번호가 정상적으로 출력되거나 대화형 화면에 진입하면 설치가 성공한 것입니다:

claude --version
claude

다음은 무엇을 해야 할까요?

Claude Code 설치는 완료했지만 아직 NextHub에 연동하지 않았다면, 이어서 CC-Switch 튜토리얼 또는 수동 설정 튜토리얼을 확인하세요.