guides

كيف توفّر 90% من فاتورة Claude Code: OpenRouter وOllama وLiteLLM

بقلم Mert Batur
تم التحديث Jul 5, 2026
14 قراءة
كيف توفّر 90% من فاتورة Claude Code: OpenRouter وOllama وLiteLLM

يأتي Claude Code مع نماذج Anthropic، لكن متغير بيئة واحد -- ANTHROPIC_BASE_URL -- يتيح لك توجيه الطلبات إلى أي مزود LLM تقريبًا. هذا يعني أنك تستطيع التبديل إلى DeepSeek بتكلفة 0.27 دولار تقريبًا لكل مليون رمز مُخرج بدلًا من Claude Opus بـ 25 دولارًا، أو تشغيل النماذج محليًا عبر Ollama مجانًا. يغطي هذا الدليل كل طريقة لاستخدام نماذج مختلفة في Claude Code، بناءً على مقارنتنا التفصيلية لـ Claude Code مع إعداد عملي لكل نهج.

كل الطرق في لمحة واحدة

اختر الطريقة التي تناسب وضعك، ثم انتقل إلى قسمها للحصول على كود الإعداد.

الطريقةالأفضل لـالتكلفةالإعدادالنماذج
OpenRouterتنوع النماذج، مفتاح API واحددفع لكل رمز (مرور مباشر)سهل300+
Ollamaالخصوصية، مجاني، بدون إنترنتمجاني (أجهزتك الخاصة)سهل50+ مفتوحة المصدر
LM Studioنماذج محلية مع واجهة رسوميةمجاني (أجهزتك الخاصة)سهل50+ مفتوحة المصدر
claude-code-routerالتوجيه الذكي حسب المهمةيتفاوت حسب المزودمتوسطيعتمد على الإعداد
claude-code-proxyخلفية Gemini/OpenAIأسعار المزودمتوسطOpenAI + Gemini
LiteLLMالمؤسسات، موازنة الحملأسعار المزودمتقدم100+ عبر مزودين متعددين

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

كيف يعمل تبديل نماذج Claude Code فعليًا؟

قبل تهيئة أي بروكسي، عليك أن تفهم لماذا تتركك معظم الأدلة التعليمية بإعداد معطوب. يستخدم Claude Code داخليًا ثلاثة فتحات نموذج -- وليس واحدة:

  • فتحة Haiku -- المهام في الخلفية كتلخيص الملفات واستكمال علامات التبويب
  • فتحة Sonnet -- البرمجة الافتراضية، النموذج الذي تتفاعل معه أكثر
  • فتحة Opus -- الاستدلال المعقد والتخطيط والمهام العميلة متعددة الخطوات

عندما تغير النموذج باستخدام /model أو --model، أنت تغير الفتحة الأساسية فحسب. يستمر Claude Code في محاولة استدعاء الفتحتين الأخريين باستخدام API الخاصة بـ Anthropic. إذا وجّهت ANTHROPIC_BASE_URL إلى بروكسي لكنك حددت نموذجًا واحدًا فقط، ستفشل تلك الفتحات الأخرى بخطأ "model not found".

الحل: اضبط جميع متغيرات البيئة الثلاثة حتى تمر كل فتحة عبر بروكسيك.

bash
# اضبط الثلاث فتحات لتمر عبر بروكسيك
export ANTHROPIC_DEFAULT_HAIKU_MODEL="مكافئ-haiku-الخاص-بك"
export ANTHROPIC_DEFAULT_SONNET_MODEL="مكافئ-sonnet-الخاص-بك"
export ANTHROPIC_DEFAULT_OPUS_MODEL="مكافئ-opus-الخاص-بك"
<!-- IMAGE: Architecture diagram showing Claude Code request routing through ANTHROPIC_BASE_URL to multiple providers (OpenRouter, Ollama, LiteLLM, claude-code-router) -->

تبديل النماذج الأصلي (نماذج Anthropic)

إذا بقيت داخل عائلة نماذج Anthropic، فإن التبديل سهل. استخدم أمر /model داخل Claude Code، أو مرر --model عند التشغيل من الطرفية، أو أضف النماذج إلى مصفوفة availableModels في ملف الإعدادات الخاص بك. تستمر Anthropic في إضافة خيارات هنا، ويتتبع ملخصنا لـأحدث ميزات Claude Code لعام 2026 ما صدر مؤخراً.

استراتيجية opusplan

