클로드 코드 쓰다가 사용량 한도에 자주 걸리시나요? **옴니라우트(OmniRoute)**는 AI 제공자 **375곳(무료 150곳 이상)**을 주소 하나로 묶어 주는 무료 오픈소스 도구예요(MIT, 깃허브 별 8.5만, 2026-11-08 기준). 한 곳이 한도에 차면 연결해 둔 다른 모델로 자동으로 넘겨서 작업을 이어 가요. 이 페이지에 README 공식 설치 명령어, 공식 무료 키를 받을 수 있는 제공자 14곳, 약관 때문에 피하는 게 좋은 제공자 12곳, 클로드 코드 연결법을 정리했어요.
📺 더 많은 클로드 활용법: 유튜브 빌더조쉬 구독 · 조쉬의 뉴스레터 구독
cheaper-inference/OmniRoute 저장소 — 375 providers (150+ free), Quota-aware auto-fallback
| 항목 | 내용 |
|---|---|
| 무엇 | 여러 AI 제공자를 주소 하나(http://localhost:20128/v1)로 묶는 내 컴퓨터용 AI 게이트웨이 |
| 연결할 수 있는 곳 | 제공자 375곳 (대시보드 기준 무료 등급 156곳), 모델 1,400개 이상 |
| 핵심 기능 | 한도·오류가 나면 다음 제공자로 자동 전환(Quota-aware auto-fallback) |
| 비용 | 옴니라우트 자체는 무료(MIT). 각 제공자의 무료 사용량은 내가 직접 가입해서 받은 만큼 |
| 같이 쓰는 도구 | 클로드 코드, Codex, Cursor, Cline, OpenCode 등 39개 |
| 설치 | npm install -g omniroute 한 줄 (Node.js 필요) |
1) 설치하고 실행 (README 공식 명령)
npm install -g omniroute
omniroute
http://localhost:20128-g(전역)로 깔면 어느 폴더에서든 omniroute 명령을 쓸 수 있어요. 이 방법을 기본으로 쓰세요.
실제 설치 화면 — npm install -g omniroute → added 1331 packages in 1m → 버전 3.8.53
npm 11 이상에서 설치 스크립트가 막히면 (README 안내 그대로)
npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
도커로 돌리고 싶으면
docker run -d --name omniroute --restart unless-stopped -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
<aside> 💡
대시보드가 안 열리면 → ① 터미널에 omniroute가 켜져 있는지 확인 ② 주소창에 http://localhost:20128 직접 입력 ③ command not found가 나오면 터미널을 새로 열거나 npm install -g omniroute를 다시 실행 ④ 처음 로그인 비밀번호는 첫 실행 화면 안내를 따르세요.
</aside>