نقطة نهاية API شخصي لClaude Code: إعداد بوابة طرف ثالث مع نماذج مفتوحة المصدر الصينية

يمكن تكوين Claude Code لتتواصل مع نقطة نهاية متوافق مع Anthropic بدلاً من استخدام نقطة نهاية مزودة مباشرة من مزود. هذا يسمح بتجربة عملية بوابة تدير طرف ثالث مع IDs نماذج المعرض من البوابة، بما في ذلك نماذج مفتوحة المصدر الصينية المتاحة في الفهرس الحالي لنماذج ECAIX.

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

بداية سريعة

إذا فهمت بالفعل حدود التوافق، استخدم هذا المسار القصير أولاً:

1. افتح الفهرس الحالي لنماذج ECAIX واختر ID نموذجي نشط.
2. أنشئ مفتاح API لـ ECAIX وابقه خارج إدارة المصدر.
3. حدد ANTHROPIC_BASE_URL إلى https://ecaix.com/api/ai/v1/anthropic.
4. أرسل طلب التشخيص أدناه وقم بتسجيل حالة HTTP.
5. قم بتشغيل Claude Code في مشروع اختبار قراءة فقط باستخدام claude -p.
6. اختبر الأدوات، التدفق، حدود السياق، والصلاحيات بشكل منفصل.

حالة التحقق عند النشر

هذه الجدولية مقصودة: مثال تكوين ليس نفسه نتيجة توافق مؤكدة.

ما يتغير في الإعداد

يتكون الإعداد من أربعة أجزاء منفصلة:

1. Claude Code هو العميل الذي يخلق المهام التكنولوجية ويرسل الطلبات.
2. بوابة متوافق مع Anthropic يستقبل الطلبات في نقطة نهاية متوافق مع Anthropic.
3. ID النموذج يختار النموذج الأم المعرض من البوابة.
4. مفتاح API يؤيد الطلب ويحدد الحساب، وحجم الاستخدام، والصلاحيات.

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

قبل البدء

أنت بحاجة إلى:

• تثبيت Claude Code يدعم تكوين النقطة النهاية عبر بيئة أو إعدادات.
• مفتاح API لـ ECAIX.
• ID نموذج موجود حاليًا في الفهرس الحالي لنماذج ECAIX.
• شاشة ترميز حيث يمكنك تشغيل طلب صغير دون وضع مفتاح API في إدارة المصدر.

تغير الفهرس باستمرار. قبل نسخ ID النموذج إلى ملف التكوين، افتح قائمة نماذج ECAIX واكتب أن النموذج نشط ومتوفر للاستخدام حسب نوع API الذي ترغب في استخدامه.

تكوين بوابة النقطة النهاية

يخزن Claude Code الإعدادات في ~/.claude/settings.json في العديد من الإعدادات. يمكن أن تتغير هيكل الإعدادات الخاصة بك، لذا افترض ما يلي كنموذج أولي وقارنه مع وثائق إصدارك الحالي.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

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

يمكنك أيضًا تكوين النقطة النهاية في جلسة ترميز أثناء الاختبار:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

يمكن أن تتغير أسماء المتغيرات والإعدادات المدعومة من إصدار خاص من Claude Code. إذا تجاهل العميل ANTHROPIC_MODEL, استخدم حقل النموذج أو آلية أسماء النماذج الموصوفة في إصدارك. لا يزال يجب على البوابة التعرف على ID النموذج النهائي.

التحقق من النقطة النهاية المتوافق مع Anthropic أولاً

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

أمر أدناه يحفظ العناوين والجسم الإجابي بشكل منفصل ثم ينشر حالة HTTP. استخدم مفتاحًا موثوقًا به فقط في جلسة ترميز محلية؛ لا تقم أبدًا بإدراجه في المقال أو في قضية أو سجل مشترك.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

التفسير المتوقع:

• 200: تحقق من شكل الإجابة وتأكد من الحقول النموذجية أو الحقول المستخدمة.
• 401 أو 403: تحقق من المفتاح، العناوين، الحساب، والحد من صلاحيات الوصول قبل تغيير الإجابة.
• 404: تحقق من URL الأساسية، الجزء /messages, وDeployment النقطة النهاية.
• 400: تقليل الطلب إلى الجسم الأصغر والأكثر صحة، وتحقق من الحقول الخاصة بالنموذج.
• 5xx أو الوقت المفقود: سجل الوقت الذي تم فيه إرسال الطلب والجسم الإجابي، ثم تفصل سلوك الوقت المفقود للبوابة، والنموذج الأم، والوقت المفقود للعميل.

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

اختيار ID النموذج

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

تطوير وتطوير عام

ابدأ باستخدام نموذج DeepSeek أو Qwen أو GLM أو Seed قادر على التطوير والتطوير، والذي يظهر في الفهرس. على سبيل المثال، قد تعرض الفهرس IDs مثل deepseek-v4.1-flash, qwen3.8-flash, glm-5.3, أو seed-2.0-code. يمكن أن تتغير المتاحة والقدرات، لذا تحقق دائمًا من صفحة النموذج الحالية قبل النشر التكوين.

العمل مع مستودعات طويلة السياق وثقافات طويلة

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

عملاء الأدوات والعملية الآلية

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

تطوير العملات الصينية

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

