كيفية استخدام AgentRouter مع Claude وGemini وCodex

نظرة عامة والعرض الترويجي المحدود

تتطلب بيئات التطوير الحديثة المدعومة بالذكاء الاصطناعي تشغيل نماذج متعددة بالتوازي: استخدام نموذج Claude 3.5 Sonnet للهندسة البرمجية الدقيقة وإعادة الهيكلة، ونماذج OpenAI للاستنتاج المنطقي المعقد، ونماذج Google Gemini لتحليل السياقات الضخمة والبيانات متعددة الوسائط.

تتسبب إدارة حسابات واشتراكات متفرقة وبطاقات ائتمان متعددة لكل مزود في تشتيت موارد المطورين وزيادة التكاليف الثابتة. هنا تبرز منصة AgentRouter كبوابة توجيه موحدة (Reverse-Proxy Gateway) تُتيح استدعاء نماذج Claude وOpenAI وGemini من خلال نقطة نهاية واحدة ورصيد حساب مالي موحد.

في الوقت الحالي، أعادت المنصة فتح برنامجها الترويجي الخاص بالمطورين: يحصل المستخدمون المؤهلون الذين يسجلون عبر GitHub على 150 دولار رصيد ترويجي يمكن استخدامه لتغطية استهلاك الـ API والنماذج المدعومة. يوضح هذا الدليل كيفية تفعيل العرض، حماية المفاتيح، وتهيئة بيئات العمل الطرفية.

01. ما هي منصة AgentRouter؟

منصة AgentRouter هي بوابة تجميع وتوجيه لاستدعاءات نماذج الذكاء الاصطناعي (AI Gateway)، مصممة لتوحيد واجهات برمجة التطبيقات (APIs) عبر كبرى الشركات المطورة (Anthropic، OpenAI، Google، والمصادر المفتوحة).

02. تفاصيل رصيد الترحيب (150$) وبرنامج الإحالة

لفهم محددات العرض وشروطه بشكل منضبط:

• 150 دولار رصيد ترويجي عند التسجيل: يُضاف تلقائياً لحسابات المستخدمين الجدد المؤهلين عند إتمام التسجيل عبر حساب GitHub.
• مكافأة إحالة بقيمة 50 دولار: يتيح الحساب مشاركة رابط الإحالة الخاص للحصول على 50 دولار رصيد ترويجي عن كل مستخدم مؤهل يسجل عبر الرابط.
• عرض محدود زمنياً: اختفى هذا العرض سابقاً ثم عاد للظهور مؤخراً، وقيم الأرصدة أو شروط الاستحقاق ومعدلات الاستهلاك قابلة للتعديل من قِبل إدارة المنصة.
• نطاق الاستخدام: هذا الرصيد مخصص حصراً لتغطية استدعاءات النماذج والـ API المدعومة عبر المنصة، ولا يعني بأي شكل أن النماذج مجانية بصورة دائمة أو غير محدودة.

03. خطوات التسجيل المباشر عبر GitHub

1. انتقل إلى صفحة التسجيل عبر رابط الإحالة المعتمد: بوابة التسجيل في AgentRouter عبر GitHub.
2. اختر تسجيل الدخول عبر GitHub (Sign in with GitHub) لمنح المصادقة عبر بروتوكول OAuth.
3. وافق على صلاحيات المصادقة المطلوبة في شاشة التأكيد الخاصة بـ GitHub.
4. بعد التحويل إلى لوحة التحكم (Console)، انتقل إلى تبويب Wallet للتحقق من نزول الرصيد الترويجي في حسابك.

04. بنية المحفظة (Wallet) وإثبات الرصيد

تحتوي لوحة تحكم AgentRouter على واجهة محفظة (Wallet) واضحة تبيّن الرصيد الحالي (Current balance) وإجمالي الاستهلاك الفعلي (Consumption). توضح اللقطة التالية من لوحة التحكم بنية المحفظة وقت إعداد الدليل:

توضيح: تُظهر الصورة حساباً برصيد نشط يبلغ 174.92 دولار واستهلاكاً بقيمة 0.08 دولار وقت التقاط الشاشة. الرصيد يعكس حركة الحساب والمكافآت الترويجية، وهو معروض كدليل تطبيقي على عمل محفظة المنصة وليس وعداً برقم دخل محدد لكل حساب.

05. توليد وإدارة مفاتيح الـ API Tokens

قبل البدء في ربط أدوات الطرفية أو بيئات التطوير، يلزم استخراج مفتاح استدعاء (API Token) من لوحة التحكم:

