دليل استخدام مزودي الطرف الثالث لـ Claude Code - تحليل متعمق وأفضل الممارسات

يوضح هذا المقال بالتفصيل كيفية استخدام مزودي الطرف الثالث (مثل DeepSeek و Z-AI و Moonshot وما إلى ذلك) لتكوين Claude Code، بما في ذلك إعداد متغيرات البيئة، وتحسين اختيار النموذج، وتقنيات استخدام وضع Plan، بالإضافة إلى نصائح عملية لتجنب الأخطاء الشائعة في التكوين.
Tags:
Categories:

دليل استخدام مزودي الطرف الثالث لـ Claude Code

مقدمة

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

تكوين متغيرات البيئة

التكوين الأساسي (ما يذكره معظم الدروس)

ANTHROPIC_BASE_URL=عنوان API الخاص بالموفر
ANTHROPIC_AUTH_TOKEN=رمز المصادقة الخاص بك
ANTHROPIC_MODEL=اسم النموذج الافتراضي

تم التخلص من ANTHROPIC_SMALL_FAST_MODEL، واستُبدِل بـ ANTHROPIC_DEFAULT_HAIKU_MODEL.

التكوين المتقدم (يتم ذكره بشكل أقل)

يدعم Claude Code حاليًا اختيار نماذج مختلفة لمختلف المهام:

# تكوين النماذج المختلفة لأنواع مختلفة من المهام
ANTHROPIC_DEFAULT_OPUS_MODEL=نموذج سلسلة opus
ANTHROPIC_DEFAULT_SONNET_MODEL=نموذج سلسلة sonnet
ANTHROPIC_DEFAULT_HAIKU_MODEL=نموذج سلسلة haiku

# نموذج الوكيل الفرعي
CLAUDE_CODE_SUBAGENT_MODEL=نموذج الوكيل الفرعي
# تعيين مهلة الانتظار
BASH_DEFAULT_TIMEOUT_MS=10000
# تعطيل حركة المرور غير الضرورية
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# تعطيل تنبيهات التكلفة، وإلا فسيتم إرسال تنبيه عند كل استخدام بقيمة 5 دولارات وفقًا لسعر Claude Sonnet
DISABLE_COST_WARNINGS=1
# تعطيل استدعاءات النموذج غير الضرورية
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# تعطيل مراقبة البيانات
DISABLE_TELEMETRY=1

claudecod-with-third-party-vendor-2025-09-17-22-22-43

المزيد من الإعدادات متوفرة في: https://docs.claude.com/en/docs/claude-code/settings#environment-variables

نصائح استخدام وضع Plan

وضع Plan في Claude Code هو ميزة مفيدة جدًا، حيث يدفع الذكاء الاصطناعي للتفكير أكثر دون تعديل الملفات مباشرة. هذا الوضع مثالي للعمل مع نموذج Reasoner من DeepSeek، حيث يمكن في وضع plan:

  • تقليل التعديلات غير الضرورية للملفات
  • تقديم عملية تفكير أكثر تفصيلًا
  • مناسب للاستعراض المعقد للكود واتخاذ قرارات التصميم

التبديل السريع بين مزودي الطرف الثالث

قام البعض بتطوير أداة Claude Code Router لدمج مزودي نماذج الطرف الثالث في Claude Code، وقام آخرون بتطوير أداة لتبديل متغيرات البيئة. أنا لا أنصح بشدة باستخدام هذه العمليات الإضافية. كل ما تحتاجه حقًا هو فتح إعدادات VS Code، ثم البحث عن terminal.integrated.env، وتكوين أول ثلاثة خيارات قابلة للتكوين.

vscode设置项

مثل هذا:

claudecod-with-third-party-vendor-2025-09-17-22-23-05

ثم عند فتح طرفية جديدة داخل VS Code، سيتم استخدام متغيرات البيئة الجديدة. لا حاجة لاستخدام أدوات الطرف الثالث الإضافية، يكفي تكوين VS Code الخاص بك.

لماذا لا يُنصح باستخدام أدوات تحويل API

يحاول العديد من المستخدمين استخدام Claude Code Router أو كتابة نصوص تحويل لراحتهم، ولكن غالبًا ما تنبع هذه الطرق من عدم الإلمام بـ VS Code وواجهات API.

التوصية: اختر الموردين الذين يدعمون واجهة Anthropic API بشكل أصلي، بدلاً من قضاء الوقت في تحويل API. الأسباب كالتالي:

  • تحويل واجهة Anthropic API معقد، ويصعب التوفيق بينه بشكل مثالي
  • الموردون المدعومون رسميًا يقدمون خدمة أكثر استقرارًا
  • تجنب مشكلات التوافق ووقت التصحيح غير الضروري

يوجد فجوة كبيرة بين API العادي و Anthropic API، إليك جدول التوافق الرسمي لتحويل DeepSeek إلى Anthropic API: DeepSeek-anthropic_api#anthropic-api-兼容性细节

حتى التحويل الرسمي لا يزال يحتوي على العديد من عدم التوافق، ناهيك عن التحويل الذاتي، لذلك لا أنصح بضياع الوقت في هذه الأمور.

موردو الطرف الثالث المحليون الذين يدعمون Claude Code

حاليًا أعرف الموردين المحليين الذين يدعمون واجهة Anthropic API بشكل أصلي ويشملون:

  • DeepSeek - أداء شامل ممتاز
  • Z-AI - يقدم دعم API جيد
  • Moonshot - حجم بارامترات كبير
  • ModelScope - فقط GLM-4.5 يعمل بسلاسة

لا يوجد واحد منهم يدعم Claude Code بشكل مثالي، ويواجهون جميعًا مشكلات مختلفة، مثل DeepSeek لا يدعم subagent، والأربع شركات لا تدعم الصور والمستندات وما إلى ذلك. إذا أردت الشعور بقوة Claude Code الكاملة، فإن الحد الأدنى لدخول门槛 هو 100 دولار لـ Max، وليس 20 دولارًا لـ Pro، لأن Pro لا يمكنه استخدام نموذج Opus.

DeepSeek

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",

Z-AI

"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"CLAUDE_CODE_SUBAGENT_MODEL": "glm-4.5",

Moonshot

"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "kimi-k2-turbo-preview",

ModelScope

"ANTHROPIC_BASE_URL": "https://api-inference.modelscope.cn",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-R1-0528",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "ZhipuAI/GLM-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Qwen/Qwen3-Coder-480B-A35B-Instruct",
"CLAUDE_CODE_SUBAGENT_MODEL": "ZhipuAI/GLM-4.5",

خاتمة

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

للاطلاع على التفاصيل حول مشكلات الأمان، يرجى الرجوع إلى: تحليل المخاطر الأمنية لجهاز توجيه النموذج