يرسل 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.