opusplan هو التوجيه متعدد النماذج المدمج في Claude Code. يرسل المهام الخلفية إلى Haiku ويوجّه الاستدلال المعقد إلى Opus -- تلقائيًا. لا تحتاج إلى تهيئته يدويًا؛ فقط اختره نموذجًا. إنه رد Anthropic الخاص على مشكلة "لماذا أدفع أسعار Opus لقائمة ملفات؟". يستحق التجربة قبل اللجوء إلى موجّه خارجي، إلى جانب الوضع السريع من Anthropic إذا كانت السرعة الخام أولويتك.

OpenRouter -- مفتاح API واحد، 300+ نموذج

يعمل OpenRouter كمجمِّع API. تحصل على مفتاح API واحد والوصول إلى 300+ نموذج من Anthropic وGoogle وMeta وMistral وDeepSeek والمزيد. التسعير بالمرور المباشر لمعظم النماذج -- دون هامش ربح.

خطوات الإعداد

  1. أنشئ حسابًا على openrouter.ai وأنشئ مفتاح API
  2. شغّل claude /logout لمسح أي جلسة Anthropic موجودة
  3. اضبط متغيرات البيئة الخاصة بك:
bash
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_API_KEY="sk-or-v1-مفتاحك-هنا"

# عيّن خريطة الثلاث فتحات
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-chat-v3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4"
  1. شغّل claude وتحقق من الاتصال

لاحظ متغيرات الفتحات الثلاثة -- إذا أغفلتها ستواجه خطأ "model not found" الذي تناولناه أعلاه. يؤكد دليل تكامل OpenRouter الرسمي هذا الإعداد.

النماذج الموصى بها عبر OpenRouter

لا يتعامل كل نموذج على OpenRouter مع استدعاء أدوات Claude Code بشكل موثوق. إليك ما يعمل بشكل جيد فعلًا:

المهمةالنموذجلماذا
المهام الخلفية الرخيصةDeepSeek V3.20.27 $/1.10 $ لكل MTok، استدعاء أدوات لائق
البرمجة الافتراضيةClaude Sonnet 4نفس جودة الاتصال المباشر، فوترة موحدة
قواعد الكود الضخمة (سياق 1M)Gemini 2.5 Flash0.15 $/0.60 $ لكل MTok، نافذة سياق ضخمة
الاستدلال المعقدClaude Opus 4أفضل جودة برمجة عميلة

التكلفة والفوترة

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

الحكم: OpenRouter هو الخيار الأفضل للمطورين الذين يريدون أقصى تنوع في النماذج مع أدنى إعداد. مفتاح API واحد، لوحة فوترة واحدة، 300+ نموذج. يصعب منافسته من حيث المرونة.

Ollama -- مجاني ومحلي وخاص

يشغّل Ollama النماذج بالكامل على جهازك. منذ الإصدار v0.14.0 (يناير 2026)، يدعم Anthropic Messages API محليًا، مما يعني أن Claude Code يمكنه التواصل معه دون أي طبقة ترجمة. لا يغادر كودك جهازك أبدًا.

المتطلبات المسبقة والأجهزة

ستحتاج إلى أجهزة جيدة لتجربة مقبولة:

  • نماذج 7B (تعديلات سريعة، مهام بسيطة): 16 جيجابايت RAM كحد أدنى
  • نماذج 14B (جودة برمجة جيدة): 32 جيجابايت RAM، GPU مُوصى به
  • نماذج 32B+ (جودة قريبة من السحابة): 64 جيجابايت RAM أو GPU مخصص بـ 24 جيجابايت+ VRAM. للمزيد من التفاصيل، راجع مقارنة Windsurf و Cursor.

للتعمق أكثر في متطلبات الأجهزة واختيار النموذج، راجع دليلنا لتشغيل LLMs محليًا.

خطوات الإعداد

  1. ثبّت Ollama من ollama.com
  2. احضر نموذجًا يركز على البرمجة
  3. شغّله مع توافق Claude Code
  4. اضبط متغيرات البيئة الخاصة بك
bash
# ثبّت واحضر نموذج برمجة
ollama pull qwen2.5-coder:14b

# شغّل مع توافق Claude Code
ollama launch claude

# اضبط متغيرات البيئة
export ANTHROPIC_BASE_URL="http://localhost:11434"
export ANTHROPIC_API_KEY="ollama"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen2.5-coder:14b"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen2.5-coder:14b"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen2.5-coder:14b"

توصي وثائق تكامل Ollama باستخدام نماذج بنوافذ سياق تزيد عن 64k رمز لأفضل تجربة مع Claude Code.

أفضل النماذج المحلية للبرمجة

