تقديم مشروع Claude Code Router

نظرة عامة على المشروع

Claude Code Router هو مشروع مفتوح المصدر يهدف إلى توجيه طلبات Claude Code إلى نماذج ذكاء اصطناعي مختلفة، ليكون أساسًا للبنية التحتية للبرمجة، مما يتيح للمستخدمين تحديد كيفية التفاعل مع النماذج مع الاستمتاع بالتحديثات من Anthropic. الهدف الأساسي لهذا المشروع هو خفض تكلفة استخدام Claude Code بشكل كبير من خلال التوجيه الذكي والتعاون بين النماذج المتعددة.

دوافع المشروع

تواجه أدوات البرمجة التقليدية المدعومة بالذكاء الاصطناعي المشكلات التالية:

• تكلفة باهظة: استخدام نماذج متطورة مثل Claude مباشرة لجميع المهام مكلف للغاية.
• قيود النموذج: لا يمكن لنموذج واحد أن يقدم أفضل أداء في جميع السيناريوهات.
• إهدار الموارد: استخدام نماذج معقدة للمهام البسيطة يؤدي إلى إهدار الموارد.

يعالج Claude Code Router هذه المشكلات من خلال التوجيه الذكي. يذكر المؤلف أنه عند استخدام Claude-4 في VSCode Copilot لمعالجة مشكلة Flutter، أدت ثلاث جولات من المحادثة إلى إفساد الملفات مما استدعى التراجع، بينما باستخدام Claude Code مع DeepSeek، تم إنجاز المهمة بنجاح بعد ثلاث أو أربع جولات من المحادثة بتكلفة تقل عن 1 يوان صيني.

الميزات الأساسية

1. تشغيل بوضعين

• الوضع العادي (Normal Mode): استخدام نموذج واحد لإنجاز جميع المهام.
• وضع الموجه (Router Mode): استخدام نماذج متخصصة متعددة للتعاون في إنجاز أنواع مختلفة من المهام.

2. تقسيم المهام الذكي بين النماذج

في وضع الموجه، يستخدم النظام أربعة نماذج متخصصة مختلفة:

• وكيل التوجيه (Router Agent): qwen2.5-coder-3b

  • مسؤول عن توزيع توجيه الطلبات.
  • لا يتطلب ذكاءً عاليًا، ويمكن لنموذج صغير أن ينجز المهمة.
  • يستخدم حاليًا نموذج qwen2.5-coder-3b المجاني الرسمي من Alibaba Cloud.

• وكيل الأدوات (Tool Agent): qwen-max-0125

  • مسؤول عن استدعاء الأدوات.
  • يجب أن يدعم استدعاء الدوال (Function Calling).
  • يحتاج إلى دعم طول وصف أداة كبير بما يكفي (أكبر من 1754 بشكل مثالي).

• وكيل المبرمج (Coder Agent): deepseek-v3

  • مسؤول بشكل خاص عن مهام توليد الكود.
  • يستخدم نماذج سلسلة DeepSeek.

• وكيل التفكير (Think Agent): deepseek-r1

  • مسؤول عن مهام الاستدلال المعقدة.
  • يستخدم نموذج الاستدلال DeepSeek R1.

3. تحسين التكلفة

• بفضل نموذج qwen2.5-coder-3b المجاني من Alibaba Cloud وتقنية KV-Cache من DeepSeek.
• يمكن أن يخفض تكلفة استخدام Claude Code بشكل كبير.
• يتجنب استخدام النماذج باهظة الثمن للمهام البسيطة من خلال تقسيم المهام.

التثبيت والتكوين

1. تثبيت Claude Code

npm install -g @anthropic-ai/claude-code

2. استنساخ المشروع

git clone https://github.com/musistudio/claude-code-reverse.git

3. تثبيت التبعيات

npm i

4. تكوين متغيرات البيئة

تكوين الوضع العادي

# تعطيل الموجه
ENABLE_ROUTER=false
OPENAI_API_KEY=""
OPENAI_BASE_URL=""
OPENAI_MODEL=""

تكوين وضع الموجه

# تفعيل الموجه
ENABLE_ROUTER=true
export TOOL_AGENT_API_KEY=""
export TOOL_AGENT_BASE_URL=""
export TOOL_AGENT_MODEL="qwen-max-2025-01-25"
export CODER_AGENT_API_KEY=""
export CODER_AGENT_BASE_URL="https://api.deepseek.com"
export CODER_AGENT_MODEL="deepseek-chat"
export THINK_AGENT_API_KEY=""
export THINK_AGENT_BASE_URL="https://api.deepseek.com"
export THINK_AGENT_MODEL="deepseek-reasoner"
export ROUTER_AGENT_API_KEY=""
export ROUTER_AGENT_BASE_URL=""
export ROUTER_AGENT_MODEL="qwen2.5-coder-3b-instruct"

5. بدء الخدمة

node index.mjs

6. تكوين متغيرات بيئة Claude Code

export DISABLE_PROMPT_CACHING=1
export ANTHROPIC_AUTH_TOKEN="test"
export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
export API_TIMEOUT_MS=600000
claude

البنية التقنية

مبدأ عمل وضع الموجه

1. استقبال الطلبات: يرسل Claude Code الطلبات إلى خادم الوكيل المحلي.
2. التوجيه الذكي: يحلل وكيل التوجيه (Router Agent) نوع الطلب ويقرر إلى أي نموذج متخصص يتم إعادة توجيهه.
3. تنفيذ المهام:
   • مهام استدعاء الأدوات ← وكيل الأدوات (Tool Agent)
   • مهام توليد الكود ← وكيل المبرمج (Coder Agent)
   • مهام الاستدلال المعقدة ← وكيل التفكير (Think Agent)
4. إرجاع النتائج: تعيد النماذج المختلفة النتائج بعد إكمال المهام.

المزايا الرئيسية

• فصل المهام: فصل مهام استدعاء الأدوات عن مهام البرمجة.
• تخصص النماذج: يركز كل نموذج على المهمة التي يبرع فيها.
• التحكم في التكلفة: اختيار النموذج المناسب بناءً على تعقيد المهمة.
• دعم نماذج الاستدلال: يدعم نماذج الاستدلال مثل R1 التي لا تدعم استدعاء الدوال.

ملاحظات هامة

⚠️ تذكير هام:

• هذا المشروع في مرحلة الاختبار وقد يستهلك كمية كبيرة من الرموز (tokens).
• قد تحدث حالات فشل في تنفيذ المهام.
• يُنصح بتعيين إعدادات ignorePatterns المناسبة للمشروع.

أهمية المشروع

يمثل Claude Code Router اتجاهًا مهمًا في تطوير أدوات البرمجة المدعومة بالذكاء الاصطناعي:

• إضفاء الطابع الديمقراطي على التكلفة: جعل مساعدي البرمجة بالذكاء الاصطناعي في متناول المزيد من المطورين.
• تنوع النماذج: عدم الاعتماد على نموذج واحد، بل القدرة على اختيار النموذج الأنسب بمرونة.
• ابتكار معماري: تحسين الكفاءة الكلية من خلال التوجيه وتقسيم المهام المتخصص.

يوفر هذا المشروع للمطورين أداة قوية، تمكنهم من خفض تكلفة الاستخدام بشكل كبير مع الحفاظ على وظائف Claude Code القوية، مما يجعله مساهمة مهمة في تعميم أدوات البرمجة المدعومة بالذكاء الاصطناعي.