Deepseek ArtifactsDeepseek Artifacts
Claude Code Router · دليل 2026

برنامج تعليمي لـ Claude Code Router: وجّه Claude Code إلى DeepSeek أو Gemini أو أي نموذج

يحافظ الموجّه مفتوح المصدر على تجربة Claude Code التي تعرفها، لكنه يرسل كل طلب إلى نماذج أرخص — DeepSeek أو Kimi أو Gemini أو نموذج Ollama محلي. ثبّته عبر npm، واضبط المزوّدين في وحدة ccr ui، وحدّد مسارات لكل سيناريو، ثم شغّل مهمة حقيقية للتأكد. 15 خطوة بلقطات شاشة.

ابدأ الإعداداقرأ الأسئلة الشائعة

باختصار: ماذا يفعل Claude Code Router

  • Claude Code Router (CCR) وسيط مجاني مفتوح المصدر: يحتفظ Claude Code بواجهته وموجّهه النظامي وأدواته، لكن نداءات النموذج تذهب إلى ما تضبطه أنت — DeepSeek أو Kimi K2 أو Gemini أو OpenRouter أو نموذج Ollama محلي.
  • التثبيت أمر npm واحد (npm install -g @musistudio/claude-code-router)، ووحدة الويب ccr ui تعدّل ملف ~/.claude-code-router/config.json نيابةً عنك — دون حاجة لتحرير JSON يدويًا.
  • التوجيه حسب السيناريو: تحصل الفتحات default وbackground وthink (الاستدلال في Plan Mode) وlongContext (يُفعَّل تلقائيًا بعد عتبة 60,000 رمز) وwebSearch كلٌّ منها على نموذج خاص بها.
  • يبدأ الأمر ccr code جلسة موجَّهة بعنوان أساسي http://127.0.0.1:3456؛ ويبقى الأمر claude العادي يعمل كما هو. ملاحظة معروفة: يبقى /cost عند $0، فتابع الإنفاق من لوحة مزوّدك.

Claude Code Router: Use Gemini 2.5 Pro FREE API in Claude Code

الفيديو الأصلي:AI With Nathan10:52

فتح

claude-code-router — official README

حقائق المنتج:musistudio on GitHubDocs

فتح

اتبع الخطوات واللقطات الفيديو الأصلي؛ أما أسماء حقول config.json وأدوار الموجّه وسلوك المحوِّلات فقد تمت مطابقتها مع ملف README الرسمي.

الإطارات لقطات شاشة منسوبة إلى الفيديو المصدر، وكل منها مربوط بطابعها الزمني. نص هذا الدليل أصلي — وليس نقلًا للكلام.

إعداد Claude Code Router خطوة بخطوة

1 · حوّل Claude Code إلى نماذج أرخص

  1. 1

    لماذا يحتاج Claude Code إلى موجّه

    Claude Code مرتبط بنماذج Claude، وهي باهظة: سعر Opus 4.1 الرسمي 15 دولارًا لكل مليون رمز إدخال و75 دولارًا لمليون رمز إخراج. يحافظ مشروع Claude Code Router (CCR) مفتوح المصدر على تجربة Claude Code لكنه يوجّه كل طلب إلى النموذج الذي تختاره — DeepSeek أو Kimi أو Gemini أو نموذج Ollama محلي.

    Anthropic API pricing page showing Claude Opus 4.1 at 15 dollars per million input tokens and 75 dollars per million output tokens, the cost Claude Code Router helps you avoid
    أسعار Anthropic الرسمية قبل التحول — وهذه هي الفاتورة التي يجنّبها CCR.شاهد عند 0:30
  2. 2

    ثبّت Claude Code ثم الموجّه

    يفترض CCR أن Claude Code مثبّت مسبقًا: npm install -g @anthropic-ai/claude-code. ثم ثبّت الموجّه: npm install -g @musistudio/claude-code-router. سيكون إعداد مزوّديك في ~/.claude-code-router/config.json.

    Claude Code Router README Getting Started section listing npm install -g @anthropic-ai/claude-code and npm install -g @musistudio/claude-code-router
    تثبيتان من README الرسمي — الموجّه لا يستبدل Claude Code أبدًا.شاهد عند 3:36
  3. 3

    دع npm يُتمّ التثبيت الشامل

    يسحب npm اعتماديات الموجّه (تحذير إهمال node-domexception أمر طبيعي). عند الانتهاء يصبح أمر ccr متاحًا في كل مكان.

    Terminal output while npm installs @musistudio/claude-code-router globally with cached package fetches and a node-domexception deprecation warning
    npm ينزّل الحزم أثناء التثبيت الشامل لـ @musistudio/claude-code-router.شاهد عند 3:49

