Claude

Ubuntu에 Claude CLI를 설치하는 방법

2026.01.26 07:28 조회 6

Ubuntu에 Claude CLI를 설치하는 방법을 안내해 드리겠습니다.


Claude CLI 설치 방법 (Ubuntu 24.04)

1. 사전 요구사항 확인

# Node.js 18+ 필요 (권장: 20 LTS)
node --version

# npm 확인
npm --version

Node.js가 없거나 버전이 낮다면:

# NodeSource에서 Node.js 20 LTS 설치
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

2. Claude CLI 설치

방법 A: npm으로 설치 (기존 방식 - Deprecated)

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

방법 B: 공식 설치 스크립트 (권장)

# 공식 설치 스크립트 실행
curl -fsSL https://claude.ai/install.sh | sh

방법 C: 직접 다운로드

# Linux x64용 바이너리 직접 다운로드
curl -fsSL https://claude.ai/download/linux -o claude
chmod +x claude
sudo mv claude /usr/local/bin/

3. 설치 확인

# 버전 확인
claude --version

# 또는
claude -v

4. 초기 설정 (인증)

# 프로젝트 디렉토리로 이동
cd ~/your-project

# Claude CLI 실행 (첫 실행 시 인증 진행)
claude

첫 실행 시:
1. 브라우저가 열리며 Anthropic 계정 로그인
2. OAuth 인증 완료
3. 터미널로 돌아와서 사용 시작


5. 유용한 설정

# 기본 설정 확인
claude config list

# 에디터 설정 (예: VS Code)
claude config set editor "code"

# 테마 설정
claude config set theme "dark"

6. 기본 사용법

# 대화형 모드
claude

# 단일 질문
claude "이 프로젝트의 구조를 설명해줘"

# 특정 파일과 함께
claude "이 코드를 리뷰해줘" -f main.py

# 명령어 목록
claude --help

문제 해결

npm 권한 오류 시

# npm 전역 디렉토리 설정
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

# PATH에 추가 (~/.bashrc 또는 ~/.zshrc)
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

인증 문제 시

# 인증 정보 초기화
claude auth logout
claude auth login

설치 중 문제가 발생하면 말씀해 주세요!

목록 Claude
전체 메뉴
로그인이 필요합니다

SANGKI.COM의 모든 기능을 이용하시려면 로그인해주세요.