النموذجالحجمالقوةملاحظات
Qwen 2.5 Coder 14B14Bأفضل برمجة محلية بشكل عاماستدعاء أدوات قوي، تعامل جيد مع السياق
devstral24Bمتخصص برمجة من Mistralرائع لإعادة الهيكلة ومراجعة الكود
GLM 4.79Bاستدلال عامتوازن جيد بين السرعة والجودة

كن صادقًا مع نفسك بشأن شيء واحد: تنتج النماذج المحلية جودة كود أقل بشكل ملحوظ من Claude Sonnet في المهام العميلة المعقدة متعددة الخطوات. استدعاء الأدوات أقل موثوقية، وستشاهد مسارات ملفات وهمية أكثر. إنها رائعة للتعديلات السريعة والتوليد البسيط والعمل الحساس للخصوصية -- لكن لا تتوقع جودة Claude الأصيلة في إعادة هيكلة 50 ملفًا.

الحكم: Ollama هو الخيار الأفضل للعمل الحساس للخصوصية والمطورين الذين يريدون استخدامًا مجانيًا وغير محدود. إذا كانت لديك الأجهزة، يصعب الاعتراض على "صفر دولار إلى الأبد."

Ollama Cloud مقابل OpenRouter: الأسعار ومتى يفوز كل منهما

يحل Ollama وOpenRouter مشكلة التكلفة من طرفين متعاكسين. يشغّل Ollama النماذج على أجهزة تتحكم بها بتكلفة صفرية لكل رمز، بينما يفرض OpenRouter تسعيراً بالمرور المباشر عبر أكثر من 300 نموذج مستضاف دون أي أجهزة لإدارتها. يُعِدّ هذا الدليل Ollama محلياً، وتنطبق نفس معادلة التكلفة الثابتة مقابل التكلفة لكل رمز إذا شغّلت مستواه المُستضاف بدلاً من ذلك.

العاملOllamaOpenRouter
نموذج التكلفةمجاني محلياً، تدفع مقابل الأجهزةمرور مباشر لكل رمز، بدون هامش ربح على معظم النماذج
مثال على السعر0 $ لكل رمزDeepSeek V3.2 بسعر 0.27 $/1.10 $، Gemini 2.5 Flash بسعر 0.15 $/0.60 $ لكل MTok
الأجهزة16 جيجابايت RAM (7B) وصولاً إلى 24 جيجابايت+ VRAM (32B+)لا شيء، مُستضاف بالكامل
الوصول للنماذج50+ نموذج مفتوح المصدر300+ عبر المزودين
الخصوصيةلا يغادر كودك جهازك أبدًاتمر الطلبات عبر OpenRouter

اختر Ollama عندما تهم الخصوصية أو الاستخدام دون اتصال أو التعديلات الروتينية عالية الحجم ولديك الأجهزة بالفعل. اختر OpenRouter عندما تريد تنوع النماذج، ودون أجهزة مسبقة، وفوترة الدفع مقابل الاستخدام فقط.

LM Studio -- نماذج محلية بواجهة رسومية

يوفر LM Studio تشغيل النماذج المحلية نفسه كـ Ollama، لكن مع واجهة مرئية. تتصفح النماذج في واجهة رسومية، وتختار مستويات التحديد الكمي بنقرة واحدة، وتختبر المحادثة قبل توجيه Claude Code إليه. نفس متطلبات الأجهزة كـ Ollama. إذا كنت تقارن أدوات التشغيل، يغطي دليلنا لأفضل أدوات تشغيل LLM محلياً المقايضات.

الإعداد

  1. حمّل LM Studio وثبّته
  2. ابحث عن نموذج برمجة وحمّله (Qwen 2.5 Coder وdevstral وغيرها)
  3. شغّل الخادم المحلي من واجهة LM Studio
  4. وجّه Claude Code إليه:
bash
# وجّه Claude Code إلى خادم LM Studio المحلي
export ANTHROPIC_BASE_URL="http://localhost:1234/v1"
export ANTHROPIC_API_KEY="lm-studio"
export ANTHROPIC_DEFAULT_SONNET_MODEL="اسم-نموذجك-المحمّل"

يحتوي مدونة LM Studio على شرح تفصيلي مع لقطات شاشة إذا كنت تفضل أدلة الإعداد المرئية.

الحكم: LM Studio هو الأفضل للمطورين الذين يفضلون الواجهة الرسومية على سطر الأوامر لإدارة النماذج المحلية. إذا كنت مرتاحًا بالفعل مع ollama pull وملفات التهيئة، فابقَ مع Ollama. إذا أردت تصفح النماذج بصريًا وضبط الإعدادات بأشرطة التمرير، فـ LM Studio هو اختيارك.

