Claude Code 설치 및 사용 가이드 - AI 프로그래밍 어시스턴트 설정

Claude Code는 터미널에서 AI와 직접 협업할 수 있게 해주는 강력한 AI 프로그래밍 어시스턴트입니다. 이 가이드는 설치 및 설정 과정을 단계별로 안내합니다.

시스템 요구 사항#

Claude Code를 설치하기 전에, 시스템이 다음 요구 사항을 충족하는지 확인하세요:

• Node.js: 18.0 이상 버전
• 운영 체제: macOS, Linux, 또는 Windows (WSL 권장)

빠른 시작#

1단계: Node.js 설치#

이미 Node.js 18.0 이상이 설치되어 있다면, 이 단계를 건너뛸 수 있습니다.

Ubuntu / Debian#

# Install Node.js LTS version
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verify installation
node --version

macOS#

# Install Xcode command line tools
sudo xcode-select --install

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Verify installation
node --version

2단계: Claude Code 설치#

npm을 사용해 Claude Code를 전역(global)으로 설치합니다:

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

# Verify installation
claude --version

3단계: API 액세스 설정#

Crazyrouter API와 함께 Claude Code를 사용하려면 두 가지 설정 항목이 필요합니다:

권장 토큰 설정:

• Name: 알아보기 쉬운 이름 아무거나
• Quota: 개발 용도로 무제한으로 설정
• Group: "Claude Code" 또는 "Official Claude 3+" 선택
• 기타 옵션: 기본값 유지

4단계: Claude Code 실행#

Linux / macOS#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Windows PowerShell#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Launch Claude Code
claude

Windows CMD#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Launch Claude Code
claude

5단계: 첫 실행 설정#

Claude Code를 처음 실행하면 다음과 같은 설정 절차가 나타납니다:

1. 테마 선택(Select Theme) - 원하는 색상 테마를 선택하고 Enter 키를 누르세요
2. 안전 안내(Safety Notice) - 안전 관련 안내를 검토하고 확인
3. 터미널 설정(Terminal Configuration) - 기본 설정을 사용하거나 필요에 따라 커스터마이즈
4. 작업 디렉터리 신뢰(Working Directory Trust) - 현재 디렉터리를 신뢰하여 파일 접근을 허용

이제 AI 프로그래밍 파트너와 함께 코딩을 시작할 준비가 되었습니다.

영구 설정 (선택 사항)#

매번 환경 변수를 설정하지 않으려면, 셸 프로필에 추가하세요:

Bash (~/.bashrc 또는 ~/.bash_profile)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh (~/.zshrc)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

추가 후 셸을 다시 로드합니다:

source ~/.bashrc  # or source ~/.zshrc

자주 묻는 질문#

"Invalid API Key" 오류#

"Invalid API Key - Please run /login" 메시지가 표시되면 다음을 확인하세요:

• ANTHROPIC_AUTH_TOKEN이 올바르게 설정되어 있는지 (sk-로 시작)
• ANTHROPIC_BASE_URL이 https://crazyrouter.com/으로 설정되어 있는지
• 환경 변수 설정 후 터미널을 재시작했는지

"Offline" 상태#

Claude Code는 Google에 연결하여 네트워크 상태를 확인합니다. "offline"으로 표시되어도 일반적인 사용에는 영향을 주지 않으며, 단지 Google 서버에 연결할 수 없음을 의미합니다.

웹 가져오기(Web Fetch) 실패#

Claude Code는 웹 페이지에 접근하기 전에 보안 검사를 수행합니다. 다음을 확인하세요:

• 안정적인 인터넷 연결
• 필요하다면 글로벌 프록시 사용

지속적인 "Fetch Failed" 오류#

네트워크 문제로 인해 발생할 수 있습니다. 다음을 시도해보세요:

1. Claude Code 종료 (Ctrl+C)
2. claude 명령을 다시 실행
3. 문제가 지속되면 잠시 후 다시 시도

API 오류#

API 오류가 발생하면:

• Claude Code를 종료(Ctrl+C)
• 잠시 기다린 후 다시 실행
• 대시보드에서 토큰 quota를 확인

중요 참고 사항#

• Crazyrouter는 공식 Claude Code 서비스로의 직접 포워딩을 제공합니다.
• API 토큰을 안전하게 보관하고, 공개적으로 공유하지 마세요.
• 예상치 못한 요금을 방지하기 위해 대시보드에서 사용량을 모니터링하세요.

가격 정책#

Claude Code는 Crazyrouter에서 다음과 같은 가격으로 Claude 모델을 사용합니다:

모든 가격에는 공식 요금 대비 45% 할인 혜택이 포함되어 있습니다.

관련 리소스#

• Crazyrouter Pricing Page
• Claude Code Official Documentation
• Node.js Official Website

도움이 필요하신가요? 지원팀에 문의하거나, 더 자세한 내용은 Crazyrouter documentation를 확인하세요.