كيفية استخدام كود كلود مع OpenRouter

إذا كنت تستمتع بسير العمل السلس لأداة Claude Code (أداة سطر الأوامر من Anthropic)، فمن المحتمل أنك تعرف أنها تتوقع تنسيق Anthropic API افتراضيًا. ولكن ماذا لو أردت استخدام نموذج مختلف، أو استكشاف نماذج جديدة غير متاحة عبر واجهة برمجة تطبيقات Anthropic المباشرة؟ وهنا يأتي دور OpenRouter! فهو يوفر وصولًا موحدًا ومتوافقًا مع OpenAI API إلى مئات النماذج من العديد من المزودين المختلفين.

من خلال الربط بين النظامين، يمكنك الحصول على أفضل ما في العالمين: واجهة Claude Code الملائمة للمطورين وكتالوج OpenRouter الواسع من النماذج. هذا التكامل هو ما نشير إليه بـ "Claude Code مع Openrouter."

تكمن الحيلة في استخدام "موجه / وكيل" (router / proxy) يترجم بين تنسيقات واجهة برمجة التطبيقات (API) المختلفة. بمجرد إعداده، يمكنك تشغيل Claude Code كالمعتاد، ولكن مع OpenRouter الذي يدعم الواجهة الخلفية.

💡

هل تريد أداة رائعة لاختبار واجهة برمجة التطبيقات (API) تولد توثيق API جميل؟

هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بأقصى قدر من الإنتاجية؟

يلبي Apidog جميع متطلباتك، ويحل محل Postman بسعر أكثر معقولية بكثير!

زر

المزايا الرئيسية لاستخدام Claude Code مع Openrouter

يفتح الجمع بين Claude Code و Openrouter مجموعة من الفوائد القوية:

الوصول إلى أكثر من 400 نموذج — بما في ذلك إصدارات Claude، ونماذج بأسلوب GPT، ونماذج اللغات الكبيرة مفتوحة المصدر (LLMs)، والمزيد.
لا حاجة للاشتراك في Anthropic — تدفع فقط مقابل ما تستخدمه عبر تسعير Openrouter بالدفع حسب الاستخدام.
تبديل النماذج بمرونة — يمكنك تغيير النماذج أثناء الجلسة في Claude Code باستخدام /model، أو التوجيه بناءً على نوع المهمة (خفيفة الوزن مقابل التفكير، التكلفة مقابل الأداء).
تحسين التكلفة — نماذج منخفضة التكلفة أو مجانية للمهام الروتينية، ونماذج قوية عند الحاجة فقط: مثالية للمطورين المهتمين بالميزانية.
التوجيه المحلي أو القائم على السحابة — تشغيل كل شيء محليًا للخصوصية، أو استضافة الموجه الخاص بك للاستخدام المشترك للفريق، أو CI/CD، أو الأتمتة السحابية.
الأدوات والمرونة — تدعم بعض أجهزة التوجيه ميزات متقدمة مثل البث، والنموذج الاحتياطي (model fallback)، وتعدد الإرسال لمقدمي الخدمات المتعددين، والتكامل مع سير عمل التطوير الأوسع.

انقر لعرض المزيد حول Claude Code

المتطلبات الأساسية

قبل أن تبدأ، تأكد من توفر لديك:

1. Claude Code مثبتًا عالميًا (على سبيل المثال عبر npm install -g @anthropic-ai/claude-code).

2. حساب Openrouter مع مفتاح API صالح (sk-or-...) (أنشئ حسابًا على OpenRouter).

3. أداة موجه/وكيل (router/proxy) (Docker هو الأسهل، ولكن الموجهات القائمة على Node.js تعمل أيضًا) للتعامل مع تحويل التنسيقات.

4. الراحة الأساسية في استخدام متغيرات البيئة و سطر الأوامر.

باستخدام هذا الإعداد، ستتمكن من توجيه Claude Code إلى الموجه — الذي بدوره يقوم بإعادة توجيه الطلبات إلى Openrouter ويعيد الردود.

الطريقة الأولى: y-router (الأبسط والأكثر توصية)

أحد أجهزة التوجيه الأكثر استخدامًا لهذا الإعداد هو y-router. يعمل كمترجم بين تنسيق واجهة برمجة التطبيقات الذي تتوقعه Anthropic وتنسيق واجهة برمجة تطبيقات OpenRouter على غرار OpenAI (عرض المستودع على: GitHub). إليك كيفية القيام بذلك خطوة بخطوة باستخدام y-router:

1. نشر y-router محليًا (Docker موصى به):

git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

هذا يشغل خدمة موجه محلية تستمع (افتراضيًا) على http://localhost:8787.

2. تهيئة متغيرات البيئة لديك بحيث يرسل Claude Code طلباته إلى y-router، وليس مباشرة إلى Anthropic:

export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-openrouter-key>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"   # لنموذج سريع وخفيف الوزن
# أو export ANTHROPIC_MODEL="z-ai/glm-4.5"   # لنموذج أكثر قوة

3. تشغيل Claude Code:

claude

ستبدأ الواجهة كالمعتاد. إذا كتبت /model، فسترى النموذج المدعوم بواسطة Openrouter محددًا. تهانينا — أنت الآن تستخدم Claude Code مع Openrouter. (ishan.rs)

تحافظ هذه الطريقة على التوجيه محليًا وبسيطًا وتحت سيطرتك — وهي مثالية للمطورين الذين يفضلون الخصوصية والحد الأدنى من الأعباء الإضافية.

الطريقة الثانية: Claude Code Router (قائم على npm، غني بالميزات)

إذا كنت تفضل عدم استخدام Docker، فهناك خيار قوي آخر: Claude Code Router — أداة توجيه قائمة على Node.js مصممة لمنح Claude Code إمكانية الوصول إلى الموفرين الخارجيين (عرض المستودع على GitHub). إليك كيفية إعداده:

1. التثبيت عالميًا:

npm install -g @musistudio/claude-code-router

ثم أنشئ ملف تهيئة (على سبيل المثال ~/.claude-code-router/config.json) بإعداداتك ونماذجك المفضلة. يدرج العديد من المستخدمين Openrouter كمزود، مع تحديد مفتاح API الخاص بهم وإدراج النماذج المدعومة (مزيد من التفاصيل حول هذه الطريقة على lgallardo.com).

2. بدء تشغيل الموجه:

ccr start

بمجرد التشغيل، قم بتعيين ANTHROPIC_BASE_URL إلى عنوان URL الخاص بالموجه واستخدم claude كالمعتاد. سيقوم الموجه بترجمة الطلبات والسماح بالتبديل الديناميكي بين النماذج — بما في ذلك سلوك الاحتياطي وقواعد التوجيه والمزيد.

هذه الطريقة قوية إذا كنت تريد مزيدًا من التحكم في توجيه النماذج، أو سياسات التراجع (fallback policies)، أو التكامل في سلاسل الأدوات الأكبر (مثل CI/CD، أو البرامج النصية الآلية، أو التجارب متعددة النماذج).

الطريقة الثالثة: وكيل Openrouter المباشر (إعداد بسيط للاختبار السريع)

إذا كنت ترغب فقط في إجراء فحص أو اختبار سريع — دون تشغيل موجه كامل — يمكنك محاولة توجيه Claude Code مباشرة إلى وكيل متوافق مع Openrouter أو محول بسيط. توجد بعض الحلول المجتمعية لتسهيل ذلك (عرض مستودعهم على GitHub).

على سبيل المثال، يمكنك تعيين:

export ANTHROPIC_BASE_URL="https://proxy-your-choice.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-key>"
export ANTHROPIC_MODEL="openrouter/model-name"

ثم قم بتشغيل Claude Code. هذا النهج مفيد للاختبارات العابرة أو التجارب السريعة. ومع ذلك، قد يفتقر إلى المتانة (على سبيل المثال للبث، أو استدعاء الأدوات، أو الجلسات طويلة الأمد)، اعتمادًا على تنفيذ الوكيل.

أفضل الممارسات والنصائح لتجربة سلسة

التحقق من توافق النموذج — لا تدعم جميع النماذج الميزات المتقدمة مثل استدعاء الأدوات أو نوافذ السياق الطويلة. استخدم النماذج الأخف للمهام البسيطة، والنماذج الأكثر قدرة للمهام الثقيلة مثل التفكير أو البرمجة.
تأمين مفتاح API الخاص بك — تعامل مع مفتاح API الخاص بـ Openrouter وكأنه سر؛ قم بتخزينه بأمان ولا تكشفه أبدًا من جانب العميل.
إدارة التكاليف — راقب استخدام الرمز المميز (token) عند استخدام النماذج الكبيرة؛ فكر في التخزين المؤقت للمطالبات، أو النماذج الاحتياطية، أو التوجيه القائم على المهام لتحسين توازن التكلفة/الأداء.
اختبار إعداد التوجيه — بعد التهيئة، قم دائمًا بالاختبار باستخدام أوامر بسيطة (مثل claude --model <model>) للتأكد من أن كل شيء يتم توجيهه بشكل صحيح.
استخدام التوجيه الاحتياطي للموثوقية — في إعدادات النماذج المتعددة، قم بتهيئة خيارات الاحتياطي بحيث إذا كان أحد النماذج غير متاح، يمكن للموجه التبديل إلى آخر تلقائيًا.

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

س1. هل أحتاج إلى الدفع لـ Anthropic لاستخدام Claude Code مع Openrouter؟
لا. عند التكوين باستخدام Openrouter (عبر موجه أو وكيل)، يستخدم Claude Code مفتاح API الخاص بـ Openrouter للطلبات — لا تحتاج إلى اشتراك مدفوع في Anthropic.

س2. هل يمكنني تبديل النماذج بسرعة داخل نفس جلسة Claude Code؟
نعم. تسمح العديد من أجهزة التوجيه (و Claude Code نفسه) بالتبديل بين النماذج باستخدام /model <model_name>. يعمل هذا في منتصف المحادثة في معظم الحالات.

س3. هل جميع النماذج في Openrouter متوافقة مع ميزات Claude Code (مثل تنفيذ الأدوات، البث)؟
ليس دائمًا. قد لا تدعم بعض النماذج "النصية فقط" أو الأخف وزنًا استدعاء الأدوات، أو السياق الطويل، أو البث. لسير العمل المعقد، استخدم النماذج المعروفة بدعم هذه الميزات.

س4. هل الموجه المحلي لـ Docker أكثر أمانًا من الموجه المستضاف؟
نعم بشكل عام. يمنحك تشغيل موجه محلي تحكمًا كاملاً ويتجنب كشف مفتاح API الخاص بك لخدمات خارجية. الموجهات المستضافة مريحة ولكنها قد تشكل مقايضات في الأمان أو الموثوقية.

س5. هل يمكنني دمج هذا الإعداد في CI/CD أو سير العمل الآلي؟
بالتأكيد. تدعم أدوات مثل Claude Code Router ملفات التكوين ومتغيرات البيئة، مما يجعلها سهلة الدمج في خطوط الأتمتة (GitHub Actions، البرامج النصية، إلخ).

الخلاصة

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

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

جربها: قد يتم تشغيل جلسة التعليمات البرمجية التالية قريبًا بواسطة نموذج لم تعتقد أنه ممكن أبدًا — كل ذلك تحت واجهة Claude Code المألوفة.

💡

زر