Instalasi & Setup 9Router

9Router adalah AI router atau gateway yang menghubungkan berbagai AI coding tools ke banyak provider dan model AI melalui satu endpoint.

Sederhananya, tanpa 9Router:

Claude Code → Anthropic
Codex → OpenAI
Cline → Provider lain

Dengan 9Router:

Claude Code ─┐
Codex ───────┤
Cline ───────┼──→ 9Router → Provider / Model AI
OpenClaw ────┤
Cursor ──────┘

Jadi kita tidak perlu terus-menerus mengganti API, provider, atau konfigurasi di setiap aplikasi.

9Router juga menyediakan fitur seperti multi-provider, quota tracking, format translation, token saver, multi-account, dan automatic fallback ke model lain ketika model utama mencapai limit atau mengalami error.

9Router cocok digunakan jika kamu memakai tools seperti:

• +

  Claude Code

• +

  Codex

• +

  Cursor

• +

  Cline

• +

  OpenCode

• +

  OpenClaw

• +

  Roo Code

• +

  Continue

• +

  berbagai tools yang mendukung OpenAI-compatible API

9Router akan menyediakan endpoint lokal:

http://localhost:20128/v1

Tool AI kemudian cukup diarahkan ke endpoint tersebut. Setelah itu, provider dan model dapat dikelola dari dashboard 9Router.

9Router membutuhkan Node.js 20 atau lebih baru. npm biasanya otomatis ikut terinstall bersama Node.js.

Yang perlu disiapkan:

Node.js 20+
npm
Terminal / PowerShell
Internet

Untuk instalasi baru, disarankan menggunakan versi Node.js LTS.

Cek apakah Node.js sudah terinstall:

$ node -v

Kemudian cek npm:

$ npm -v

Jika keduanya menampilkan nomor versi, kamu bisa lanjut menginstall 9Router.

Buka PowerShell atau Command Prompt, kemudian jalankan:

$ npm install -g 9router

Setelah selesai:

$ 9router

9Router akan berjalan dan dashboard dapat dibuka melalui:

http://localhost:20128

atau langsung:

http://localhost:20128/dashboard

Instalasi global menggunakan npm merupakan metode Quick Start resmi 9Router.

Pastikan Node.js dan npm sudah tersedia:

$ node -v
npm -v

Kemudian install:

$ npm install -g 9router

Jalankan:

$ 9router

Lalu buka:

http://localhost:20128

Jika Linux digunakan sebagai komputer desktop, dashboard dapat langsung dibuka melalui browser.

Untuk VPS atau server publik, sebaiknya jangan langsung membuka port 9Router ke internet tanpa authentication dan konfigurasi keamanan tambahan.

Buka dashboard:

http://localhost:20128

Kemudian masuk ke Providers dan pilih provider AI yang ingin digunakan.

9Router mendukung provider berbasis:

OAuth
API Key
Free Provider
Custom Endpoint

Setelah provider berhasil terhubung, model yang tersedia dapat digunakan melalui 9Router. Selanjutnya buat atau copy API Key dari dashboard.

Konfigurasi umum untuk aplikasi yang mendukung OpenAI-compatible API adalah:

Base URL:
http://localhost:20128/v1

API Key:
API_KEY_DARI_9ROUTER

Model:
MODEL_YANG_DIPILIH

Sekarang request dari tool tersebut akan melewati 9Router terlebih dahulu sebelum diteruskan ke provider AI.

Setiap kali ingin menjalankan 9Router secara manual, cukup buka terminal dan jalankan:

$ 9router

Kemudian akses:

http://localhost:20128

Jika 9Router berhenti, aplikasi yang menggunakan endpoint lokal 9Router juga tidak akan dapat mengirim request sampai 9Router dijalankan kembali.

Untuk memperbarui 9Router ke versi terbaru:

$ npm install -g 9router@latest

Kemudian jalankan kembali:

$ 9router

9router is not recognized

Jika Windows menampilkan:

'9router' is not recognized

pastikan package sudah terinstall:

$ npm list -g --depth=0

Jika 9Router sudah ada tetapi command belum terbaca, tutup terminal lalu buka kembali.

Cek juga lokasi global npm:

$ npm config get prefix

Pastikan lokasi tersebut tersedia di environment variable PATH.

Permission denied di Linux

Jika muncul error permission ketika menjalankan instalasi global, hindari langsung menggunakan sudo jika tidak diperlukan.

Cara yang lebih aman adalah menggunakan Node.js melalui NVM, sehingga global npm package dapat diinstall pada user sendiri.

Setelah Node.js terinstall melalui NVM:

$ npm install -g 9router

Dashboard Tidak Bisa Dibuka

Pastikan 9Router masih berjalan pada terminal.

Coba buka:

http://127.0.0.1:20128

Jika tetap tidak bisa, jalankan kembali:

$ 9router

dan perhatikan error yang muncul pada terminal.

Port 20128 Sudah Digunakan

Jika muncul error bahwa port sudah digunakan, berarti ada aplikasi lain atau instance 9Router lain yang sedang menggunakan 20128.

Pada Windows kamu dapat mengeceknya dengan:

$ netstat -ano | findstr :20128

Pada Linux:

$ ss -ltnp | grep 20128

Tutup proses yang tidak diperlukan atau pastikan tidak ada dua instance 9Router yang berjalan bersamaan.

Provider Sudah Connected tetapi AI Tidak Bisa Digunakan

Periksa beberapa hal berikut:

Provider masih aktif
API Key masih valid
Quota belum habis
Model masih tersedia

Jika menggunakan OAuth dan koneksi bermasalah:

Dashboard → Providers → Reconnect

Dokumentasi 9Router juga merekomendasikan reconnect provider jika token OAuth mengalami masalah.

Rate Limit / Quota Habis

Jika provider mengembalikan error seperti:

429 Too Many Requests

kemungkinan quota atau rate limit provider sudah tercapai. Kamu dapat:

• +

  Mengganti model

• +

  Mengganti provider

• +

  Menunggu quota reset

• +

  Menggunakan fitur Combo / Fallback

Salah satu fungsi utama 9Router memang memungkinkan beberapa model disusun sebagai fallback sehingga request dapat dialihkan ketika model utama tidak tersedia.

Setup dasar 9Router sebenarnya hanya membutuhkan:

$ npm install -g 9router
9router

Kemudian buka:

http://localhost:20128

Setelah itu:

Connect Provider
      ↓
Pilih Model
      ↓
Copy API Key
      ↓
Hubungkan AI Tool
      ↓
Selesai

Dengan 9Router, berbagai AI coding tools dapat menggunakan satu gateway untuk mengakses dan mengatur banyak model serta provider AI, sehingga perpindahan model, pengelolaan quota, dan fallback menjadi jauh lebih praktis.