claude-code-router -- التوجيه الذكي للنماذج

claude-code-router هو حزمة npm تشغّل بروكسي محليًا بين Claude Code ومزوديك المهيّأين. ما يجعله مثيرًا للاهتمام هو التوجيه الواعي بالسياق -- يمكنك إرسال المهام الخلفية الرخيصة إلى DeepSeek، والبرمجة الافتراضية إلى Sonnet، والاستدلال المعقد إلى Opus، كل ذلك تلقائيًا.

يمتلك المشروع 30,000+ نجمة GitHub ويدعم OpenRouter وDeepSeek وGemini وOllama وGroq وVolcengine وSiliconFlow كمزودين.

التثبيت والإعداد

bash
npm install -g claude-code-router
claude-code-router init
claude-code-router start

يُنشئ أمر init ملف config.json حيث تعرّف مزوديك وتعيينات النماذج:

json
{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-...",
      "models": {
        "haiku": "deepseek/deepseek-chat-v3",
        "sonnet": "anthropic/claude-sonnet-4",
        "opus": "anthropic/claude-opus-4"
      }
    }
  }
}

تهيئة التوجيه الواعي بالسياق

هنا يتألق claude-code-router. يمكنك توجيه أنواع مهام مختلفة إلى نماذج مختلفة بناءً على التعقيد. يذهب التلخيص في الخلفية إلى نموذج رخيص، بينما يذهب التخطيط وعمل البنية المعمارية إلى أفضل نموذجك. يتعامل الموجّه مع جميع تعيينات الفتحات بشفافية.

يمكنك أيضًا خلط المزودين -- استخدم Ollama للمستودعات الحساسة للخصوصية وOpenRouter لكل شيء آخر، والتبديل بأمر /model داخل Claude Code.

الحكم: claude-code-router هو الأفضل للمستخدمين المتقدمين الذين يريدون تحكمًا دقيقًا في أي نموذج يتعامل مع كل نوع مهمة. إنه الخيار الأكثر قابلية للتهيئة، لكن هذه المرونة تأتي بإعداد أكثر من مجرد تبديل ANTHROPIC_BASE_URL.

claude-code-proxy وLiteLLM -- الإعدادات المتقدمة

تخدم هاتان الطريقتان احتياجات مختلفة لكنهما تتشاركان سمة واحدة: كلتاهما خوادم بروكسي تترجم بين تنسيقات API.

claude-code-proxy (خلفية Gemini وOpenAI)

claude-code-proxy أداة Python (3,300+ نجمة GitHub) تقبل طلبات بتنسيق Anthropic من Claude Code وتترجمها إلى تنسيق OpenAI أو Gemini عبر LiteLLM تحت الغطاء. إنها أبسط طريقة لاستخدام Gemini أو نماذج GPT تحديدًا مع Claude Code. قد يهمك أيضاً أفضل مكدس ذكاء اصطناعي لـ SaaS.

bash
pip install claude-code-proxy
claude-code-proxy --port 8080

# ثم وجّه Claude Code إليه
export ANTHROPIC_BASE_URL="http://localhost:8080"
export ANTHROPIC_API_KEY="مفتاح-gemini-أو-openai-الخاص-بك"

إذا أردت تحديدًا سياق 1M رمز من Gemini للمستودعات الضخمة، فهذا المسار الأكثر مباشرة.

LiteLLM (البروكسي الشامل للمؤسسات)

LiteLLM بروكسي على مستوى المؤسسات يدعم 100+ مزود مع موازنة الحمل وسلاسل الاحتياط وتحديد المعدل وتسجيل التدقيق. إنه مبالغة لمطور فردي لكنه ضروري للفرق التي تحتاج إلى حوكمة حول استخدام نماذج الذكاء الاصطناعي.

يستخدم الإعداد تهيئة YAML:

yaml
model_list:
  - model_name: claude-sonnet-4-20250514
    litellm_params:
      model: gemini/gemini-2.5-flash
      api_key: os.environ/GEMINI_API_KEY
  - model_name: claude-haiku-3-5-20241022
    litellm_params:
      model: deepseek/deepseek-chat
      api_key: os.environ/DEEPSEEK_API_KEY
bash
# شغّل بروكسي LiteLLM
litellm --config config.yaml --port 4000

# وجّه Claude Code إلى LiteLLM
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_API_KEY="sk-litellm"

