Claude Code의 백엔드를 OpenRouter 무료 모델로 전환하여 AI 코딩 비용을 90% 절감하는 5가지 설정

• Claude Code의 백엔드를 OpenRouter를 경유하는 무료 모델로 전환함으로써 월별 AI 비용을 대폭 절감할 수 있다.

ANTHROPIC_BASE_URL<br><br>환경 변수와 --model 플래그만으로 3분 이내에 설정을 변경할 수 있다. 핵심은 작업 유형별로 '사용 모델을 분리'하는 라우팅 전략을 통해 비용 최적화를 달성하는 것이다.

Claude Code는 강력한 AI 코딩 어시스턴트이지만, Claude 3.5 Sonnet 또는 Claude 3 Opus를 상시 호출할 경우 API 비용이 급증한다. 특히 '변수명 리네임', '주석 추가', '타입 보완'과 같은 소규모 작업에 계속 Sonnet을 사용하는 것은 명백히 과도한 사양이다.

OpenRouter에는 :free 접미사가 붙은 여러 무료 모델이 존재한다. 이들을 Claude Code의 백엔드로 사용하면, 복잡한 사고 과정이 필요하지 않은 작업은 비용 제로로 처리할 수 있다.

본 글에서는 작업의 복잡도에 따라 모델을 다르게 사용하는 '티어드 라우팅 전략(tiered routing strategy)'을 설명한다.

• Claude Code v1.x (CLI)
• OpenRouter 계정 (무료 플랜 가능)
• Node.js 18+

Claude Code는 내부적으로 Anthropic SDK를 사용한다. Anthropic SDK는 ANTHROPIC_BASE_URL을 참조하므로, 이를 OpenRouter의 엔드포인트로 대체하기만 하면 프록시가 완성된다.

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxx" # OpenRouter의 키

⚠️ 여기에 실제 키는 기재하지 않는다.

.env 파일에 작성하고, .gitignore에 추가해야 한다.

Claude Code를 실행하면 요청은 Anthropic 서버가 아닌 OpenRouter를 경유하게 된다.

claude --model "qwen/qwen3-235b-a22b:free" "이 파일의 타입 에러를 고쳐줘"

각 모델의 최신 스펙은 openrouter.ai/models에서 확인하세요.

:free 모델은 이용 제한(RPM/일일 상한)이 있으므로, 본질적으로 중요한 용도로는 적합하지 않다.

비용 절감의 요령은 '작업을 난이도별로 티어화하고, 가장 저렴한 모델부터 시도하는 것'이다.

# Tier 0: 반복적・기계적인 변환 작업
claude --model "qwen/qwen3-30b-a3b:free" \
"이 파일 내의 console.log를 모두 logger.debug로 치환해줘"
...

# Tier 1: 버그 수정・구현
claude --model "qwen/qwen3-235b-a22b:free" \
"이 TypeScript의 에러를 수정해줘: Type 'string' is not assignable to type 'number'"

# Tier 2: 설계・안전성 체크에는 유료 모델을 사용한다
claude --model "anthropic/claude-3.5-sonnet" \
"이 인증 플로우의 보안 문제를 파악해줘"

판단 기준:

코드 양 < 200줄 AND 작업이 기계적 → Tier 0
코드 양 200~1000줄 OR 여러 파일에 걸쳐 → Tier 1
설계 판단 / 보안 / 요구사항 정의 → Tier 2

매번 --model을 수동으로 입력하는 것은 비효율적이므로, 래퍼 스크립트를 만든다.

#!/usr/bin/env bash
# claude-router.sh — 작업 복잡도에 따라 모델 자동 선택
set -euo pipefail
...

사용법:

chmod +x claude-router.sh
alias c="./claude-router.sh"
c "console.log를 전부 지워줘" # → Tier 0 free
...

Claude Code는 프로젝트 루트의 .claude/settings.json을 읽는다. 여기에 기본 모델을 작성해 두면 --model 생략 시에도 :free 모델이 사용된다.

{
"model": "qwen/qwen3-235b-a22b:free",
"fallbackModel": "anthropic/claude-3.5-sonnet"
...

fallbackModel은 폴백 기능이 공식 지원될 경우를 위한 작성 예시이다. 현재는 model 키만 유효하다. 자세한 내용은 공식 문서를 확인해 달라.

가령, 하루에 200번 AI에게 질문하는 엔지니어가 아래와 같은 비율로 작업을 가지고 있다고 가정해보자:

기존 방식 (전체 Sonnet 사용): 200건 × $0.03 ≈ $6/일 → $180/월

티어드 적용 후: 20건 × $0.03 ≈ $0.60/일 → $18/월

→ 약 90% 비용 절감 (작업 비율은 예시. 실제 환경에서는 변동함)

OpenRouter의 무료 모델에는 RPM(Requests Per Minute)과 일일 상한이 있다. CI/CD 파이프라인에서 대량 병렬 호출을 하면 429 에러가 반환된다. 재시도 로직을 구현해 두는 것이 좋다.

# exponential backoff의 간이 구현
for i in 1 2 4 8 16; do
claude --model "qwen/qwen3-235b-a22b:free" "$PROMPT" && break
...

OpenRouter는 Anthropic SDK의 /v1/messages 엔드포인트를 호환 구현하고 있지만, **tool use (function calling)**나 vision은 일부 모델에서 미지원이다. claude --dangerously-skip-permissions와 같은 플래그는 사용하지 말 것.

:free 모델은 예고 없이 스펙이나 제공 상태가 변경될 가능성이 있다. 프로덕션 코드 리뷰와 같은 중요 용도는 유료 모델을 베이스라인으로 하는 것이 좋다.

'일단 전부 Sonnet'을 하는 것을 중단하는 것만으로도 AI 코딩의 구동 비용은 극적으로 낮아진다. 먼저 claude-router.sh를 만들어 보는 것을 추천한다.

• OpenRouter 공식 문서
• OpenRouter 모델 목록 (:free 필터)
• Claude Code 공식 문서
• Anthropic SDK — Custom Base URL

✍️ 본 기고지 작성자: 合同会社ジモラボ

지모라보는 하치오지를 거점으로 AI를 활용한 SaaS(Software as a Service)를 다수 개발하고 있습니다. 본 기사의 기술 검증 역시 그러한 개발 과정의 부산물입니다.

• 🌐 공식 사이트: https://locallab.jp
• 🔍 AI SEO 최적화 SaaS: lookupai.jp
• 📺 YouTube: @locallab_llc
• ✉️ 문의: [email protected]

관심을 가져주신다면, 각 SNS 팔로우도 부탁드립니다!