Vercel AI SDK: متى يدفع اشتراكك تكلفة وكيل البرمجة؟

غيّرت Vercel في 14 سبتمبر 2026 الحساب الذي يمكنه دفع تكلفة وكيل برمجة مضمّن. يستطيع Vercel AI SDK الآن استخدام اشتراك مدعوم سبق تسجيل الدخول إليه على الجهاز المضيف، فتكون التكلفة الإضافية لتشغيل النموذج المؤهل التالي $0 إلى أن تنفد حصة الخطة. أما حوسبة Sandbox فلها فاتورتها المستقلة.

ما الذي يغيّره Vercel AI SDK في جهة الدفع؟

يضم AI SDK طبقة لتشغيل وكلاء برمجة متكاملين خلف واجهة HarnessAgent واحدة. وتسمّي Vercel كل موصّل من هذه الموصّلات harness لأنه يغلف أكثر من مجرد استدعاء للنموذج؛ فالوكيل يأتي بأدواته وسلوكه داخل مساحة العمل وحالة الجلسة والأذونات وآلية اختصار السياق الخاصة به.

وهذا فارق جوهري. لا يجعل هذا الإصدار Claude Code أو Codex أو Cursor أو أي وكيل آخر أفضل في البرمجة. ما يفعله هو منح الموصّل مكانًا جديدًا للعثور على بيانات الاعتماد: جلسة اشتراك أصلية محفوظة على الجهاز الذي يشغّل تطبيقك.

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

يسمّي إعلان الإصدار 9 موصّلات: Claude Code وCline وCodex وCursor وfx وGitHub Copilot وGrok Build وOpenCode وPi. لكن ذلك ليس ضمانًا شاملًا لكل حساب؛ إذ يظل على الوكيل الأساسي دعم تسجيل الدخول بالاشتراك، كما تظل قواعد خطته هي التي تحدد ما يمكن لهذا الدخول استهلاكه.

النتيجة العملية للأعمال بسيطة: قد يقع استدعاء agent.generate() نفسه على واحد من 3 بنود مختلفة في الميزانية، بحسب بيانات الاعتماد المحيطة به.

ترتيب بيانات الاعتماد هو الذي يحدد الفاتورة

توجد 3 أوضاع للمصادقة، والوضع الافتراضي هو auto. وبالنسبة إلى الموصّلات المباشرة مثل Claude Code وCodex، يكون ترتيب الأولوية عمليًا كما يلي:

هنا قد يغيّر متغير بيئة صامت مسار المحاسبة بالكامل. فعند تشغيل Claude Code في وضع direct، سيُستخدم ANTHROPIC_API_KEY أو ANTHROPIC_AUTH_TOKEN قبل اشتراك Claude. وبالمثل، سيستخدم تشغيل Codex المتغير OPENAI_API_KEY أو CODEX_API_KEY قبل استحقاق ChatGPT.

يضيف auto مستوى آخر فوق ذلك كله. إذا وجد بيانات اعتماد لـ Gateway، فستكون الأولوية لها قبل مفتاح المزوّد والاشتراك معًا.

لا يتطابق مسار الشبكة مع مصدر الفوترة في جميع الموصّلات. فما زال fx يرسل طلبات النموذج عبر AI Gateway في وضعي direct وai-gateway، لكنه يستطيع الآن العثور على اشتراك أصلي مدعوم حين لا توجد بيانات اعتماد بيئية تنطبق على الحالة ولم يُختر ai-gateway. لذلك راجع صفحة الموصّل قبل التعامل مع هذا الجدول بوصفه خريطة نقل تصلح للجميع.

هذا الحد الأمني أفضل من نسخ رمز OAuth خام إلى جهاز معزول. تعثر Vercel على بيانات الاعتماد وتجدّد جلسة OAuth على الجهاز المضيف. وعندما يدعم Sandbox تحويل الطلبات، لا يرى الوكيل سوى قيمة بديلة، بينما يحقن الجهاز المضيف بيانات الاعتماد الحقيقية في الطلب الصادر المطابق فقط.

يحمي ذلك السر من Sandbox، لكنه لا يحوّل الاشتراك الشخصي إلى سعة مشتركة للشركة.

كيف تُحسب التكلفة فعليًا؟

يمكن نقل تكلفة النموذج إلى حصة اشتراك، لكن تكلفة بيئة التشغيل لا تنتقل معها.

