같은 주에 Claude Code, Codex, Cursor를 함께 켜 두면, 시간을 잡아먹는 일은 “더 센 모델을 찾는 것”이 아니라 키 세 개, Base URL 세 개, 쿼터가 끊길 때마다 바뀌는 임시 처방입니다. OmniRoute의 실측 가치는 그 입구를 로컬 AI Gateway 하나로 모은 뒤, 일상 워크플로에 남길 모델만 고르는 데 있습니다.
데이터 포인트: OmniRoute v3.8.50 공개 수치는 provider 352개, 채팅 카탈로그 약 고유 모델 ID 1,312개입니다. “정확히 352개 모델”이 아닙니다. 제목의 352는 접속 면에 가깝고, 검수에서 볼 것은 엔드포인트 하나가 Claude Code, Codex, Cursor를 안정적으로 받느냐입니다. (GitHub: OmniRoute)
판단: 입구를 먼저 통일하고, 모델 수는 나중에. 이미 코딩 에이전트 세 개와 환경 변수를 오가고 있다면 30분 검수는 가치가 있습니다. 공식 요금제가 하나이고 쿼터 중단도 거의 없다면, “352” 때문에 게이트웨이를 더하지 않는 편이 낫습니다.
대상은 Claude Code와 Cursor를 같이 쓰는 개인 개발자, Codex CLI와 에디터 키를 한곳으로 모으려는 소규모 팀, 노트북마다 구성을 복제하기 싫어 클라우드 Mac에 상주 Gateway를 두려는 담당자입니다.
최종 갱신 2026년 9월 11일. 숫자는 당시 공개 설명입니다. 사내 위키에 적기 전에 가동 중인 호스트의 /v1/models로 실측하세요.
352가 가리키는 것: provider는 모델 목록이 아니다
검색 스니펫은 “352 providers”를 “352개 모델”로 줄입니다. README와 omniroute.online을 나란히 보면 다음 읽기가 안전합니다.
- 352는 등록 provider 수이며, 약 150개는 무료 발견 플래그가 있습니다.
- 채팅 카탈로그는 모델 ID 1,200+개(v3.8.50 근처 공개표는 1,312)입니다.
- 무료 한도, OAuth, 로컬 모델, 클라우드 카탈로그는 분모가 다릅니다. 더해서 영업 숫자로 쓰지 마세요.
조달 질문이 바뀝니다. 사는 것은 352개 모델이 아닙니다. OpenAI 호환 입구 하나로 세 도구를 같은 머신에 붙일 수 있는지, 쿼터 소진 시 폴백이 도는지, 실패가 키·모델명·프로토콜 차이 중 무엇인지 로그로 가를 수 있는지를 묻는 것입니다.
OmniRoute는 MIT 라이선스의 자체 호스팅 AI Gateway이고 기본 포트는 20128입니다. 도구는 localhost로 보내고, 게이트웨이가 카탈로그·쿼터·폴백으로 넘깁니다. 공식 사이트 비교축도 새 채팅 UI가 아니라 provider 수, 폴백, 토큰 압축, CLI 한 방 설정입니다.
카탈로그를 선반, Gateway를 창고 담당으로 보면 현장에 가깝습니다. 선반은 길어도 됩니다. 매일 출고하는 레인은 몇 개입니다. 352는 선반 폭이고, 일상 프로필은 출고 규칙입니다. 둘을 뒤집으면 “많이 연결된다”를 “운영 가능한 코딩 워크플로가 있다”로 착각합니다.
왜 세 도구에 공통 게이트웨이가 필요한가
- 프로토콜이 다릅니다. Claude Code는 Anthropic Messages, Codex는 OpenAI Chat Completions, Cursor는 OpenAI 호환 URL입니다. 게이트웨이가 없으면 머리속에 모델이 세 개 남습니다.
- 키가 흩어집니다. Anthropic은 Claude Code, OpenAI는 Codex, 다른 애그리게이터는 Cursor. 퇴사·교체·유출 때 폐기 범위가 흐려집니다.
- 쿼터가 동기화되지 않습니다. Claude가 멈춰도 Cursor는 공식 API를 치고, Codex 무료 한도 종료를 에디터는 모릅니다.
- 이름을 재사용하지 못합니다. 같은 DeepSeek나 GLM도 ID가 세 개가 되어, 차이가 모델인지 철자인지 구분하지 못합니다.
게이트웨이는 세 제품을 하나로 만들지 않습니다. “어느 환경 변수를 고칠지”를 “게이트웨이의 한 라우트”로 줄입니다. 소규모 팀에는 또 다른 중개 사이트보다 일상에 가깝습니다.
같은 호스트에서 MCP와 도구 서버도 돌린다면 차선을 나누세요. 사이트 안 클라우드 Mac mini에 MCP Server 배포하기가 도구 경로이고, OmniRoute는 모델 경로입니다. 한 프로세스에 섞어 디버깅하지 마세요.
검수에서는 실패 언어가 공유되는지도 봅니다. Claude Code는 타임아웃, Codex는 429, Cursor는 “provider error”만 보이는데 게이트웨이 로그에 공통 provider 이름과 모델 ID가 없다면, 그 홉은 운영 가치를 거의 더하지 못합니다. 통일 호출의 목표는 UI가 같아 보이는 것이 아니라, 한 사람이 한 로그로 한 실패를 설명하는 것입니다.
세 도구를 같은 입구에 붙이는 방법
공식 문서는 살아 있는 카탈로그를 읽고 각 도구 설정을 쓰는 omniroute setup-*를 제공합니다. (CLI Integrations)
| 도구 | 명령 | 기록 위치 | 자주 빠지는 함정 |
|---|---|---|---|
| Claude Code | omniroute setup-claude | ~/.claude/profiles/…/settings.json | ANTHROPIC_BASE_URL에 /v1을 붙이지 마세요. CLI가 /v1/messages를 붙입니다 |
| Codex CLI | omniroute setup-codex | ~/.codex/.config.toml | OpenAI 호환 /v1. 전환은 프로필로 |
| Cursor | omniroute setup-cursor | 로컬 파일을 쓰지 않고 앱 안 절차를 출력 | 설정은 불투명 저장소. 안내된 Base URL과 키만 입력 |
영구 설정을 건드리고 싶지 않은 데모에는 omniroute run claude / omniroute run codex로 그 프로세스만 환경을 주입합니다. 공유 워크스테이션에는 맞지 않습니다.
Claude Code는 게이트웨이 모델 발견을 켜면 네이티브 /model이 claude 또는 anthropic으로 시작하는 ID만 보여 줍니다. Kimi, GLM, DeepSeek는 프로필이나 ANTHROPIC_MODEL로 지정할 수 있고, 그 선택기에만 안 나올 뿐입니다. (Claude Code 설정)
합격은 세 도구 요청이 콘솔에 보이고, 실패가 어느 provider인지 말할 수 있으며, 모델을 바꿀 때 벤더 대시보드 세 개를 열지 않는 것입니다.
첫 배선에서는 “대화가 된다”와 “일상에 든다”를 나눕니다. 답장은 포트가 열린 것뿐입니다. 일상 조건은 같은 짧은 작업이 세 도구에서 재현되고, 실패가 로그의 모델 ID와 맞으며, 프로필 전환에 GUI 세 번이 필요 없는 것입니다. 첫 답장에서 성공을 선언하면 나중에 Cursor가 공식 경로를 쓰고, Claude Code에 /v1이 하나 더 있고, Codex 프로필이 한 터미널에만 남는 구멍이 보입니다.
30분 검수 목록
- [ ] 계속 켜 둘 Mac에 Node.js가 있고
omniroute가 실행됩니다. - [ ]
http://localhost:20128에 카탈로그가 보입니다. 빈 페이지가 아닙니다. - [ ] 게이트웨이 키로
/v1/models를 호출해 실제 개수를 적습니다. 홍보 숫자를 붙여 넣지 않습니다. - [ ] 처음에는 Claude Code 또는 Codex 하나만 연결합니다.
- [ ] 재현 가능한 짧은 작업을 보내고 로그에서 모델 ID, 지연, 오류 유형을 확인합니다.
- [ ] 선호 모델을 끄고 폴백이 도는지 봅니다.
- [ ] 두 번째 도구를 붙여 같은 카탈로그인지, 별칭 목록이 아닌지 확인합니다.
- [ ] 벤더 키는 게이트웨이 쪽에 두고, 도구에는 게이트웨이 토큰만 남깁니다.
카탈로그가 안 뜨면 352는 포스터입니다. 카탈로그가 커도 폴백이 없으면 프록시와 단일 장애점만 늘어난 것입니다.
짧은 작업은 고정하세요. “이 폴더의 테스트 파일을 나열하고 함수 하나를 설명하라”면 충분합니다. 잡담은 검수가 약합니다. 모델 ID 오타도, 도구 호출이 생각한 레인을 탔는지도 안 보입니다. 시각, 도구, 모델 ID, 폴백 여부, 원문 오류를 한 줄로 남기세요. 2주 뒤 그 표가 업그레이드 사고인지 무료 provider 증발인지를 가릅니다.
언제 도입하고, 언제 건너뛰나
| 상황 | 더 나은 선택 | 이유 |
|---|---|---|
| 1인, 공식 요금제 하나, 전환이 드묾 | 직결 유지 | 프로세스, 업그레이드, 로그가 늘어남 |
| Claude Code와 Cursor가 서로 다른 키를 다툼 | OmniRoute 도입 | 기본 모델 논쟁 전에 입구를 맞춤 |
| 초안은 무료 풀, 마감은 유료 모델 | 도입하고 라우트를 문서화 | 쿼터 인지 스케줄의 본령 |
| 지정 벤더/지역에 요청을 가둬야 함 | provider와 컴플라이언스를 먼저 확인 | 큰 카탈로그는 준수 목록이 아님 |
| LiteLLM으로 이미 세 도구가 묶여 정책이 안정 | 숫자 때문에 이전하지 않음 | 비용은 정책. 설치 명령이 아님 |
토큰 압축(공식은 약 15–95% 절감)을 “기본으로 켜면 돈 절약”으로 쓰지 마세요. 긴 저장소와 반복 컨텍스트에는 도움이 됩니다. 짧은 완성이면 변환만 한 번 늘 수 있습니다. 같은 작업에서 켜고 끄며 품질과 청구서를 비교하세요.
라우팅은 깨진 tool-calling JSON을 고치지 않습니다. 인자에서 실패한다면 홉을 더하기 전에 AI Agent가 JSON에 의존하는 이유를 보세요.
리뷰에 잘 안 적히는 보류 이유도 있습니다. 당번이 없는 것입니다. Gateway는 새 단일 장애점이 됩니다. 뚜껑을 닫거나, 프로세스가 죽거나, 인증서가 만료되거나, 카탈로그 API가 바뀌면 세 도구가 같이 멈춥니다. 재시작 정책과 스냅샷을 줄 수 없다면, 입구 통일의 편리함은 한 번의 공동 장애로 사라집니다. 운영을 먼저 두고 352를 이야기하세요.
왜 클라우드 Mac에 Gateway를 두나
노트북 OmniRoute는 개인 시험에 맞습니다. Cursor, Claude Code, CI가 같은 카탈로그를 나누는 순간, 뚜껑을 닫으면 인프라가 사라집니다. 계속 켜져 있고, 스냅샷이 되며, 권한을 회수할 수 있는 클라우드 Mac이 더 맞습니다.
- launchd 등으로 상주시켜 창을 닫아도 멈추지 않게 합니다.
- 20128은 터널이나 사설망만. 콘솔을 공개하지 않습니다.
- 키는 머신 쪽에 두고 Git과 채팅에 넣지 않습니다.
- 업그레이드 전 스냅샷으로 카탈로그 변경을 되돌립니다.
여기 Mac은 “더 비싼 모델”이 아닙니다. 노트북이 잠들어도 세 도구가 계속 쓰는 만남 지점입니다. 권한 분리는 ZekVPS Mac 지원 페이지를 먼저 보세요. Gateway 계정을 호스트 관리자로 쓰지 마세요.
두 명 이상이라면 “Gateway 호스트 한 대 + 각자의 에디터”를 권합니다. 사람마다 게이트웨이는 격리처럼 보이지만 라우트, 무료 한도 판단, 업그레이드를 세 배로 복제합니다. 공유의 대가는 경계입니다. 동료는 게이트웨이 토큰만 갖고, 업스트림 키와 운영 라우트 편집은 갖지 않습니다. 그 선을 쓰면 352개 provider가 352개의 오클릭 입구가 되지 않습니다.
자주 묻는 질문
OmniRoute에 이미 모델이 352개인가?
2026년 9월 공개 설명에서 352는 주로 provider입니다. 모델 카탈로그는 1,200개 이상입니다. 검수는 호스트의 /v1/models를 기준으로 합니다.
세 도구가 같은 Base URL을 쓸 수 있나?
같은 OmniRoute 호스트는 공유할 수 있고, 접미사는 공유할 수 없습니다. Claude Code는 보통 /v1을 붙이지 않습니다. Codex와 대부분의 OpenAI 호환 클라이언트는 /v1을 씁니다. Cursor는 setup-cursor 출력을 따릅니다.
무료 provider만으로 매일 코드를 짤 수 있나?
초안과 탐색에는 됩니다. 고객 코드나 나중에 설명해야 할 작업의 유일한 경로로 두지 마세요. 무료 풀은 제한, 대기, 갑작스러운 종료가 있습니다.
세 도구의 요청이 352개 업체에 노출되나?
게이트웨이는 당신이 통제하는 머신에서 돕니다. 업스트림은 당신이 고릅니다. 키를 모으는 일은 카탈로그 전 행을 여는 일이 아닙니다. 운영 라우트는 화이트리스트로 두세요.
이미 OpenRouter나 LiteLLM이 있다. 바꿔야 하나?
숫자 352 때문이라면 아닙니다. 아직 네이티브 설정 세 개를 유지하고 setup-claude, setup-codex, setup-cursor로 배선을 끝내고 싶을 때 검토하세요.
입구를 맞춘 뒤 카탈로그를 넓힌다
OmniRoute의 용도는 주말에 1,300개 모델을 시험하는 대회가 아닙니다. 곧 만료될 키 세 개를 돌리지 않고, 중단 대신 페일오버하며, 비교를 한 로그에서 하는 일입니다. 352는 폭이지 기본 프로필이 아닙니다.
개인 시험이 되면 다음 단계는 스냅샷 가능한 클라우드 Mac으로 옮기고 동료 에디터도 같은 입구를 보게 하는 것입니다. 호스트 경계는 ZekVPS 서비스 안내를 본 뒤, 노트북과 원격 노드 중 어디를 고를지 정하세요.
주간 보고에 넣을 한 문장으로 닫습니다. 세 코딩 도구가 같은 로컬 포트에 닿는지를 먼저 증명하고, 화이트리스트에 넣을 모델은 나중에 정한다. 카탈로그는 계속 길어져도 됩니다. 일상 워크플로는 짧고, 바꿀 수 있고, 되돌릴 수 있어야 합니다.
코딩 도구 세 개를 상주 Gateway 하나에 모을까요?
노트북을 닫으면 Gateway가 사라집니다. 클라우드 Mac은 계속 켜져 있고 업그레이드 전 스냅샷이 됩니다.
월 단위 전용 Mac mini에 OmniRoute, 로그, 키 경계를 두고 권한은 회수할 수 있게 하세요.
개인 시험이 되면 입구를 스냅샷 가능한 노드로 옮기는 편이 또 다른 중개 탭보다 현장에 가깝습니다. ZekVPS 클라우드 Mac mini 플랜 보기