مدیریت هوشمند مدل‌های هوش مصنوعی با 9Router

با رشد روزافزون دستیارهای هوش مصنوعی و ابزارهای کدنویسی مانند Claude Code، Cursor، Cline، Copilot و Codex، مدیریت سرویس‌دهنده‌ها (Providers)، کلیدهای API و هزینه‌های مربوط به توکن به یکی از چالش‌های اصلی توسعه‌دهندگان تبدیل شده است.بسیاری از برنامه‌نویسان با محدودیت‌های زمانی (Rate Limits)، پایان ناگهانی سهمیه اشتراک‌ها، یا هزینه‌های بالا هنگام استفاده مستقیم از APIها مواجه می‌شوند.

پروژه اوپن‌سورس ۹Router برای حل همین چالش‌ها طراحی شده است.این ابزار به عنوان یک پروکسی محلی و هوشمند (Local AI Proxy & Gateway) عمل کرده و به شما امکان می‌دهد تمام ابزارهای برنامه‌نویسی خود را به بیش از ۴۰ ارائه‌دهنده هوش مصنوعی و بیش از ۱۰۰ مدل مختلف متصل کنید.

در این مقاله آموزشی، به بررسی کامل پروژه ۹Router، ویژگی‌های منحصر‌به‌فرد آن، نحوه نصب، پیکربندی و بهترین روش‌های استفاده از آن خواهیم پرداخت.

۱. ۹Router چیست و چه مشکلی را حل می‌کند؟

به زبان ساده، ۹Router یک لایه میانجی (Middleware / Gateway) هوشمند است که روی سیستم شما یا سرور شخصی اجرا می‌شود.این ابزار درخواست‌های خروجی از ابزارهای کدنویسی (نظیر Claude Code، Cursor یا VS Code) را دریافت کرده، آن‌ها را به فرمت استاندارد مدل مقصد ترجمه می‌کند و به ارائه‌دهنده‌های مختلف ارسال می‌نماید.

مشکلاتی که ۹Router حل می‌کند:

1. هزینه بالای توکن‌ها در خروجی ابزارها (Tool Outputs):خروجی دستوراتی مانند git diff یا grep حجم زیادی از توکن‌های ورودی را مصرف می‌کنند.
2. برخورد به محدودیت نرخ (Rate Limits):قطع شدن کدنویسی به دلیل تمام شدن سهمیه ساعت یا روزانه در یک سرویس.
3. عدم هماهنگی فرمت APIها:ابزارهای مختلف از استانداردهای متفاوت (OpenAI API، Claude API، Gemini API) استفاده می‌کنند.
4. عدم مدیریت هوشمند اکانت‌ها:سوئیچ دستی بین اکانت‌های مختلف هنگام تمام شدن سهمیه.

۲. ویژگی‌های کلیدی ۹Router

• کاهش مصرف توکن با تکنولوژی RTK (Token Saver):با فشرده‌سازی و بهینه‌سازی خروجی ابزارها (tool_result) تا ۲۰ الی ۴۰ درصد در مصرف توکن‌های ورودی صرفه‌جویی می‌کند.
• سیستم جایگزینی خودکار ۳ مرحله‌ای (۳-Tier Auto-Fallback):در صورت اتمام سهمیه یا وقوع خطا، درخواست شما به‌صورت خودکار و بدون قطعی به ترتیب از مسیر: اشتراک اصلی ← سرویس ارزان ← سرویس رایگان هدایت می‌شود.
• ترجمه فرمت همه‌جانبه (Universal Translation):تبدیل لحظه‌ای و بی‌نقص فرمت‌های مختلف API به یکدیگر (OpenAI ↔ Anthropic Claude ↔ Google Gemini ↔ Ollama).
• پشتیبانی از چند اکانت (Multi-Account Round-Robin):امکان تعریف چند اکانت برای یک سرویس و پخش بار درخواست‌ها بین آن‌ها.
• رفرش خودکار توکن‌های OAuth:مدیریت و به‌روزرسانی خودکار کلیدهای انقضاپذیر بدون نیاز به لاگین مجدد.
• پشتیبانی از بیش از ۴۰ سرویس‌دهنده:اتصال به OpenAI، Anthropic، Google Vertex/Gemini، Ollama، Grok، SiliconFlow و سرویس‌های رایگان مانند OpenCode Free.
• داشبورد گرافیکی وب:وب‌سایت محلی جذاب برای مشاهده مصرف توکن‌ها، تنظیمات، لاگ‌ها و مدیریت ترکیب مدل‌ها (Combos).

