Claude Code와 OpenRouter의 무료 모델로 월 0원 AI 개발 환경 구축하는 5가지 설정

• OpenRouter의 :free 모델을 Claude Code를 통해 호출하면 LLM 비용을 거의 0으로 만들 수 있습니다. - 설정은 환경 변수 2개 + CLAUDE.md에 몇 줄만 작성하면 됩니다. - 무료 모델로도 '조사・초안 작성・테스트 생성'은 충분히 처리할 수 있습니다.
• 비용 최적화의 관점에서 '작업 유형별로 모델을 분리하여 사용하기(모델 스위칭)' 전략이 효과적입니다.

AI 코딩 어시스턴트가 실용 단계에 접어든 한편, Claude Opus나 GPT-4o를 전면적으로 사용할 경우 월 API 비용이 예상치 못하게 크게 증가한다는 문제가 대두되고 있습니다.

OpenRouter는 여러 LLM 프로바이더로 연결되는 통합 API 게이트웨이입니다. 이 안에는 :free 접미사가 붙은 모델들이 여러 개 존재하며, 이는 레이트 제한은 있지만

무료로 API 호출할 수 있습니다.

본문에서는 다음 내용을 설명합니다.

• OpenRouter :free 모델의 종류와 특성 - Claude Code (CLI)와 결합하는 설정 방법
• 작업 유형별 모델 분리 사용 전략
• 실제로 시도해 본 느낌과 주의점들

OpenRouter에는 <provider>/<model-name>:free 형식의 모델 식별자가 준비되어 있으며, 2026년 기준으로 다음과 같은 모델이 무료로 이용 가능합니다 (레이트 제한 있음).

주의: 무료 모델은 이용 가능 상황이 바뀔 수 있습니다. 최신 모델 목록은 openrouter.ai/models에서 free 필터를 사용하여 확인해 주세요.

무료 모델에는 대체로 다음과 같은 제약 사항이 있습니다.

• 요청 수: 약 20 req/분, 200 req/일
• 컨텍스트 길이: 모델마다 다름 (32k~128k)
• 지연 시간(Latency): 유료 모델보다 느릴 수 있음 (특히 혼잡할 때)

'대량의 자동 처리'에는 적합하지 않지만, 사람이 읽으면서 대화하는 속도라면 거의 문제없이 사용할 수 있습니다.

Claude Code는 Anthropic의 CLI 기반 코딩 어시스턴트이지만, ANTHROPIC_BASE_URL을 변경하여 OpenRouter 호환 엔드포인트를 겨냥할 수 있습니다.

openrouter.ai에서 가입하고 'Keys'에서 API 키를 발급받습니다 (무료 플랜 있음).

# ~/.bashrc 또는 ~/.zshrc에 추가
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxx" # OpenRouter의 API 키

source ~/.zshrc

# 특정 모델을 지정하여 실행
claude --model "qwen/qwen3-235b-a22b:free"

또는 CLAUDE.md에 기본 모델을 작성해 두는 방법도 있습니다 (프로젝트 루트에 배치).

<!-- CLAUDE.md -->
## AI Settings
- Default model: qwen/qwen3-235b-a22b:free
...

claude -p "Hello! What model are you running on?"

OpenRouter를 통해 호출할 경우, 응답 헤더나 일부 모델은 자기소개에서 사용 모델을 반환합니다.

'모든 것을 무료 모델로 끝내는 것'은 불가능하지만, 작업을 분류하여 적절한 모델에 분배함으로써 비용을 대폭 절감할 수 있습니다.

タスク種別 推奨モデル
─────────────────────────────────────────────────────────
ファイル探索・grep 代替 :free モデル (コスト 0)
...

# ~/.zshrc
alias ai-free='ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1" \
ANTHROPIC_API_KEY="sk-or-v1-xxxx" \
...```

이렇게 하면 `ai-free`로 비용 제로의 조사 모드, `ai-sonnet`으로 유료 구현 모드를 명확하게 구분하여 사용할 수 있습니다.

**테스트 코드 생성**은 품질이 높고 실용적이었습니다. 기존 코드를 전달하여 단위 테스트를 작성하도록 하면, Jest / Vitest / pytest 어느 것에서도 8할 이상 그대로 사용 가능한 코드가 반환됩니다.

// 이런 코드를 주면...
export function formatPrice(cents: number): string {
return ¥${(cents / 100).toLocaleString('ja-JP')};
...```

README・CHANGELOG 초안 생성도 매우 사용하기 쉬우며, diff를 보면서 '이 릴리스에서 무엇이 바뀌었는지' 요약하도록 하는 유즈케이스는 고정도가 높았습니다.

컨텍스트 길이: 큰 파일을 통째로 전달하면 레이트 제한에 걸리기 쉽습니다. 관련 함수만 추출해서 전달하는 노력이 필요합니다 -
지연 시간 변동성: 혼잡할 때는 30~60초를 기다릴 수도 있습니다. 타임아웃 설정을 여유롭게 해두면 안심입니다 -
모델 교체: :free
프레임의 모델은 예고 없이 변경되거나 폐지될 수 있습니다. CI 등에 통합하는 경우에는 폴백(fallback) 모델을 설정해야 합니다.

OpenRouter 고유 기능으로, 프롬프트가 너무 길어서 컨텍스트 초과할 것 같을 때 자동으로 잘라주는 옵션이 있습니다.

# API 직접 호출 예시 (curl)
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
...```

`

바꾸기만 하면 Claude Code에서 사용 가능 - 환경 변수 2개 + 셸 별칭으로 무료/유료 모델을 쉽게 전환할 수 있습니다.
- 테스트 생성, 문서 초안 작성, 코드 조사는 무료 모델로 충분합니다.
- 복잡한 설계나 대규모 리팩토링에는 유료 모델을 적절히 사용합니다.
- 
`transforms: ["middle-out"]`
으로 컨텍스트 초과 오류를 줄일 수 있습니다.

AI 코딩 어시스턴트를 '비용이 무서워서 아껴 쓰는' 것이 아니라, **모델 선택 전략을 통해 적극적으로 사용하며 비용을 최적화하는 것**이 2026년의 현실적인 해결책입니다.

- OpenRouter 공식 문서
- OpenRouter 모델 목록 (free 필터)
- Claude Code 공식 문서
- Qwen3 모델 카드 (Hugging Face)
- Meta Llama 3.3 릴리스 노트

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

지모라보는 하치오지에 거점을 두고 AI를 활용한 SaaS를 다수 개발하고 있습니다. 본 기사의 기술 검증 역시 그러한 개발 과정의 부산물입니다.

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

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