Claude Code 설치 방법

Claude Code용 Node.js: 필요한 버전과 Node.js 없이 설치하는 방법

npm 방식에는 Node.js 18 이상이 필요합니다. 다음으로 node -v 확인하고, nvm(nvm install --lts)으로 해결하세요. 새로 설치한 프로그램이 시작되지 않는 가장 흔한 원인은 오래된 Node 버전입니다. 도구 체인에 Node가 없다면 설치하지 않아도 됩니다. 아래의 네이티브 설치 프로그램은 독립 실행형 바이너리를 제공하며 자동으로 업데이트됩니다.

방법 1 — npm(Node.js 18 이상이 있는 모든 OS)

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

만약 npm install -g 이 macOS 또는 Linux에서 EACCES 오류로 실패하면 sudo를 사용하지 말고 npm 접두 경로를 수정하세요: npm config set prefix ~/.npm-global 그리고 다음을 ~/.npm-global/bin PATH에 추가하세요. Windows에서는 일반(관리자 권한이 아닌) 터미널에서 설치를 실행하세요.

방법 2 — Mac, Linux, Windows용 네이티브 설치 프로그램(Node.js 불필요)

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Linux 및 Ubuntu에 Claude Code 설치

Ubuntu, Debian, Fedora 또는 다른 배포판에서는 네이티브 설치 프로그램(curl -fsSL https://claude.ai/install.sh | bash)이 홈 디렉터리에 자동 업데이트되는 바이너리를 설치하며, root 권한이나 Node.js가 필요하지 않습니다. npm을 선호한다면 먼저 NodeSource 또는 nvm으로 Node 18 이상을 설치하세요. Ubuntu의 apt로 설치하는 Node는 대개 너무 오래된 버전입니다. 그런 다음 다음을 실행하세요: npm install -g @anthropic-ai/claude-code. 터미널만 사용하는 서버나 컨테이너에서는 네이티브 바이너리가 더 나은 선택입니다. 게이트웨이 변수 두 개를 다음에 추가하면 ~/.bashrc SSH에서도 로컬과 동일하게 작동합니다.

네이티브 빌드는 자동으로 업데이트되며 Node 버전 충돌을 방지합니다. Node가 기존 도구 체인에 포함되지 않은 컴퓨터에서는 더 나은 선택입니다.

방법 3 — 데스크톱 앱 또는 IDE 확장

Claude 데스크톱 앱에는 Claude Code가 포함되어 있으며, VS Code 및 JetBrains 확장은 처음 사용할 때 CLI를 설치해 줍니다. 각 환경에서 가능한 작업과 불가능한 작업은 웹, 데스크톱 및 IDE 가이드를 참고하세요.

Windows 참고 사항

Claude Code는 Windows 10/11(PowerShell 또는 Git Bash)에서 네이티브로 실행되며 WSL 내에서도 실행됩니다. Unix 셸을 전제로 하는 프로젝트에서는 WSL을 사용하는 편이 더 원활합니다. 다음 명령을 claude Windows에서 npm으로 설치한 후 찾을 수 없다면, PATH을 다시 읽도록 새 터미널을 열거나 다음을 확인하고 npm config get prefix 해당 경로의 bin 폴더를 추가하세요.

로그인 없이 Claude Code 실행: API 키로 인증

다음 명령을 실행하세요: claude 그리고 다음을 선택하면 /login Claude Pro/Max 구독으로 로그인할 수 있습니다. 또는 로그인을 완전히 건너뛸 수도 있습니다. ANTHROPIC_API_KEY(또는 ANTHROPIC_AUTH_TOKEN)을 설정하면 Claude Code는 로그인 화면을 표시하지 않으며, ANTHROPIC_BASE_URL에 지정된 엔드포인트에 연결하여 로컬에서 실행됩니다. 브라우저를 열 수 없는 컴퓨터에서도 이 방식으로 실행할 수 있습니다. 이 게이트웨이에는 키 인증 방식을 사용하세요:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key   # or ANTHROPIC_AUTH_TOKEN
claude

이 두 줄을 다음에 넣거나 ~/.zshrc, ~/.bashrc PowerShell 프로필에 넣어 새 터미널마다 적용되도록 하세요. Claude Code 안에서는 /status 으로 현재 사용 중인 엔드포인트와 키를 확인할 수 있습니다.

Claude Code 업데이트 및 제거 방법

claude update                      # native / self-update
npm update -g @anthropic-ai/claude-code   # npm install
npm uninstall -g @anthropic-ai/claude-code

설치에 성공했지만 Claude Code가 시작되지 않는 경우

• command not found → PATH: 새 셸을 열거나 npm의 전역 bin 디렉터리를 추가하세요.
• Node version 오류 → Node.js 18 이상이 필요합니다. node -v 으로 확인하거나 네이티브 설치 프로그램으로 전환하세요.
• 첫 실행 시 멈춤 → 기업 프록시 문제입니다. HTTPS_PROXY을 설정하거나, 네트워크에서 api.anthropic.com을 차단하는 경우 게이트웨이 기본 URL을 설정하세요.
• 401 / 유효하지 않은 키 → ANTHROPIC_BASE_URL이 여기를 가리키면 게이트웨이 키를 사용해야 합니다. Anthropic 콘솔 키는 거부됩니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

자주 묻는 질문

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.