۳. پیش‌نیازها

قبل از شروع نصب ۹Router، مطمئن شوید موارد زیر روی سیستم شما نصب و فعال هستند:

1. Node.js: نسخه ۱۸ یا بالاتر.
2. محیط مدیریت پکیج:npm یا pnpm یا yarn.
3. دسترسی اینترنت یا ابزار تغییر IP: در صورت نیاز به استفاده از ارائه‌دهنده‌های تحریم‌شده.

۴. نحوه نصب و راه‌اندازی گام‌به‌گام

راه‌اندازی ۹Router بسیار ساده است و می‌توانید به دو روش آن را نصب و اجرا کنید.

روش اول: نصب سریع و سراسری (پیشنهادی)

کافی است دستور زیر را در ترمینال سیستم خود وارد کنید:

npm install -g 9router 9router

پس از اتمام نصب، داشبورد مدلسازی و مدیریت پروژه به‌صورت خودکار در مرورگر شما روی آدرس زیر باز می‌شود:

http://localhost:20128

روش دوم: اجرا از طریق سورس کد (برای توسعه‌دهندگان)

اگر قصد دارید تغییراتی در سورس کد بدهید یا آن را به‌صورت داکر اجرا کنید:

# ۱. کلون کردن مخزن
git clone https://github.com/decolua/9router.git
cd 9router

# ۲. کپی کردن فایل تنظیمات نمونه
cp .env.example .env

# ۳. نصب وابستگی‌ها
npm install

# ۴. اجرای پروژه در حالت توسعه
npm run dev

۵. نحوه استفاده و اتصال به ابزارهای برنامه‌نویسی

گام ۱: اتصال سرویس‌دهنده (Provider) در داشبورد

مرورگر خود را باز کرده و به آدرس http://localhost:20128 بروید.

از منوی سمت چپ وارد بخش Providers شوید.

می‌توانید یک سرویس رایگان بدون نیاز به ثبت‌نام مانند OpenCode Free یا کلید API اختصاصی خود را (مانند OpenAI API Key یا Anthropic Key) وارد کنید.

کلید API اختصاصی که ۹Router برای شما تولید می‌کند را کپی کنید.

گام ۲: تنظیم ابزارهای برنامه‌نویسی (مثال‌های کاربردی)

اکنون کافی است ابزار برنامه‌نویسی خود را طوری تنظیم کنید که به آدرس پروکسی ۹Router متصل شود.

مثال ۱: تنظیم در Claude Code یا CLI Tools

آدرس Base URL و API Key را در متغیرهای محیطی سیستم یا فایل کانفیگ ابزار خود قرار دهید:

export ANTHROPIC_BASE_URL="http://localhost:20128/v1"
export ANTHROPIC_API_KEY="9router-your-api-key"

مثال ۲: تنظیم در افزونه Cursor یا Cline (VS Code)

1. تنظیمات افزونه را باز کنید.
2. حالت ارائه‌دهنده را روی OpenAI Compatible یا Custom Anthropic قرار دهید.
3. مقادیر زیر را جایگزین کنید:
   • Base URL:http://localhost:20128/v1
   • API Key: کلید کپی‌شده از داشبورد ۹Router
   • Model Name:نام مدل مورد نظر شما در ۹Router (مثلاً kr/claude-sonnet-4.5 یا gpt-4o)

