شنو هو Infinite Claude Code؟
Infinite Claude Code هو proxy ديال Node.js بلا حتى dependency، كيربط clients الرسميين ديال Anthropic، بما فيهم Claude Code CLI وClaude Desktop وامتدادات IDE المدعومة، مع pool ديال مزوّدي النماذج المتوافقين مع OpenAI. كيقبل طلبات Anthropic Messages API فـ /v1/messages، كيحوّلها للصيغة ديال المزوّد، وكيحوّل الردود من جديد لأحداث Server-Sent Events متوافقة مع Anthropic وكتوصل فالحين.
المشروع كيركّز على النماذج السحابية المجانية، وكيدعم بيانات الاعتماد الاختيارية ديال المزوّدين، ويقدر يرجع لاستعمال instance محلية ديال Ollama. حسب README ديال المشروع، الراوتر كيبدا بسرعة، وكيستعمل أقل من 30 MB من الذاكرة، وما كيستهلك حتى CPU ملي كيكون خامل.
المستودع كيصف pool السحابية المهيّأة مسبقاً بأنها مجانية للاستعمال. ولكن التوفّر ديال المزوّدين، وحدود الاستعمال، والولوج للنماذج، والثمن يقدرو يتبدلو من طرف الخدمات الخارجية المعنية، لذلك راجع الشروط الحالية ديال كل مزوّد قبل ما تعتمد عليه فخدمات مستمرة.
كيفاش كيخدم الراوتر
الراوتر المحلي كيسمع افتراضياً فـ 127.0.0.1:20129. Claude Code كيبعث طلب بصيغة Anthropic لهاد العنوان، ومن بعد Infinite Claude Code كيصنّف المهمة، كيختار النموذج المناسب، كيحوّل استدعاءات الأدوات، وكيرجع النتيجة للعميل عبر streaming.
Claude Code أو Claude Desktop أو امتداد IDE كيبعث طلب لـ
/v1/messages.المصنّف الدلالي كيفحص الـ prompt والأدوات المتاحة.
الـ dispatcher كيختار المزوّد والنموذج من pool ديال الأولوية.
إلا كان المزوّد غير متاح أو وصل للحد ديال الاستعمال، الراوتر كينتاقل لمزوّد آخر مهيّأ.
استدعاءات الدوال بصيغة OpenAI كيتحوّلو لرسائل استعمال الأدوات بصيغة Anthropic.
توكنات الرد كترجع عبر SSE streaming فالحين.
إلا ما بقاتش المسارات السحابية متاحة وكان Ollama مهيّأ، الراوتر يقدر يستعمل نموذج محلي.
المزايا الرئيسية
توزيع متزامن للوكلاء الفرعيين
ملي Claude Code كيبدا بزاف ديال الوكلاء الفرعيين أو الجلسات اللي خدامة فالخلفية، dispatcher ديال swarm يقدر يوزّع الطلبات المتزامنة على مزوّدين مختلفين بلا ما يصيفط الخدمة كاملة لنموذج واحد. الهدف هو ينقص الاختناقات المرتبطة بمزوّد واحد وأخطاء تجاوز حدود الاستعمال.
التوجيه الدلالي للمهام
الراوتر كيختار النماذج حسب نوع الخدمة اللي باينة. استراتيجية التوجيه الموثّقة كتفضّل نماذج الاستدلال بحال Nemotron 120B أو Kimi K3 لمهام البنية، ونماذج مركّزة على الكود بحال North Mini Code أو Qwen Coder للتوليد وتعديل الملفات، وNemotron Lightning للأوامر السريعة.
إصلاح استدعاءات الأدوات
شي نماذج مفتوحة الأوزان كتنشئ JSON غير صالح فحجج الأدوات. Infinite Claude Code فيه sanitizer مبني على AST كيحاول يصلح مشاكل بحال علامات الاقتباس اللي ما متحوّلاش أو الأقواس الناقصة قبل ما ينفّذ Claude Code استدعاء الأداة.
الانتقال التلقائي بين المزوّدين
المشروع كيدعم pool مرتّبة فيها OpenRouter وNVIDIA NIM وOmniRouter و9Router وGroq وCerebras وTogether AI وGoogle Gemini وMistral AI وOpenAI وAnthropic وخدمات اختيارية أخرى. الطلب اللي فشل أو وصل لحد الاستعمال يقدر يعاود يتجرّب عبر مزوّد آخر متاح.
لوحة المراقبة
واجهة HUD فالمتصفح كتعرض الوكلاء الفرعيين النشيطين، ونشاط المزوّدين، والتوكنات المولّدة، ووقت الاستجابة، وعداداً تقديرياً للفلوس اللي توفّرات اعتماداً على الثمن الرسمي لـ Claude 3.7 Sonnet API.
البديل بلا إنترنت
Ollama يقدر يوفّر استمرارية محلية بنماذج بحال qwen3:4b أو deepseek-r1. الأداء المحلي وموثوقية الأدوات كيعتمدو على النموذج المختار وعلى العتاد ديالك.
المتطلبات
Node.js 18 أو أحدث.
Git لطرق التثبيت اليدوية.
Claude Code CLI أو Claude Desktop أو تكامل متوافق مع IDE.
PowerShell فـ Windows أو shell فـ macOS وLinux.
Ollama غير إلا بغيتي البديل المحلي بلا إنترنت.
المشروع براسو ما كيحتاجش بيئة Python ولا حزم Node.js إضافية.
تثبيت Infinite Claude Code
الخيار 1: مُثبّت Windows بأمر واحد
حلّ PowerShell وشغّل أمر التثبيت من المستودع:
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/juanitogit/infinite-claude-code/main/install.ps1")))حيت هاد الأمر كيحمّل وكيشغّل مباشرة script من الإنترنت، راجع install.ps1 قبل، إلا كانت سياسة الأمان ديالك كتطلب هاد الشي.
الخيار 2: التثبيت اليدوي فـ Windows
git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
powershell -ExecutionPolicy Bypass -File .\install.ps1الخيار 3: التثبيت فـ macOS أو Linux
git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
chmod +x install.sh && ./install.shاختيار طريقة التثبيت
المُثبّت التفاعلي كيعرض جوج ديال الطرق:
Express Install: كيهيّأ المستوى المجاني الموثّق والمهيّأ مسبقاً بلا ما يطلب بيانات اعتماد اختيارية ديال المزوّدين.
Custom Install: كيطلب مفاتيح API ديال مزوّدين إضافيين. ضغط على
Enterباش تتجاوز أي مزوّد ما بغيتيش تهيّأه.
التحقق من الراوتر المحلي
من مجلد المستودع، تحقّق من حالة الخدمة:
node bin/infinite-claude.js statusالتثبيت السليم خاصو يبيّن أن Infinite Claude Code خدام، ويحدّد العنوان المحلي كـ http://127.0.0.1:20129، ويأكّد SSE streaming، ويعرض المزوّدين النشيطين فـ pool.
Infinite Claude Code خدام ونشيط وبصحة مزيانة!
URL: http://127.0.0.1:20129
Streaming: مفعّل (SSE فالحين)
Active Providers in Pool: ...إلا ماكانش السيرفيس خدام مزيان، تأكد بلي Node.js 18 ولا أحدث متوفر، وبلي ماكاين حتى تطبيق آخر كايستعمل البورت 20129.
شغّل Claude Code
منين يكون الراوتر خدام والـ installer وجد الـ client، شغّل Claude Code بالطريقة العادية:
claudeمن بعد تقدر تدخل طلب ديال البرمجة فالجلسة التفاعلية:
Inspect this project, explain its architecture, and identify the safest first refactoring task.الطلب خاصو يدوز من خلال الـ proxy المحلي، والجواب غادي يبان بالتدريج وهو كايتولّد.
جرّب مهمة مباشرة
Claude Code يقدر حتى يتوصل بـ prompt مباشرة من الـ terminal:
claude "Review the authentication module and propose a refactoring plan"هاد الطريقة مفيدة للخدمة المركزة اللي ماكاتحتاجش تبدا بجلسة تفاعلية خاوية. اختيار الموديل كايتدار من طرف منطق التوجيه ديال Infinite Claude Code، وماشي من طرف الأمر بوحدو.
راقب الطلبات فـ Cyber HUD
حل العنوان المحلي التالي والراوتر خدام:
http://localhost:20129/hudالـ HUD كايعطيك telemetry مباشرة ديال الجلسة الحالية، ومنها:
الـ provider اللي كايخدم كل طلب.
عدد الـ tokens المتولدة.
المدة ديال استجابة الطلب بالميلي ثانية.
عدد الـ subagents النشيطين فـ نفس الوقت.
عداد تقريبي للتوفير محسوب على حساب أثمنة API ديال Claude 3.7 Sonnet.
استعمل هاد الـ dashboard باش تتأكد بلي الطلبات كتتوزع على الـ pool المكوّن، وتكتاشف الـ providers اللي عندهم latency طالعة بشكل غير عادي.
كوّن الـ Providers ومتغيرات البيئة
تقدر تبدّل تعريفات الـ providers فـ src/providers.js ولا تعطي بيانات الدخول والـ endpoints باستعمال متغيرات البيئة. الـ README كايوثق المتغيرات التالية:
OPENROUTER_API_KEY: credential مخصص ديال OpenRouter. الـ default الموثق كايستعمل الـ free tier الموجد من قبل.NVIDIA_API_KEY: credential مخصص ديال NVIDIA NIM. الـ repository كايوثق NIM key موجد من قبل كـ default.OMNIROUTER_API_KEY: credential مخصص ديال OmniRouter.ROUTER9_API_KEY: credential مخصص ديال 9Router.GROQ_API_KEY: credential اختياري ديال Groq.TOGETHER_API_KEY: credential اختياري ديال Together AI.OLLAMA_HOST: endpoint ديال Ollama، والـ default ديالو هوhttp://localhost:11434.PORT: بورت ديال الـ proxy المحلي، والـ default ديالو هو20129.
مثلاً، فـ shell ديال macOS ولا Linux تقدر توجّه الراوتر لـ Ollama host وبورت مختلفين قبل ما تشغلو:
export OLLAMA_HOST="http://localhost:11434"
export PORT="20129"فـ PowerShell، متغيرات الجلسة المكافئة هي:
$env:OLLAMA_HOST = "http://localhost:11434"
$env:PORT = "20129"خلي API keys الشخصية ديالك برا source control. ماتديرش commit لملفات shell profiles ولا environment files ولا إعدادات providers مبدّلة وفيها secrets.
وجد Ollama كـ fallback محلي
Infinite Claude Code كايدعم Ollama كـ route offline ولا للطوارئ. الـ README كاايذكر qwen3:4b وdeepseek-r1 كموديلات محلية مثالية.
سطّب وشغّل Ollama بوحدو.
وفّر الموديل اللي بغيتي فـ installation ديال Ollama.
خلي
OLLAMA_HOSTعلىhttp://localhost:11434ولا بدّلو للـ endpoint المخصص ديالك.عاود تأكد من router ديال Infinite Claude Code باستعمال أمر الحالة.
الـ fallback المحلي مفيد بزاف ملي كيوقع انقطاع فالإنترنت، ولكن السرعة، وسعة الـ context، وجودة البرمجة غادي يبقاو تابعين للموديل المحلي ولموارد CPU والذاكرة ولا GPU المتوفرة.
شغّل Subagents ذاتيين
فـ مهمة كتستافد من التقسيم، طلب بشكل واضح من Claude Code ينشئ subagents خدامين فـ نفس الوقت:
claude "Divide this task and use concurrent subagents in parallel to build the complete platform"وتقدر حتى تطلق مهمة فالخلفية باستعمال الخيار الموثق --bg:
claude --bg "Refactor the authentication module and write unit tests"الراوتر مصمم باش يوزع نداءات الـ subagents المتزامنة على providers مختلفين. راقب الـ HUD والمهمة خدامة باش تشوف الحمل ديال الـ swarm واختيار الـ providers.
نصائح متقدمة
وافق التزامن مع توفر الـ providers
المشروع كايدعم التزامن الواسع، ولكن الـ providers الخارجيين يقدرو يفرضو limits ديال المعدل ولا قيود على التوفر ديالهم. شوف الـ HUD ولائحة الـ providers النشيطين قبل ما تطلق عدد كبير ديال المهام فالخلفية.
استعمل keys اختيارية باش توسّع الـ pool
إلا كانت الـ routes الموجدة من قبل مضغوطة، يقدر Custom Install يزيد providers بحال Groq ولا Together AI. الـ pool الأوسع كايعطي نظام failover routes أكثر، ولكن كل service اختياري يقدر تكون عندو quotas وشروط مختلفة.
استعمل أمر الحالة أثناء حل المشاكل
شغّل node bin/infinite-claude.js status قبل ما تبدا تdebugّي Claude client براسو. هاد الشي كاايفرق بسرعة بين مشكل فالراوتر المحلي ومشكل فـ model-provider ولا فالـ client.
بدّل البورت إلا كان ضروري
إلا كان البورت 20129 متعارض مع service آخر، عيّن PORT لقيمة أخرى. تأكد بلي إعدادات Anthropic client كاتشير لنفس الـ endpoint المحلي من بعد ما تبدّل البورت.
فتّش إعدادات الـ providers بعناية
المستخدمين المتقدّمين يقدرو يبدلو src/providers.js باش يخصّصو الموديلات. حافظو على الصيغ المتوقعة ديال المزوّدين، وجرّبو التغييرات بطلب بسيط قبل ما تبداو وكلاء متزامنين.
حمي الكود الخاص
الطلبات اللي كتدوز من السحابة تقدر تتضمّن الكود المصدري، مخرجات الأدوات، ولا سياق المشروع. راجع سياسات الخصوصية والتعامل مع البيانات ديال كل مزوّد مفعّل قبل ما تستعمل الراوتر مع مستودعات فيها معلومات سرّية. فضّل مسار Ollama ملي خاص الخدمة تبقى محلية.
الخلاصة
Infinite Claude Code كيوفّر طبقة خفيفة للترجمة والتوجيه بين عملاء Anthropic ومجموعة كبيرة ديال الموديلات السحابية ولا المحلية. من بعد ما تشغّل المثبّت، تأكّد من الخدمة، شغّل claude، واستعمل HUD باش تراقب البث، والتحويل عند الفشل، والوكلاء الفرعيين المتزامنين. مفاتيح المزوّدين الاختيارية وOllama كيخليوك توسّع المجموعة ولا تزيد قدرة محلية على الاستمرار حسب الحاجة ديال سير العمل ديالك.
المشروع كيتصان من طرف JuaneX وكيتوزّع برخصة MIT. الكود المصدري وسكريبتات التثبيت متوفرين فـ مستودع Infinite Claude Code.