ملاحظة مهمة من وثائق Claude Code الرسمية: "لا تؤيد Anthropic LiteLLM ولا تحافظ عليه ولا تراجعه." استخدمه، لكن اعلم أنه أداة مجتمعية وليس منتج Anthropic. يحتوي برنامج LiteLLM التعليمي على أمثلة تهيئة أكثر تقدمًا.

الحكم: استخدم claude-code-proxy إذا أردت نماذج Gemini أو OpenAI تحديدًا. استخدم LiteLLM إذا احتاجت فرقتك إلى موازنة الحمل والاحتياط وتسجيل التدقيق عبر المزودين.

Claude Code Router مقابل LiteLLM: أيهما يجب أن تستخدم؟

Claude Code Router هو الخيار الأبسط للمطورين المنفردين الذين يريدون توجيهاً للنماذج حسب المهمة، بينما بُني LiteLLM للفرق التي تحتاج إلى موازنة الحمل وسلاسل الاحتياط وتسجيل التدقيق. يُثبَّت Router عبر npm ويقرأ ملف config.json؛ بينما يشغّل LiteLLM بروكسي مؤسسي مهيّأ بـ YAML عبر أكثر من 100 مزود.

العاملClaude Code RouterLiteLLM
صعوبة الإعدادمتوسطة: تثبيت npm، تعديل config.jsonمتقدمة: ملف تهيئة YAML
الأفضل لـالمطورون المنفردون الذين يريدون توجيهاً حسب المهمةالفرق التي تحتاج إلى حوكمة
تنسيق التهيئةconfig.jsonYAML model_list
الميزة البارزةالتوجيه الواعي بالسياق حسب المهمةموازنة الحمل، الاحتياط، تسجيل التدقيق
المزودونOpenRouter، DeepSeek، Gemini، Ollama، Groq، والمزيد100+ عبر المزودين
النضج30,000+ نجمة GitHub، مبني لـ Claude Codeبروكسي للمؤسسات، أداة مجتمعية (غير مدعومة من Anthropic)

اختر claude-code-router إذا كنت مطوراً منفرداً تريد مهاماً خلفية رخيصة على DeepSeek واستدلالاً معقداً على Opus دون إعداد كبير. اختر LiteLLM إذا احتاج فريقك إلى موازنة الحمل وتحديد المعدل وسجلات التدقيق عبر المزودين.

تقيّم بروكسيات أخرى أيضاً؟ يقارنها ملخصنا لـأفضل أدوات بوابة LLM جنباً إلى جنب.

ما الذي يكلّفه كل طريقة فعليًا؟

لنضع أرقامًا حقيقية على هذا. إليك ما ستدفعه لكل مليون رمز في مجموعات النموذج/الطريقة الأكثر شيوعًا:

النموذج / الطريقةالمدخلات (لكل 1M رمز)المخرجات (لكل 1M رمز)التقدير الشهري (استخدام معتدل)
Claude Opus 4.6 (مباشر)5.00 $25.00 $~50-150 $
Claude Sonnet 4.6 (مباشر)3.00 $15.00 $~30-60 $
Claude Sonnet عبر OpenRouter3.00 $15.00 $نفسه (مرور مباشر)
DeepSeek V3.2 (OpenRouter)0.27 $1.10 $~3-8 $
Gemini 2.5 Flash (OpenRouter)0.15 $0.60 $~2-5 $
Ollama (محلي)مجانيمجاني0 $ (تكاليف الأجهزة)

بيانات الأسعار من صفحة أسعار Anthropic الرسمية وOpenRouter. يفترض الاستخدام المعتدل ~5-10M رمز/شهر لجلسات برمجة يومية.

"التكلفة لكل 1M رمز مُخرج حسب النموذج"

"يكلّف Claude Opus 4.6 مبلغ 25 $ لكل 1M رمز مُخرج مقابل 1.10 $ لـ DeepSeek V3.2 -- فجوة تكلفة بمعدل 23 مرة. يعمل Ollama مجانًا تمامًا على الأجهزة المحلية."
جدول البيانات
"التكلفة لكل 1M رمز مُخرج حسب النموذج"
"النموذج""تكلفة المخرجات"
"Opus 4.6"25
"Sonnet 4.6"15
"DeepSeek V3.2"1.1
"Gemini 2.5 Flash"0.6
"Ollama (محلي)"0

