هناك طريقتان لاستخدام Claude مع الإبقاء على عقدك وفوترتك في Google Cloud. الأولى هي النسخة بإدارة Google، التي تشغّلها Google ضمن Agent Platform (المعروفة سابقًا باسم Vertex AI). والثانية هي النسخة بإدارة Anthropic، وفيها تستخدم Claude API الذي تشغّله Anthropic انطلاقًا من مشروع على Google Cloud. وقد أصبحت متاحة للجميع في 22 أكتوبر 2026 (إعلان Anthropic). تظهر النسختان كلتاهما في فاتورة Google Cloud، لكنهما تختلفان في الميزات المتاحة والمناطق والجهة التي تدير حدود الاستخدام ودعم Claude Code.
الخلاصة: أيّهما تختار
بإدارة Google
تُفعَّل من Model Garden في Agent Platform (المعروفة سابقًا باسم Vertex AI)
- تريد استخدام Claude Code على Google Cloud
- تريد أن تتولى Google وحدها التعامل مع بياناتك، أو تحتاج إلى أن يبقى الاستدلال داخل الاتحاد الأوروبي
- تريد إدارة الحصص من وحدة تحكم Google Cloud
بإدارة Anthropic
اشتراك عبر Google Cloud Marketplace
- تحتاج إلى Files API وAgent Skills وManaged Agents وجلب الويب وموصل MCP وميزات مشابهة
- تريد الوضع السريع لـ Opus 5.5
- تريد الميزات الجديدة مبكرًا (السياسة المعلنة هي الإتاحة في اليوم نفسه مع Claude API)
إن كان كل ما تحتاجه هو Claude Code، فاختر النسخة بإدارة Google. لا تصف وثائق Claude Code أي إعداد لاستخدام Claude Code مع النسخة بإدارة Anthropic.
استنادًا إلى الوثائق الرسمية لـ Anthropic وGoogle Cloud (تاريخ المراجعة 26 أكتوبر 2026)، يشرح هذا المقال الفرق بين النسختين، والأسعار، والمناطق، وطريقة البدء، وإعداد Claude Code، وكيفية التعامل مع الحصص وأخطاء 429. وفي الأقسام التي تتناول النسختين معًا، تأتيان بالترتيب بإدارة Google ← بإدارة Anthropic وبالألوان نفسها.
1. الفرق بين النسختين
تحمل النسختان الاسم «Claude Models on Google Cloud»، ويميّز بينهما بين قوسين «Google managed» أو «Anthropic managed». تسمّي Google خدمة Vertex AI الآن «Gemini Enterprise Agent Platform»، وتغيّرت عناوين وثائقها إلى Agent Platform. أما شاشة تسجيل الدخول في Claude Code فما زالت تعرض «Google Vertex AI».
| البند | بإدارة Google | بإدارة Anthropic |
|---|---|---|
| الجهة المشغّلة | Google (جزء من Agent Platform) | Anthropic |
| من يتعامل مع البيانات | Google Cloud | Anthropicتتولى Google المصادقة وتوجيه طلبات API وسجلات التدقيق والفوترة، بينما يجري الاستدلال وتخزين البيانات على بنية Anthropic التحتية |
| شكل API | نقطة نهاية التنبؤ في Agent Platformيوضع اسم النموذج في عنوان URL | مثل Claude API تمامًالا يختلف سوى عنوان URL الأساسي والمصادقة |
| الفوترة | Google Cloud (بوصفها استخدامًا لـ Agent Platform) | Google Cloud Marketplaceتُقاس بوحدات Claude Consumption Units (وحدة CCU واحدة = 0.01 دولار أمريكي) |
| من يدير حدود الاستخدام | Google Cloud (الحصص) | Anthropic |
| أدوار IAM | roles/aiplatform.user وغيره | roles/claude.user وroles/claude.admin وroles/claude.viewer |
| وحدة الإدارة | وحدة تحكم Google Cloud (Model Garden) | Claude Console (تُفتح من وحدة تحكم Google Cloud) |
| عميل SDK | AnthropicVertex | AnthropicGoogleCloud (إصدار تجريبي) |
| النماذج والميزات الجديدة | تصل وفق جدول Agent Platform وModel Garden | السياسة هي الإتاحة في اليوم نفسه مع Claude API |
المصادر: جدول المقارنة في صفحة Anthropic «Claude Models on Google Cloud»، وصفحتا Google Cloud «Use Claude models on Google Cloud (Anthropic managed)» و«Anthropic Claude models». تاريخ المراجعة 26 أكتوبر 2026.
وتشترك النسختان أيضًا في أمور. فكلتاهما تُستدعى ببيانات اعتماد Google Cloud (بما فيها Application Default Credentials، أي ADC)، وتظهر رسومهما في فاتورة Google Cloud. وبدءًا من Claude 4.6، تتطابق معرّفات النماذج في النسختين مع معرّفات Claude API (مثل claude-opus-5-5). أما النماذج الأقدم، فالنسخة بإدارة Google وحدها تضع @ قبل التاريخ (مثل claude-haiku-4-5@20251001).
مع النسخة بإدارة Anthropic، تُنشأ مؤسسة Anthropic جديدة لكل مشروع على Google Cloud. وهي منفصلة عن أي مؤسسة تستخدمها حاليًا مع Claude API أو عن Claude Enterprise، ولا يمكن نقل مؤسسة قائمة إليها. لا تنتقل مفاتيح API ومساحات العمل وإعدادات Console، وتبقى الموارد مثل الملفات والدفعات في المؤسسة الأصلية.
2. كيف تختار: 5 أسئلة
ابدأ من الأعلى وتوقّف عند أول سؤال ينطبق عليك. وإن لم ينطبق أيٌّ منها، فاحسم الأمر بمدى سهولة تقدير التكاليف. فالنسخة بإدارة Google تنشر قائمة أسعارها وحصصها الافتراضية، فتستطيع تقدير الميزانية والحدود قبل أن تبدأ. أما النسخة بإدارة Anthropic، فاتساع ميزاتها ووصولها المبكر إلى الجديد منها يصبحان ميزة إن استطعت التحقق من الأسعار في صفحة Marketplace ومن الحدود مع ممثل Anthropic.
- تريد استخدام Claude Code مع الفوترة عبر Google Cloud←بإدارة Google
- تريد أن تتولى Google وحدها التعامل مع بياناتك، أو تحتاج إلى VPC Service Controls أو تخزين البيانات إقليميًا أو شهادات مثل FedRAMP High←بإدارة Google
- تحتاج إلى أن يجري الاستدلال داخل الاتحاد الأوروبي فقط←بإدارة Google (المنطقة المتعددة eu)
- تستخدم Files API أو Agent Skills أو Managed Agents أو جلب الويب أو موصل MCP أو تنفيذ الشيفرة أو Message Batches API←بإدارة Anthropic
- تريد الوضع السريع لـ Opus 5.5←بإدارة Anthropic
يسرد السؤال الثاني الحالات التي توصي فيها وثائق Google Cloud باختيار النسخة بإدارة Google (Use Claude models on Google Cloud (Anthropic managed)).
ويمكنك أيضًا استخدام النسختين معًا. مثلًا، يستخدم المطوّرون Claude Code عبر النسخة بإدارة Google، بينما يستدعي تطبيقك Managed Agents عبر النسخة بإدارة Anthropic. تظهر النسختان في فاتورة Google Cloud نفسها، لكن وحدتي الإدارة وإدارة حدود الاستخدام منفصلة.
3. الفروق في الميزات
أكبر الفروق في الميزات التي تعمل من جهة الخادم وتشغّلها Anthropic. تتمحور النسخة بإدارة Google حول Messages API، ولا يتوفر فيها تخزين الملفات ولا بيئات تشغيل الوكلاء.
| الميزة | بإدارة Google | بإدارة Anthropic |
|---|---|---|
| Messages API والبث | نعم | نعم |
| التخزين المؤقت للموجّهات | نعم | نعم |
| التفكير الموسّع والمخرجات المنظّمة | نعم | نعم |
| البحث في الويب | نعم | نعم |
| استخدام الحاسوب (أداة API) | نعم | نعمليست في قائمة الميزات بوثائق Anthropic، لكنها مذكورة في جدول المقارنة لدى Google Cloud وفي إعلان Anthropic |
| جلب الويب وتنفيذ الشيفرة وadvisor | لا | نعم |
| Files API | لا | نعم |
| Agent Skills وموصل MCP | لا | نعم |
| Claude Managed Agents | لا | نعمأنفاق MCP غير متاحة |
| Message Batches API | لااستخدم التنبؤ الدفعي في Agent Platform بدلًا منها | نعم |
| الوضع السريع (Opus 5.5) | غير مذكورليس في قائمة الميزات المدعومة | نعم |
المصادر: قسم دعم الميزات في صفحات Anthropic «Claude Models on Google Cloud (Anthropic managed)» و«Claude Models on Google Cloud (Google managed)» و«Fast mode». الوضع السريع في النسخة بإدارة Google غائب عن قائمة الميزات المدعومة في وثائق Anthropic، التي لا تقول إنه متاح ولا إنه غير متاح (أما جدول الميزات في Claude Code فيذكره غير متاح على Agent Platform). تاريخ المراجعة 26 أكتوبر 2026.
لمعرفة طريقة عمل Managed Agents، راجع «ما هو Claude Managed Agents؟ مقابل Agent SDK»، ولسرعة الوضع السريع وأسعاره، راجع «Claude Opus 5.5 مقابل Opus 5: السعر والأداء والترحيل».
4. الأسعار: هل هي نفس أسعار Claude API؟
أسعار النسخة بإدارة Google
على نقطة النهاية global في النسخة بإدارة Google، تتطابق أسعار الإدخال والإخراج والتخزين المؤقت لـ Opus 5.5 وSonnet 5.5 وHaiku 5.5 مع أسعار Claude API لدى Anthropic. وتكلّف المنطقتان المتعددتان us وeu أكثر بنسبة 10% من global (ونقاط النهاية الإقليمية أغلى بنسبة 10% أيضًا، لكنها لا تخدم إلا Sonnet 4.6 والنماذج الأقدم؛ انظر القسم 5).
المصادر: صفحة Anthropic «Pricing»، وقسم نماذج Claude من Anthropic في صفحة Google Cloud «Agent Platform pricing»، وصفحة Anthropic «Claude Models on Google Cloud (Google managed)» (المناطق المتعددة ونقاط النهاية الإقليمية أغلى بنسبة 10% من global، لـ Sonnet 4.5 وHaiku 4.5 وOpus 4.5 والنماذج الأحدث). تاريخ المراجعة 26 أكتوبر 2026. النسخة بإدارة Anthropic ليست في الرسم لأن أسعارها لكل رمز غير موجودة في الوثائق الرسمية (انظر القسم أدناه).
| النموذج | الإدخال | الإخراج | قراءة الذاكرة المؤقتة | الكتابة في الذاكرة المؤقتة (5 دقائق / ساعة واحدة) |
|---|---|---|---|---|
| Opus 5.5 | $4 | $20 | $0.20 | $5 / $8 |
| Sonnet 5.5 | $2 | $10 | $0.10 | $2.50 / $4 |
| Haiku 5.5إدخال حتى 100 ألف رمز | $0.10 | $0.50 | $0.01 | $0.125 / $0.20 |
| Haiku 5.5إدخال يتجاوز 100 ألف رمز | $0.50 | $2.50 | $0.05 | $0.625 / $1 |
بالدولار الأمريكي لكل مليون رمز. أسعار Claude API لدى Anthropic ونقطة النهاية global في النسخة بإدارة Google (صفحتا الأسعار لدى الشركتين، تاريخ المراجعة 26 أكتوبر 2026). المنطقتان المتعددتان us/eu بـ 1.1 ضعف هذه الأسعار. تكلّف قراءة الذاكرة المؤقتة 0.05 ضعف سعر الإدخال لـ Opus 5.5 وSonnet 5.5، و0.1 ضعف لـ Haiku 5.5 (ملاحظة في صفحة أسعار Anthropic). للاطلاع على القائمة الكاملة للنماذج وتاريخ الأسعار، راجع «مقارنة أسعار وأداء Claude Fable وOpus وSonnet وHaiku [2026]».
أما Provisioned Throughput، الذي يحجز سعة مقابل رسم ثابت، فغير متاح على global ولا على المناطق المتعددة، ويتطلب نقطة نهاية إقليمية (وثائق Google Cloud). ولأن نقاط النهاية الإقليمية لا تخدم إلا Sonnet 4.6 والنماذج الأقدم، يُستخدم Opus 5.5 وSonnet 5.5 وHaiku 5.5 بنظام الدفع حسب الاستخدام.
أسعار النسخة بإدارة Anthropic
مع النسخة بإدارة Anthropic، تقيس Anthropic الاستخدام بوحدات Claude Consumption Units (CCU، وحدة CCU واحدة = 0.01 دولار أمريكي) وتبلغ به Google Cloud، فيظهر في فاتورة Google Cloud. ولا ترسل Anthropic فاتورة منفصلة. لا توجد قائمة أسعار لكل رمز منشورة في الوثائق الرسمية لدى Anthropic ولا لدى Google Cloud (تاريخ المراجعة 26 أكتوبر 2026). والطريقة الموثوقة هي التحقق من الأسعار في صفحة الخدمة على Google Cloud Marketplace قبل الاشتراك، ثم إجراء تجربة صغيرة بعد البدء والتأكد من المبلغ الفعلي في صفحة Usage في Claude Console وفي تقارير الفوترة في Google Cloud.
هناك ثلاثة أمور موثّقة رسميًا:
- الوضع السريع لـ Opus 5.5 يكلّف 8 دولارات للإدخال و40 دولارًا للإخراج لكل مليون رمز (صفحة Fast mode لدى Anthropic والإعلان).
- إضافة
inference_geo: "us"إلى الطلب لإبقاء الاستدلال داخل الولايات المتحدة تضرب الأسعار في كل الفئات في 1.1 (صفحة Anthropic «Data residency»). - إن كان لديك التزام إنفاق مع Google Cloud، فالاستخدام يُحتسب ضمنه مثل مشتريات Marketplace الأخرى. وإن كان لديك اتفاق خصم، فتواصل مع ممثل Anthropic أو Google Cloud قبل البدء (لا تُطبَّق الخصومات بأثر رجعي).
أسعار المعالجة الدفعية
تتعامل النسختان مع الدفعات بطريقتين مختلفتين. تستخدم النسخة بإدارة Google التنبؤ الدفعي في Agent Platform (بإدخال JSONL من BigQuery أو Cloud Storage)، وأسعاره في عمود الدفعات بصفحة أسعار Google Cloud. أما النسخة بإدارة Anthropic فتدعم Message Batches API نفسها الموجودة في Claude API، لكن أسعار دفعاتها ليست في الوثائق الرسمية هي الأخرى. وخصم الدفعات في Claude API (مباشرة) مشروح في «مقارنة أسعار وأداء Claude Fable وOpus وSonnet وHaiku [2026]».
5. المناطق وتخزين البيانات
في Claude على Google Cloud، تحدد قيمة location التي تستدعيها مكان تشغيل الاستدلال. تقدّم النسخة بإدارة Google ثلاثة أنواع، بينما لا تقدّم النسخة بإدارة Anthropic سوى global.
global
بإدارة Google بإدارة Anthropic
يجري الاستدلال في أي منطقة تتوفر فيها سعة. الأسعار مطابقة لـ Claude API. ويمكن للنسخة بإدارة Anthropic حصر الطلب في الولايات المتحدة بـ inference_geo: "us" (1.1 ضعف).
المنطقة المتعددة us/eu
بإدارة Google
يجري الاستدلال داخل الولايات المتحدة أو الاتحاد الأوروبي فقط. متاحة لـ Claude 4.7 والنماذج الأحدث. الأسعار 1.1 ضعف.
إقليمية
بإدارة Google
يجري الاستدلال في المنطقة الواحدة التي تحددها فقط. تخدم Sonnet 4.6 والنماذج الأقدم، أما النماذج الأحدث فتستخدم global أو منطقة متعددة.
المصادر: صفحتا Anthropic «Claude Models on Google Cloud (Google managed)» و«(Anthropic managed)»، وصفحة Google Cloud «Agent Platform partner models». تاريخ المراجعة 26 أكتوبر 2026.
وتختلف أماكن تخزين البيانات أيضًا. تخزّن النسخة بإدارة Google البيانات في المنطقة أو المنطقة المتعددة التي تختارها. غير أن صفحة نماذج الشركاء في Google Cloud تقول كذلك إن موقع المعالجة قد يختلف عن موقع التخزين. في المقابل، تقول وثائق Anthropic إن الاستدلال في المناطق المتعددة يبقى داخل us أو eu، ولا تُشرح العلاقة بين القولين. فإن كانت لديك متطلبات صارمة بشأن مكان المعالجة، فتحقق مع Google Cloud قبل توقيع العقد. ويمكنك أيضًا استخدام سياسة المؤسسة constraints/gcp.restrictEndpointUsage لحظر نقطة النهاية global والسماح بالمناطق المتعددة فقط.
أما في النسخة بإدارة Anthropic، فمنطقة تخزين مساحة العمل هي "us" ولا يمكن تغييرها (صفحة Anthropic «Data residency»).
حتى 26 أكتوبر 2026، لا تغطي المناطق المتعددة في الوثائق الرسمية لأي من النسختين سوى الولايات المتحدة والاتحاد الأوروبي. فإن كان يجب أن تبقى المعالجة أو التخزين داخل بلد معيّن خارج هاتين المنطقتين، فتأكد مع Google Cloud أو ممثل Anthropic من وجود location مناسبة قبل توقيع العقد.
6. البدء
تتطلب النسختان كلتاهما مشروعًا على Google Cloud وحساب فوترة مفعّلًا. فيما يلي الخطوات الواردة في الوثائق الرسمية لإتاحة كل نسخة، ثم الخطوات المشتركة للمصادقة واستدعاء النموذج.
بإدارة Google: البدء
- فعّل Agent Platform API
تكفي مرة واحدة لكل مشروع.gcloud config set project YOUR-PROJECT-ID gcloud services enable aiplatform.googleapis.com - فعّل نماذج Claude التي تريدها في Model Gardenيحتاج من يفعّلها إلى دور Consumer Procurement Entitlement Manager (
roles/consumerprocurement.entitlementManager). ويجب أيضًا أن تسمح سياسة مؤسستك بـcloudcommerceconsumerprocurement.googleapis.com. تقول وثائق Claude Code إن الموافقة على الوصول قد تستغرق من 24 إلى 48 ساعة (ولا تذكر وثائق Google Cloud المدة). - امنح المستدعين دورًاامنح دورًا يتضمن الإذن
aiplatform.endpoints.predict(roles/aiplatform.user).
المصادر: صفحة Anthropic «Claude Models on Google Cloud (Google managed)»، وصفحة Google Cloud «Agent Platform partner models». تاريخ المراجعة 26 أكتوبر 2026.
عقبات شائعة عند البدء (بإدارة Google)
- لا يمكنك تفعيل نموذج في Model Garden: تحقق من أن من يفعّله لديه دور Consumer Procurement Entitlement Manager وأن سياسة مؤسستك تسمح بـ
cloudcommerceconsumerprocurement.googleapis.com. - تعيد الاستدعاءات الخطأ 404 (النموذج غير موجود): تحقق من أنك فعّلت النموذج وأنه موجود في الموقع الذي اخترته (النماذج الأحدث موجودة فقط على global أو منطقة متعددة).
- تعيد الاستدعاءات الخطأ 403: تحقق من أن المستدعي لديه
roles/aiplatform.user.
بإدارة Anthropic: البدء
- اشترك في Marketplaceافتح «Claude Models on Google Cloud (Anthropic managed)» في Google Cloud Marketplace وانقر Subscribe. تحتاج إلى أذونات الشراء من Marketplace على حساب الفوترة.
- فعّل خدمتين
تكفي مرة واحدة لكل مشروع.gcloud services enable claude.googleapis.com \ anthropic-managed-claude.cloudpartnerservices.goog \ --project=YOUR-PROJECT-ID - نشّط المؤسسةانقر Activate في صفحة Claude، ثم اتبع الرابط المرسل إلى بريد جهة الاتصال لإدخال اسم المؤسسة ونوع النشاط والبلد وحالة الاستخدام، والموافقة على شروط الخدمة التجارية وسياسة الاستخدام لدى Anthropic. يتطلب ذلك
roles/claude.admin. - دوّن معرّف مساحة العملفي Claude Console (التي تُفتح من وحدة تحكم Google Cloud)، انتقل إلى Settings > Workspaces ودوّن المعرّف الذي يبدأ بـ
wrkspc_. ستحتاج إليه لإجراء الاستدعاءات. - امنح المستدعين دورًاامنح
roles/claude.user. الأدوار على مستوى المشروع، فإن أردت فصل الفرق فاستخدم مشاريع منفصلة (يصبح كل مشروع مؤسسة Anthropic منفصلة).
المصدر: قسم Set up your account في صفحة Anthropic «Claude Models on Google Cloud (Anthropic managed)» (تاريخ المراجعة 26 أكتوبر 2026). لا يمكنك تسجيل الدخول إلى مؤسسة Anthropic بعنوان بريد إلكتروني، إذ تُفتح Console من وحدة تحكم Google Cloud.
النسختان: المصادقة والاستدعاء
في أيٍّ من النسختين، شغّل gcloud auth application-default login على الجهاز الذي يُجري الاستدعاء لإنشاء ADC، وسيستخدم SDK بيانات الاعتماد هذه (على الخوادم، استخدم بيانات اعتماد حساب خدمة). ثم استدعِ النموذج بعميل SDK الوارد في القسم 7.
عقبات شائعة عند البدء (بإدارة Anthropic)
- لا يُعثر على الخدمة: شغّل
gcloudبالحساب نفسه الذي اشتركت به في Marketplace. - خطأ أذونات عند أول استدعاء: تحقق من أن
claude.googleapis.comمفعّلة وأن المستدعي لديهroles/claude.user. - يبقى الزر على «Finish Setup»: لم يُكمل المسؤول إدخال بيانات المؤسسة.
- لا يظهر الاستخدام في Console: يستغرق ظهوره بضع دقائق.
7. استدعاء Claude من SDK
تدعم حزم SDK الرسمية من Anthropic النسختين كلتيهما. لا يختلف سوى الحزمة التي تثبّتها واسم العميل، أما messages.create فيُكتب بالطريقة نفسها كما في Claude API.
بإدارة Google (Python)
# pip install -U "anthropic[vertex]"
from anthropic import AnthropicVertex
client = AnthropicVertex(project_id="YOUR-PROJECT-ID", region="global") # تعمل "us" أو "eu" أيضًا
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "مرحبًا يا Claude"}],
)
في TypeScript، استخدم AnthropicVertex من @anthropic-ai/vertex-sdk. وللاستدعاء عبر HTTP دون SDK، يأخذ عنوان URL الشكل https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict؛ لا تضع اسم النموذج في جسم الطلب، وضع فيه "anthropic_version" (vertex-2023-10-16 أو 2026-10-21). وللبث، استخدم :streamRawPredict. أما ما يتغيّر في إصدار API الجديد 2026-10-21 فمشروح في «أسباب ظهور «temperature is deprecated for this model» وطريقة حلّه».
بإدارة Anthropic (Python)
# pip install -U "anthropic[google_cloud]"
# متغيرات البيئة: ANTHROPIC_GOOGLE_CLOUD_PROJECT و
# ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID (إلزامية)
from anthropic import AnthropicGoogleCloud
client = AnthropicGoogleCloud()
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "مرحبًا يا Claude"}],
)
في TypeScript، هو AnthropicGoogleCloud من @anthropic-ai/google-cloud-sdk (وكلاهما في إصدار تجريبي). وعبر HTTP، يكون جسم الطلب والاستجابة مثل Claude API تمامًا، والفروق هي:
- عنوان URL الأساسي:
https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke، ويتضمن معرّف مساحة العمل (لا ترسل الترويسةanthropic-workspace-id). - المصادقة: أرسل رمز وصول من Google عبر
Authorization: Bearer(لا ترسلx-api-key). - مفاتيح API: لا يمكن إنشاؤها. ويُتجاهل متغيرا البيئة
ANTHROPIC_API_KEYوANTHROPIC_BASE_URL.
المصادر: صفحتا Anthropic «Claude Models on Google Cloud (Anthropic managed)» و«(Google managed)». تاريخ المراجعة 26 أكتوبر 2026.
8. استخدام Claude Code على Google Cloud
على Google Cloud، يدعم Claude Code النسخة بإدارة Google. ويعرّف جدول الميزات في Claude Code منصة Agent Platform بأنها «تشغّلها Google، وتُضبط بـ CLAUDE_CODE_USE_VERTEX». ولا تصف وثائق Claude Code طريقة استخدام Claude Code مع النسخة بإدارة Anthropic (تاريخ المراجعة 26 أكتوبر 2026).
طريقتان للإعداد
- الإعداد بالمعالجشغّل
claudeواختر في شاشة تسجيل الدخول «3rd-party platform» ← «Google Vertex AI» (وإن كنت مسجّل الدخول بالفعل، فاستخدم/login). يسألك عن طريقة المصادقة والمشروع والمنطقة، ويتيح لك التحقق من النماذج المتاحة وتثبيتها. تُحفظ النتيجة فيenvضمن إعدادات المستخدم (~/.claude/settings.json)، ويمكنك فتحه لاحقًا من جديد بـ/setup-vertex. - الإعداد بمتغيرات البيئةتناسب هذه الطريقة CI والتعميم على فريق. بعد تفعيل النماذج في Model Garden، اضبط ما يلي.
أسباب تثبيت النماذج مشروحة في التحذير أدناه.export CLAUDE_CODE_USE_VERTEX=1 export CLOUD_ML_REGION=global export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID # تثبيت النماذج # النموذج الرئيسي: Sonnet يُبقي التكاليف منخفضة. ولـ Opus استخدم claude-opus-5-5 export ANTHROPIC_MODEL=claude-sonnet-5-5 export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5 export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5
وفي الحالتين، شغّل /status بعد الإعداد. إن ظهر Google Vertex AI في «API provider» وظهرت أسطر لمشروع GCP والمنطقة والنموذج، فقد نجح الإعداد.
المصادر: صفحتا Claude Code «Claude Code on Google Cloud's Agent Platform» و«Environment variables». تاريخ المراجعة 26 أكتوبر 2026.
تنبيهان إن لم تثبّت النماذج
- التكلفة: على Agent Platform، النموذج الرئيسي الافتراضي حين لا يُثبَّت شيء هو Opus 5.5. وتحذّر وثائق Claude Code من أنك ستُحاسَب بأسعار Opus إن لم تثبّت النماذج.
- انجراف الأسماء المستعارة: يشير الاسم المستعار
sonnetإلى Sonnet 4.5 وhaikuإلى Haiku 4.5، وهذا يختلف عن الأسماء المستعارة المستخدمة مع Claude API. ولكي لا ينجرف نموذج كل مستخدم حين تصدر نماذج جديدة، ثبّتها بالمتغيرات الأربعة أعلاه إن كنت تعمّمه على عدة أشخاص.
طريقة عمل الأسماء المستعارة مشروحة أيضًا في «opusplan في Claude Code: Opus للتخطيط وSonnet للتنفيذ».
إن لم يكن نموذج ما متاحًا في موقع CLOUD_ML_REGION، فيمكنك تجاوز المنطقة لذلك النموذج وحده، كما في VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5 (يستدعي هذا المثال Haiku 4.5 وحده في المنطقة us-east5). يقبل CLOUD_ML_REGION القيم global أو us أو eu، أو اسم منطقة مثل us-east5. ويستخدم Claude Agent SDK أيضًا النسخة بإدارة Google بمتغيرات البيئة نفسها (انظر «Claude Agent SDK: دليل تطوير وكلاء الذكاء الاصطناعي»).
التحديث التلقائي لبيانات الاعتماد، والتخزين المؤقت، وإعدادات سياق المليون رمز
- لتحديث ADC تلقائيًا عند انتهاء صلاحيتها، أضف
"gcpAuthRefresh": "gcloud auth application-default login"إلى إعداداتك (يُعدّ التحديث فاشلًا إن لم ينتهِ أمر المصادقة خلال 3 دقائق). - يُطبَّق التخزين المؤقت للموجّهات تلقائيًا. لإيقافه، اضبط
DISABLE_PROMPT_CACHING=1، ولذاكرة مؤقتة مدتها ساعة، اضبطENABLE_PROMPT_CACHING_1H=1(سعر الكتابة أعلى). - تستخدم نماذج مثل Sonnet 5 وما بعده وOpus 4.7 وما بعده سياقًا من مليون رمز افتراضيًا. لاستخدام 200 ألف، اضبط
CLAUDE_CODE_DISABLE_1M_CONTEXT=1. - توصي وثائق Claude Code بإنشاء مشروع مخصص لـ Claude Code حتى تتابع تكاليفه بشكل منفصل.
دعم ميزات Claude Code على Agent Platform
| الحالة | الميزات |
|---|---|
| غير متاحة | الميزات التي تتطلب اشتراك Claude (الجلسات السحابية وSlack و/schedule وUltrareview وCode Review وRemote Control وإضافة Chrome واستخدام الحاسوب وArtifacts والإدخال الصوتي)، والوضع السريع وAdvisor وChannels ولوحة التحليلات والإعدادات المُدارة من الخادم و/logout |
| جزئية | البحث في الويب (Opus 4 وSonnet 4 وHaiku 4.5 وما بعدها)، ووضع auto (Sonnet 5 وما بعده، وOpus 4.7 وما بعده، وHaiku 5.5، وClaude Fable)، وعدم الاحتفاظ بالبيانات (يتوقف على اتفاقك مع Google Cloud) |
| متاحة | GitHub Actions وGitLab CI/CD والبحث عن أدوات MCP (Opus 4.5 وSonnet 4.5 وHaiku 4.5 وما بعدها) |
استخدام الحاسوب في هذا الجدول هو ميزة Claude Code (التي تتطلب اشتراكًا)، وليس أداة استخدام الحاسوب في API الواردة في القسم 3. المصدر: صفحة Claude Code «Feature availability» (/logout والبحث عن أدوات MCP من صفحة «Claude Code on Google Cloud's Agent Platform»). تاريخ المراجعة 26 أكتوبر 2026. ولا تُحمَّل موصلات claude.ai أيضًا (انظر «claude.ai connectors are disabled: معناه وحله في Claude Code»).
أخطاء Claude Code الشائعة وحلولها (بإدارة Google)
Could not load the default credentials: شغّلgcloud auth application-default login، أو اضبطGOOGLE_APPLICATION_CREDENTIALSعلى مسار ملف مفتاح.- النموذج غير موجود (404): تحقق من أنك فعّلت النموذج في Model Garden وأنه موجود في الموقع الذي اخترته (النماذج الأحدث موجودة فقط على global أو منطقة متعددة).
- 429: إن حددت منطقة، فتحقق من أن النموذج الرئيسي والنموذج الصغير كليهما متاحان فيها، وفكّر في
CLOUD_ML_REGION=global.
9. الحصص وأخطاء 429
بإدارة Google: الحصص لكل عائلة نماذج
تستخدم النماذج الصادرة بعد 26 مايو 2026 (Opus 5.5 وSonnet 5.5 وHaiku 5.5 وغيرها) حصصًا مشتركة على مستوى عائلة النماذج (أما النماذج الأقدم، فراجع الحصص لكل نموذج في صفحة Google Cloud نفسها). فمثلًا، أيًّا كان إصدار Opus الذي تستدعيه على global، فإنه يسحب من الحصة نفسها anthropic-claude-opus، ولا تحتاج إلى طلب حصة من جديد حين يصدر إصدار جديد. ولـ global ولكل منطقة متعددة حصص منفصلة.
| النموذج | global (في الدقيقة) | المنطقة المتعددة us/eu (لكل منهما، في الدقيقة) |
|---|---|---|
| Opus 5.5 | 2,000 طلب / 20 مليون رمز إدخال / 2 مليون رمز إخراج | 1,000 طلب / 10 ملايين رمز إدخال / 1 مليون رمز إخراج |
| Sonnet 5.5 | 2,500 طلب / 25 مليون رمز إدخال / 2.5 مليون رمز إخراج | 1,250 طلبًا / 12.5 مليون رمز إدخال / 1.25 مليون رمز إخراج |
| Haiku 5.5 | 3,000 طلب / 30 مليون رمز إدخال / 3 ملايين رمز إخراج | 1,500 طلب / 15 مليون رمز إدخال / 1.5 مليون رمز إخراج |
المصدر: الحصص الافتراضية في صفحة Google Cloud «Quotas for Anthropic Claude models» (تاريخ المراجعة 26 أكتوبر 2026). الإدخال هو مجموع الرموز غير المخزّنة مؤقتًا والكتابة في الذاكرة المؤقتة. وتنبّه Google إلى أن الحدود تختلف من حساب لآخر وقد تُقيَّد.
تحقق من الحصص واطلب زيادتها من صفحة Quotas & System Limits في وحدة تحكم Google Cloud. وتسهّل التصفية بـ base_model (مثل anthropic-claude-opus) العثور عليها. قد تكون أعداد الرموز في هذه الصفحة غير دقيقة بسبب طريقة عمل التقدير والاسترداد؛ وللأعداد الدقيقة، استخدم API عدّ الرموز أو token_count في Metrics Explorer.
حين تتجاوز حصة، تتلقى خطأ 429 بهذه الرسالة:
Resource exhausted, please try again later.
هذه رسالة الاستخدام بنظام الدفع حسب الاستخدام (صفحة Google Cloud «Error code 429»). ومع Provisioned Throughput تكون الرسالة «Too many requests. Exceeded the Provisioned Throughput.»
- استخدم global إن لم يكن لديك شرط بشأن موقع الاستدلالحصصها أكبر من حصص المناطق المتعددة، وتُعالَج الطلبات في أي منطقة تتوفر فيها سعة. في Claude Code، اضبط
CLOUD_ML_REGION=global. وإن كان لديك شرط مثل إبقاء الاستدلال داخل الاتحاد الأوروبي، فتخطَّ هذه الخطوة واطلب زيادة (الخطوة 3) أولًا. - انتظر وأعد المحاولةأعد المحاولة بتراجع أُسّي محدود السقف، وتجنّب القفزات المفاجئة في حجم الطلبات.
- اطلب زيادة الحصةاطلبها من صفحة Quotas & System Limits المذكورة أعلاه.
المصادر: صفحة Google Cloud «Error code 429»، وقسم استكشاف الأخطاء في صفحة Claude Code «Claude Code on Google Cloud's Agent Platform».
بإدارة Anthropic: تدير Anthropic الحدود
تدير Anthropic حدود الاستخدام، والقيم الافتراضية غير موجودة في الوثائق الرسمية. ولزيادتها، تحدّث إلى ممثل Anthropic أو فريق المبيعات. وتوصي وثائق Anthropic بالتأكد من حدودك قبل نقل حركة الإنتاج. تأخذ الأخطاء شكل أخطاء Claude API نفسه: تجاوز الحد يعيد 429 rate_limit_error، والازدحام يعيد 529 overloaded_error. وإن نقصت أذونات IAM، تعيد Google Cloud الخطأ 403.
- انتظر وأعد المحاولةأعد المحاولة بتراجع أُسّي، وتجنّب القفزات المفاجئة في حجم الطلبات (كما في النسخة بإدارة Google).
- تأكد من الحدود قبل الإنتاجقبل الترحيل، أخبر ممثل Anthropic بالحجم الذي تحتاجه وتأكد من حدودك.
- اطلب زيادة الحدتحدّث إلى ممثل Anthropic أو فريق المبيعات. لا يمكن رفع الحدود من صفحة الحصص في Google Cloud.
المصادر: قسم Rate limits في صفحة Anthropic «Claude Models on Google Cloud (Anthropic managed)»، وصفحة «Errors». تاريخ المراجعة 26 أكتوبر 2026.
الخلاصة
- يأتي Claude على Google Cloud بنسختين: بإدارة Google (Agent Platform، المعروفة سابقًا باسم Vertex AI) وبإدارة Anthropic. وتظهر النسختان في فاتورة Google Cloud.
- لـ Claude Code، استخدم النسخة بإدارة Google. اضبط
CLAUDE_CODE_USE_VERTEX=1والمتغيرات المرتبطة به، وثبّت النماذج بالمتغيرات الأربعة إن كنت تعمّمه على عدة أشخاص. - لـ Files API وAgent Skills وManaged Agents وجلب الويب وموصل MCP وما شابهها، أو للوضع السريع لـ Opus 5.5، استخدم النسخة بإدارة Anthropic.
- في global بالنسخة بإدارة Google، أسعار Opus 5.5 وSonnet 5.5 وHaiku 5.5 مطابقة لـ Claude API. والمنطقتان المتعددتان us/eu بـ 1.1 ضعف. أما النسخة بإدارة Anthropic فتُقاس بوحدات CCU، ولا توجد قائمة أسعار لكل رمز في الوثائق الرسمية.
- حصص النسخة بإدارة Google مشتركة لكل عائلة نماذج، وتجاوزها يعيد 429 «Resource exhausted, please try again later.» وعلاجه باستخدام global وإعادة المحاولة وطلب الزيادة. أما حدود النسخة بإدارة Anthropic فتديرها Anthropic.
- تُنشئ النسخة بإدارة Anthropic مؤسسة Anthropic جديدة لكل مشروع، ولا يمكن نقل المؤسسات القائمة إليها.
- المنطقتان المتعددتان الوحيدتان في الوثائق الرسمية لأي من النسختين هما us وeu؛ فتأكد من متطلبات البقاء داخل بلد آخر قبل توقيع العقد.
الأسئلة الشائعة
س. هل Claude على Vertex AI أغلى من Claude API؟
على نقطة النهاية global في النسخة بإدارة Google، أسعار الإدخال والإخراج والتخزين المؤقت لـ Opus 5.5 وSonnet 5.5 وHaiku 5.5 هي نفسها. والمنطقتان المتعددتان us وeu أغلى بنسبة 10% (صفحتا الأسعار لدى Anthropic وGoogle Cloud، تاريخ المراجعة 26 أكتوبر 2026). أما النسخة بإدارة Anthropic، فأسعارها لكل رمز ليست في الوثائق الرسمية، فراجع صفحة الخدمة على Google Cloud Marketplace.
س. هل يمكنني استخدام مفتاح Claude API؟
تُستدعى النسختان كلتاهما بمصادقة Google Cloud (ADC أو حساب خدمة)، لا بمفتاح API منشأ في Claude Console. والنسخة بإدارة Anthropic لا تتيح إنشاء مفاتيح API، ويُتجاهل ضبط ANTHROPIC_API_KEY.
س. هل يمكنني استخدام Claude Code مع النسخة بإدارة Anthropic؟
لا تصف وثائق Claude Code إعدادًا للنسخة بإدارة Anthropic (تاريخ المراجعة 26 أكتوبر 2026). وإعداد Google Cloud في Claude Code (CLAUDE_CODE_USE_VERTEX) مخصص للنسخة بإدارة Google.
س. هل يمكنني تحويل مؤسستي الحالية في Anthropic إلى الفوترة عبر Google Cloud؟
لا. تُنشئ النسخة بإدارة Anthropic مؤسسة جديدة لكل مشروع، ولا يمكن تحويل المؤسسات القائمة. لا تنتقل مفاتيح API ومساحات العمل وإعدادات Console، فتعيد إنشاءها في المؤسسة الجديدة.