1. 환경 요구사항

  • 운영체제: CentOS 7/8/Stream 9
  • Node.js: v18 이상
  • 메모리: 2GB 이상 권장
  • 네트워크: Anthropic API 접근 가능해야 함

2. Node.js 설치

1
2
3
4
5
6
7
8
9

# NodeSource 저장소 설치
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -

# Node.js 설치
sudo yum install -y nodejs

# 확인
node -v
npm -v

Node.js 버전이 너무 낮으면 nvm으로 버전을 관리하세요:

1
2
3
4

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

3. Claude Code 설치

1
2
3
4
5

# 전역 설치
npm install -g @anthropic-ai/claude-code

# 확인
claude --version

권한 문제가 발생하면 두 가지 해결 방법이 있습니다:

1
2
3
4
5
6
7
8

# 방법 1: sudo
sudo npm install -g @anthropic-ai/claude-code

# 방법 2: npm 전역 디렉터리 변경 (추천)
mkdir -p ~/.npm-global
npm config set prefix "~/.npm-global"
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

4. API Key 설정

1
2
3
4
5
6

# 방법 1: 환경 변수 (추천)
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

# 확인
echo $ANTHROPIC_API_KEY

방법 2: claude를 직접 실행하면 최초 실행 시 API Key 입력을 요청합니다.

5. 기본 사용법

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 대화형 세션 시작
cd /path/to/your/project
claude

# 직접 질문하기 (비대화형 모드)
claude -p "현재 디렉터리의 모든 파일 개수를 세는 Python 스크립트를 작성해줘"

# 코드 분석
cat main.py | claude -p "이 코드의 잠재적 문제점을 분석해줘"

# 설정 확인/수정
claude config

# 최신 버전으로 업데이트
claude update
명령어 설명
claude 대화형 세션 시작
claude -p "질문" 직접 질문, 비대화형 모드
claude config 설정 확인/수정
claude update 최신 버전으로 업데이트

6. 네트워크 문제 해결

Anthropic API 연결이 타임아웃되는 경우:

1
2
3
4
5
6

# 프록시 설정
export https_proxy="http://your-proxy:port"
export http_proxy="http://your-proxy:port"

# 연결 테스트
curl -s https://api.anthropic.com/ | head -5

7. 보안 권장사항

1
2
3
4
5
6
7
8
9

# API Key를 하드코딩하지 말고 항상 환경 변수를 사용하세요
echo 'export ANTHROPIC_API_KEY="sk-ant-xxx"' >> ~/.bashrc  # ✅
# ANTHROPIC_API_KEY=sk-ant-xxx 코드에 직접 작성  # ❌

# 파일 권한 제한
chmod 600 ~/.bashrc

# 유출 여부 확인
grep -r "ANTHROPIC_API_KEY" --include="*.py" --include="*.js" .