فجوة التكلفة كبيرة، لكن النماذج الأرخص تنتج جودة كود أقل -- خاصة في المهام العميلة المعقدة حيث تهم موثوقية استدعاء الأدوات. DeepSeek بـ 1.10 $/MTok مُخرج رائع للتعديلات الروتينية. في إعادة هيكلة متعددة الملفات حيث يحتاج Claude Code إلى القراءة والتخطيط والتعديل والتحقق عبر 20 ملفًا؟ ستظل تريد Sonnet أو Opus.

الحكم: لتوفير التكاليف مع جودة مقبولة، يوفر OpenRouter + DeepSeek أفضل نسبة. لصفر تكلفة، Ollama لا يُضاهى إذا كانت لديك الأجهزة. لأقصى جودة، Anthropic المباشر لا يزال الملك.

أي طريقة يجب أن تستخدم؟ -- إطار القرار

هذا هو القسم الذي يتخطاه كل دليل آخر. بدلًا من أن نقول لك "فقط استخدم OpenRouter"، دعنا نطابق الطرق مع الاحتياجات الفعلية:

إذا احتجت إلى...استخدم هذه الطريقةلماذا
أقصى تنوع للنماذج، مفتاح API واحدOpenRouter300+ نموذج، إعداد سهل، ادفع حسب الاستخدام
مجاني، غير محدود، الكود يبقى محليًاOllamaصفر تكلفة، خصوصية كاملة، قادر على العمل دون إنترنت
نماذج محلية بواجهة مرئيةLM Studioمتصفح نماذج رسومي، اختيار سهل للتحديد الكمي
توجيه ذكي حسب المهمةclaude-code-routerالاستدلال إلى Opus، التعديلات السريعة إلى DeepSeek
نماذج Gemini أو OpenAI تحديدًاclaude-code-proxyيترجم تنسيق Anthropic إلى OpenAI/Gemini
مؤسسات: موازنة الحمل، التدقيقLiteLLMتحديد المعدل، سلاسل الاحتياط، ضوابط الفريق

هل يجب عليك التبديل أصلًا؟

رأي صريح: لمعظم المطورين الذين يقومون بالبرمجة العميلة المعقدة -- إعادة هيكلة متعددة الملفات، تخطيط البنية المعمارية، تصحيح مشكلات التزامن الصعبة -- يظل Claude Sonnet عبر Anthropic المباشر الخيار الأفضل. تمتلك نسخة Claude الأصيلة استدعاء الأدوات الأكثر موثوقية، وأفضل فهم لسير عملها العميل الخاص، وصفر تأخير للبروكسي.

تبديل النموذج هو تحسين لسيناريوهات محددة:

  • أنت تحرق رموزًا في مهام خلفية لا تحتاج جودة Sonnet، أو تصطدم باستمرار بـحدود استخدام Claude المضاعفة (2x)
  • تحتاج إلى نافذة سياق 1M رمز من Gemini لمستودع ضخم
  • لا يمكن لكودك مغادرة جهازك (حكومة، رعاية صحية، تمويل)
  • ميزانيتك محدودة والجودة المقبولة تتفوق على الجودة المثالية

إذا لم ينطبق أي من ذلك، فقد يكون opusplan (التوجيه المدمج في Anthropic) كل ما تحتاجه.

موثوقية استدعاء الأدوات هي مقياس الجودة الأكثر أهمية هنا. التسلسل الهرمي هو: Claude الأصيل >> Claude OpenRouter >> DeepSeek/Gemini >> النماذج المحلية. كلما نزلت، كلما رأيت المزيد من استدعاءات الأدوات الفاشلة ومسارات الملفات الوهمية والتعديلات غير المكتملة.

استكشاف المشكلات الشائعة وإصلاحها

خطأ "model not found"

هذه هي المشكلة الأكثر شيوعًا. تحدث عندما تضبط ANTHROPIC_BASE_URL لكنك تنسى تعيين خريطة الفتحات الثلاث. يحاول Claude Code استدعاء Haiku أو Opus عبر بروكسيك، البروكسي لا يتعرف على اسم نموذج Anthropic الافتراضي، وتحصل على الخطأ.

bash
# الإصلاح: اضبط جميع متغيرات فتحات النموذج الثلاث
export ANTHROPIC_DEFAULT_HAIKU_MODEL="نموذجك"
export ANTHROPIC_DEFAULT_SONNET_MODEL="نموذجك"
export ANTHROPIC_DEFAULT_OPUS_MODEL="نموذجك"

الاتصال مرفوض / انتهاء المهلة

