2026년 Claude Code CLI 설치 방법: 전체 설정 가이드

AI Perks

AI Perks는 스타트업과 개발자가 비용을 절감할 수 있도록 AI 도구, 클라우드 서비스, API에 대한 독점 할인, 크레딧 및 혜택을 제공합니다.

모든 AI Perks 보기

2026년 Claude Code CLI 설치 방법

Claude Code를 설치하려면 터미널에서 **npm install -g @anthropic-ai/claude-code@latest**를 실행하세요. 설치에는 약 30초가 소요됩니다. **claude --version**으로 확인한 다음, **claude auth login**으로 인증하여 사용을 시작하세요.

Claude Code는 Node.js 18 이상을 요구합니다. 설치 후에는 macOS, Linux, Windows에서 동일한 명령어로 실행됩니다. 또한, 설정하는 동안 AI Perks를 이용하면 Claude Code를 무료로 구동할 수 있는 $1,000-$25,000 이상의 상당한 무료 Anthropic 크레딧을 받을 수 있습니다.

AI 크레딧으로 예산을 절약하세요

혜택 검색

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

모두무료파트너십

혜택 검색

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

모두무료파트너십

Software	예상 크레딧	조건	승인 지수	작업

당신의 SaaS를 홍보하세요

당신과 같은 도구를 찾는 전 세계 90,000+ 창업자에게 도달하세요

지금 신청

시스템 요구 사항

Node.js 버전을 확인하세요:

node --version

18 미만인 경우, nodejs.org에서 최신 LTS 버전을 설치하거나 nvm을 사용하세요.

AI Perks

AI Perks는 스타트업과 개발자가 비용을 절감할 수 있도록 AI 도구, 클라우드 서비스, API에 대한 독점 할인, 크레딧 및 혜택을 제공합니다.

모든 AI Perks 보기

macOS에 Claude Code 설치하기

1단계: Node.js 설치 (아직 설치되지 않은 경우)

Homebrew 사용:

brew install node

또는 nodejs.org에서 다운로드하세요.

2단계: Claude Code 설치

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

3단계: 설치 확인

claude --version

버전 번호(예: 1.x.x)가 출력되어야 합니다.

4단계: 인증

claude auth login

이 명령은 Anthropic 계정으로 로그인하기 위해 브라우저를 엽니다.

Linux에 Claude Code 설치하기