2 · أضف المزوّدين في وحدة ccr ui

  1. 4

    افتح وحدة الإعداد عبر ccr ui

    بدل تحرير JSON يدويًا، شغّل ccr ui. تُفتح تبويب متصفح على 127.0.0.1:3456: المزوّدون على اليسار، وقسم Router على اليمين يخصص نماذج للسيناريوهات، وتحته Custom Transformers.

    Claude Code Router web console from ccr ui on first launch with an empty Providers list and Default, Background, and Think router slots
    التشغيل الأول لوحدة ccr ui — قائمة المزوّدين فارغة وفتحات الموجّه بانتظار النماذج.شاهد عند 4:08
  2. 5

    أضف مزوّدًا من قالب جاهز

    انقر Add Provider واختر قالبًا — يستخدم الفيديو OpenRouter، وتوجد قوالب أيضًا لـ deepseek وgemini وdashscope وmodelscope وsiliconflow وvolcengine. يملأ القالب رابط API وقائمة نماذج افتراضية تلقائيًا، ويمكن ترك المحوِّل فارغًا.

    Add Provider template dropdown in the Claude Code Router console listing dashscope, deepseek, gemini, modelscope, openrouter, siliconflow, and volcengine presets
    قوالب المزوّدين في ccr ui — اختر واحدًا فيُملأ الرابط وقائمة النماذج تلقائيًا.شاهد عند 4:30
  3. 6

    الصق مفتاح API واختر نماذجك

    ثلاثة حقول مهمة فعلًا: رابط API (معبّأ مسبقًا)، والمفتاح السري، وقائمة النماذج. يضيف الفيديو DeepSeek R1 وKimi K2 عبر OpenRouter ثم يحفظ — فيظهر المزوّد في اللوحة اليسرى جاهزًا للتخصيص.

    Edit Provider dialog for the openrouter template showing the pre-filled API Full URL https://openrouter.ai/api/v1/chat/completions, a masked API key field, and the models list
    نموذج Edit Provider: الرابط والمفتاح والنماذج — وكل ما عدا ذلك يبقى افتراضيًا.شاهد عند 4:53
  4. 7

    دع المحوِّلات تعالج اختلافات الـ API

    يعيد المحوِّلات (Transformers) صياغة حمولات الطلب والاستجابة لتبقى واجهات الجهات الخارجية متوافقة مع Claude Code. يأتي CCR بقيم افتراضية مدروسة — مثل محوِّل deepseek لـ api.deepseek.com ومحوِّل tooluse لـ deepseek-chat — فلن تحتاج غالبًا إلى كتابة محوِّل بنفسك.

    Claude Code Router README transformer section with a Model-Specific Transformer example applying the deepseek transformer to the api.deepseek.com provider and deepseek-chat model
    أمثلة المحوِّلات العامة وخاصية النموذج من README، بما في ذلك إعداد DeepSeek الجاهز.شاهد عند 3:54
  5. 8

    أضف مفتاح Gemini مجانيًا لمهام الاستدلال

    أضف مزوّدًا ثانيًا من قالب Gemini وأنشئ مفتاح API مجانيًا في Google AI Studio (Get API key ثم Create API key). الصقه واحفظ — ستحيل قريبًا هذا المزوّد إلى فتحات الاستدلال والسياق الطويل والبحث في الويب.

    Google AI Studio Create API key dialog used to generate the free Gemini API key for the Claude Code Router think and longContext routes
    إنشاء مفتاح Gemini المجاني في Google AI Studio لمزوّد CCR.شاهد عند 5:45

