عندما تستخدم نموذج ذكاء اصطناعي في OpenCode، يذهب طلبك مباشرة إلى مزوّد النموذج: Anthropic أو OpenAI أو Google أو من يستضيف النموذج. هذا يعني حسابًا منفصلًا، ومفتاح API منفصلًا، وفاتورة منفصلة لكل مزوّد. يجلس AI gateway بين OpenCode والمزوّدين، ويمنحك نقطة تحكم واحدة: فاتورة واحدة، ومجموعة سجلات واحدة، ومكانًا واحدًا لإدارة الوصول.
في هذا التمرين، ستعدّ Cloudflare AI Gateway وتربطه بـ OpenCode. مع Unified Billing، تحمّل رصيدًا في حساب Cloudflare وتستخدم نماذج من Anthropic وOpenAI ومزوّدين آخرين دون الحاجة إلى مفاتيح API الخاصة بهم. يتولى Cloudflare مدفوعات المزوّدين.
لماذا تستخدم gateway؟
بلا gateway، كل مزوّد علاقة منفصلة: سجّل، احصل على مفتاح API، أدِر الفوترة، تحقق من الاستخدام. مع gateway:
- فاتورة واحدة — حمّل رصيدًا مرة، واستخدم نماذج من أي مزوّد مدعوم
- التسجيل — كل طلب ورد يُسجَّل في مكان واحد، مفيد لتصحيح الأخطاء وفهم الاستخدام
- تبديل المزوّدين — جرّب نماذج مختلفة دون إنشاء حسابات جديدة أو إدارة مفاتيح API جديدة
- التخزين المؤقت — يمكن تقديم الطلبات المتطابقة المتكررة من الذاكرة المؤقتة، مما يوفّر المال ويقلّل زمن الاستجابة
بوابات الذكاء الاصطناعي نمط شائع. خطط Zen وGo الخاصة بـ OpenCode تعمل بالطريقة نفسها — إنها بوابات تمرّر طلباتك إلى مزوّدين متعددين خلف مفتاح API واحد. في هذا التمرين، ستعدّ gateway خاصًا بك مع Cloudflare، مما يمنحك تحكمًا مباشرًا في المزوّدين الذين تستخدمهم، وكم تنفق، وما يُسجَّل.
المتطلبات
ستحتاج إلى حساب Cloudflare مجاني وNode.js مثبتًا (من أجل wrangler CLI). إن كنت قد أكملت تمرين ابنِ موقعًا إلكترونيًا، فلديك كلاهما بالفعل.
ستحمّل أيضًا 5 دولارات على الأقل كرصيد في الـ gateway من أجل Unified Billing. هذا مال حقيقي، لكن 5 دولارات تقطع شوطًا طويلًا: محادثة Claude Sonnet نموذجية تكلف بضعة سنتات.
ما الذي ستفعله
- إنشاء gateway في لوحة تحكم Cloudflare مع تفعيل المصادقة والتسجيل
- تحميل رصيد حتى يتولى Cloudflare المدفوعات إلى Anthropic وOpenAI ومزوّدين آخرين نيابة عنك عبر Unified Billing
- تخزين رمز الـ gateway في OpenCode حتى يتمكن من المصادقة مع الـ gateway
- إضافة نماذج من مزوّدين مختلفين على الأقل إلى إعدادات OpenCode (مثل Claude Sonnet وGPT-4.1)
- اختباره بالدردشة عبر الـ gateway والتحقق من السجلات في لوحة تحكم Cloudflare
ملاحظة حول متغيرات البيئة
يستخدم الـ gateway رمزًا (يبدأ بـ cfut_) مختلفًا عن Cloudflare API token العادي. إن كان لديك CLOUDFLARE_API_TOKEN مضبوطًا بالفعل في صدفتك لـ wrangler أو أدوات Cloudflare الأخرى، فسيستخدم OpenCode ذلك بدل رمز الـ gateway. سيساعدك الوكيل على تسوية هذا أثناء الإعداد. wrangler نفسه لا يحتاج إلى متغير البيئة ذلك إن كنت قد شغّلت wrangler login — لديه جلسة OAuth خاصة به.
أتمت إعداد اللوحة
يتضمن إعداد الـ gateway عدة نقرات في لوحة تحكم Cloudflare: إنشاء الـ gateway، وتفعيل المصادقة، وتحميل الرصيد، وتوليد رمز. إن كنت قد أكملت تمرين قُد متصفحًا ولديك Chrome DevTools MCP معدًّا، يمكنك أن تدع الوكيل ينقر نيابة عنك. صف ما تريد في Plan Mode ودعه يقود اللوحة.