Claude Code 설치 & 로그인

Claude Code 설치는 터미널에서 명령어 한 줄이면 됩니다. 두 가지 방법이 있는데, 2026년 기준으로 Native Installer가 공식 권장 방법입니다. 방법 1: Native Installer (권장) Node.js 설치 없이 바로 Claude Code를 설치할 수 있는 가장 간단한 방법입니다. 아래 명령어를 터미널에 그대로 복사해서 붙여넣기 하시면 됩니다. 방법 2: npm 설치 이미 Node.js가 설치되어 있다면 npm으로도 설치할 수 있습니다. npm은 Node.js에 포함된 '프로그램 설치 도우미'입니다. 어떤 방법을 쓰든 결과는 동일합니다. Node.js가 없다면 방법 1, 이미 Node.js가 있다면 어느 방법이든 상관없습니다.

# 방법 1: Native Installer (권장 — Node.js 불필요)
curl -fsSL https://claude.ai/install.sh | bash

# 방법 2: npm 설치 (Node.js가 이미 있는 경우)
npm install -g @anthropic-ai/claude-code

# 설치 확인 (어느 방법이든 동일)
claude --version
# 버전 번호가 출력되면 성공입니다!

Claude Code를 사용하려면 Anthropic 계정이 필요합니다. 두 가지 방법이 있습니다. 방법 1: Claude 구독 사용 이미 claude.ai에서 Pro 또는 Team 구독을 하고 계시다면, 별도의 API 설정 없이 Claude Code에서 바로 로그인할 수 있습니다. 이 방법이 가장 간단합니다. 방법 2: API 키 사용 console.anthropic.com에서 계정을 만들고, API 키를 발급받아 사용하는 방법입니다. 사용한 만큼만 비용이 청구되므로, 사용량이 많지 않다면 이 방법이 경제적일 수 있습니다. 어느 방법을 사용하든, 처음 claude 명령어를 실행하면 로그인 과정을 안내해 줍니다.

이제 Claude Code를 처음 실행해 보겠습니다. 터미널에서 이전에 만들어 둔 업무 폴더로 이동한 뒤, claude를 입력합니다. 첫 실행 시 로그인 화면이 나타납니다. 웹 브라우저가 자동으로 열리면서 Anthropic 계정으로 로그인하라는 안내가 뜹니다. 로그인을 완료하면 터미널로 돌아와서 Claude Code를 사용할 수 있게 됩니다. 로그인은 한 번만 하면 됩니다. 이후에는 claude만 입력하면 바로 사용할 수 있습니다.

# 업무 폴더로 이동
cd ~/Documents/노무사업무

# Claude Code 실행
claude

# 첫 실행 시 로그인 안내가 나타납니다.
# 화면의 안내를 따라 로그인을 완료하세요.

설치 과정에서 문제가 생길 수 있습니다. 흔한 문제와 해결 방법을 정리했습니다. 'npm: command not found' → Node.js가 제대로 설치되지 않은 것입니다. 2-2강으로 돌아가서 Node.js를 다시 설치하세요. 'EACCES: permission denied' (Mac) → sudo npm install -g @anthropic-ai/claude-code 로 다시 시도하세요. 설치는 됐는데 'claude: command not found' → 터미널을 껐다가 다시 열어보세요. 그래도 안 되면 npm의 전역 설치 경로가 PATH에 포함되어 있는지 확인해야 합니다. 이때는 npx @anthropic-ai/claude-code를 대신 사용할 수 있습니다. 네트워크 에러 → 회사 네트워크에서 npm 접근이 차단되어 있을 수 있습니다. 개인 네트워크(핫스팟 등)로 전환해서 시도해 보세요.