1. من القائمة الجانبية في لوحة التحكم، انقر على API Token.
2. اضغط على زر إضافة مفتاح جديد (Add API Token).
3. حدد اسماً دالاً على الغرض (مثل: workstation-claude-code).
4. (اختياري) يمكنك تعيين تاريخ انتهاء وسقف إنفاق مالي محدد للمفتاح.
5. انسخ المفتاح المولد فوراً (يبدأ عادةً بـ sk-ar-...) واحفظه في مكان آمن، ولا تشاركه في مستودعات عامة.

06. ضبط بيئة Codex ومكتبات OpenAI

تتوافق نقطة النهاية الأساسية لـ AgentRouter تماماً مع بنية OpenAI REST API. لتوجيه استدعاءات مكتبة OpenAI أو أدوات Codex، نقوم بتعديل عنوان Base URL وتمرير مفتاح المنصة.

إعداد متغيرات البيئة في macOS / Linux:

# Add to ~/.zshrc or ~/.bashrc
export OPENAI_BASE_URL="https://agentrouter.org/v1"
export OPENAI_API_KEY="YOUR_AGENTROUTER_API_KEY"

إعداد متغيرات البيئة في Windows PowerShell:

# Persist to Windows User Registry
setx OPENAI_BASE_URL "https://agentrouter.org/v1"
setx OPENAI_API_KEY "YOUR_AGENTROUTER_API_KEY"
setx AGENTROUTER_API_KEY "YOUR_AGENTROUTER_API_KEY"

نموذج كود Python باستخدام مكتبة OpenAI SDK:

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://agentrouter.org/v1",
    api_key=os.environ.get("AGENTROUTER_API_KEY")
)

response = client.chat.completions.create(
    model="gpt-4o", # or "claude-3-5-sonnet-20241022", "gemini-2.0-flash"
    messages=[{"role": "user", "content": "Explain closed-loop CRM attribution in 2 sentences."}]
)
print(response.choices[0].message.content)

07. إعداد أداة Claude Code في الطرفية

تعتمد أداة الطرفية الرسمية من أنثروبيك Claude Code على الاتصال بنقاط نهاية Anthropic. لتوجيه استدعاءاتها عبر بوابة AgentRouter، نقوم بضبط متغيرات البيئة الخاصة بـ Anthropic Base URL:

أنظمة macOS / Linux:

export ANTHROPIC_BASE_URL="https://agentrouter.org/v1"
export ANTHROPIC_API_KEY="YOUR_AGENTROUTER_API_KEY"

أنظمة Windows PowerShell:

setx ANTHROPIC_BASE_URL "https://agentrouter.org/v1"
setx ANTHROPIC_API_KEY "YOUR_AGENTROUTER_API_KEY"

# تذكر فتح نافذة PowerShell جديدة بعد تشغيل setx!

بعد الضبط، يمكنك تشغيل أمر claude داخل مجلد مشروعك لبدء جلسة تفاعلية تتم محاسبتها بالكامل من رصيدك في AgentRouter.

08. الربط مع Gemini CLI وبيئات التطوير

نظراً لمعايرة المنصة لأسماء النماذج، يمكنك إدخال بيانات الـ API داخل إضافات ومحررات الأكواد المدعومة بالذكاء الاصطناعي (مثل: Cursor، Continue، Roo Code، Aider):

09. حوكمة أمان المفاتيح وضبط الحصص المالية

لحماية رصيد حسابك من الاستهلاك المفاجئ أو التسريب غير المقصود:

• فصل المفاتيح حسب الاستخدام: أنشئ مفتاحاً مستقلاً لكل أداة طرفية بدلاً من مشاركة مفتاح عام واحد بين كل أجهزتك.
• تحديد سقف مالي (Quota): ضع حداً أقصى للمفاتيح التجريبية (بين 5 و10 دولارات) لتفادي استنزاف الرصيد في حال حدوث حلقات استدعاء لا نهائية.
• منع رفع المفاتيح للـ Git: تأكد من إضافة ملفات .env إلى ملف .gitignore.
• إلغاء المفاتيح فوراً: عطّل أو احذف أي مفتاح تشك في تعرضه للمشاركة من خلال لوحة تحكم المنصة مباشرة.

10. زمن استجابة البوابات والمفاضلة الهندسية

على الرغم من المرونة والوفر المالي الذي تقدمه بوابات التجميع، يجب مراعاة الفروق التقنية التالية:

الأسئلة الشائعة

الخلاصة وبدء الاستخدام

توفر AgentRouter وسيلة فعالة وعملية للمطورين والتقنيين لاختبار واستخدام نماذج الذكاء الاصطناعي الرائدة عبر Claude Code وOpenAI Codex وGemini CLI بإعداد موحد ورصيد ترويجي مجزي.