اختبار الكود لClaude بعد نجاح طلب API

بعد نجاح طلب مباشر، ابدأ بتجربة أمر غير محرر أو منخفض المخاطر:

claude -p "Explain what this repository does without editing files."

ثم اختبر مهمة محدودة النطاق، على سبيل المثال:

claude -p "List the likely entry points for the web application. Do not modify files."

استخدم اختبارات أكثر تحديًا تدريجيًا:

1. إجابة نصية.
2. شرح مختصر للكود.
3. التنقل في dépôt.
4. تعديل مخطط في فرع مؤقت.
5. استخدام الأدوات أو المهام المتعددة الخطوات.
6. السلوك التدفق والقدرة على معالجة السياق الطويل.

لا تتوقع أن نجاح الإجابة النصية يثبت أن سلوك طلبات الترخيص، أو المكالمات عبر الأدوات، أو التدفق، أو حدود السياق، أو تحرير الملفات يتطابق تمامًا مع جلسة مستخدم Claude.

اختيار المسار الصحيح API

Claude Code هو فقط workflow واحد من عملاء API. يعتمد المسار الصحيح على العميل والخصائص المخصصة التي تحتاجها:

لإيكسيك (ECAIX)، استخدم وثيقة رسائل Anthropic للمسار المتوافق مع Anthropic، ووثيقة مكتملات المحادثة للمستخدمين المتوافقين مع OpenAI. استخدم قائمة النماذج لتأكيد النموذج الحالي، وصفحة التكاليف لتأكيد التكاليف المعروضة حاليًا.

جدول التوافق

الجدول التالي هو حدود إثبات النشر، وليس اعترافًا بأن كل الخاصية مدعومة:

هذه التفرقة تمنع عرض طلب بسيط ناجح على أنه شهادة كاملة لتوافق Claude Code.

صفحات التفاصيل للنماذج والأIDs الحالية

استخدم صفحات التفاصيل للنماذج بدلاً من نسخ اسم نموذج قديم من منشور:

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• Kimi K3

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

بعد الخطأ، استخدم هذا الترتيب بدلاً من تغيير عدة متغيرات في نفس الوقت:

1. حفظ حالة الإجابة HTTP والجسم.
2. تأكيد URL الأساسية ومقاطع نهاية النهاية.
3. تأكيد أن مفتاح API موجود محليًا ويحتوي على الصلاحيات المتوقعة.
4. تأكيد ID النموذج الدقيق في الكتالوج الحي الكتالوج النموذجي.
5. إعادة المحاولة باستخدام طلب صغير وموثق.
6. مقارنة النتيجة مع طلب العميل الذي أرسله Claude Code.
7. فقط بعد ذلك استكشف اختلافات التوجيه، أو الوقت المحدد، أو اختلافات مخطط الأدوات.

للمشكلة "النموذج غير موجود"، هذا يفصل بين خطأ الكتابة عن مشكلة صلاحية، أو مشكلة في التوجيه، أو فشل المورد الأصلي. بالنسبة لـ "401" و"403"، تغيير النموذج عادة ما لا يكون الحل الأول. بالنسبة للمشكلة التي ناجحة في النص/فشل الأدوات، يجب أن تستمر الاختبار التالي مع مخطط الأدوات بدلاً من طلب نص آخر.

أخطاء شائعة

الأمن والحماية البيانات

اعتبر البوابة كحدد خدمة منفصل. قبل إرسال مصدر الكود أو بيانات العملاء، مرر:

• أي خدمة تتلقى طلبات المحتوى والمحتويات الملفية.
• ما إذا كانت الطلبات والإجابات يتم تسجيلها.
• كيف يتم تخزين وتجديد مفاتيح API.
• ما إذا كانت المسار النموذجي هو اتصال حقيقي مع المورد الأصلي أو مسار بديل لمورد آخر.
• الأدوات التي يمكن للمستخدم invoke.
• كيف يمكن إلغاء صلاحية المفتاح بعد الاختبار.

لا تقم بنشر مفتاح إنتاجي في مشكلة عامة، أو مقالة، أو شاشة، أو تاريخ команд التي يتم مشاركتها مع الآخرين.

قائمة مراجعة التوافق العملي

قبل اعتبار دمج النظام مفيدًا للفرق، سجل نتيجة كل اختبار:

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

عندما لا تستخدم الإعداد

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

الحفاظ على الإعداد الحالي

مرر الإعداد عند حدوث أي من التغييرات التالية:

• تحديث كلود كود.
• تغير بوابة التحويل في تنفيذها المتوافق مع أنثروبيك.
• تغيير اسم النموذج أو إزالته أو إعادة تعيينه إلى نموذج مصدر آخر.
• تغيير تدفق الأدوات، أو حدود السياق، أو سلوك الأخطاء.
• تغيير ECAIX في النماذج أو حدود API المعروضة في الكتالوج الحي.

احتفظ بالإعداد في مشروع اختبار صغير وموثق. هذا يسهل مقارنة السلوك بعد تحديث العميل أو النموذج دون التعرض لمستودع إنتاج.

مصادر

• كلود كود من أنثروبيك: بوابات لملفات نظام اللغة المتقدمة
• وثائق API ديب سيك
• قواعد البداية لQwen
• توافق Qwen مع API من OpenAI