BroadRouter
ابدأ الآن

Claude Code مع النماذج المفتوحة: الوكلاء ونقاط النهاية الأصلية والحدود

بقلم فريق BroadNet Inference · قراءة في 6 دقائق · تاريخ النشر

يرسل Claude Code طلبات بصيغة Anthropic Messages API إلى ANTHROPIC_BASE_URL. لاستخدام مزود متوافق مع OpenAI، شغّل وكيل ترجمة (proxy) مثل LiteLLM ووجّه Claude Code إليه، أو اختر مزودًا لديه نقطة نهاية خاصة بصيغة Anthropic مثل DeepSeek أو Z.ai. لا تدعم Anthropic النماذج غير Claude في Claude Code، لذا اختبر الأدوات والتخزين المؤقت وحدود السياق بنفسك.

يرسل Claude Code كل طلب بصيغة Anthropic Messages API، إلى /v1/messages على أي عنوان يشير إليه ANTHROPIC_BASE_URL. أما معظم مزودي النماذج المفتوحة، ومنهم BroadNet Inference، فيتحدثون صيغة OpenAI. لذا تحتاج إما إلى وكيل (proxy) يترجم بين الصيغتين، أو إلى مزود ينشر نقطة نهاية خاصة به بصيغة Anthropic. يغطي هذا المقال الخيارين، إضافة إلى الحدود التي تقرر ما إذا كان الأمر يستحق العناء.

لماذا لا يستطيع Claude Code استدعاء واجهة API متوافقة مع OpenAI مباشرة؟

يسرد دليل توافق البوابات في Claude Code الصيغ التي يجب أن تقدّمها البوابة. وفي حالة العنوان الأساسي البسيط، هذه الصيغة هي Anthropic Messages: /v1/messages، مع /v1/messages/count_tokens اختياريًا، وتمرير ترويستَي anthropic-beta وanthropic-version. أما واجهة API المتوافقة مع OpenAI فتقدّم /v1/chat/completions بشكل مختلف للطلب والاستجابة. وجّه Claude Code إليها مباشرة وستفشل الطلبات.

وأمر آخر يجب أن تعرفه قبل أن تبدأ. يقول توثيق Claude Code نفسه إن Anthropic “doesn’t support routing Claude Code to non-Claude models through any gateway.” (الترجمة: لا تدعم توجيه Claude Code إلى نماذج غير Claude عبر أي بوابة). يفعل ذلك كثيرون على أي حال، لكن لن يتتبّع أحد في Anthropic الأعطال نيابة عنك.

ما خياراتك الثلاثة؟

المسار كيف يعمل الأنسب لـ المقابل
وكيل ترجمة (LiteLLM) يتحدث Claude Code بصيغة Anthropic مع وكيل محلي؛ ويستدعي الوكيل المزود المتوافق مع OpenAI استخدام مزود معيّن متوافق مع OpenAI، مثل BroadNet عملية إضافية تشغّلها وتحدّثها؛ وفجوات في الترجمة
نقطة نهاية أصلية بصيغة Anthropic يقبل المزود /v1/messages بنفسه نماذج DeepSeek أو GLM من الشركات المطوّرة لها كل مزود يربط بعض الحقول أو يتجاهلها
وكيل برمجة آخر استخدم وكيلًا يقبل عنوانًا أساسيًا متوافقًا مع OpenAI كل من لا يحتاج إلى Claude Code تحديدًا تتخلى عن واجهة Claude Code وميزاته

كيف تشغّل Claude Code عبر LiteLLM؟

يعمل الدرس التعليمي في LiteLLM للنماذج غير Anthropic هكذا: ثبّت الوكيل، وعرّف النماذج في config.yaml، وشغّله، ثم اضبط متغيرين في Claude Code. يترجم LiteLLM بين الصيغتين، فيستمر Claude Code في إرسال طلبات Anthropic.

عرّف نماذج BroadNet بالطريقة نفسها المتبعة في دليل LiteLLM، مع البادئة openai/ وapi_base:

model_list:
  - model_name: glm
    litellm_params:
      model: openai/broadnet/glm-5.3
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30
  - model_name: qwen
    litellm_params:
      model: openai/broadnet/qwen3.8-27b
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30

general_settings:
  master_key: os.environ/LITELLM_MASTER_KEY

شغّل الوكيل:

uv tool install 'litellm[proxy]'
export BROADNET_API_KEY='your-broadnet-key'
export LITELLM_MASTER_KEY='sk-any-local-secret'
litellm --config config.yaml   # listens on http://0.0.0.0:4000

ثم وجّه Claude Code إليه. يُرسَل ANTHROPIC_AUTH_TOKEN كترويسة Authorization: Bearer، وهي ما يقرؤه LiteLLM:

export ANTHROPIC_BASE_URL=http://0.0.0.0:4000
export ANTHROPIC_AUTH_TOKEN="$LITELLM_MASTER_KEY"
export ANTHROPIC_MODEL=glm                  # main model
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen   # background tasks
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm   # the sonnet alias
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm     # the opus alias
export CLAUDE_CODE_SUBAGENT_MODEL=glm       # subagents
claude

نفّذ /status في Claude Code. يجب أن يُظهر سطر Anthropic base URL عنوان الوكيل.

متغيرات النموذج مهمة. تحذّر صفحة Claude Code في توثيق LiteLLM من أن اختيار اسم Claude مدمج غير معرّف في إعداداتك يفشل برسالة “Invalid model name passed in” (الترجمة: مُرّر اسم نموذج غير صالح). ويقول مرجع متغيرات البيئة في Claude Code إن ANTHROPIC_DEFAULT_HAIKU_MODEL يُستخدم أيضًا للوظائف التي تعمل في الخلفية، فاربطه هو الآخر، وإلا طلبت طلبات الخلفية اسم Haiku لا يعرفه الوكيل. ويحدد CLAUDE_CODE_SUBAGENT_MODEL النموذج الافتراضي للوكلاء الفرعيين، لكن النموذج الذي يمرّره Claude عند إنشاء وكيل فرعي، وغالبًا ما يكون اسمًا مستعارًا مثل sonnet أو haiku، له الأولوية. وربط الاسمين المستعارين sonnet وopus أيضًا يعني أن تلك الطلبات ستُحلّ إلى نموذج يعرفه الوكيل. واحفظ مفتاح BroadNet في بيئة الوكيل، لا في ملف .claude/settings.json المحفوظ في مستودع المشروع.

أي نقاط نهاية DeepSeek وGLM تعمل دون وكيل؟

تنشر شركتان مطوّرتان للنماذج عناوين أساسية بصيغة Anthropic:

المزود العنوان الأساسي التعامل مع النماذج (من توثيقهما، تاريخ المراجعة 2026-11-15)
DeepSeek https://api.deepseek.com/anthropic الأسماء claude-sonnet* وclaude-haiku* تُربط بـ deepseek-flash؛ وclaude-opus* تُربط بـ deepseek-v4-pro؛ والأسماء التي لا تبدأ بـ claude تُرجع 400
Z.ai (GLM Coding Plan) https://api.z.ai/api/anthropic المفتاح في ANTHROPIC_AUTH_TOKEN؛ ومثال الإعداد اليدوي يربط Opus وSonnet بـ glm-5.3[1m] وHaiku بـ glm-5.3-flash[1m]

تقول ملاحظة الإصدار من DeepSeek بتاريخ 10 سبتمبر 2026 إن deepseek-flash يقدّم DeepSeek-V4.1-Flash. وتسرد صفحة Anthropic API لديها أيضًا ما تتجاهله، ومنه: cache_control وbudget_tokens وdisable_parallel_tool_use وترويسة anthropic-version. وعلى deepseek-flash تُرجع الصور في رسائل المساعد الخطأ 400، بينما يستبدل deepseek-v4-pro الصور بالنص “[Unsupported Image]”.

إذا كنت تريد DeepSeek أو GLM فقط في Claude Code، فنقاط النهاية الأصلية هذه هي أقصر طريق. وتجد مقارنة الأسعار وحدود الخطط لكليهما في صفحة بدائل Claude API.

ما الذي يتعطل أو يتغير مع نموذج غير Claude؟

