입소문 속 문구는 “무료 AI 제공업체 200개 이상”입니다. 실제 숫자는 90개에 더 가깝고, OmniRoute의 어느 페이지를 보느냐에 따라 달라집니다.
OmniRoute가 264개 제공업체를 세는 방식, 그리고 무료로 쓸 수 있는 90개
OmniRoute의 README에는 전체 제공업체 264개가 정리되어 있으며, 그중 90개 이상은 무료 티어가 있고 약 11개는 “영구 무료”로 표시되어 있습니다 . 자주 반복되는 “무료 200개 이상”이라는 숫자는 서로 다른 두 수치를 섞은 것입니다. 전체 카탈로그의 규모와 비용이 들지 않는 하위 집합을 혼동한 셈입니다. 이 둘은 별개의 숫자이며, OmniRoute 자체 표면에서도 총계가 서로 맞지 않습니다. README는 264개, 웹사이트는 236개, 2026-07-13 날짜의 자동 생성 Provider Reference는 250개라고 말합니다 . v3.8.x 변경 로그가 움직이면서 이 숫자는 매주 달라집니다.
짧은 스크립트로 그 차이를 분명히 볼 수 있습니다. 아래 스니펫은 정상 실행되었습니다.
import re
claim = "OmniRoute: 250 providers, 90+ free providers."
total, free = map(int, re.search(r"(\d+) providers, (\d+)\+ free", claim).groups())
print(f"catalog providers: {total}")
print(f"free-tier providers: {free}+")
print(f"paid/other providers: {total - free}+")
assert free == 90 and free != 200
print("OK: 'unlimited free' means 90+ free providers, not 200.")제공업체 범주는 OAuth, 웹 쿠키, API 키, 로컬, 검색, 오디오, 클라우드 에이전트, 시스템까지 걸쳐 있습니다 . 실제로 비용 없이 쓸 수 있는 경로를 제공하는 것은 API 키 제공업체와 일부 OAuth 제공업체뿐입니다. 나머지는 유료 백엔드, 로컬 모델, 유틸리티 서비스입니다. Kiro, Qoder, Pollinations, LongCat, Cloudflare AI, NVIDIA NIM, Cerebras 등을 포함한 약 11개의 “영구 무료” 항목도 무제한 처리량을 제공하는 것이 아니라 일일 또는 월간 한도가 강하게 걸려 있습니다 . 따라서 “무제한 무료”는 경계가 있는 무료로 읽는 편이 맞습니다. 하나의 라우터 뒤에 90개 안팎의 무료 티어가 묶여 있고, 각각은 속도 제한을 받습니다. 이 표현은 “200개 이상 제공업체”를 내세운 YouTube walkthrough에서 비롯된 것으로 보이지만, 저장소의 숫자가 말해 주는 이야기는 더 좁습니다.
Claude Code를 OmniRoute에 연결하려면 환경 변수 세 개면 됩니다
OmniRoute는 전역 npm 패키지로 설치되며 전부 로컬 머신에서 실행됩니다. 그래서 Claude Code에 연결하는 작업은 설치 한 번과 환경 변수 세 개로 끝납니다. npm install -g omniroute로 설치한 뒤 omniroute를 실행하면 됩니다. 그러면 대시보드와 OpenAI 호환 API가 20128 포트에서 올라오고, 표준 라우트는 http://localhost:20128/v1로 노출됩니다 .
Claude Code는 프록시 라우팅을 기본 지원하므로 패치가 필요 없습니다. 로컬 게이트웨이를 가리키기만 하면 됩니다. OmniRoute의 CLI 가이드에 따르면, Claude Code가 Anthropic 엔드포인트 대신 라우터를 통해 트래픽을 보내도록 변수 두 개를 내보내면 됩니다.
export ANTHROPIC_BASE_URL="http://localhost:20128"
export ANTHROPIC_AUTH_TOKEN="sk-your-omniroute-key"Codex, Cursor, Cline, Continue 같은 OpenAI 호환 에이전트는 버전이 붙은 라우트를 가리키는 다른 변수를 사용합니다.
export OPENAI_BASE_URL="http://localhost:20128/v1"두 방식 모두 OmniRoute의 공식 CLI 문서에서 나온 것입니다 . 인증 토큰은 Anthropic 키가 아니라 OmniRoute 키입니다. 실제로 어느 백엔드가 응답할지는 라우터가 결정합니다.
그 결정은 가상 모델 ID가 이끕니다. 특정 모델 이름을 지정하는 대신 auto, auto/coding, auto/fast, auto/cheap, auto/offline을 요청할 수 있고, OmniRoute는 활성 자격 증명에서 라우팅 체인을 구성한 뒤 기능 기준으로 후보를 걸러내고 점수를 매겨 디스패치합니다 . 비용 없는 백엔드에 머물고 싶다면 auto/cheap과 auto/offline이 보수적인 선택입니다. 더 강한 보장을 원한다면, 2026-07-07에 배포된 v3.8.46 릴리스에서 추가된 hidePaidModels 옵션을 쓰면 됩니다. 이 옵션은 auto/* 풀에서 유료 전용 후보를 제거하므로, 실행 중 무료 티어 할당량이 소진되더라도 세션이 조용히 과금 백엔드로 넘어가지 않습니다 .
할당량 계산: 약 10억 토큰은 Mistral에서 나오고, 나머지는 부차적입니다
OmniRoute가 내세우는 "무료 토큰 16억 개"는 자체 무료 티어 참고 문서(버전 3.8.40, 2026-06-28 최종 업데이트)에서 나온 반올림된 마케팅 수치입니다. 이 문서는 40개 이상의 무료 티어 풀과 500개 이상의 모델을 합산해 매월 반복 제공되는 토큰을 약 15.4억 개로 계산합니다 . 첫 달 가입 크레딧까지 더하면 일회성 총량은 약 21.5억 개까지 올라갑니다 . 다만 이 문서 자체도 이론상 24시간 내내 한도까지 쓰는 경우의 상한이 월 100억 토큰에 가까울 수는 있지만, 이는 보장치가 아니며 대표 수치로 내세워서는 안 된다고 경고합니다 .
사용량을 계획할 때 중요한 점은 이 제공량이 고르게 분산된 것이 아니라 한쪽에 몰려 있다는 사실입니다. Mistral 하나만으로 매월 약 10억 토큰, 즉 대표 수치의 약 65%를 차지하며, 나머지는 그보다 훨씬 뒤처집니다 :
- Mistral — 월 약 10억 토큰
- LLM7 — 월 약 1억 5천만
- Gemini — 월 약 6천만
- Cerebras — 월 약 3천만
- Cloudflare AI — 월 약 3천만
- Groq — 월 약 1천5백만
Mistral이 무료 티어를 더 엄격하게 조정하거나 계정이 자격을 잃으면, 반복 사용 가능한 예산은 사실상 수억 토큰 수준으로 줄어듭니다. 제공업체별 상한도 여기에 겹칩니다. Kiro는 월 약 50크레딧을 제공하고, Pollinations는 익명 사용을 약 6~15초당 1요청으로 제한하며, LongCat은 KYC가 필요한 1회성 1천만 토큰 제공이고, Cerebras는 분당 3만 토큰과 일일 100만 토큰 상한을 둡니다 .
siliconflow, glm-cn, tencent, baidu처럼 "영구 무료"로 표시된 항목 중 일부는 토큰 상한을 전혀 공개하지 않습니다. 하지만 속도와 동시성 제한이 있으므로 처리량을 수치화할 수 없고, 그래서 15.4억 계산에서도 제외됩니다 . 독립적인 보도도 같은 점을 분명히 짚습니다. 토큰 수치는 OmniRoute 자체 문서에서 나온 것이고, 제3자 감사를 거친 값이 아니며, 무료 모델은 어려운 에이전트 작업에서 최전선 모델과 "동등하지 않을 것"이라는 점입니다. 라우터가 늘려주는 것은 접근성이지 성능 자체가 아닙니다 . 16억은 믿고 쓸 수 있는 하한이 아니라, 한 제공업체에 좌우되는 상한으로 봐야 합니다.
이용약관의 작은 글씨: 프록시 하네스를 명시적으로 금지하는 제공업체
"무제한 무료 Claude Code"라는 표현이 가장 약해지는 지점은 법적 리스크입니다. OmniRoute의 고가치 무료 티어 중 상당수가 바로 이런 라우팅 방식을 제한하기 때문입니다. OmniRoute 자체 무료 티어 참고 문서도 여러 제공업체를 명확히 허용된 것으로 보지 않고 caution, avoid, 또는 ambiguous로 표시합니다 . 팀 워크로드를 연결하기 전에 해당 조항을 먼저 읽어야 합니다:
- Kiro — FAQ에서 "OpenClaw 및 서드파티 하네스를 활용하는 유사 도구와 함께 사용하는 것을 명시적으로 금지"한다고 되어 있어, OmniRoute 같은 프록시 라우터를 직접 겨냥하는 문구입니다 .
- Mistral — 반복 제공 토큰의 가장 큰 비중을 차지하지만, 소비자 API를 "개인적 필요"로 제한하고 키 공유를 금지합니다. 이는 팀 또는 상업적 라우팅과 충돌합니다 .
- Together — 4.3(d)항은 서비스를 재판매하거나 독립형 서비스로 제공하는 것을 금지합니다 .
- SiliconFlow — 조항에서 서비스를 제3자에게 노출하는 것을 금지합니다 .
OmniRoute는 자신의 이용약관 요약이 "정보 제공용이며 법률 자문이 아니다"라고 분명히 밝히고, 각 제공업체를 독립적으로 확인하라고 권합니다 . 이 면책 문구가 현실적인 해석입니다. 라우터는 약관상 프록시 사용을 금지할 수 있는 제공업체들 사이로 요청을 손쉽게 분산하게 해주지만, 집행 리스크는 도구가 아니라 사용자의 계정에 남습니다. 상업용 또는 팀 트래픽을 라우팅하기 전에는 프로젝트 내부 문서 요약만 믿지 말고, 현재 약관을 직접 확인해야 합니다.
90개 전체를 켜기 전에, 확인된 무료 제공업체 두 곳부터 범위 잡기
정확히 두 제공업체, Cerebras와 Cloudflare AI부터 시작하세요. 둘 다 OmniRoute 자체 메모에서 "free forever"로 문서화되어 있고, 둘 다 명시적인 속도 제한을 공개합니다. Cerebras는 분당 30K 토큰, 하루 1M 토큰 상한이 있으며 대략 월 30M 토큰을 제공합니다. Cloudflare AI도 비슷한 수준입니다. 또한 제공업체 레퍼런스에서 둘 다 주의 표시나 프록시 금지 라벨이 없습니다 . 그래서 풀을 넓히기 전에 가장 낮은 위험으로 진입할 수 있는 선택지입니다.
Claude Code에 연결하기 전에 hidePaidModels를 설정하세요. 릴리스 v3.8.46 (2026-07-07)에서 이 플래그가 추가되어 auto/* 라우팅이 유료 전용 모델을 후보 풀에서 걸러냅니다. 이 설정이 없으면 무료 티어 할당량이 소진된 뒤 라우터가 조용히 유료 백엔드로 올라갈 수 있습니다. 클라이언트에는 경고가 표시되지 않고, 업스트림 비용은 사용자의 키에 청구됩니다.
프롬프트 압축(RTK Rust 필터와 규칙 기반 Caveman 압축)은 자동으로 작동합니다. OmniRoute는 도구 사용이 많은 세션에서 평균 약 89% 감소를 주장하지만, 출력 품질이 유지된다는 독립 벤치마크는 없습니다. 의존하기 전에 본인의 작업으로 품질을 검증하세요.
숫자는 맥락 안에서 봐야 합니다. "unlimited free"라는 표현은 무료 티어 제공업체가 200곳이 아니라 90곳 이상이라는 뜻입니다:
import re
claim = "OmniRoute: 250 providers, 90+ free providers."
total, free = map(int, re.search(r"(\d+) providers, (\d+)\+ free", claim).groups())
print(f"catalog providers: {total}")
print(f"free-tier providers: {free}+")
print(f"paid/other providers: {total - free}+")
assert free == 90 and free != 200
print("OK: 'unlimited free' means 90+ free providers, not 200.")이 스니펫은 실행되었고(exit 0), 유료/기타 제공업체가 160곳 이상 남는다고 출력합니다. 2026-07-19 기준 저장소 신호는 강합니다. 스타 18.7k, 포크 약 2.7k, Docker Hub 풀 100K+, v3.8.49로 배포 중입니다. 하지만 제공업체 수와 자격 조건은 매주 바뀝니다. 90을 보장값이 아니라 하한선으로 보세요. 알려진 무료 백엔드 두 곳을 고정하고, 유료 전환을 차단하고, 실제 워크로드에서 압축을 측정한 다음 확장하세요.
자주 묻는 질문
OmniRoute로 Claude를 무료로 쓸 수 있나요?
아니요. OmniRoute는 Anthropic 모델을 무료로 열어주지 않습니다. Claude Code CLI가 다른 백엔드를 바라보도록 ANTHROPIC_BASE_URL을 덮어쓰는 방식입니다. Anthropic 자체 문서에서도 이 프록시 설정이 Claude Code를 다른 엔드포인트로 향하게 한다고 확인합니다 . 무료 티어 요청은 Mistral, Gemini, Cerebras 같은 제공업체가 처리하므로 Anthropic 인프라는 관여하지 않습니다. 즉 Claude Code를 클라이언트로 사용해 Claude가 아닌 모델에 연결하는 것이지, Claude를 무료로 쓰는 것은 아닙니다 .
OmniRoute에는 실제로 무료 티어 제공업체가 몇 곳 있나요?
약 90곳 이상의 제공업체가 무료 티어를 갖고 있으며, 그중 대략 11곳은 "free forever"로 표시됩니다(Kiro, Qoder, Pollinations, LongCat, Cloudflare AI, NVIDIA NIM, Cerebras 등). 이는 전체 카탈로그 수와는 다릅니다. 전체 수는 표면마다 충돌합니다. README는 264라고 하고, 웹사이트는 236, 자동 생성된 Provider Reference는 250이라고 합니다(마지막 생성일 2026-07-13) . 바이럴된 "무료 200곳 이상"이라는 숫자는 전체 카탈로그와 무료 하위 집합을 섞은 것입니다.
월 16억 토큰이라는 수치는 정확한가요?
OmniRoute 자체 계산이며, 독립 감사를 받은 수치는 아닙니다. 무료 티어 레퍼런스(버전 3.8.40, 마지막 업데이트 2026-06-28)는 40개 이상 풀에서 반복적으로 방어 가능한 제공량을 약 월 1.54B 토큰으로 잡고, 마케팅에서는 이를 약 1.6B로 반올림합니다. 이 중 Mistral만 대략 1.00B을 차지합니다. 첫 달 가입 크레딧까지 더하면 약 2.15B까지 올라갈 수 있습니다. OmniRoute 자체 문서도 24시간 상시 사용 기준의 이론상 한도인 월 약 10B 토큰은 보장이 아니며, 대표 수치로 내세워서는 안 된다고 경고합니다.
OmniRoute 사용이 제공업체 이용약관을 위반할 수 있나요?
예, 일부 명시된 제공업체에서는 그럴 수 있습니다. OmniRoute 자체 문서는 여러 고가치 제공업체를 주의 또는 회피 대상으로 표시합니다. Kiro FAQ는 제3자 하네스와 함께 사용하는 것을 명시적으로 금지하고, Mistral의 소비자 ToS는 API 사용을 "personal needs"로 제한하며 키 공유를 금지하고, SiliconFlow 조항은 서비스를 제3자에게 노출하는 것을 금지합니다 . 이 프로젝트는 이것이 법률 자문이 아니라 정보 제공이라고 강조하므로, 준수 책임은 사용자에게 있습니다. 프로덕션 작업을 라우팅하기 전에 각 백엔드의 약관을 확인하세요.
hidePaidModels 옵션은 무엇을 하며, 언제 켜야 하나요?
2026-07-07 릴리스 v3.8.46에서 추가된 hidePaidModels는 auto/* 라우팅 후보 풀에서 유료 전용 백엔드를 걸러냅니다 . 목표가 지출 0원이라면 항상 켜세요. 이 설정이 없으면 세션 도중 무료 할당량이 소진됐을 때 auto 라우팅이 조용히 유료 제공업체로 폴백할 수 있습니다. 바로 그 방식으로 "무료" 실행이 예상치 못한 청구서가 됩니다. 켜두면 무료 용량이 바닥난 경로는 비용을 조용히 올리는 대신 실패하거나 멈춥니다.
이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.
