دمج النماذج الخارجية / المحلية
استخدم النماذج المحلية / الخارجية مثل DeepSeek لتشغيل Claude Code، وقم بخفض فاتورتك
📚 دليل السلسلة: شرحت المقالة السابقة 04 · تكوين API كيفية استخدام مفتاح API الرسمي لتوصيل Claude Code. هذه المقالة تأخذ نهجاً مختلفاً - استبدال "الدماغ" الخلفي بالكامل، واستخدام نماذج مثل DeepSeek لتوفير المال.
⚠️ تنبيه مسبق في بداية هذه المقالة: استخدام نماذج خارجية لتشغيل Claude Code يعتبر "أسلوباً تجريبياً". تغطي الوثائق الرسمية فقط "بوابة LLM" وخدمات Claude المستضافة مثل Bedrock / Vertex، ولا تصادق على أي نماذج غير تابعة لـ Anthropic. كل ما هو مذكور بشكل صريح من قبل الجهات الرسمية في هذه المقالة (معاني متغيرات البيئة، السلوك الافتراضي) قمت بتحديد مصدره؛ أما جزء DeepSeek فيعتمد بشكل أساسي على حلول المجتمع والتجارب الفعلية، قد تتغير عناوين الواجهة وأسماء النماذج في أي وقت، لذا يرجى الاعتماد على الوثائق الرسمية لـ DeepSeek.
يا رفاق، دعوني أقول شيئاً قد يعرضني للانتقاد: معظم الناس لا يحتاجون إلى العبث بالنماذج الخارجية على الإطلاق.
العديد من الدروس على الإنترنت تبالغ في أن "ربط Claude Code بـ DeepSeek" هو أداة سحرية لتوفير المال، مما يجعلك تبدو مغفلاً إذا لم تقم بربطه. ولكن لقول الحقيقة — إذا كنت قد اشتريت بالفعل اشتراك Claude (Pro / Max)، أو كانت نفقات API الخاصة بك بضعة عشرات من الدولارات فقط في الشهر، فإن المال القليل الذي توفره بعد الكثير من العناء لا يغطي الوقت الذي تقضيه في تصحيح أخطاء متغيرات البيئة.
إذن لماذا أكتب هذه المقالة؟ لأن هناك نوعين من الأشخاص يحتاجونها حقاً: النوع الأول هو المستخدم الكثيف الذي يشعر بألم عند استهلاك رصيد API، مع عشرات الملايين من الـ token الصادرة والواردة يومياً، حيث يمكن أن يوفر استخدام نموذج أرخص بعشر مرات مئات أو آلاف الدولارات شهرياً؛ النوع الثاني هو المستخدمون في بعض الدول الذين لا يستطيعون الاتصال بالخدمات الرسمية بسهولة ولا يرغبون في استخدام برامج تجاوز الحجب، واجهة الاتصال المباشر مثل DeepSeek هي الأكثر راحة لهم.
إذا كنت من هذين النوعين — واصل القراءة. إذا لم تكن كذلك، فيكفي أن تلقي نظرة سريعة على المبادئ، ولا تتسرع في التبديل.
بعد قراءة هذه المقالة، ستحصل على:
- جدول مقارنة بين "API الرسمي مقابل النماذج الخارجية" لمساعدتك في اتخاذ قرار بشأن التبديل
- مجموعة من تكوينات DeepSeek الجاهزة للنسخ والتشغيل (مقدمة لكل من Mac / Windows)
- فهم دقيق لما تفعله 4 متغيرات بيئة رئيسية، وهي صالحة عند التبديل إلى أي نموذج خارجي
- بعض المزالق الشائعة: المتغيرات المهملة، التحقق باستخدام
/status، ومتى يجب عدم استخدامها
01 أولاً افهم: ماذا يعني التبديل في النماذج؟
دعنا نذكر الاستنتاج أولاً: يُعد Claude Code "غلافاً"، والنموذج هو "الدماغ"، وما يفعله الدمج الخارجي هو استبدال هذا الدماغ بدماغ شخص آخر.
نسخة Claude Code التي تثبتها هي في جوهرها عميل يعمل في الطرفية (terminal) — فهي مسؤولة عن قراءة الكود الخاص بك، واستدعاء الأدوات، وإدارة السياق، وتشغيل حلقة الوكيل (agent) "فكر → تصرف → انظر". لكنها لا تفكر بنفسها، كل خطوة تتطلب إرسال طلب إلى نموذج لغوي كبير، وانتظار رد النموذج. افتراضياً، هذا النموذج هو Claude من Anthropic.
تشبيه: تغيير محرك سيارة. يُعد Claude Code هيكل السيارة — عجلة القيادة، والمقاعد، ولوحة القيادة لا تتغير، ولا تحتاج عاداتك في التشغيل إلى أي تغيير. النموذج هو المحرك. المحرك الأصلي (Claude) يمتلك القوة الأكبر ولكنه يستهلك وقوداً باهظاً؛ إذا أردت توفير المال، يمكنك فكه وتركيب محرك محلي (DeepSeek). السيارة لا تزال نفس السيارة، وتجربة القيادة متشابهة تقريباً، الشيء الوحيد الذي تغير هو القوة واستهلاك الوقود.
إذن كيف يتم "تغيير المحرك" بالتحديد؟ ليس عن طريق تعديل الكود، بل من خلال عدة متغيرات بيئة (Environment Variables). أهمها هو ANTHROPIC_BASE_URL — والذي يحدد العنوان الذي يرسل إليه Claude Code الطلبات.
هنا نقطة تم التأكيد عليها في الوثائق الرسمية ولكن تسعين بالمائة من الشروحات لم توضحها:
يغير
ANTHROPIC_BASE_URLالوجهة التي تُرسل إليها الطلبات، وليس أي نموذج يجيب عليها. (النص الأصلي من "تكوين النماذج" الرسمي)
ماذا يعني ذلك؟ يقوم ANTHROPIC_BASE_URL بتغيير "أين تُرسل الرسالة" فقط، ولا يتحمل مسؤولية "من سيرد على الرسالة". إذا قمت بتغيير العنوان إلى واجهة DeepSeek، فإن موافقة DeepSeek على استلامها والنموذج المستخدم للرد يعتمدان على عنوان الواجهة + اسم النموذج معاً. لذلك تغيير URL وحده لا يكفي، يجب أيضاً إعداد اسم النموذج — هذه منطقة شائعة جداً للوقوع في الأخطاء، تذكر ذلك.
إذن لماذا يمكن ربط DeepSeek مباشرة؟ لأن DeepSeek توفر واجهة "متوافقة مع بروتوكول Anthropic" — العنوان هو https://api.deepseek.com/anthropic. بصراحة، فإن DeepSeek تتنكر في هيئة Anthropic، مما يجعل Claude Code يعتقد أنه لا يزال يتحدث مع الجهة الرسمية، بينما في الواقع DeepSeek هو من يقوم بالحسابات. لا تحتاج إلى تعديل سطر واحد من الكود المصدري لـ Claude Code.
💡 خلاصة في جملة واحدة: تغيير النموذج = تعديل بعض متغيرات البيئة لاستبدال "المحرك"، دون المساس بهيكل السيارة (Claude Code)؛ يتولى
ANTHROPIC_BASE_URL"أين تُرسل"، بينما يتولى اسم النموذج "من يجيب"، وكلاهما يجب أن يتوافقا.
02 هل يجب أن أبدل؟ ألق نظرة على هذا الجدول أولاً
قبل البدء، اهدأ لخمس دقائق. النماذج الخارجية ليست وجبة مجانية، فهي توفر المال، لكنك ستفقد بعض الأشياء.
قمت بمقارنة مشروع حقيقي لمدة أسبوعين: نفس الكود ونفس المهام، استخدمت في الأسبوع الأول Sonnet الرسمي، وفي الأسبوع الثاني قمت بالتبديل إلى DeepSeek. الجدول أدناه يوضح التجربة الحقيقية، وليس منسوخاً من جداول المعلمات.
| البعد | Claude الرسمي (Anthropic API) | النماذج الخارجية / المحلية (مثل DeepSeek) |
|---|---|---|
| السعر | غالي، Opus يستهلك المال بشكل خاص | ✅ رخيص، عادة ما يكون أرخص بمقدار كبير |
| الاتصال المباشر (الدول المقيدة) | غالباً يتطلب برامج لتجاوز الحجب | ✅ DeepSeek وغيرها توفر اتصالاً مباشراً بدون عوائق |
| قدرة الكود | ✅ حالياً في المستوى الأول، مستقر في إعادة الهيكلة المعقدة | كافٍ، لكن قد يفشل أحياناً في المهام المعقدة |
| استدعاء الأدوات / قدرة الوكيل | ✅ الأكثر استقراراً أصلياً، لا يتعثر في المهام متعددة الخطوات | ⚠️ يعتمد على النموذج، الواجهة المتوافقة قد تواجه سلوكيات غير معتادة |
| تكلفة التكوين | فقط أضف المفتاح (Key) | يتطلب إعداد مجموعة من متغيرات البيئة، سهل الوقوع في الأخطاء |
| الدعم الرسمي | ✅ مواطن من الدرجة الأولى | ❌ تجريبي، لا يوجد دعم إذا حدثت مشكلة |
هل فهمت؟ السعر الرخيص والاتصال المباشر هما الورقتان الرابحتان للطرف الثالث؛ والثمن هو الحد الأقصى لقدرات الكود، واستقرار الوكيل (Agent)، و"عدم وجود دعم".
الاستنتاج الحقيقي بعد المقارنة على مدار أسبوعين: للمهام اليومية مثل الإضافة والحذف والتعديل والاستعلام، وكتابة الاختبارات، وإكمال الوثائق، وشرح الكود، يعتبر DeepSeek كافياً تماماً، والتجربة مشابهة جداً لـ Sonnet، لكن التكلفة لا تكاد تذكر. ولكن عند التعامل مع مهام "فهم علاقات الاستدعاء لخمسة أو ستة ملفات وإعادة هيكلة كبيرة عبر الوحدات"، فوت DeepSeek التبعيات الرئيسية مرتين، بينما نجح Claude في نفس الـ prompt من المرة الأولى.
لذا فإن الاستخدام الأكثر عملية هو الخلط بينهما: المهام البسيطة للنماذج الرخيصة، والمهام الصعبة نعود فيها إلى Claude — كيفية التقسيم بالتحديد، يقدم القسم 05 تكويناً جاهزاً للنسخ.
حكم في جملة واحدة حول التبديل:
- ✅ يجب التبديل: المستخدمون الكثيفون الذين تصل فواتير API الخاصة بهم إلى مئات أو آلاف الدولارات شهرياً؛ المستخدمون في الدول التي يواجهون فيها صعوبة في الاتصال بالخدمات الرسمية ولا يريدون استخدام برامج تجاوز الحجب؛ الأشخاص الذين يرغبون فقط في التدريب ولا يهتمون بتلك الفروق في النماذج.
- ❌ لا تزعج نفسك: الذين اشتروا بالفعل اشتراك Claude (الاشتراك هو رسوم ثابتة، التحويل إلى API سيكلفك مالاً إضافياً، سيتم شرح ذلك بالتفصيل في المقالة 06)؛ الذين يقومون بشكل أساسي بالبنى المعمارية المعقدة وتصحيح الأخطاء الصعبة (توفير القليل من المال لا يستحق التضحية بجودة النتائج).
هل ما زلت متردداً؟ دع الشبكة تتحدث أولاً
في قائمة "هل يجب التبديل" أعلاه، "هل الاتصال بالخدمات الرسمية من بلدك صعب أم لا" هو أصعب شيء يمكنك تحديده بنفسك — تظن أن تشغيل برنامج تجاوز الحجب مستقر، ولكن بعد خطوات قليلة يعطي Claude Code خطأ 502 أو 400 فجأة، هل هذا بسبب مشكلة لديه أم أن شبكتك خضعت للرقابة؟ التخمين لا ينفع، قم بإجراء فحص أولاً:
ipcheck هي أداة تشخيص صغيرة لبيئة الشبكة كتبتها سابقاً، باستخدام أمر واحد يمكنك فحص IP / DNS / البروكسي / التحكم في المخاطر، وتخبرك مباشرة ما إذا كانت شبكتك الحالية تستطيع الاتصال النظيف بـ API الرسمي.
- إذا ظهرت النتيجة حمراء / صفراء بالكامل (تلوث DNS، اكتشاف البروكسي، إصابة بالتحكم في المخاطر) → لا تتردد، اتجه للطرف الثالث، لتوفير العديد من عمليات استكشاف الأخطاء الغامضة لاحقاً.
- إذا ظهرت النتيجة خضراء بالكامل → استخدم الخدمة الرسمية بهدوء، ولا تزعج نفسك بمجموعة من متغيرات البيئة من أجل توفير ذلك القليل من المال.
💡 خلاصة في جملة واحدة: استبدل النماذج الخارجية بـ "الحد الأقصى للكود + الدعم" مقابل "توفير المال + الاتصال المباشر"؛ يجب على المستخدمين الكثيفين وأصحاب الاتصال المباشر التبديل، أما أصحاب الاشتراكات والمتعصبون لإعادة الهيكلة فلا داعي للانضمام للضجة.
03 التنفيذ: ربط DeepSeek بـ Claude Code
حسناً، لنفترض أنك قررت التبديل. يقدم هذا القسم تكويناً يمكنك نسخه وتشغيله مباشرة.
أدناه أستخدم DeepSeek كمثال (الأكثر راحة في بعض الدول). إن ربط النماذج الخارجية الأخرى (Kimi، Zhipu، وغيرها من منصات التوجيه المجمعة...) يتبع نفس النهج تماماً، فقط يتم استبدال
ANTHROPIC_BASE_URLواسم النموذج بالمنصة المقابلة — ويجب الاعتماد على الوثائق الرسمية لكل منها.
الخطوة التحضيرية: الحصول على DeepSeek API Key
الشرط المسبق هو أنك قمت بالفعل بتثبيت Claude Code (إذا لم تقم بذلك، راجع 02 · التثبيت والاستخدام). ثم:
- افتح منصة DeepSeek المفتوحة، وسجل / سجل الدخول
- قم بإنشاء API Key، انسخه واحفظه (بصيغة
sk-xxxxxxxx)
🔑 يعتبر الـ API Key مثل مفتاح محفظة حسابك. لا ترفعه إلى مستودع Git، ولا ترسله في المجموعات، ولا تكتبه داخل الكود. أدناه سنستخدم متغيرات البيئة لإدارته، وبطبيعتها لن تدخل في الكود.
الخطوة الأولى: إعداد متغيرات البيئة
متغيرات البيئة هي "مجموعة من المفاتيح والعناوين المكتوبة للنظام ليقرأها"، سيقوم Claude Code بقراءتها عند بدء التشغيل لتحديد أين يُرسل وما هو النموذج الذي يستخدمه.
تشبيه: ملء بوليصة الشحن. ANTHROPIC_BASE_URL هو عنوان المستلم، و ANTHROPIC_AUTH_TOKEN هو بطاقة هويتك (للتحقق من هويتك قبل الإرسال)، وسلسلة ANTHROPIC_*_MODEL التالية تعني "تحديد ساعي البريد الذي سيوصلها". إذا قمت بملء النموذج بشكل صحيح، ستصل الطرود (طلباتك) إلى المكان الصحيح وتُعالج بواسطة الشخص المناسب.
Mac / Linux
افتح الطرفية (terminal)، ونفذ سطراً بسطر (استبدل <Your DeepSeek API Key> بالمفتاح الحقيقي):
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<Your DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-chat
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-chat
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-chatWindows (PowerShell)
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<Your DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-chat"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-chat"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-chat"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat"⚠️ بخصوص اسم النموذج: يُعد
deepseek-chatالمكتوب أعلاه عنصراً نائبًا توضيحيًا. أسماء نماذج DeepSeek المحددة (ومستوى القدرة الذي تتوافق معه) تخضع لـ الوثائق الرسمية لـ DeepSeek، ستتغير الأسماء عند ترقية المنصة، لذا لا تقم بكتابتها بشكل ثابت. اسم النموذج هو "رقم ساعي البريد المكتوب في بوليصة الشحن"، إذا قمت بملئه بشكل خاطئ فلن يتعرف عليه النظام، وسيقوم بالإبلاغ عن خطأ عند بدء التشغيل.
الرابطة الكاملة التي تريد الصورة أعلاه التعبير عنها: أمرك → يتم تجميعه في طلب بواسطة Claude Code → يقوم BASE_URL بتغيير عنوان الاستلام إلى DeepSeek → يقوم AUTH_TOKEN بالتحقق من الهوية → حوسبة نموذج DeepSeek → تعود النتيجة بنفس المسار إلى الطرفية. أثناء ذلك لم يتغير "غلاف" Claude Code على الإطلاق.
الخطوة الثانية: جعل التكوين ساري المفعول بشكل دائم (اختياري ولكن يُنصح به بشدة)
الأوامر export / $env: أعلاه صالحة فقط في نافذة الطرفية الحالية، بمجرد إغلاق النافذة تختفي — وهذا هو أول فخ كبير للمبتدئين: "لقد قمت بتكوينه بوضوح، لماذا لا يعمل عند إعادة فتح الطرفية؟"
لجعله ساري المفعول بشكل دائم:
- Mac (zsh، الافتراضي): أضف أسطر
exportهذه إلى نهاية~/.zshrc، ثم نفذsource ~/.zshrc - Linux (bash): أضفها إلى نهاية
~/.bashrc، ونفذsource ~/.bashrc - Windows: أضف متغيرات المستخدم في "خصائص النظام → متغيرات البيئة"، أو اكتبها في
$PROFILEالخاص بـ PowerShell
💡 خلاصة في جملة واحدة: ربط DeepSeek = الحصول على Key + إعداد مجموعة من متغيرات البيئة (العنوان + بطاقة الهوية + اسم النموذج)؛ أمر export المؤقت يبطل عند إغلاق النافذة، إذا أردت استخدامه على المدى الطويل فاكتبه في
~/.zshrc.
04 التحقق: هل تم الاتصال حقاً؟
بعد الانتهاء من التكوين، لا تستعجل استخدامه، تحقق أولاً. إذا بدأت العمل دون التحقق، فمن المحتمل جداً أن تكتشف بعد كتابة الكود لفترة أن الطلبات ما زالت تمر عبر الجهة الرسمية، ولم يتم التبديل على الإطلاق — وتضيع وقتك هباءً.
التحقق يتم بأمر واحد. ادخل إلى دليل أي مشروع، وابدأ تشغيل Claude Code، واكتب /status:
cd /path/to/your-project
claudeبمجرد الدخول، اكتب في مربع الحوار:
/statusإذا تم الاتصال، سترى بضعة أسطر مشابهة لهذه في المخرجات (ركز على Base URL والنموذج):
Base URL: https://api.deepseek.com/anthropic
Model: deepseek-chatرؤية تحول Base URL إلى عنوان DeepSeek، يعني أن "المحرك" قد تم تغييره فعلاً. سيعرض /status أيضاً معلومات حسابك والنموذج الحالي، وهي أسرع طريقة لاستكشاف مثل هذه الأخطاء وإصلاحها — كما تذكر الوثائق الرسمية بالاسم استخدامه "للتحقق مما إذا كان البروكسي والبوابة (gateway) قد تم تكوينهما وتطبيقهما بشكل صحيح".
إذا كان العنوان المعروض لا يزال العنوان الرسمي، أو أبلغ عن خطأ بشكل مباشر، قم بالتحقق من هذه الأسباب المتكررة واحدة تلو الأخرى:
| الظاهرة | السبب المحتمل | كيفية الإصلاح |
|---|---|---|
| Base URL لا يزال العنوان الرسمي | متغيرات البيئة لم تدخل حيز التنفيذ (ربما فتحت طرفية جديدة) | أعد تنفيذ source، أو تأكد من كتابتها في ملف التكوين |
| الإبلاغ عن خطأ بأن النموذج غير موجود عند بدء التشغيل | اسم النموذج مكتوب بشكل خاطئ / غيرت المنصة الاسم | راجع الوثائق الرسمية لـ DeepSeek لمعرفة أحدث اسم للنموذج |
| 401 / فشل المصادقة | API Key خاطئ أو منتهي الصلاحية | أعد إنشاء Key جديد، وتأكد من عدم نسخ مسافات إضافية |
| يطلب تسجيل الدخول إلى claude.ai | العميل لا يزال يحاول تسجيل الدخول الرسمي | انظر التوضيح أدناه |
ملاحظة خاصة حول النقطة الأخيرة: في بعض سيناريوهات الربط الخارجي، سيقوم Claude Code بإظهار مطالبة تسجيل الدخول الرسمية عند بدء التشغيل. الطريقة الشائعة هي تعديل ~/.claude.json، وإضافة السطر "hasCompletedOnboarding": true لتخطي التوجيه. يعتبر هذا تجاوزاً تجريبياً، وليس ممارسة قياسية موثقة رسمياً، وقد يتغير السلوك في الإصدارات الجديدة — لا تلمسه إلا إذا كنت مضطراً، وجربه فقط إذا علقت حقاً.
💡 خلاصة في جملة واحدة: نظرة واحدة على Base URL عبر
/statusلتعرف ما إذا تم الاتصال أم لا؛ إذا لم يتم الاتصال فلا تخمن بشكل أعمى، بل اتبع جدول استكشاف الأخطاء وإصلاحها عنصراً بعنصر.
05 خطوة متقدمة: استخدام النماذج في طبقات، لتوفير المال دون أخطاء
هذا القسم هو الأكثر قيمة، وهو التنفيذ الفعلي لمبدأ "الخلط بينهما" المذكور في القسم 02.
هل تتذكر مجموعة متغيرات ANTHROPIC_*_MODEL في القسم 01؟ لا يتم ملؤها بشكل متكرر هباءً — يقوم Claude Code داخلياً بتقسيم المهام إلى ثلاث فئات، ويمكنك تعيين نموذج مختلف لكل فئة.
| المتغير | المعنى الرسمي | ما هي المهام المناسبة له |
|---|---|---|
ANTHROPIC_DEFAULT_OPUS_MODEL | النموذج الذي يحلله الاسم المستعار لـ opus | الأكثر تعقيداً: تصميم البنية المعمارية، وتصحيح الأخطاء الصعبة |
ANTHROPIC_DEFAULT_SONNET_MODEL | النموذج الذي يحلله الاسم المستعار لـ sonnet | يومياً: كتابة الميزات، وتعديل الكود |
ANTHROPIC_DEFAULT_HAIKU_MODEL | النموذج الخاص بالاسم المستعار لـ haiku / وظائف الخلفية (مثل العناوين التلقائية، إلخ) | خفيف الوزن: الإجابة السريعة للأسئلة، والمهام الخلفية المتنوعة |
CLAUDE_CODE_SUBAGENT_MODEL | النموذج المستخدم لجميع الوكلاء الفرعيين (subagents) / فريق الوكلاء | المهام الفرعية، يوصى بنموذج رخيص وسريع |
المعاني المذكورة أعلاه مأخوذة جميعها من وثيقة "تكوين النماذج" الرسمية. هذه الآلية ليست حصرية لـ DeepSeek، بل هي أصلية في Claude Code — عند ربط نماذج خارجية، أنت تقوم ببساطة بتوجيه كل هذه الأسماء المستعارة إلى نماذج خارجية.
تشبيه: جدولة مطعم. الطاهي الرئيسي (النموذج الأقوى) راتبه مرتفع، دعه يقوم فقط بالأطباق المميزة؛ يتم تسليم الأطباق المنزلية العادية إلى الطهاة العاديين (النماذج المتوسطة)؛ أما تقديم الشاي وغسل الخضار (مهام الخلفية، والمهام الفرعية) فتُرسل للمتدربين (النماذج الرخيصة والسريعة). ماذا لو استخدمت الطاهي الرئيسي لكل شيء؟ سيكون الطعام لذيذاً، لكنك لن تستطيع دفع الرواتب.
لذا فإن طريقة التكوين التي توضح أنك حقاً محترف ليست "ملء جميع الخانات بنموذج واحد"، بل التقسيم إلى طبقات — بافتراض أن منصة معينة لديها نموذج "إصدار التفكير القوي" ونموذج "إصدار سريع ورخيص" في نفس الوقت:
# استخدام النموذج القوي للمهام المعقدة
export ANTHROPIC_DEFAULT_OPUS_MODEL=<اسم النموذج ذو التفكير القوي>
export ANTHROPIC_DEFAULT_SONNET_MODEL=<اسم النموذج ذو التفكير القوي>
# استخدام النموذج الرخيص والسريع للمهام الخفيفة والوكلاء الفرعيين لتوفير المال
export ANTHROPIC_DEFAULT_HAIKU_MODEL=<اسم النموذج السريع والرخيص>
export CLAUDE_CODE_SUBAGENT_MODEL=<اسم النموذج السريع والرخيص>فائدة هذا التكوين: عندما تستخدم /model opus في Claude Code للتبديل إلى "الفئة الثقيلة" فإنه يعمل بالنموذج القوي، بينما يعمل عادةً بالنموذج الرخيص بشكل افتراضي، وستعمل الاستدعاءات الخلفية عالية التردد مثل الوكلاء الفرعيين تلقائياً بأرخص نموذج — فتنخفض الفاتورة بشكل كبير على الفور.
وهناك أيضاً متغير للتحكم في "عمق التفكير" وهو CLAUDE_CODE_EFFORT_LEVEL، تدعم الجهة الرسمية low / medium / high / xhigh / max / auto (auto يعني استعادة الفئة الافتراضية للنموذج؛ وما هي الفئات المتاحة يعتمد على النموذج بالتحديد). إذا أردت أن يفكر النموذج لفترة أطول قليلاً للحصول على نتيجة أكثر استقراراً، فيمكنك رفعه؛ إذا أردت توفير الـ token، وتحتاج إلى سرعة، فقم بخفضه.
تركيبة جيدة للاستخدام: الفئة الافتراضية نموذج رخيص + جهد
mediumللمهام اليومية، وعند مواجهة مشاكل صعبة استخدم يدوياً/modelللتبديل للفئة الثقيلة + ورفعه مؤقتاً إلىhigh. بهذه التركيبة ستنخفض فاتورة API الشهرية إلى حوالي الثلث تقريباً، بينما تبقى التجربة اليومية دون تغيير تقريباً.
💡 خلاصة في جملة واحدة: لا تملأ جميع الفئات بنموذج واحد — المهام البسيطة للرخيص، المهام الصعبة للقوي، الوكلاء الفرعيون للأرخص، بعد التقسيم إلى طبقات يمكنك الحصول على توفير المال والجودة معاً.
06 فخان يقع فيهما المبتدئون لا محالة
أخيراً، أود أن أشير إلى فخين شائعين يقع فيهما المبتدئون للتحدث عنهما بالتحديد.
الفخ الأول: نسخ اسم متغير مهمل بالفعل من قبل الجهة الرسمية
ستجد على الإنترنت (بما في ذلك في جداول "التكوين المرجعي" في بعض الدروس) متغيراً يُدعى ANTHROPIC_SMALL_FAST_MODEL، يُستخدم لتحديد "النموذج الصغير السريع" هذا.
هذا المتغير قد تم وضع علامة عليه بـ "مُهمل (deprecated)" من قبل الجهة الرسمية، والمتغير الأصلي الصحيح هو ANTHROPIC_DEFAULT_HAIKU_MODEL. العديد من الأشخاص ينسخون ANTHROPIC_SMALL_FAST_MODEL وفقاً للدروس القديمة عند تكوينهم لأول مرة، وعلى الرغم من أنه لا يزال يعمل في ذلك الوقت، إلا أنهم دائماً يشعرون بعدم الثقة — بقراءة وثيقة "متغيرات البيئة" الرسمية ستكتشف أنه تم استبداله.
الاستنتاج: تستخدم جميع التكوينات الجديدة ANTHROPIC_DEFAULT_HAIKU_MODEL، وإذا رأيت ANTHROPIC_SMALL_FAST_MODEL في الدروس القديمة قم باستبداله مباشرة، ولا تبقيه.
الفخ الثاني: عدم القدرة على التمييز بين AUTH_TOKEN و API_KEY
عند ربط نماذج خارجية، أي متغير يجب استخدامه للمصادقة؟ هذان المتغيران يبدوان متشابهين، لكن سلوكهما مختلف تماماً — انظر مباشرة إلى البيان الرسمي:
| المتغير | السلوك الرسمي | أيهما تستخدم عند ربط نموذج خارجي |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | يُرسل كترويسة Authorization، ويتم إضافة بادئة Bearer للقيمة تلقائياً | ✅ استخدم هذا عند ربط DeepSeek وغيرها من النماذج الخارجية |
ANTHROPIC_API_KEY | يُرسل كترويسة X-Api-Key؛ في الوضع غير التفاعلي (-p) سيتم إجباره على استخدامه طالما أنه موجود | استخدمه عند الاتصال بـ Anthropic API الرسمي |
لماذا يُنصح باستخدام ANTHROPIC_AUTH_TOKEN للطرف الثالث؟ لأن الواجهات المتوافقة مثل DeepSeek تستخدم معيار Authorization: Bearer <key>، وهو يتطابق تماماً. وهذا هو السبب في استخدام ANTHROPIC_AUTH_TOKEN في كل من حلول المجتمع والتجارب الفعلية.
هناك أيضاً فخ صغير ذو صلة يجب أن تكون على دراية به: تنص الوثائق الرسمية صراحةً على أنه عندما يشير ANTHROPIC_BASE_URL إلى "مضيف ليس من الطرف الأول" (أي ليس عنواناً رسمياً)، سيتم إيقاف تشغيل بحث أداة MCP بشكل افتراضي. بعبارة بسيطة — بعد توصيل طرف ثالث، قد تختلف سلوكيات بعض الميزات المتقدمة التي تعتمد على الجهة الرسمية أو قد لا تكون متاحة للاستخدام. وهذا يتماشى مع عبارة "تجريبي، لا يوجد دعم" في القسم 02. لا يُستخدم كثيراً في البرمجة اليومية، ولكن إذا كنت تعتمد بشكل كبير على MCP، يجب أن تكون على علم بهذا.
💡 خلاصة في جملة واحدة: للمصادقة ابحث عن
ANTHROPIC_AUTH_TOKEN، وللنماذج الصغيرة ابحث عنANTHROPIC_DEFAULT_HAIKU_MODEL؛ استبدل المتغيرات المهملة في الدروس القديمة مباشرة، ربط طرف ثالث سيقلل من بعض الميزات المتقدمة.
07 ملخص
قامت هذه المقالة بشيء واحد فقط: استبدال "الدماغ" لـ Claude Code من Claude الرسمي إلى نماذج خارجية أرخص.
إليك النقاط الرئيسية:
| المرحلة | الإجراء الرئيسي |
|---|---|
| فكر بوضوح | الأمر يستحق التبديل فقط للمستخدمين الكثيفين / أصحاب الاتصال المباشر، أصحاب الاشتراكات لا تزعجوا أنفسكم |
| التوصيل | قم بإعداد ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN + اسم النموذج |
| التحقق | استخدم /status لترى ما إذا كان Base URL قد تغير |
| التوفير الأمثل | املأ النماذج في طبقات، المهام البسيطة للرخيص، المهام الصعبة للقوي، والوكلاء الفرعيون للأرخص |
| تجنب الفخاخ | لا تستخدم المتغير المهمل ANTHROPIC_SMALL_FAST_MODEL؛ استخدم AUTH_TOKEN للمصادقة |
يجب أن تكون الآن قادراً على: ربط DeepSeek (أو أي نموذج خارجي متوافق مع بروتوكول Anthropic) بـ Claude Code بشكل مستقل، والتحقق من الاتصال، وتكوينه عبر الطبقات حسب المهام لتقليل فاتورتك.
دعنا نؤكد مرة أخرى على هذه العبارة المخالفة للبديهة: هذه وسيلة لتوفير المال، وليست دورة إلزامية. ما إذا كان الأمر يستحق العناء يعتمد على ما إذا كنت تشعر حقاً بالألم تجاه فاتورة API الخاصة بك — بالنسبة لمعظم المستخدمين الخفيفين، من الأفضل استخدام النموذج الرسمي.
المقالة التالية 06 · Coding Plan: باقات الاشتراك والفوترة — بما أن هذه المقالة كانت تتحدث طوال الوقت عن "توفير المال"، دعنا نحسب التكلفة حتى النهاية: باقات اشتراك Claude (Pro / Max) أم الدفع حسب الاستخدام عبر API، أيهما أكثر فعالية من حيث التكلفة؟ أترك لك سؤالاً لتفكر فيه أولاً: إذا كنت تستخدم Claude Code بكثافة كل يوم، هل يجب عليك شراء اشتراك، أم أن الاتصال بـ API خارجي سيوفر لك المزيد؟ ستجد الإجابة بعد قراءة المقالة التالية.