الترجمة تُبقي الطلبات تتدفق، لكن عدة ميزات في Claude Code تعتمد على أشياء قد لا يمرّرها الوكيل أو النموذج الآخر. يسمّيها توثيق Claude Code:

  • التخزين المؤقت للأوامر. يضع Claude Code الوسم cache_control على كتل system والرسائل. إذا أسقطته البوابة أو المزود، فلن يظهر خطأ، لكن كل دور سيُحتسب كإدخال غير مخزّن مؤقتًا. ومع مزود متوافق مع OpenAI، يتبع التخزين المؤقت قواعد ذلك المزود. تحتسب BroadNet الإدخال المخزّن مؤقتًا بسعر أقل حين تُبلغ كتلة usage لديها عن إصابة في الذاكرة المؤقتة؛ تحقّق من cached_tokens في سجلاتك.
  • عدّ الرموز. من دون /v1/messages/count_tokens يلجأ Claude Code إلى تقدير قائم على عدد الأحرف، فيصبح /context تقريبيًا.
  • نافذة السياق. يطبّق Claude Code نافذته الافتراضية على أسماء النماذج التي لا يعرفها. اضبط CLAUDE_CODE_AUTO_COMPACT_WINDOW (من 100,000 إلى 1,000,000 رمز) بما يناسب النموذج. ومع Qwen3.8 27B، وسياقه 262,144 رمزًا، اضبطه أقل من ذلك بكثير.
  • الحقول غير المعروفة. خطأ 400 يذكر Extra inputs are not permitted أو قيمة anthropic-beta يعني أن جهة في المسار رفضت حقلًا تجريبيًا لم يُطلق بعد. ويقترح التوثيق CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1.
  • التفكير. MAX_THINKING_TOKENS والتفكير التكيّفي ميزتان خاصتان بـ Claude. على BroadNet، تستدل نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B منطقيًا قبل أن تجيب، وتُحتسب رموز الاستدلال المنطقي هذه ضمن max_tokens. إذا عادت الإجابات فارغة، فارفع حد الإخراج أو أرسل reasoning_effort منخفضًا. راجع لماذا تُرجع نماذج الاستدلال المنطقي إجابات فارغة.
  • الصور. GLM 5.3 نصي فقط على BroadNet. استخدم Qwen3.8 27B إذا كنت تلصق لقطات شاشة.

اختبر مهمة حقيقية من البداية إلى النهاية، بتعديل ملفات وأوامر طرفية وجلسة طويلة، قبل أن تعتمد عليه.

أي نموذج من BroadNet يناسب العمل خلف Claude Code؟

يقرأ Claude Code الملفات ويعدّلها وينفّذ الأوامر عبر استدعاءات الأدوات. ويوثّق المرجع التقني لـ BroadNet الأدوات والمخرجات المنظَّمة والاستدلال المنطقي لنموذجين:

النموذج الإدخال / الإخراج لكل مليون رمز السياق الصور الأدوات موثّقة
GLM 5.3 $0.78 / $3.46 1,048,576 لا نعم
Qwen3.8 27B $0.175 / $2.17 262,144 نعم نعم
DeepSeek V4.1 Flash $0.175 / $0.52 1,048,576 نعم غير موثّقة

GLM 5.3 هو النموذج الرئيسي الطبيعي للمستودعات الكبيرة. وQwen3.8 27B أرخص لكل رمز إدخال ويصلح للصور واستدعاءات الخلفية الأخف. وكلاهما يحتاج إلى شحن الرصيد؛ فلا يغطيهما الرصيد المبدئي البالغ $5. وتعرض مقارنة GLM 5.3 مع Qwen3.8 27B النموذجين جنبًا إلى جنب.

هل يمكنك استخدام خطة BroadNet الثابتة مع Claude Code؟

ليس كاستخدام موثّق، ومن الأفضل أن تعرف ذلك قبل الشراء. خطط البدر (Full Moon) والمدار (Orbit) والشهاب (Meteor) تغطي DeepSeek V4.1 Flash فقط، ولا توثّق BroadNet استدعاء الأدوات له. كما أن كل جلسة خطة تشغّل طلبًا واحدًا في كل مرة. ويستطيع Claude Code تشغيل وكلاء فرعيين ومهام خلفية بجانب الحلقة الرئيسية، وهذه الطلبات ستصطف في طابور على جلسة واحدة.

إذا كان السعر الثابت هو ما تريده، فاستخدم وكيلًا توثّقه BroadNet مع الخطة، مثل Aider. أما مع Claude Code فاستخدم GLM 5.3 أو Qwen3.8 27B بالدفع حسب الاستخدام، بحد 30 طلبًا في الدقيقة و4 طلبات قيد التنفيذ لكل مفتاح. وانتظر ثم أعد المحاولة عند 429 كما في الأخطاء وإعادة المحاولة.

