free-router: 바이브 코딩 비용 0원을 만들어주는 CLI를 새벽에 만들었습니다

오랫동안 만나고 싶었던 두 분을 어젯밤 저녁 자리에서 우연히 만났습니다. 대화 중에 한 분이 제가 외부에 공개한 결과물이 예상보다 훨씬 적다고 지적했는데, 사실이라 더 아팠습니다.

집에 돌아와서도 그 말이 머릿속에서 떠나지 않았고, 새벽 3시쯤 코드를 쓰기 시작했습니다. 아침이 되니 free-router(free-router)가 완성돼 있었습니다. 살아 있는 무료 AI API를 찾아서 바이브 코딩 환경에 바로 연결해주는 CLI 도구입니다.

기술 장벽보다 비용 장벽이 더 높습니다

주변에서 같은 말을 계속 듣습니다. “바이브 코딩 해보고 싶은데 API 비용이 부담돼서 못 하겠다.” 학생 개발자에게는 월 20달러도 큰돈입니다. 아이러니한 건 무료 모델 용량이 이미 꽤 많이 존재한다는 겁니다. NVIDIA NIM은 약 100개 모델을 무료 API로 제공하고, OpenRouter는 프롬프트 비용이 0인 모델만 필터링할 수 있습니다. 여기에 OpenCode 같은 오픈소스 코딩 도구를 조합하면 실제 지출은 0원입니다.

문제는 아무도 이 조각들을 하나의 워크플로로 연결하지 않았다는 것입니다.

진짜 어려운 건 “지금 빠른 무료 모델”을 찾는 일입니다

무료 모델이 있다는 걸 아는 사람도 있습니다. 더 어려운 질문은 어떤 모델이 바로 지금 이 순간 응답이 빠른지 아는 것입니다. 같은 모델이 오전에는 200ms로 날아오다가 오후에 5초씩 걸리는 걸 직접 확인했습니다. 이 정도 변동성이면 실제 코딩 세션을 유지할 수가 없습니다.

free-router는 2초 간격으로 모든 모델에 핑을 보내 이 문제를 해결합니다. 동시 접속 20개 풀로 병렬 측정하고, 전체 상태를 하나의 TUI 대시보드에 표시합니다. 5회 연속 실패한 모델은 점진적 백오프로 자동 건너뜁니다. 각 모델에 SWE-bench 기반 티어(S+~C)도 함께 표시하기 때문에 단순히 가장 빠른 모델이 아니라 무료이면서 가장 유능한 모델을 고를 수 있습니다.

원키 설정이라 JSON 파일을 직접 만질 필요가 없습니다

반복적으로 보는 패턴이 있습니다. 무료 모델을 찾고, 코딩 도구의 config 파일을 열고, 스키마가 복잡해서 포기합니다. free-router는 Enter를 누르는 순간 config를 대신 써줍니다. OpenCode나 OpenClaw의 프로바이더 설정과 모델 ID를 자동 생성하고, 기존 설정은 타임스탬프 백업으로 남기며, API 키는 0600 권한으로 저장합니다.

oh-my-opencode 사용자라면 NIM 모델을 OpenRouter 트윈으로 자동 전환해줍니다. 스크립트 용도로는 --best 모드가 가장 빠른 모델 ID를 stdout으로 출력합니다.

설치 한 줄, 단축키 네 개

npx frouter-cli

이게 전부입니다. TUI가 바로 뜹니다. W/X로 핑 간격을 1초에서 30초 사이로 조절합니다. P로 API 키 관리와 프로바이더 토글을 엽니다. ?로 전체 단축키를 확인합니다. 글로벌 설치를 원하면 npm i -g frouter-cli도 됩니다.

코드와 문서는 tonylee.im/free-router와 GitHub에서 확인할 수 있습니다.

아직 확신이 없는 부분들

프로바이더 세 개를 동시에 돌리는 상황까지는 충분히 테스트하지 못했습니다. 백오프 로직이 실제 장애가 아니라 간헐적 콜드 스타트 지연이 있는 모델에게는 너무 공격적일 수 있습니다. SWE-bench 티어 매핑도 공개 벤치마크를 기반으로 수작업한 것이라 새 모델 버전이 나오면 어긋날 겁니다. 사람들이 쓰기 시작하면 공개적으로 고쳐나갈 계획입니다.

참고로 이번 주말에 정구봉 님이 계신 팀 어텐션 주최 랄프톤 해커톤에 참여합니다. 13명이 함께 빌딩하는 자리인데, 참여자분들에게 도움이 될 무언가를 가져가고 싶습니다.

무료로 할 수 있는 범위는 대부분의 사람이 생각하는 것보다 넓습니다. 장벽은 능력이 아니라 연결이었을 뿐입니다.