🆓 9Router: 40개 AI 제공자 연결 + 토큰 40% 절약 무료 라우터

안녕하세요! 오늘은 AI 코딩 도구를 40개 이상의 제공자에 연결하고, 토큰 사용량을 최적화하는 오픈소스 라우터 9Router에 대해 알아보겠습니다. 9Router는 RTK Token Saver로 요청당 20-40% 토큰을 절약하고, 3단계 스마트 폴백으로 구독 → 저렴한 모델 → 무료 모델 순으로 자동 전환하는 기능을 제공합니다. 또한 Claude, Gemini, Cursor, OpenAI 등 다양한 형식을 자동 변환하고 실시간 할당량 추적을 통해 토큰 소비량을 한눈에 파악할 수 있습니다.

이 글에서는 9Router의 핵심 기능, 설치 방법, 설정 가이드, 지원 CLI 도구, API 사용법에 대해 상세히 설명하겠습니다. 함께 살펴보시죠!

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

 

 

 

 

🤖 9Router란 무엇인가?

9Router는 AI 코딩 도구들을 40개 이상의 AI 제공자에 연결하고, 자동 폴백 및 토큰 절약 기능을 제공하는 오픈소스 AI 라우터입니다. MIT 라이선스로 배포되며, GitHub에서 12.4k 스와 1.9k 포크를 기록한 인기 프로젝트입니다.

핵심 개념: 9Router는 모든 AI 코딩 도구(Claude Code, Cursor, Copilot 등)를 단일 API 엔드포인트로 통합합니다. 도구는 localhost:20128/v1/chat/completions에 요청을 보내고, 9Router가 이를 적절한 AI 제공자로 라우팅합니다. 제공자 실패 시 자동으로 다른 제공자로 폴백하며, 토큰 사용량을 실시간으로 추적합니다.

⚙️ 핵심 기능 살펴보기

1. RTK Token Saver

RTK Token Saver는 git diff, grep, ls 등 도구 출력을 압축하여 요청당 20-40% 토큰을 절약합니다. 긴 파일 내용이나 디렉토리 목록을 핵심 정보만 추출하여 전송하므로, API 비용을 크게 줄일 수 있습니다.

2. 3단계 스마트 폴백

제공자 실패 시 자동으로 다음 순서로 전환합니다:

폴백 순서	제공자 유형	예시	비용
1단계	구독형	Claude Code, Cursor, Copilot	월 $20~30
2단계	저렴한 API	GLM ($0.6/1M), MiniMax ($0.2/1M)	$0.2~0.6/1M 토큰
3단계	무료	Kiro AI (무제한), OpenCode Free	$0

3. 실시간 할당량 추적

토큰 소비량과 리셋 카운트다운을 실시간으로 표시합니다. Claude Code의 경우 1시간 45분 후 자동 리셋되며, Gemini는 일일 1500 요청 제한을 추적합니다. 이를 통해 할당량 초과 전에 미리 다른 제공자로 전환할 수 있습니다.

4. 형식 변환

다양한 AI 제공자의 API 형식을 자동 변환합니다:

입력 형식	출력 형식	변환 내용
OpenAI	Claude	messages → messages, tools → tools
Claude	Gemini	system → systemInstruction, tools → functionDeclarations
Cursor	Vertex AI	streaming SSE → streaming SSE
Kiro	OpenRouter	OAuth 토큰 → API Key

5. 다중 계정 지원

제공자별로 여러 계정을 추가하고 로드밸런싱할 수 있습니다. Claude Code 3개 계정, Gemini 2개 계정을 추가하면, 할당량 소진 시 자동으로 다음 계정으로 전환합니다. 이를 통해 단일 계정의 할당량 제한을 우회할 수 있습니다.

6. 자동 토큰 갱신

OAuth 토큰이 만료되기 전에 자동으로 갱신합니다. Claude Code, Cursor, Kiro 등 OAuth 기반 제공자의 토큰을 백그라운드에서 관리하므로, 사용자가 직접 토큰을 업데이트할 필요가 없습니다.

 

 

 

 

 

🛠️ 지원 CLI 도구

9Router는 다음 AI 코딩 도구를 지원합니다:

CLI 도구	설명	설정 방법
Claude Code	Anthropic 공식 CLI	ANTHROPIC_BASE_URL=http://localhost:20128/v1
Cursor	VS Code 확장 AI	설정 → API Base URL → localhost:20128/v1
OpenClaw	오픈소스 Claude 대안	OPENCLAW_API_BASE=http://localhost:20128/v1
Codex	OpenAI CLI	OPENAI_BASE_URL=http://localhost:20128/v1
Cline	VS Code 확장	설정 → Base URL → localhost:20128/v1
Continue	VS Code 확장	config.json → apiBase → localhost:20128/v1
RooCode	VS Code 확장	설정 → API Base URL
Copilot	GitHub VS Code 확장	Copilot 설정 → Custom API Endpoint
Antigravity	AI 코딩 에이전트	환경 변수 설정
Kilo Code	VS Code 확장	설정 → Base URL
Droid	모바일 AI 도구	API 설정
Roo	VS Code 확장	설정 → API Endpoint

🌐 지원 AI 제공자

9Router는 40개 이상의 AI 제공자를 지원합니다:

무료 제공자

제공자	모델	특징	비용
Kiro AI	Claude 4.5 + GLM-5	무제한 사용	$0
OpenCode Free	다양한 모델	무료 티어	$0
Vertex AI	Gemini, Claude	$300 무료 크레딧	$300 크레딧

구독형 제공자

제공자	모델	월 비용	할당량
Claude Code	Claude Opus 4.6, Sonnet 4.6	$20	45회/시간
Cursor	GPT-4, Claude, Gemini	$20	500 fast/day
Codex	GPT-4o, o1, o3	$20	제한 없음
GitHub Copilot	GPT-4, o1-preview	$10	제한 없음

API 키형 제공자

제공자	비용/1M 토큰	모델	특징
GLM	$0.6	GLM-4, GLM-5	저렴한 한국어 모델
MiniMax	$0.2	MiniMax-01	가장 저렴
Kimi	$9/월	Kimi k1, k2	월 정액
OpenRouter	다양	모든 모델	통합 라우터
OpenAI	$2.5~15	GPT-4o, o1, o3	공식 API
Anthropic	$3~15	Claude Opus, Sonnet	공식 API
Gemini	$0~3.5	Gemini 2.5 Pro	무료 어 있음
DeepSeek	$0.27	DeepSeek-V3, R1	저렴한 추론 모델
Groq	$0.05	Llama, Mixtral	초고속 추론
xAI	$2	Grok	Elon Musk AI
Mistral	$0.2~2	Mistral Large	유럽 AI
Perplexity	$2	Sonar, R1	검색 기반 AI

🚀 설치 방법 완벽 가이드

방법 1: npm 글로벌 설치

가장 간단한 설치 방법입니다:

# npm 글로벌 설치
npm install -g 9router

# 실행 (기본 포트 20128)
9router

# 특정 포트로 실행
9router --port 3000

 

방법 2: Docker 설치

Docker로 실행하면 데이터가 컨테이너 내에 저장됩니다:

# Docker 실행
docker run -d --name 9router -p 20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  decolua/9router:latest

# Docker Compose 사용
version: '3'
services:
  9router:
    image: decolua/9router:latest
    ports:
      - "20128:20128"
    volumes:
      - ~/.9router:/app/data
    environment:
      - DATA_DIR=/app/data
      - JWT_SECRET=my-secret-key
      - INITIAL_PASSWORD=mypassword

 

방법 3: 소스에서 실행

소스 코드를 직접 실행하여 최신 기능을 사용할 수 있습니다:

# 소스 클론
git clone https://github.com/decolua/9router.git
cd 9router

# 의존성 설치
npm install

# 빌드
npm run build

# 실행
npm run start

# 개발 모드 실행
npm run dev

 

방법 4: WSL2 설치

Windows 사용자는 WSL2에서 실행할 수 있습니다:

# WSL2 Ubuntu 설치 후
sudo apt update
sudo apt install nodejs npm

# Node.js 20 설치
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 9Router 설치
npm install -g 9router
9router

 

💡 추천 설치 방법: Docker 설치를 추천합니다. 데이터가 호스트의 ~/.9router 디렉토리에 저장되므로, 컨테이너를 재생성해도 설정이 유지됩니다. 또한 시스템 환경과 격리되어 Node.js 버전 문제를 방지할 수 있습니다.

📝 설정 가이드

환경 변수 설정

주요 환경 변수입니다:

환경 변수	설명	기본값	예시
PORT	서비스 포트	20128	3000
JWT_SECRET	JWT 서명 비밀키	자동 생성	my-secret-key-123
INITIAL_PASSWORD	초기 로그인 비밀번호	123456	mypassword
DATA_DIR	데이터 저장 위치	~/.9router	/app/data
ENABLE_REQUEST_LOGS	요청/응답 로그	false	true

제공자 추가

웹 UI(http://localhost:20128)에서 제공자를 추가합니다:

제공자 추가 방법:

1. 웹 UI 접속 → 로그인 (기본 비밀번호: 123456)
2. Providers 탭 → Add Provider
3. 제공자 선택 (Claude Code, Cursor, GLM 등)
4. 인증 방식 선택 (OAuth, API Key, Cookie)
5. 인증 정보 입력
6. Save → 연결 테스트

OAuth 인증 설정

Claude Code, Cursor, Kiro 등 OAuth 기반 제공자 설정:

# Claude Code OAuth 설정
1. Providers → Add Provider → Claude Code
2. Auth Type: OAuth
3. Login with Claude Code 버튼 클릭
4. Anthropic 로그인 페이지에서 인증
5. 자동으로 토큰 저장 및 갱신

# Cursor OAuth 설정
1. Providers → Add Provider → Cursor
2. Auth Type: OAuth
3. Login with Cursor 버튼 클릭
4. Cursor 계정으로 인증
5. 자동으로 토큰 저장

 

API Key 설정

GLM, MiniMax, OpenAI 등 API Key 기반 제공자:

# GLM API Key 설정
1. Providers → Add Provider → GLM
2. Auth Type: API Key
3. API Key 입력 (https://bigmodel.cn에서 생성)
4. Model: GLM-4, GLM-5 선택
5. Save → Test Connection

# MiniMax API Key 설정
1. Providers → Add Provider → MiniMax
2. Auth Type: API Key
3. API Key + Group ID 입력
4. Model: MiniMax-01 선택
5. Save

 

🔌 API 사용법

기본 API 호출

OpenAI 형식 API를 사용합니다:

# API 호출 예시
curl -X POST http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cc/claude-opus-4-6",
    "messages": [
      {"role": "user", "content": "Hello, how are you?"}
    ],
    "stream": true
  }'

 

모델 이름 형식

모델 이름은 제공자/모델명 형식입니다:

모델 이름	제공자	모델
cc/claude-opus-4-6	Claude Code	Claude Opus 4.6
cc/claude-sonnet-4-6	Claude Code	Claude Sonnet 4.6
cursor/gpt-4	Cursor	GPT-4
gemini/gemini-2.5-pro	Gemini	Gemini 2.5 Pro
glm/glm-4	GLM	GLM-4
kiro/claude-4.5	Kiro	Claude 4.5

Kiro AI 제공 모델들

스트리밍 API

Server-Sent Events(SSE)로 스트리밍합니다:

# Python 스트리밍 예시
import requests

url = "http://localhost:20128/v1/chat/completions"
headers = {
    "Authorization": "Bearer your-api-key",
    "Content-Type": "application/json"
}
data = {
    "model": "cc/claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Write a hello world in Python"}],
    "stream": True
}

response = requests.post(url, headers=headers, json=data, stream=True)
for line in response.iter_lines():
    if line:
        print(line.decode('utf-8'))

 

Tool Use 지원

Claude Code, Cursor의 Tool Use를 지원합니다:

{
  "model": "cc/claude-opus-4-6",
  "messages": [
    {"role": "user", "content": "Read the file config.json"}
  ],
  "tools": [
    {
      "name": "read_file",
      "description": "Read a file from the filesystem",
      "input_schema": {
        "type": "object",
        "properties": {
          "path": {"type": "string"}
        },
        "required": ["path"]
      }
    }
  ],
  "stream": true
}

 

💰 토큰 절약 효과

RTK Token Saver 작동 원리

RTK Token Saver는 다음 도구 출력을 압축합니다:

도구	원본 크기	압축 후	절약률
git diff	10,000 토큰	6,000 토큰	40%
grep -r	5,000 토큰	3,000 토큰	40%
ls -la	2,000 토큰	1,200 토큰	40%
cat file	8,000 토큰	5,600 토큰	30%

실제 비용 절감 예시

1시간 코딩 세션 비용 비교:

제공자	RTK 미사용	RTK 사용	절약
Claude API	$15	$9	$6 (40%)
OpenAI API	$10	$6	$4 (40%)
GLM API	$1.5	$0.9	$0.6 (40%)
Claude Code 구독	할당량 소진	할당량 유지	폴백 방지