حصة الاشتراك

يمثل Claude Code أوضح مثال حالي. تبلغ تكلفة Claude Pro ‏$20 عند الدفع شهريًا أو $200 للسنة، بينما تبلغ تكلفة Claude Max ‏$100 أو $200 شهريًا مقابل استخدام يعادل 5x أو 20x من Pro. إذا كنت تدفع بالفعل مقابل إحدى هذه الخطط، فلن يضيف التشغيل المؤهل عبر المصادقة الأصلية تكلفة منفصلة للنموذج إلى أن تنفد الحصة المشتركة.

وكلمة المشتركة هنا أساسية. توضح Anthropic حاليًا أن Claude Agent SDK وclaude -p وتطبيقات Agent SDK التابعة لجهات خارجية ما زالت تستهلك من حدود الاشتراك. كما توضح أن claude.ai وClaude Code وClaude Desktop تُحتسب جميعًا من حد الاستخدام نفسه. وبما أن موصّل Claude Code في Vercel يستخدم Agent SDK من Anthropic، فالقراءة العملية هي أن العمل المضمّن ينافس استخدامات المشترك الأخرى في Claude على الحصة نفسها.

لدى OpenAI بنية ميزانية مماثلة، لكن بعدّادات مختلفة. تبلغ تكلفة ChatGPT Plus ‏$20 شهريًا، ويأتي Codex ضمن خطط ChatGPT، فيما تختلف الحدود باختلاف الخطة. ويتشارك Codex حصة واحدة للعمل الوكيلي مع ChatGPT Work وChatGPT for Excel وWorkspace Agents حيثما تتوفر هذه المنتجات. ويمكن لمستخدمي Plus وPro المؤهلين شراء أرصدة بعد استنفاد الاستخدام المضمّن، لكنها ليست أرصدة API.

إذًا، لا يعني مسار الاشتراك استدلالًا مجانيًا؛ بل هو سعة مدفوعة مسبقًا بسقف متغير. وقد يوفر نقل المهام الخلفية إلى الموصّل رسوم API اليوم، لكنه قد يقلّص مدة جلسة المستخدم التفاعلية غدًا.

API المباشر للمزوّد

إذا فاز مفتاح المزوّد بالأولوية، فسيتحمّل حسابه القائم على الاستخدام المقاس التكلفة. تبلغ تكلفة Claude Sonnet 4.6 حاليًا $3 لكل مليون رمز إدخال و$15 لكل مليون رمز إخراج وفق أسعار API القياسية. أما GPT-5.6 Luna من OpenAI، فتبلغ تكلفته $0.20 لكل مليون رمز إدخال، و$0.02 لكل مليون رمز إدخال مخزّن مؤقتًا، و$1.20 لكل مليون رمز إخراج.

تجعل هذه الأسعار تكلفة مسار API سهلة الإسناد، لكنها لا تجعل تكلفة مهمة وكيل برمجة سهلة التنبؤ. فحجم المستودع وسجل المحادثة ومستوى جهد الاستدلال وإعادة المحاولات وحلقات الأدوات كلها تغيّر استهلاك الرموز. قِس المهام المكتملة، لا المطالبات.

Vercel AI Gateway

إذا فازت بيانات اعتماد Gateway بالأولوية، يظهر الاستخدام في AI Gateway. تفرض Vercel سعر المزوّد الأصلي المعلن بلا زيادة على سعر الرموز أو رسوم للمنصة. ويكون مصدر الدفع المعتاد رصيد Gateway مدفوعًا مسبقًا، فيما يستطيع عملاء Enterprise استخدام فاتورة Vercel موحّدة.

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

حوسبة Sandbox

تظل كل بيئة تشغيل لوكيل AI SDK عاملة داخل Sandbox. في منطقة Vercel الافتراضية iad1، تبلغ تكلفة Sandbox ‏$0.128 لكل ساعة Active CPU و$0.0212 لكل ساعة من الذاكرة المحجوزة بسعة GB واحدة. يتوقف احتساب CPU أثناء انتظار العملية للنموذج أو إدخال وإخراج الشبكة، لكن الذاكرة تستمر طوال زمن التشغيل الفعلي.

يعمل مثال Vercel نفسه للتحقق من شيفرة AI مدة 5 دقائق باستخدام وحدتي vCPU وذاكرة بسعة 4 GB، وتبلغ تكلفته نحو $0.03 عند استخدام CPU بنسبة 100%. ولو كان رصيد Pro البالغ $20 متاحًا بالكامل لهذه المهمة نفسها دون سواها، لأعطت الحسبة سقفًا تقريبيًا قدره 666 تشغيلًا قبل بدء الاستخدام المدفوع لـ Sandbox. أما السعة الفعلية فستختلف لأن خدمات Vercel الأخرى قد تستهلك الرصيد، ولأن المهام تستخدم موارد مختلفة، وقد تضاف تكاليف النقل أو التخزين.

هذه هي الميزانية كاملة:

• مسار الاشتراك: سعر الخطة الحالية، وحصتها المشتركة، إضافة إلى Sandbox.
• مسار المزوّد: رموز المزوّد ذات الاستخدام المقاس، إضافة إلى Sandbox.
• مسار Gateway: رموز بسعر المزوّد المعلن تُخصم من رصيد Gateway أو فاتورته، إضافة إلى Sandbox.

من الأنسب لكل مسار؟

مؤسس منفرد يشغّل مساعدًا داخليًا للمستودع

يستطيع مؤسس يدفع بالفعل مقابل Claude Pro أو ChatGPT Plus وضع أداة محدودة الاستخدام لإصلاح الاختبارات أو تلخيص المستودع خلف HarnessAgent، ثم اختيار direct وترك الخطة الأصلية تغطي عمل النموذج المؤهل. والمكسب في مرحلة التجربة هو تجنّب فتح رصيد آخر للنموذج.

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

قائد تقني في وكالة يوحّد مهام المشغّلين

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

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

فريق منصة تطوير يشغّل أتمتة مشتركة

ينبغي لفريق المنصة في العادة تثبيت المهام غير المراقبة أو المشتركة على ai-gateway. صحيح أن ذلك يتنازل عن نافذة الاشتراك ذات التكلفة الإضافية البالغة $0، لكنه يمنح الفريق مالك فوترة واحدًا، ورصيدًا أو فاتورة واحدة، وضوابط إنفاق مرتبطة بالخدمة بدلًا من شخص بعينه.

لا يزال الشرح الأقدم لموصّل fx مصيبًا في تفصيل مهم: كلا وضعي fx يرسلان طلبات النموذج عبر AI Gateway. وما تغيّر في 14 سبتمبر هو خيار الرجوع إلى بيانات اعتماد بديلة. ولذلك بات على أقسام الإعداد والتكلفة فيه احتساب اشتراك أصلي مدعوم عندما لا تتقدم عليه بيانات اعتماد أعلى أولوية.

مؤسس SaaS يبيع عمل الوكلاء للعملاء

لا ينبغي لميزة برمجة موجّهة إلى العملاء أن تعتمد في تخطيط سعتها على اشتراك موظف واحد. فحركة العملاء مشتركة ومتغيرة، ويُفترض أن تستمر رغم تغيّر الموظفين. استخدم AI Gateway أو حساب API لدى المزوّد بمالك محدد، ثم أدخل Sandbox في اقتصاديات الوحدة.

تجيب المقارنة المستقلة لوكلاء البرمجة العاملين بالاشتراكات عن سؤال مختلف: أي عميل محلي أو مفتوح المصدر ينبغي لمطوّر واحد استخدامه مع خطة يملكها بالفعل؟ أما هذا الإصدار فيتعلق بتضمين بيئة تشغيل مدعومة داخل تطبيق AI SDK. قد يكون تسجيل الدخول متشابهًا، لكن نموذج التشغيل ليس كذلك.

تشغيل مهمة Claude Code واحدة على حصة الاشتراك

هذا المسار مخصص لمهمة داخلية محدودة على جهاز مضيف سبق لمستخدم محدد بالاسم تسجيل الدخول إلى Claude Code عليه. وهو يختار direct عمدًا عبر إعداد موصّل Claude Code الموثّق، كي يتمكن رمز Vercel OIDC من مصادقة Sandbox من دون توجيه عمل النموذج إلى Gateway.

1. 1

   ثبّت الحزم الموثّقة

   داخل مشروع Node قائم، أضف حزمة الوكيل الأساسية وموصّل Claude Code وموصّل Vercel Sandbox.

   pnpm add @ai-sdk/harness @ai-sdk/harness-claude-code @ai-sdk/sandbox-vercel

2. 2

   سجّل الدخول على الجهاز المضيف

   شغّل Claude Code على الجهاز المضيف نفسه، واختر حساب Claude ذي الاشتراك المؤهل.

   claude

   أبقِ VERCEL_OIDC_TOKEN متاحًا لـ Sandbox. افحص بيئة العملية وأزل ANTHROPIC_API_KEY وANTHROPIC_AUTH_TOKEN من هذا التشغيل إذا أردت أن يدفع الاشتراك. فأي من متغيري المزوّد يتقدم على تسجيل الدخول الأصلي.

3. 3

   افرض المسار المباشر

   احفظ الملف باسم agent.mjs. تستخدم الشيفرة محدد direct الموثّق، وبيئة تشغيل Sandbox الحالية node24، والمنفذ المكشوف 4000 الذي يتطلبه الجسر.

   import { HarnessAgent } from '@ai-sdk/harness/agent';
   import { createClaudeCode } from '@ai-sdk/harness-claude-code';
   import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
   
   const agent = new HarnessAgent({
     harness: createClaudeCode({ auth: 'direct' }),
     model: 'claude-sonnet-4-6',
     sandbox: createVercelSandbox({
       runtime: 'node24',
       ports: [4000],
     }),
   });
   
   const session = await agent.createSession();
   
   let exitCode = 0;
   try {
     const result = await agent.generate({
       session,
       prompt: 'Create a short TODO.md for this repository.',
     });
   
     console.log(result.text);
   } catch (err) {
     exitCode = 1;
     console.error(err);
   } finally {
     await session.destroy();
     process.exit(exitCode);
   }

4. 4

   تحقق من سجلي التكلفة

   شغّل مهمة واحدة غير مؤذية. تأكد من أن صفحة الاستخدام لدى المزوّد تُظهر استهلاك حصة الخطة من دون رسوم API جديدة، ثم راجع Vercel Usage بحثًا عن بند Sandbox.

   إذا سجّل AI Gateway طلب النموذج، فقد فازت بيانات اعتماد Gateway بالأولوية. وإذا سجّلت لوحة API لدى المزوّد رسمًا، فقد فازت بيانات اعتماد المزوّد. توقف وأصلح البيئة قبل توسيع التجربة.

الحدود التي يجب قولها بوضوح

يرتبط تسجيل الدخول الأصلي بالجهاز المضيف. فهو ليس تدفق OAuth جاهزًا لكل عميل في تطبيقك، ولا يجمع حصص الأفراد في سعة واحدة للفريق.

كما أن سعة الخطة متغيرة. تقول OpenAI إن حدود Codex تختلف بحسب الخطة والمهمة، وتقول Anthropic إن استخدام Claude يعتمد على النموذج وتعقيد المهمة والسياق والجهد. ولا تقدم أي منهما لهذا المسار عبر Vercel عددًا ثابتًا من مهام الإنتاج.

ولا تزال حزم وكلاء AI SDK تجريبية، وقد تحمل الإصدارات الجديدة تغييرات كاسرة. يمكن قبول ذلك في تجربة داخلية مقاسة، لكنه سبب لتثبيت إصدارات الاعتماديات واختبار اختيار بيانات الاعتماد وتجهيز مسار Gateway أو المزوّد قبل إدخال الميزة ضمن وعد للعملاء.

الخطوة العملية ليوم الاثنين

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

ابدأ هذا الأسبوع إذا كنت تملك بالفعل خطة مدعومة ولديك سير عمل داخلي محدود. وانتظر إذا كان الوكيل الأساسي لا يدعم تسجيل الدخول بالاشتراك، أو إذا كانت الصفة التجريبية للحزمة تتعارض مع سياسة الاعتماديات لديك. وابقَ على ai-gateway إذا كانت الميزانيات المركزية وملكية الإنتاج المشتركة أهم من الوفر الهامشي في تكلفة النموذج. ولن يؤثر فيك هذا التغيير إذا كنت تستدعي مزوّدي النماذج العاديين في AI SDK ولا تستخدم HarnessAgent مطلقًا.

لمزيد من الشروحات العملية لأدوات AI التي تغيّر الميزانيات وسير العمل فعلًا، اشترك في النشرة البريدية.