استخدام Claude Code مع GetVibe: الإعداد والنماذج والتكلفة

لا يستخدم Claude Code نقطة نهاية المحادثة من OpenAI. بل يرسل طلبات Anthropic Messages إلى /v1/messages، ولذلك يجب أن يستخدم عنوانه الأساسي وبيانات اعتماده إعدادات Anthropic الخاصة بـ Claude Code. يدعم GetVibe تنسيق Messages لنماذج محددة في الكتالوج؛ أما GPT-6 Luna وGPT-6 Sol وGPT-6.1 Sol فهي غير متوافقة مع مسار CLI هذا. يتبع هذا الدليل إعداد Claude Code في GetVibe والمرجع الحالي لنقطة النهاية المخصصة.

تثبيت Claude Code وإعداده

ثبّت CLI باستخدام Node.js 22 أو إصدار أحدث:

npm install -g @anthropic-ai/claude-code
mkdir -p ~/.claude

حرّر الملف ~/.claude/settings.json واستخدم الحقول التالية كما هي. لا يحتوي عنوان URL الأساسي عمدًا على /v1؛ إذ يضيف Claude Code المسار /v1/messages. أما قيمة ANTHROPIC_API_KEY الفارغة فهي مهمة: فمن دونها قد يفضّل Claude Code استخدام مصادقة Anthropic المباشرة المعتادة بدلًا من نقطة النهاية المخصصة.

{
  "apiKeyHelper": "echo $GETVIBE_API_KEY",
  "env": {
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

عيّن المفتاح في shell قبل تشغيل Claude Code: export GETVIBE_API_KEY='your-dashboard-key'. هذا هو متغير البيئة الذي تستخدمه ملفات التكامل في GetVibe. يشير ملف الإعدادات إلى المتغير، ولا ينبغي أن يحتوي على المفتاح الفعلي. تجنّب وضع بيانات اعتماد Anthropic مباشرة في هذا الملف، لأن أولوية بيانات الاعتماد قد تتسبب في تجاوز نقطة النهاية المخصصة.

تحقق من نقطة النهاية قبل منح صلاحية الكتابة

شغّل claude في مستودع مؤقت ونفّذ /status. يجب أن يكون عنوان URL الأساسي لـ Anthropic هو https://getvibeapi.com. اطرح سؤالًا للقراءة فقط أولًا، ثم اطلب تعديلًا صغيرًا وافحص diff. إذا ظل الطلب يُرسل مباشرة إلى Anthropic، فتحقق من أن ANTHROPIC_API_KEY عبارة عن سلسلة فارغة، ومن أن المساعد يستطيع قراءة GETVIBE_API_KEY. إذا ظهر /v1/v1/messages مكررًا، فأزل /v1 من عنوان URL الأساسي.

ما النماذج التي تعمل عبر Messages؟

يسرد دليل التكامل الحالي في GetVibe Claude Opus 5.5 وClaude Sonnet 5 وDeepSeek V4.1 Flash وGemini 3.8 Flash وGLM-5.3 وKimi K3 كأمثلة على النماذج المدعومة عبر مسار Anthropic Messages. راجع كتالوج النماذج الحالي قبل تغيير أي خانة؛ إذ إن دعم البروتوكول يختلف من نموذج إلى آخر. لا تعمل GPT-6 Luna وGPT-6 Sol وGPT-6.1 Sol عبر نقطة نهاية Messages في Claude Code. استخدم Codex CLI لهذه النماذج المتوافقة مع Responses بدلًا من ذلك. تُظهر لقطة الكتالوج العامة التي تم التحقق منها في 3 أكتوبر 2026 أن سعر Sonnet 5.5 هو $0.168 الإدخال · $0.84 الإخراج لكل مليون رمز لكل مليون رمز؛ ويظل السعر المعروض محدثًا.

عيّن خانات النماذج بعناية

يدعم Claude Code خانات Opus وSonnet وHaiku. يختار مثال إعدادات GetVibe معرّفات حالية لهذه الخانات، ويستخدم CLAUDE_CODE_SUBAGENT_MODEL للعمل مع الوكلاء الفرعيين. غيّر خانة واحدة في كل مرة. بعد إعادة تشغيل CLI، اسأل /status عن النموذج النشط ونفّذ prompt اختباريًا غير مؤذٍ. لا تفترض أن نموذج OpenAI ينتمي إلى خانة Claude: فالبروتوكول وآلية التعامل مع عائلة النموذج مختلفان.

لمقارنة التكلفة، قارن Sonnet وOpus في المهمة نفسها، ولقطة المستودع نفسها، والصلاحيات نفسها، وطلب الإخراج نفسه. سجّل جميع جولات الوكيل وخطوات الإصلاح. يظهر سعر Sonnet 5.5 الحالي على أنه $0.168 الإدخال · $0.84 الإخراج لكل مليون رمز لكل مليون رمز من رموز الإدخال والإخراج. تاريخ لقطة الكتالوج هو 3 أكتوبر 2026؛ استخدم صفحة النموذج المرتبطة عند إعداد ميزانية جلسة جديدة.

تحكّم في الجلسات الطويلة

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

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

أخطاء الإعداد الشائعة

401: تحقّق من GETVIBE_API_KEY، وناتج المساعد، ومن أن ANTHROPIC_API_KEY فارغ.
تجاوزت حركة المرور GetVibe: تحقّق من بيانات الاعتماد في ملف shell الشخصي، وتأكد من عنوان URL الأساسي باستخدام /status.
النموذج غير متاح: انسخ معرّفًا حاليًا دقيقًا وتحقق من توافق Messages في صفحة النموذج.
عنوان URL غير صحيح: عيّن النطاق الجذر من دون /v1؛ إذ يضيف Claude Code لاحقة المسار.

أنشئ خط أساس للتكلفة

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

أبقِ خانات النماذج محددة بوضوح

يحتوي Claude Code على خانات Opus وSonnet وHaiku. عيّن الخانات التي يخطط فريقك لاستخدامها فقط، وتأكد من الاختيار النشط باستخدام /status بعد تغيير الإعدادات. اسم خانة Claude ليس محوّلًا للبروتوكول: فلن يصبح نموذج مخصص لـ OpenAI فقط متوافقًا مع Messages لمجرد تعيينه إلى خانة Sonnet.

قِس التخزين المؤقت في جلسة فعلية

نفّذ مهمة قصيرة وأخرى متعددة الملفات باستخدام التعليمات الثابتة نفسها. قارن استخدام القراءة من الذاكرة المؤقتة في الجولات اللاحقة وسجّل التكلفة الإجمالية للجلسة. أبقِ الصلاحيات ولقطة المستودع وخانة النموذج دون تغيير بين التجارب المتكررة؛ وإلا فلن تتمكن المقارنة من تحديد ما إذا كان اختلاف التكلفة ناتجًا عن التخزين المؤقت أو استدعاءات أدوات إضافية أو مهمة مختلفة.

احمِ التعديلات وبيانات الاعتماد

استخدم شجرة عمل مؤقتة للمهمة الأولى التي تتضمن صلاحية الكتابة، وراجع الأوامر وdiffs، واحتفظ ببيانات الاعتماد في سر تديره shell. إذا ظهر مفتاح في سجل الطرفية أو في ملف إعدادات مشترك، فقم بتدويره. تتيح هذه الحدود البسيطة للمطورين استكشاف الوكيل من دون منح كل prompt إمكانية الوصول إلى بيانات الإنتاج أو شجرة عمل لم تُراجع.