1단계: Node.js 설치 (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

다른 배포판(Fedora, Arch 등)의 경우 패키지 관리자를 사용하세요.

2단계: Claude Code 설치

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

권한 오류가 발생하는 경우, npm에 sudo를 사용하지 마세요. 대신 npm의 접두사를 수정하세요:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

그 후 다시 설치하세요.

3단계: 확인 및 인증

claude --version
claude auth login

Windows에 Claude Code 설치하기

1단계: Node.js 설치

nodejs.org에서 Windows 설치 프로그램을 다운로드하여 실행하세요. 설치 중에 "Add to PATH"가 선택되었는지 확인하세요.

2단계: PowerShell 또는 Terminal 열기

PowerShell(또는 Windows Terminal)을 관리자 권한으로 여세요.

3단계: Claude Code 설치

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

4단계: 설치 확인

claude --version

claude가 인식되지 않으면 터미널을 다시 시작하거나 npm의 전역 bin 폴더가 PATH에 있는지 확인하세요:

npm config get prefix

결과 경로(뒤에 \를 붙인)를 시스템 PATH 변수에 추가하세요.

5단계: 인증

claude auth login

인증 방법

Claude Code는 세 가지 인증 방법을 지원합니다.

방법 1: OAuth 로그인 (가장 쉬움)

claude auth login

Anthropic 계정으로 로그인하기 위해 브라우저를 엽니다. Pro/Max 구독을 사용하는 개인 사용자에게 가장 적합합니다.

방법 2: API 키 (무료 크레딧에 권장)

Anthropic API 키를 환경 변수로 설정하세요:

macOS/Linux:

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc  # 또는 ~/.bashrc

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-...', 'User')

이것은 유료 구독 대신 AI Perks의 무료 Anthropic 크레딧을 사용하는 데 가장 좋은 옵션입니다.

방법 3: 구성 파일

~/.claude/auth/credentials.json을 편집하세요:

{
  "api_key": "sk-ant-...",
  "auth_type": "api_key"
}

첫 설정: 모든 것이 제대로 작동하는지 확인

설치 및 인증 후:

기본 기능 테스트

claude

Claude Code REPL이 표시되어야 합니다. 프롬프트를 시도해 보세요:

Hello! What model are you running?

Claude는 인사말과 함께 활성 모델을 표시하며 응답해야 합니다.

파일 작업 테스트

프로젝트 폴더로 이동합니다:

cd ~/projects/my-app
claude

README를 읽도록 Claude에게 요청하세요:

Can you read the README.md and summarize this project?

Claude가 읽고 응답하면 설정이 제대로 작동하는 것입니다.

일반적인 설치 오류 및 해결 방법

오류: npm ERR! EACCES permission denied

npm 전역 폴더에 쓸 권한이 없습니다. 해결 방법:

# sudo를 사용하지 마세요. 대신 npm의 접두사를 변경하세요:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

export를 ~/.zshrc 또는 ~/.bashrc에 추가하여 영구적으로 만드세요.

오류: command not found: claude

설치 후 claude 명령을 찾을 수 없습니다. 원인:

1. 터미널을 다시 시작하지 않음 - 터미널을 닫고 다시 여세요.
2. PATH에 npm bin 누락 - echo $(npm config get prefix)/bin을 실행하고 PATH에 추가하세요.
3. 잘못된 쉘 구성 - zsh의 경우 ~/.zshrc를 편집하고, bash의 경우 ~/.bashrc를 편집하세요.

오류: Node.js version too old

Claude Code는 Node.js 18 이상을 요구합니다. 업그레이드:

# macOS (Homebrew)
brew upgrade node

# Linux (nvm)
nvm install 20
nvm use 20

# Windows
# nodejs.org에서 최신 LTS 버전 다운로드

오류: Authentication failed

• API 키가 sk-ant-로 시작하는지 확인하세요.
• console.anthropic.com에서 키가 취소되지 않았는지 확인하세요.
• ANTHROPIC_API_KEY 환경 변수에 추가 공백이 없는지 확인하세요.
• 키를 다시 생성해 보세요.

오류: Cannot find module '@anthropic-ai/claude-code'

설치가 완료되지 않았습니다. 다음을 시도해 보세요:

npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest --force

무료 Anthropic 크레딧으로 Claude Code 구동하기

Claude Code는 실제로 실행하려면 유료 구독($20-$200/월) 또는 API 크레딧이 필요합니다. AI Perks를 통한 무료 Anthropic 크레딧은 API 비용을 전액 부담합니다.

총 잠재력: $4,500 - $156,000+ 상당의 무료 Claude 크레딧

Claude Code를 설치한 후, 무료 크레딧으로 구동되는 API 키로 구성하고 구독 결제를 완전히 건너뛰세요.

단계별: Claude Code 무료 설치 및 실행

1단계: Claude Code 설치

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

2단계: 무료 Anthropic 크레딧 받기

AI Perks를 구독하고 크레딧 프로그램을 신청하세요. 대부분의 결정은 일주일 이내에 내려집니다.

3단계: API 키 생성

console.anthropic.com에 로그인하고 Settings > API Keys에서 API 키를 생성하세요.

4단계: Claude Code 구성

export ANTHROPIC_API_KEY="sk-ant-..."

영구적으로 만들려면 쉘 구성에 추가하세요.

5단계: 코딩 시작

claude

이제 모든 프롬프트는 무료 크레딧 잔액에서 차감됩니다. 구독이 필요 없습니다.

자주 묻는 질문

Claude Code 설치에는 얼마나 걸리나요?

Node.js 18 이상이 이미 설치되어 있다고 가정할 때, npm을 통한 설치에는 30-60초가 소요됩니다. 먼저 Node.js를 설치해야 하는 경우 5-10분을 추가하세요. claude --version으로 성공 여부를 확인하세요.

Claude Code를 설치하려면 유료 구독이 필요한가요?

아니요, 설치는 무료입니다. Claude Code를 실제로 사용하려면 유료 Anthropic 구독 또는 API 크레딧이 필요합니다. AI Perks를 통한 $1,000-$25,000 이상의 무료 크레딧으로 비용을 완전히 없앨 수 있습니다.

Claude Code를 여러 컴퓨터에 설치할 수 있나요?

예, 원하는 만큼 많은 컴퓨터에 설치할 수 있습니다. 설치 자체는 무료입니다. Anthropic 계정, API 키 및 크레딧은 컴퓨터 간에 공유됩니다. 어떤 컴퓨터에서든 사용한 내용은 동일한 잔액으로 계산됩니다.

서버(CI/CD)에 Claude Code를 설치하려면 어떻게 해야 하나요?

동일한 npm install 명령을 사용한 다음, 환경 변수 (ANTHROPIC_API_KEY)로 구성하세요. CI/CD의 경우 API 키를 비밀로 저장하고 파이프라인 실행 중에 주입하세요. AI Perks를 통한 무료 크레딧은 CI/CD 사용을 $0으로 충당합니다.

Node.js 없이 Claude Code를 설치할 수 있나요?

아니요, Claude Code는 실행을 위해 Node.js 18 이상을 요구합니다. Anthropic에서 공식적으로 배포하는 독립 실행형 바이너리는 없습니다. 필요한 경우 nvm 또는 OS 패키지 관리자를 사용하여 Node.js를 설치하세요.

Claude Code의 특정 버전을 설치하려면 어떻게 해야 하나요?

버전 플래그로 설치하세요: npm install -g @anthropic-ai/claude-code@1.2.0 (원하는 버전으로 교체). GitHub 변경 로그에서 사용 가능한 버전을 확인하세요.

Claude Code를 설치한 후에는 어떻게 되나요?

**claude --version으로 확인하고, claude auth login (또는 ANTHROPIC_API_KEY 설정)**을 실행하세요. 어떤 프로젝트 폴더에서든 claude를 실행하여 시작하세요. Claude는 코드를 읽고, 변경 사항을 제안하며, 작업을 실행할 수 있습니다. AI Perks를 통한 무료 크레딧을 사용하면 무제한 사용 비용이 $0입니다.

Claude Code 설치 + 무료 Anthropic 크레딧 받기

Claude Code 설치는 30초가 걸립니다. 무료로 구동하는 것은 AI Perks 구독이 필요합니다:

• $1,000-$25,000 이상의 무료 Anthropic 크레딧
• $50,000 이상의 런웨이를 위한 스태킹 전략
• AI 크레딧 외 200개 이상의 추가 스타트업 혜택
• 모든 Claude Code 버전에 대한 업데이트된 가이드

getaiperks.com에서 구독하기 →

Claude Code를 30초 안에 설치하세요. getaiperks.com에서 무료로 구동하세요.