بروكسيك لا يعمل، أو Claude Code يصل إلى المنفذ الخطأ. تحقق من أن عملية البروكسي نشطة وتحقق مرة أخرى من المنفذ في ANTHROPIC_BASE_URL. يمكن لجدران الحماية والشبكات الافتراضية الخاصة أيضًا حظر اتصالات localhost. تعرف أيضاً على أفضل أدوات الذكاء الاصطناعي للشركات الناشئة.

إخفاقات استدعاء الأدوات

النموذج لا يدعم تنسيق استخدام أدوات Anthropic بشكل صحيح. الأعراض: يتوقف Claude Code، ينتج استدعاءات أدوات فارغة، أو يعدّل الملفات الخاطئة. انتقل إلى نموذج مع دعم مُتحقق منه لاستدعاء الأدوات -- Qwen 2.5 Coder وdevstral يتعاملان معه بشكل أفضل بين النماذج المحلية.

مشاكل البث

بعض البروكسيات لا تتعامل مع الأحداث المُرسلة من الخادم بشكل صحيح. تظهر الاستجابات دفعة واحدة بدلًا من البث، أو تُقطع في منتصف الاستجابة. تأكد من أن إصدار بروكسيك محدّث وراجع مشكلات GitHub للأخطاء المعروفة للبث.

تجاوز نافذة السياق

كثيرًا ما تكون نوافذ سياق النماذج المحلية 4K-8K بشكل افتراضي. يحتاج Claude Code إلى أكثر من ذلك بكثير لجلسات برمجة حقيقية. استخدم نماذج ذات سياق 32K+ أو وجّه المهام ذات السياق الطويل إلى Gemini (نافذة 1M) عبر OpenRouter.

يجب تسجيل الخروج أولًا لـ OpenRouter

إذا كنت تتبدل من Anthropic المباشر إلى OpenRouter، شغّل claude /logout أولًا. يحتفظ Claude Code بالمصادقة في ذاكرة التخزين المؤقت وسيستمر في محاولة استخدام مفتاح Anthropic الخاص بك حتى بعد تغيير عنوان URL الأساسي.

bash
# امسح المصادقة المخزنة مؤقتًا قبل تبديل المزودين
claude /logout

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

هل يمكنك استخدام Claude Code مع GPT-4 أو Gemini؟

نعم. يترجم claude-code-proxy طلبات بتنسيق Anthropic إلى تنسيق OpenAI أو Gemini. يمكنك أيضًا الوصول إلى كليهما عبر OpenRouter بمفتاح API واحد. قد يكون استدعاء الأدوات أقل موثوقية من Claude الأصيل، خاصة للمهام المعقدة متعددة الخطوات.

كيف أستخدم Claude Code بدون مفتاح API من Anthropic؟

استخدم Ollama للاستخدام المحلي المجاني تمامًا -- لا يلزم مفتاح API من أي مزود. بديلًا، استخدم OpenRouter بتنسيق مفتاح API الخاص بهم. لا تزال تضبط متغير البيئة ANTHROPIC_API_KEY، لكنه يشير إلى مفتاح بروكسيك (مثلًا sk-or-v1-... لـ OpenRouter، أو "ollama" لـ Ollama).

كيف أُعدّ Claude Code مع Ollama؟

ثبّت Ollama، احضر نموذجًا مثل qwen2.5-coder:14b، شغّل ollama launch claude، واضبط ثلاثة متغيرات بيئة: ANTHROPIC_BASE_URL وANTHROPIC_API_KEY ومتغيرات فتحات النماذج الثلاثة. راجع قسم Ollama أعلاه للكود الكامل.

ما النماذج الأفضل للعمل مع Claude Code؟

للسحابة: يُقدم Claude Sonnet 4 أفضل جودة برمجة، بينما يُقدم DeepSeek V3.2 أفضل قيمة. للمحلي: Qwen 2.5 Coder 14B هو المعيار الذهبي الحالي. العامل الحاسم هو موثوقية استدعاء الأدوات -- يعتمد Claude Code على ذلك اعتمادًا كبيرًا في عمليات الملفات، وتتعامل النماذج الأصيلة Claude مع ذلك بشكل أفضل.

كيف أُصلح خطأ "model not found" في Claude Code؟

اضبط جميع متغيرات البيئة لفتحات النماذج الثلاثة: ANTHROPIC_DEFAULT_HAIKU_MODEL وANTHROPIC_DEFAULT_SONNET_MODEL وANTHROPIC_DEFAULT_OPUS_MODEL. يحدث هذا الخطأ لأن Claude Code يستخدم ثلاث فتحات نماذج داخلية، وفتحة غير محددة تحاول استدعاء اسم نموذج لا يتعرف عليه بروكسيك.

