استخدام Claude Code مع أي نموذج: إعداد نقطة نهاية مخصصة

Claude Code هو وكيل سطر الأوامر من Anthropic للبرمجة. وهو يتصل بنقطة نهاية واحدة، /v1/messages بتنسيق Anthropic Messages، ويتيح لك تغيير عنوان URL الأساسي. وجّه الاتصال إلى GetVibe API، ويمكن لسطر الأوامر نفسه تشغيل Claude Opus 5.5 أو Claude Sonnet 5 أو نموذج غير تابع لـ Claude من كتالوجنا، باستخدام مفتاح مدفوع مسبقًا واحد.

الخطوة 1: settings.json

ثبّت Claude Code (npm install -g @anthropic-ai/claude-code، Node.js 22+)، ثم أنشئ الملف ~/.claude/settings.json أو عدّله. في Windows، يكون الملف في %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-...",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": ""
  }
}

هناك تفصيلان مهمان:

• يجب أن تكون قيمة ANTHROPIC_API_KEY سلسلة فارغة، وألا تكون مفقودة. إذا لم تكن موجودة، يتجاهل Claude Code عنوان URL الأساسي ويتصل مباشرةً بـ Anthropic.
• يجب ألا يتضمن عنوان URL الأساسي /v1. إذ يضيف Claude Code المسار /v1/messages بنفسه، ولذلك سيؤدي استخدام https://getvibeapi.com/v1 إلى تكرار المسار.

شغّل claude واكتب /status. يجب أن يظهر سطر عنوان URL الأساسي لـ Anthropic على النحو التالي: https://getvibeapi.com.

الخطوة 2: اختر النماذج

يحتوي Claude Code على ثلاث خانات للنماذج: Opus وSonnet وHaiku. ويستخدم خانة Sonnet افتراضيًا لمعظم المهام، وخانة Haiku للعمليات السريعة. كل خانة هي متغير بيئي، ويمكن أن تكون قيمتها أي معرّف نموذج من كتالوجنا يقبل تنسيق Messages:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-...",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL":   "claude-opus-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL":  "claude-haiku-4.5"
  }
}

لتشغيل الوكيل على نموذج منخفض التكلفة، ضع معرّفه في خانة Sonnet، مثل deepseek-v4.1-flash أو gemini-3.8-flash. استخدم معرّفات الكتالوج الدقيقة: فأسماء إصدارات Anthropic المؤرخة، مثل claude-haiku-4-5-20251001، لا يتم التعرّف عليها.

ما النماذج التي تعمل مع Claude Code؟

لا تقبل جميع النماذج الموجودة في الكتالوج تنسيق Anthropic Messages. ويحدد الكتالوج العام على https://getvibeapi.com/api/catalog كل نموذج باستخدام anthropicFormat. عندما تكون قيمته true، يعمل النموذج عبر /v1/messages. وفي وقت كتابة هذا المقال، يشمل ذلك:

لا تقبل نماذج GPT-6 ‏(Luna وSol وAstra) تنسيق Messages، ويتم رفضها عند استخدامها مع /v1/messages. لاستخدامها في وكيل طرفية، استخدم Codex CLI الذي يتحدث إلى Responses API، أو أي أداة تستخدم عنوان URL أساسيًا متوافقًا مع OpenAI (راجع قائمة التكاملات).

المشكلات الشائعة

• 401: تحقّق من قيمة ANTHROPIC_AUTH_TOKEN ومن أن قيمة ANTHROPIC_API_KEY هي "".
• ما تزال الطلبات تتجه إلى Anthropic: لم يتم تعيين ANTHROPIC_API_KEY كسلسلة فارغة.
• لم يتم التقاط المتغيرات: يُعد settings.json أكثر موثوقية من ملفات تعريف shell، خصوصًا في Windows.
• النموذج غير متاح: المعرّف مكتوب بشكل خاطئ، أو تم إيقافه، أو لا يدعم تنسيق Messages. تحقّق منه في صفحة النماذج.

خفض التكلفة

تعيد وكلاء البرمجة إرسال بادئة طويلة لم تتغير في معظمها مع كل دور. ولا تُجري نماذج Claude التخزين المؤقت إلا عندما يحمل الطلب نقطة توقف cache_control. إذا لم يرسل Claude Code واحدة، تضيفها البوابة نيابةً عنك. وتُحتسب تكلفة الإدخال المخزّن مؤقتًا بجزء من معدل الإدخال. يشرح دليل التخزين المؤقت ومقالة التخزين المؤقت للمطالبات كيفية الحفاظ على ثبات البادئة.

توجد الوثائق المرجعية الكاملة في دليل Claude Code وMessages وResponses. تدفع مقابل كل رمز مميّز من رصيد مدفوع مسبقًا. ولا يوجد اشتراك.