متى يكون وكيل آخر هو الخيار الأفضل؟

إذا لم تكن تحتاج إلى Claude Code نفسه، فاستغنِ عن الوكيل الوسيط. opencode وCline وRoo Code وContinue وAider كلها تقبل مباشرة عنوانًا أساسيًا متوافقًا مع OpenAI ومفتاحًا ومعرّف نموذج. أسماء الحقول لكل منها في النماذج المفتوحة في وكلاء البرمجة، مع أدلة إعداد لـ opencode وCline. وأجزاء متحركة أقل تعني أعطال ترجمة أقل. ولمقارنة النماذج لهذا العمل، راجع أفضل نموذج مفتوح لوكلاء البرمجة.

ابقَ على نماذج Claude إذا كان عملك يعتمد على ميزات خاصة بـ Claude مثل التفكير الممتد أو التخزين المؤقت للأوامر لدى Anthropic أو أحدث الميزات التجريبية في Claude Code. وفي هذه الحالة، خفّض التكاليف داخل Claude Code بدلًا من تبديل النموذج.

أين تقع BroadNet Inference؟

BroadNet Inference واجهة API متوافقة مع OpenAI، لذا لا تصل إلى Claude Code إلا عبر وكيل مثل LiteLLM. وخلفه يكون GLM 5.3 وQwen3.8 27B هما النموذجين اللذين لديهما استدعاء أدوات موثّق، ويُحتسبان لكل رمز دون الاحتفاظ بأي محتوى بعد الطلب. وإذا أردت نقطة نهاية أصلية بصيغة Anthropic، فإن DeepSeek وZ.ai أبسط. وإذا أردت خطة BroadNet الثابتة، فاقرنها بوكيل برمجة يتحدث صيغة OpenAI.

أسئلة شائعة

هل يمكن تشغيل Claude Code مع DeepSeek؟

نعم، بطريقتين. تنشر DeepSeek عنوانًا أساسيًا بصيغة Anthropic هو https://api.deepseek.com/anthropic، يربط أسماء claude-sonnet وclaude-haiku بالنموذج deepseek-flash وأسماء claude-opus بالنموذج deepseek-v4-pro. أو تضع وكيل ترجمة مثل LiteLLM أمام أي مزود متوافق مع OpenAI يستضيف نماذج DeepSeek.

هل يعمل Claude Code مع واجهة API متوافقة مع OpenAI؟

ليس مباشرة. يرسل Claude Code طلبات Anthropic Messages API إلى /v1/messages. ويستقبل وكيل مثل LiteLLM هذه الطلبات ويحوّلها إلى نقطة نهاية /chat/completions بأسلوب OpenAI، ثم يترجم الرد عائدًا.

هل تدعم Anthropic استخدام Claude Code مع نماذج أخرى؟

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

أي نموذج من BroadNet أضعه خلف Claude Code؟

GLM 5.3 أو Qwen3.8 27B. توثّق BroadNet استدعاء الأدوات لهذين النموذجين فقط، وClaude Code يعدّل الملفات وينفّذ الأوامر عبر الأدوات. لدى GLM 5.3 سياق بحجم 1,048,576 رمزًا؛ ولدى Qwen3.8 27B سياق بحجم 262,144 ويقبل الصور.

هل يمكنني تشغيل Claude Code على خطة BroadNet غير المحدودة؟

ليس كاستخدام موثّق. الخطط الثابتة تغطي DeepSeek V4.1 Flash فقط، ولا توثّق BroadNet استدعاء الأدوات لهذا النموذج. كما أن جلسة الخطة تشغّل طلبًا واحدًا في كل مرة، بينما يستطيع Claude Code تشغيل وكلاء فرعيين بالتوازي.

لماذا يقول Claude Code «Invalid model name» عبر LiteLLM؟

طلب Claude Code اسم نموذج غير معرّف في config.yaml لديك، وغالبًا ما يكون اسمًا مستعارًا مدمجًا لـ Claude أو نموذج Haiku الذي يعمل في الخلفية. اضبط ANTHROPIC_MODEL وANTHROPIC_DEFAULT_HAIKU_MODEL على أسماء من model_list لديك.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity