9router: Cline·Claude Code 등 AI 코딩 도구에 무료 모델을 연동하는 로컬 라우팅 프록시

AI 코딩 도구의 파편화가 가속화되는 가운데, 다양한 코딩 에이전트와 외부 LLM 공급자를 단일 로컬 엔드포인트로 연결해 무료 및 구독 모델을 유연하게 활용할 수 있도록 돕는 오픈소스 라우팅 프록시 도구 '9router'가 개발자들의 관심을 모으고 있습니다.

이미지 출처: decolua on GitHub / Luong NGUYEN (@luongnv89) on X

Cline, Claude Code, Codex, Cursor, OpenCode 등 최근 개발자들이 실무에서 활용하는 AI 코딩 하네스는 각 도구마다 지원하는 프로바이더 설정 방식과 API 프로토콜이 제각각입니다. 9router는 로컬 머신에서 가벼운 프록시 서버를 실행하여 서로 다른 API 규격을 중계하고, 사용자가 보유한 구독 계정과 공급사별 무료 모델 티어를 효율적으로 분배할 수 있도록 설계된 로컬 미들웨어입니다.

로컬 프록시 기반 단일 엔드포인트와 멀티 하네스 연동

9router의 핵심 아키텍처는 로컬 호스트 포트(기본 http://localhost:20128/v1)에서 표준화된 API 엔드포인트를 제공하는 데 있습니다. 이를 통해 개발자는 각 코딩 도구의 복잡한 원격 엔드포인트 설정을 매번 수정할 필요 없이, 단일 로컬 주소만 바라보도록 구성할 수 있습니다.

• 지원 코딩 하네스: Cline, Claude Code, Codex, Cursor, OpenCode를 비롯해 8개 이상의 주요 코딩 환경과 직접 연동됩니다.
• 듀얼 프로토콜 분기 처리: 공식 변경 이력(CHANGELOG)에 따르면 Anthropic 호환 POST /v1/messages 규격과 OpenAI 호환 /chat/completions 엔드포인트 분기 처리를 내장하고 있어, 클라이언트가 요구하는 형식에 맞춰 투명하게 요청을 변환합니다.
• 표준 JSONC 설정 지원: opencode, openclaw, kilo, droid, cowork, copilot, claude, cline 등 8종 이상의 클라이언트에 최적화된 JSONC 설정 프리셋을 정식 제공하여 도구별 초기 연동 과정을 간소화합니다.

개별 도구마다 엔드포인트를 수동 전환하던 번거로움을 없애고, 로컬 머신을 중심으로 코딩 에이전트의 트래픽을 일원화할 수 있는 점이 특징입니다.

40개 이상 프로바이더 통합과 3단계 스마트 폴백 메커니즘

9router는 여러 공급사가 제공하는 무료 크레딧과 티어를 한곳에 묶어 가용성을 극대화합니다.

• 다양한 무료·구독 공급자 연계: Kiro AI(월 약 50크레딧 무료: Claude 4.5, GLM-5 등 지원), OpenCode Free(별도 인증 불필요), Cline 공식 무료 모델(DeepSeek V4-Flash, Meta Muse Spark 등)을 포함해 40개 이상의 프로바이더를 단일 엔드포인트로 중계합니다.
• 3단계 스마트 폴백(3-Tier Fallback): 작업 중 레이트 리밋(Rate Limit)이나 일시적 오류로 모델 호출이 실패할 경우, 사용자가 지정한 구독 모델을 우선 사용한 뒤 저비용 유료 모델로 전환하고, 최종적으로 무료 티어로 자동 이어지는 3단계 폴백 구조를 지원합니다. 이를 통해 장시간 자율 코딩 작업 시 작업 흐름이 중단되는 위험을 낮춥니다.
• RTK 프롬프트 압축: 프록시 레이어에서 RTK 프롬프트 압축 기술을 적용해 컨텍스트 토큰 소비량을 최대 40% 절감하도록 돕습니다. 긴 대화 기록이나 대규모 코드베이스 컨텍스트를 주입할 때 토큰 비용 절감과 응답 지연 단축 효과를 기대할 수 있습니다.

실행 환경 구성과 실무 적용 시 주의점

9router를 도입하기 전, 아키텍처 특성과 운영 환경에 따른 현실적인 제약 사항을 명확히 인지할 필요가 있습니다.

• 무료 토큰 수치에 대한 객관적 이해: 소셜 커뮤니티 등에서 언급되는 '일 9,200만 토큰 완전 무료'와 같은 수치는 각 업스트림 공급사의 프로모션 한도와 이론적 무료 티어를 단순 합산한 마케팅성 집계에 가깝습니다. 실제 사용 가능한 토큰량은 공급사별 실시간 정책 변경, 가용 쿼터, 속도 제한(Rate Limit)에 따라 크게 달라질 수 있습니다.
• 로컬 실행 환경 권장: 현재 공식 저장소 안내에 따르면 코어 애플리케이션 패키지(9router-app)가 비공개 상태입니다. 따라서 검증된 소스 빌드 또는 Docker 컨테이너 환경을 구성하여 로컬 격리 상태에서 구동하는 접근이 권장됩니다.
• 보안 및 환경 격리 고려: 로컬 프록시는 개발 머신에서 발생하는 API 키와 소스 코드 요청을 중계하는 위치에 있습니다. 보안이 엄격한 기업용 상용 프로덕션 코드베이스보다는 개인 사이드 프로젝트, 오픈소스 연구, 혹은 실험적 개발 환경 위주로 테스트를 시작하는 것이 안전합니다.

출처

• decolua/9router 저장소 - GitHub: 9router 공식 오픈소스 GitHub 저장소입니다. 로컬 프록시 구동을 위한 Docker 컨테이너 구성과 40개 이상의 지원 프로바이더 목록, Cline 및 Claude Code 연동을 위한 JSONC 설정 가이드와 최신 변경 이력을 제공합니다.