هل يمكن لـ Claude Code العمل دون اتصال بالإنترنت مع النماذج المحلية؟

نعم. يشغّل كلٌّ من Ollama وLM Studio النماذج بالكامل على جهازك دون الحاجة إلى اتصال إنترنت. لا يغادر كودك أجهزتك أبدًا. ستحتاج إلى مواصفات كافية -- 16 جيجابايت RAM كحد أدنى لنماذج 7B، و32 جيجابايت+ لأي شيء أكبر.

هل يمكنني استخدام LM Studio مع Claude Code؟

نعم. يشغّل LM Studio خادماً محلياً يتصل به Claude Code عبر ضبط ANTHROPIC_BASE_URL على http://localhost:1234/v1 وضبط ANTHROPIC_API_KEY على lm-studio. حمّل نموذج برمجة مثل Qwen 2.5 Coder، وشغّل الخادم من واجهة LM Studio الرسومية، ثم اربط فتحة نموذجك. إنه البديل المرئي لواجهة سطر أوامر Ollama.

ما هو ANTHROPIC_BASE_URL وكيف أستخدمه؟

إنه متغير البيئة الذي يُخبر Claude Code بمكان إرسال طلبات API. بشكل افتراضي، يشير إلى https://api.anthropic.com. غيّره إلى أي نقطة نهاية متوافقة مع Anthropic -- OpenRouter (https://openrouter.ai/api)، وOllama (http://localhost:11434)، وLiteLLM (http://localhost:4000)، وما إلى ذلك.

هل claude-code-router أفضل من LiteLLM؟

أدوات مختلفة لمشاكل مختلفة. claude-code-router أبسط (npm install، وتعديل config.json، وانتهى) ومصمم خصيصًا لـ Claude Code. LiteLLM على مستوى المؤسسات مع موازنة الحمل وتحديد المعدل وسلاسل الاحتياط وتسجيل التدقيق. مطور فردي؟ استخدم claude-code-router. فريق بمتطلبات حوكمة؟ استخدم LiteLLM.

كم يمكنني توفيره باستخدام نماذج غير Anthropic؟

التبديل من Claude Opus 4.6 إلى DeepSeek V3.2 يخفض تكاليف رموز المخرجات بحوالي 95% (25 $ مقابل 1.10 $ لكل مليون رمز). يُجعل Ollama ذلك صفرًا إذا كانت لديك الأجهزة. لكن مقايضات الجودة حقيقية -- توقع دقة أقل في المهام العميلة المعقدة متعددة الخطوات، واستدعاء أدوات أقل موثوقية، ومسارات ملفات وهمية أكثر.

هل يعمل استدعاء الأدوات مع جميع طرق البروكسي؟

ليس بشكل موثوق عبر الجميع. Claude الأصيل لديه أفضل دعم لاستدعاء الأدوات. OpenRouter مع نماذج Claude يعمل بشكل جيد تقريبًا. DeepSeek وGemini لديهما دعم جزئي -- استدعاءات الأدوات البسيطة تعمل، لكن السلاسل المعقدة قد تفشل. النماذج المحلية عبر Ollama لديها أقل استدعاء موثوق للأدوات. هذا هو القلق الجودي الأول عند الابتعاد عن Anthropic.

المصادر

الوسوم

claude-codeopenrouterollamalitellmclaude-code-routerنماذج-محليةأدوات-برمجة-ذكاء-اصطناعي

شارك هذا المقال

مقالات ذات صلة

المزيد في guides

guides
Jul 28, 2026

الـ9 مقاييس SaaS الوحيدة المهمة في 2026 (بمقارنة مرجعية مع أكثر من 1,300 شركة)

معظم أدلة مقاييس SaaS تستشهد بحدود وُضعت في 2021 ولا تنسبها لأحد. هذا الدليل ينشر تسعة مقاييس بوسطاء CY-2025 من تقارير إصدار 2026، ومقاطع الربع الأعلى، وحجم العينة وراء كل رقم، وستة مقاييس ينبغي التوقف عن تتبعها.

13 دقيقة قراءة قراءة
اقرأ
guides
Jul 28, 2026

قالب وثيقة متطلبات المنتج (PRD) + مثال عملي كامل يمكنك نسخه

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

13 دقيقة قراءة قراءة
اقرأ
ابدأ مشروعك

هل أنت مستعد لبناء شيء استثنائي؟

دعنا نحول رؤيتك إلى واقع. فريقنا جاهز لمساعدتك في إنشاء برمجيات تصنع الفرق.