3 · اضبط قواعد التوجيه

  1. 9

    افهم أدوار الموجّه الخمسة

    يتولى default المهام العامة (وكل ما لا تخصصه). ينفّذ background المهام الخلفية — ونموذج صغير أو محلي يوفّر التكلفة هنا. يغطي think الأعمال الاستدلالية الثقيلة مثل Plan Mode. يتفعّل longContext تلقائيًا بعد longContextThreshold (60,000 رمز افتراضيًا)، ويتطلب webSearch نموذجًا يدعم الميزة — في OpenRouter أضف :online إلى اسم النموذج. ويمكن لأمر /model تبديل النموذج في منتصف الجلسة.

    Claude Code Router README describing the Router roles default, background, think, longContext with a 60000 token longContextThreshold, and webSearch with the :online suffix
    كائن Router في README: كل الأدوار وعتبة 60 ألفًا ولاحقة :online.شاهد عند 1:06
  2. 10

    خصّص نموذجًا لكل سيناريو

    في قسم Router اختر من نماذج مزوّديك المحفوظين: يضع الفيديو DeepSeek R1 كافتراضي، وKimi K2 للاستخدام العام، وGemini 2.5 Pro (نافذة مليون رمز) لـ longContext، وGemini Flash السريع لـ webSearch. ثم اضغط Save and Restart أعلى اليمين.

    Claude Code Router console setting openrouter,deepseek/deepseek-r1-0528 as the Default model with the model picker dropdown open over the saved openrouter provider
    تعبئة فتحة Default بالنموذج deepseek/deepseek-r1-0528 من المزوّد المحفوظ.شاهد عند 5:15
  3. 11

    ابدأ الجلسة الموجَّهة بأمر ccr code

    عُد إلى الطرفية وشغّل ccr code. تعرض شاشة ترحيب Claude Code سطر Overrides (via env) — API Base URL http://127.0.0.1:3456 — دليلًا على أن الطلبات تمر الآن عبر الموجّه. ويبقى الأمر claude العادي يبدأ جلسة غير موجَّهة، دون الحاجة إلى إزالة أي شيء.

    Claude Code session launched with ccr code showing Overrides via env with API Base URL http://127.0.0.1:3456, proving requests route through Claude Code Router
    كتلة Overrides في شاشة الترحيب: حركتك تمر الآن عبر الوسيط المحلي لـ CCR.شاهد عند 6:45

4 · شغّل مهمة حقيقية وتحقّق منها

  1. 12

    أعطه مهمة برمجية حقيقية

    اكتب الطلب كالمعتاد — يطلب الفيديو لعبة كسر طوب بنمط النيون وحركات حديثة. يضع Claude Code قائمة مهام وينفذها خطوة بخطوة عبر النماذج الموجَّهة. وتوقع ملاحظات شكلية: قد يتجمد عدّاد رموز الإدخال عند الصفر.

    Claude Code executing a neon brick breaker game todo list inside a session proxied by Claude Code Router
    Claude Code يتقدم في قائمة مهامه بينما يوجّه CCR نداءات النموذج.شاهد عند 7:06
  2. 13

    راجع النتيجة النهائية

    يختم الوكيل بملخص الميزات — مؤثرات بصرية، وتصميم متجاوب، وأدوات تحكم، وميكانيكا لعبة — وتهبط الملفات في مشروعك (index.html وstyle.css وscript.js). افتح ملف HTML في المتصفح وجرّب النتيجة بنفسك.

    Claude Code completion summary for a neon brick breaker game listing visual effects, responsive design, touch controls, and game mechanics
    ملخص الإنجاز من Claude Code للعبة كسر الطوب النيونية.شاهد عند 7:30
  3. 14

    تحقق من الاستخدام الفعلي في لوحة المزوّد

    صفحة Your Activity في OpenRouter هي مصدر الحقيقة: تعرض النداءات الموجَّهة — طلبات Kimi K2 المتكررة ونداء DeepSeek — مع أعداد الرموز والإنفاق. هكذا تتأكد أن CCR يستخدم نماذجك الأرخص فعلًا.

    OpenRouter Your Activity dashboard showing spend, token, and request charts with a Kimi K2 request row after routing Claude Code through Claude Code Router
    استخدام OpenRouter بعد الجلسة: النماذج الموجَّهة تظهر بأعداد طلبات حقيقية.شاهد عند 7:45
  4. 15

    اعرف الهفوات قبل أن تعتمد عليه

    شغّل /cost في جلسة موجَّهة فيعرض $0.0000، ويبيّن الاستخدام حسب النموذج claude-sonnet بصفر — محاسبة التكاليف غير موصولة بعد بالمزوّدين الخارجيين. التوجيه نفسه يعمل جيدًا؛ فقط تابع الإنفاق من لوحة مزوّدك في الوقت الحالي.

    Claude Code /cost command reporting a 0.0000 dollar total and claude-sonnet zero-token usage, the known accounting gap when models are routed externally
    عيب /cost المعروف في الجلسات الموجَّهة — لوحات المزوّدين هي عدّادك الحقيقي.شاهد عند 9:25

الأسئلة الشائعة حول Claude Code Router

تابع الاستكشاف

إعداد DeepSeek Harness: نسخة Claude Code مجانية تملكها بنفسكاستخدم DeepSeek في Cursorدرس Cline + DeepSeekبدائل Roo Codeدليل GLM Coding Planمنشئ التطبيقات DeepSeekكل الأدلة