۶. قابلیت‌های پیشرفته

۱. بهینه‌ساز توکن RTK (Token Saver)

یکی از جالب‌ترین امکانات ۹Router، فشرده‌سازی هوشمند خروجی ابزارهاست.وقتی ابزار کدنویسی شما دستوراتی مثل git status یا cat file.txt را اجرا می‌کند، ۹Router ساختار متنی اضافی را پاک کرده و تنها بخش‌های ضروری را برای مدل ارسال می‌کند.این کار هزینه‌های شما را تا ۴۰٪ کاهش می‌دهد.

۲. ساخت ترکیبات سفارشی (Custom Combos)

شما می‌توانید مجموعه‌ای از مدل‌ها را ترکیب کنید.برای مثال، یک ترکیب به نام fast-code بسازید که اولویت اول آن مدل سریع Claude 3.5 Haiku باشد، و در صورت لیمیت شدن، به‌صورت خودکار روی Gemini Flash سوییچ کند.

۳. ردگیری لحظه‌ای سهمیه (Quota Tracking)

داشبورد ۹Router دارای نمودارهای لحظه‌ای مصرف توکن، زمان باقی‌مانده تا ریست شدن سهمیه‌های ۵ ساعته/روزانه/هفتگی و تخمین هزینه‌ها به دلار است.

۷. نکات مهم

1. همیشه RTK Token Saver را فعال نگه دارید:این گزینه به صورت پیش‌فرض فعال است و مانع هدر رفتن سهمیه شما در پروژه‌های بزرگ می‌شود.
2. یک سرویس Backup رایگان تعریف کنید:حداقل یک سرویس رایگان (مثل OpenCode Free یا Ollama محلی) در لیست Fallback قرار دهید تا در صورت قطع شدن اینترنت یا انقضای کارت اعتباری، روند کدنویسی شما متوقف نشود.
3. از لاگ‌های دیباگ استفاده کنید:در صورت بروز مشکل در پاسخ‌دهی مدل‌ها، از بخش Request Logging در داشبورد، ورودی‌ها و خروجی‌های خام API را بررسی کنید.
4. همگام‌سازی ابری (Cloud Sync):اگر از چند دستگاه (مثلاً لپ‌تاپ و سیستم خانگی) استفاده می‌کنید، با فعال‌سازی Cloud Sync تنظیمات و پروکسی‌های خود را بین دستگاه‌ها همگام کنید.

نتیجه‌گیری

پروژه ۹Router یک ابزار فوق‌العاده کاربردی، به‌روز و قدرتمند برای هر برنامه‌نویسی است که روزانه از هوش مصنوعی برای توسعه نرم‌افزار استفاده می‌کند.با قابلیت‌هایی همچون فشرده‌سازی توکن‌ها، تغییر خودکار مسیر درخواست‌ها (Auto-fallback) و پشتیبانی از انواع فرمت‌های استاندارد، ۹Router نه‌تنها هزینه‌های پرداختی شما را به شدت کاهش می‌دهد، بلکه تجربه کدنویسی بدون قطعی را برای شما به ارمغان می‌آورد.

اگر از ابزارهایی مانند Claude Code، hermes, Cursor یا Cline استفاده می‌کنید، پیشنهاد می‌کنیم همین امروز ۹Router را نصب کرده و مدیریت مدل‌های هوش مصنوعی خود را کاملا هوشمند و متمرکز کنید.

بیشتر بخوانید:

چگونه ایجنت‌های هوش مصنوعی را به توسعه‌دهندگان ارشد کدنویسی تبدیل کنیم؟
تبدیل کدبیس و اسناد به گراف دانش قابل پرس‌وجو برای دستیارهای هوش مصنوعی با Graphify
نحوه نصب Hermes WebUI: رابط کاربری وب، سبک و حرفه‌ای برای عامل هوشمند Hermes Agent