OpenRouter로 Claude Code 활용하기: 완벽 가이드

OpenRouter와 Claude Code 결합의 이점

Anthropic의 CLI 도구인 Claude Code는 강력하지만, OpenRouter와 결합하면 더욱 유연해집니다.

왜 OpenRouter인가?

• 400+ 모델 접근: Claude 변형, GPT, 오픈소스 LLM 등
• 구독 불필요: 종량제 요금으로 사용한 만큼만 결제
• 즉시 모델 전환: /model 명령으로 세션 중 변경
• 비용 최적화: 작업에 따라 모델 선택

설정 방법

방법 1: y-router (Docker 기반, 권장)

y-router는 Anthropic과 OpenRouter 간 API 형식을 번역합니다.

# 1. 클론 및 실행
git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

# 2. 환경 변수 설정
export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-openrouter-key>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"

# 3. Claude Code 실행
claude

장점: 로컬 제어, 개인정보 보호, 완전한 커스터마이징

방법 2: Claude Code Router (npm 기반)

Docker 없이 Node.js 환경에서 사용합니다.

# 설치
npm install -g @musistudio/claude-code-router

# 설정 파일 생성
mkdir -p ~/.claude-code-router
cat > ~/.claude-code-router/config.json << EOF
{
  "openrouter": {
    "apiKey": "sk-or-your-key",
    "defaultModel": "anthropic/claude-3.5-sonnet"
  }
}
EOF

# 실행
ccr start

장점: 모델 라우팅, 폴백 정책, CI/CD 통합 용이

방법 3: 직접 프록시 (빠른 테스트)

export ANTHROPIC_BASE_URL="https://proxy-your-choice.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-key>"
export ANTHROPIC_MODEL="openrouter/model-name"

모델 선택 가이드

작업별 추천 모델

세션 중 모델 전환

/model anthropic/claude-3-opus-20240229

비용 비교

모범 사례

1. 모델 호환성 확인

// 모든 모델이 도구 호출을 지원하진 않음
const supportedFeatures = await openrouter.getModelCapabilities(modelId);
if (!supportedFeatures.toolCalling) {
  console.warn("이 모델은 도구 호출을 지원하지 않습니다");
}

2. 폴백 라우팅 설정

{
  "fallback": {
    "primary": "anthropic/claude-3.5-sonnet",
    "secondary": "openai/gpt-4-turbo",
    "tertiary": "meta-llama/llama-3.1-70b"
  }
}

3. 비용 모니터링

• OpenRouter 대시보드에서 토큰 사용량 추적
• 일일/월간 예산 알림 설정
• 프롬프트 캐싱 활용으로 비용 절감

4. 보안 관리

# API 키를 환경 변수로 관리
export OPENROUTER_API_KEY="sk-or-..."

# .gitignore에 추가
echo ".env" >> .gitignore
echo "*.key" >> .gitignore

문제 해결

자주 발생하는 오류

"Model not found"

# 모델 ID 형식 확인
claude --model anthropic/claude-3.5-sonnet  # ✓
claude --model claude-3.5-sonnet            # ✗

"Tool calling not supported"

• 도구 호출을 지원하는 모델로 전환
• Claude, GPT-4 계열 권장

연결 타임아웃

# Docker 네트워크 확인
docker logs y-router

결론

OpenRouter + Claude Code 조합은:

1. 유연성: 다양한 모델 선택
2. 비용 효율: 종량제 + 오픈소스 옵션
3. 제어권: 로컬 라우터로 완전한 통제

단일 제공업체 종속에서 벗어나 AI 코딩 워크플로우를 최적화하세요.