Zerg Router
ZergAI · 코딩 · 생산성
ZergRouter는 Codex에서 DeepSeek V4.1 Flash를 실행하고 다른 코딩 클라이언트를 엔드포인트 하나로 연결하는 호스팅 AI 모델 라우터다. 키 예산, 쿼터 조회, 사용 기록을 함께 제공한다.
Zerg Router 소개
What Is ZergRouter
ZergRouter는 코딩 클라이언트와 모델 제공사 사이에 놓이는 라우팅 계층이다. Codex, Pi, OpenCode를 평소 도구로 그대로 두고 주소만 하나로 바꾸면, 라우터가 각 요청을 계정이 닿는 모델로 보낸다. 그 모델은 플랫폼이 대는 용량에서 돌 수도 있고, 직접 등록한 제공사 키를 쓸 수도 있다.
이 제품이 푸는 문제는 연결만이 아니라 장부 관리이기도 하다. 코딩 에이전트는 보통 클라이언트 하나를 제공사 하나에 묶고, 제공사마다 키와 쿼터와 청구서가 따로 붙는다. ZergRouter는 코딩 에이전트용 API 라우터로 동작한다. Router API 키에 권한과 일일 예산을 싣고, 보관한 자격 증명으로 제공사 비밀을 클라이언트 설정에서 떼어 두고, 사용 화면 하나에서 모델별·클라이언트별 입력과 캐시 입력, 출력을 기록한다.
계약 전에 한계를 알아 두는 편이 좋다. 플랫폼 부담 경로는 DeepSeek V4.1 Flash만 다루며 다른 DeepSeek 모델이나 Modal 모델은 포함하지 않는다. 요청은 Modal 공유 엔드포인트나 Fireworks를 거치므로 전용 배포도, 데이터 상주 지역 보장도 없다. 이용 자격과 체험 한도, 과금은 ZergAI 안에서 확인하며 홍보 페이지에서 짐작할 일이 아니다.
Getting Started
- zergrouter.com에 ZergAI로 로그인한다. 개인 Router 계정이 만들어지고 브라우저 세션은 최대 24시간 유지된다.
- API keys에서 Router API 키를 만들고 비밀은 비밀번호 관리 도구에 넣는다. 전체 키는 한 번만 보이며 기본 권한은 chat:write, models:read, usage:read를 포함한다.
- Billing에서 카드 없이 쓰는 DeepSeek 체험 한도를 확인하고, 계속 쓸 생각이면 카드를 등록한다. 다른 모델은 키를 클라이언트에 붙이지 말고 Credentials에 제공사 자격 증명을 넣는다.
- Node.js 22 이상에서
npm install --global @zergai/zrouter로 CLI를 설치하고zrouter login,zrouter codex models,zrouter codex configure --model modal/deepseek-v4.1-flash를 차례로 실행한다. codex --profile zergrouter로 Codex를 띄운다. 평소 프로필은 그대로 남고zrouter codex restore로 이전 상태를 되돌릴 수 있다.
제품 정보
Zerg Router의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 클라이언트를 늘리지 않고 모델만 바꾸고 싶은 Codex 사용자. 라우터는 Codex를 그대로 두고 뒤쪽 제공사만 갈아 끼운다.
- 제공사 계정을 여러 개 굴리는 개발자. 자격 증명이 우선순위가 붙은 화면 하나에 모여서 클라이언트는 키 다섯 개가 아니라 하나를 가리키면 된다.
- 지출 상한이 필요한 작은 팀. 키마다 둔 일일 예산이 기록된 지출이 한도에 닿는 순간 요청을 거절한다.
- Codex를 이미 결제하고 주간 쿼터가 어디로 갔는지 궁금한 사람. 구독 화면이 남은 용량과 초기화 날짜를 보여 주고 클라이언트는 건드리지 않는다.
작업
- Codex에서 DeepSeek 실행. CLI가 별도 프로필과 모델 카탈로그를 쓰기 때문에 DeepSeek 경로가 ChatGPT 로그인을 흔들지 않는다.
- 같은 작업으로 경로 비교. 같은 키에서 같은 프롬프트를 두 모델에 보내고 사용 행을 나란히 읽는다.
- 에이전트의 일주일 점검. 사용 기록을 모델, 날짜, 클라이언트로 걸러 보고 제공사가 알려 주는 범위에서 입력과 출력 합계를 확인한다.
- 프로젝트를 동료에게 넘기기. 계정 전체 권한이 달린 제공사 비밀 대신 권한을 좁힌 예산 키를 건넨다.
활용 상황
- Codex CLI와 Router 키 하나가 있는 노트북. 설정은 로그인, 키 생성, 설정 명령 한 번이면 끝난다.
- 주간 쿼터가 붙은 Codex 계정이 여러 개인 경우. 어느 계정에 여유가 있고 쿼터가 언제 돌아오는지 화면이 알려 주며, 고르는 일은 사용자 몫이다.
- 구독 전에 모델을 시험하는 경우. 한 번뿐인 체험은 금액과 토큰을 함께 제한해서 시험이 뜻밖의 청구서로 이어지지 않는다.
- 비밀을 설정 파일에 두기 싫은 공용 장비. 키는 환경 변수에서 읽고 복원 명령은 자기가 관리한 프로필 파일만 보관한다.
주요 기능
코딩 클라이언트를 위한 엔드포인트 하나
지원 클라이언트는 모두 zergrouter.com/v1이라는 같은 베이스 URL을 쓴다. 라우터는 OpenAI의 chat completions 형식을 쓰고 Codex가 보내는 Responses 요청도 받는다. Pi, OpenCode, ZTC, Zerg 에이전트 앱도 같은 OpenAI 호환 엔드포인트로 붙으므로 새 도구에는 키와 베이스 URL만 있으면 된다.
Codex에 맞춰 만든 DeepSeek 경로
문서에서 가장 많은 지면을 쓰는 부분이 Codex Responses API 경로다. DeepSeek V4.1 Flash 카탈로그 항목은 100만 토큰 문맥, 이미지 입력, 네 단계 추론 강도, 자유 형식 패치 편집을 선언한다. shell 명령과 승인, 샌드박스는 여전히 사용자 기계의 Codex가 실행한다. Modal이 네이티브 사용자 도구를 무시하기 때문에 라우터가 apply_patch를 함수 호출로 번역하고 돌아오는 길에 이벤트를 다시 만든다.
권한과 일일 예산이 붙은 키
키는 화면에서 발급하고 저장할 때 해시만 남긴다. 권한은 만들 때 고르며 기본 조합은 채팅, 모델 읽기, 사용 읽기를 포함한다. daily_budget_usd는 UTC 기준으로 키마다 지출을 제한하고, 기록된 지출이 거기에 닿으면 요청은 429를 받는다. 예산은 안전장치이고 이미 돌고 있는 작업을 끊는 장치는 아니다.
순서가 있는 폴백을 갖춘 제공사 자격 증명
Credentials에는 내 계정으로 청구되는 경로에 쓸 제공사 API 키를 둔다. 행마다 이름과 활성 상태, 우선순위 번호가 있고 같은 제공사 자격 증명 가운데 낮은 번호를 먼저 시도한다. 폴백은 출력이 시작되기 전의 해당 실패만 처리하므로 절반쯤 흐른 스트림이 조용히 다른 모델로 바뀌지 않는다. 폴백 체인은 채팅 요청 단위로도 설정할 수 있다.
여러 계정의 Codex 쿼터 모니터링
Subscriptions는 지원 계정을 연결해 주간 쿼터와 초기화 날짜, 이월된 초기화를 알려 준다. 오래된 측정값은 지우지 않고 만료 표시를 붙여 남긴다. 라우터는 숫자만 보여 주고 선택은 사용자에게 넘긴다. 스스로 Codex에 로그인하거나 세션을 다른 계정으로 옮기지 않는다.
모델, 날짜, 클라이언트별 사용 기록
사용 화면은 트래픽을 입력, 캐시 입력, 출력 토큰으로 나눈다. 모델과 날짜, 클라이언트로 걸러 볼 수 있어서 어느 도구가 예산을 썼는지 드러난다. 제공사가 내역을 알려 주지 않으면 추정치 대신 unknown으로 표시하고, 계정 전체 Codex 기록은 라우팅한 요청과 따로 둔다.
장단점
장점
- 클라이언트를 옮기지 않아도 된다. Codex, Pi, OpenCode에 필요한 것은 베이스 URL과 키뿐이고 포크나 개조 빌드는 필요 없다.
- 체험 조건이 금액과 토큰으로 함께 적혀 있어서 첫 유료 요청 전에 상한을 알 수 있다.
- 키별 일일 예산은 이 분야에서 본 가장 단순한 지출 통제이며 별도 과금 도구 없이 작동한다.
- Codex 계정이 두세 개인 사람에게 쿼터 모니터링은 실제 답이 되고, 오래된 측정값은 감추지 않고 표시한다.
- 복원 명령은 자기가 쓴 파일만 보관하므로 실험이 멀쩡한 Codex 환경을 망가뜨리지 않는다.
단점
- 플랫폼 부담 이용은 모델 하나만 덮는다. DeepSeek V4 Pro나 다른 Modal 모델을 쓰려면 직접 발급한 제공사 자격 증명이나 다른 경로가 필요하다.
- 추론은 Modal 공유 엔드포인트나 Fireworks에서 돈다. 전용 배포가 없고 FAQ도 데이터 상주 지역을 약속하지 않는다.
- 쿼터 데이터가 세션을 옮겨 주지 않는다. 어느 Codex 계정을 쓸지는 여전히 직접 정해야 해서 자동 전환을 기대한 사람에게는 번거롭다.
- 수동 설정은 TOML 프로필과 환경 변수에 익숙해야 한다. CLI가 대부분을 가려 주지만 Node.js 22 이상을 요구한다.
자주 묻는 질문
계정이 쓸 수 있는 모델 앞에 인증된 엔드포인트 하나를 둔다. Router 키로 OpenAI 형식이나 Responses 형식 요청을 보내면 라우터가 고른 제공사로 넘긴다. 그 요청의 지출과 쿼터, 토큰 수도 함께 기록한다.
관련 콘텐츠
Zerg Router와 관련된 도구, 스킬, 아티클을 살펴보세요.
Zerg Router 대안
Base Code
Base44 (Wix) · 코딩 · 생산성Base Code는 Base44가 만든 공유 클라우드 개발 환경이다. 팀은 기존 GitHub 저장소에 대한 변경을 채팅으로 설명하고, 미리보기로 확인한 뒤 풀 리퀘스트로 돌려보낸다.
Google EmbeddingGemma 2
Google DeepMind · 글쓰기 · 이미지 · 코딩Google EmbeddingGemma 2는 7억 4000만 파라미터의 오픈 모델로, 텍스트와 코드, 이미지, 오디오, 영상 프레임을 하나의 768차원 공간에 벡터로 바꿔 스마트폰과 노트북에서 실행한다.
GitGlow
GitGlow · 코딩 · 생산성GitGlow는 내 코드와 AI 에이전트의 변경을 한 리뷰에 모으는 데스크톱 Git 클라이언트다. 배포 전에 내 기계에서 무엇이 나가는지 확인할 수 있다.