📊 다른 AI 라우터와 비교

기능	9Router	OpenRouter	LiteLLM
토큰 절약	✅ RTK Token Saver	❌	❌
스마트 폴백	✅ 3단계	❌	✅ 기본
할당량 추적	✅ 실시간	❌	✅ 기본
OAuth 인증	✅ 자동 갱신	❌	❌
다중 계정	✅ 로드밸런싱	❌	✅
형식 변환	✅ 자동	✅	✅
무료 제공자	✅ Kiro, OpenCode	❌	❌
오픈소스	✅ MIT	❌	✅
로컬 실행	✅	❌	✅

⚠️ 한계점과 주의사항

주의사항:

• Node.js 20+ 필요: 이전 버전 Node.js에서는 실행되지 않습니다
• OAuth 토큰 만료: Claude Code, Cursor 토큰은 1시간 후 만료될 수 있습니다 (자동 갱신되지만 실패 시 수동 갱신 필요)
• Kiro AI 제한: 무제한 사용이지만 서버 과부하 시 응답 지연 발생
• Docker 데이터: -v 옵션으로 데이터 디렉토리를 마운트하지 않으면 컨테이너 삭제 시 설정 손실
• API Key 보안: JWT_SECRET을 강력한 비밀키로 설정해야 합니다

❓ 자주 묻는 질문

Q: 9Router는 무료인가요?

A: 9Router는 오픈소스(MIT 라이선스)로 무료입니다. 하지만 연결하는 AI 제공자의 비용은 별도입니다. Kiro AI, OpenCode Free 등 무료 제공자를 사용하면 완전 무료로 운영할 수 있습니다.

Q: Claude Code의 할당량 제한을 어떻게 우회하나요?

A: 9Router로 Claude Code 계정 3개를 추가하면, 할당량 소진 시 자동으로 다음 계정으로 전환합니다. 또한 GLM, MiniMax 등 저렴한 API로 폴백하거나 Kiro AI 무료 제공자로 전환할 수 있습니다.

Q: RTK Token Saver는 어떻게 작동하나요?

A: git diff, grep, ls 등 도구 출력에서 핵심 정보만 추출하여 전송합니다. 예를 들어 git diff의 전체 내용을 보내지 않고, 변경된 파일 목록과 핵심 diff만 전송하여 토큰을 40% 절약합니다.

Q: Cursor에서 어떻게 사용하나요?

A: Cursor 설정 → API → Base URL을 http://localhost:20128/v1로 설정합니다. API Key는 9Router 웹 UI에서 생성한 키를 사용합니다.

Q: 여러 기기에서 설정을 공유할 수 있나요?

A: Docker로 실행하고 DATA_DIR을 클라우드 저장소(Synology NAS, Dropbox 등)에 마운트하면 여러 기기에서 설정을 공유할 수 있습니다.

🎯 맺음말

지금까지 9Router에 대해 알아보았습니다. 9Router는 RTK Token Saver로 요청당 20-40% 토큰을 절약하고, 3단계 스마트 폴백으로 구독 → 저렴한 모델 → 무료 순으로 자동 전환하는 오픈소스 AI 라우터입니다. 특히 Claude Code, Cursor, Gemini, GLM 등 40개 이상의 AI 제공자를 단일 API로 통합하고, OAuth 토큰 자동 갱신, 다중 계정 로드밸런싱, 실시간 할당량 추적 등의 기능을 제공합니다. 다만 Node.js 20+가 필요하고 OAuth 토큰이 가끔 수동 갱신이 필요한 경우가 있어 Docker로 실행하며 데이터 디렉토리를 마운트하는 것이 안정적입니다.

 

여러분도 한번 9Router를 Docker로 설치하여 Kiro AI 무료 제공자와 함께 체험해보시길 추천드리면서 저는 다음 시간에 더 유익한 정보를 가지고 다시 찾아뵙겠습니다. 감사합니다.

https://fornewchallenge.tistory.com/

 

 

 

 

 

 

---

📚 참고 문헌 및 출처

• decolua. (2025). 9Router: AI Router for Coding Tools. Retrieved from https://github.com/decolua/9router
• Anthropic. (2025). Claude Code Documentation. Retrieved from https://docs.anthropic.com/claude-code
• Zhipu AI. (2025). GLM API Documentation. Retrieved from https://bigmodel.cn