تشغيل Claude Code عبر Bedrock أو Vertex AI
تعرّف إلى متغيرات البيئة وبيانات الاعتماد المطلوبة، ومن يدفع التكلفة، وما الذي تفقده عند تشغيل Claude Code عبر Amazon Bedrock أو Google Vertex AI.
ما الذي يتغير عند تشغيل Claude Code على حسابك السحابي
يمكنك تشغيل Claude Code على Amazon Bedrock أو Google Vertex AI. يتطلب التبديل ضبط متغيرين أو ثلاثة من متغيرات البيئة، إضافة إلى بيانات اعتماد السحابة التي يملكها فريقك بالفعل. يبقى كل ما هو محلي كما هو: واجهة CLI، والوكلاء الفرعيون، والخطافات، والمهارات، وخوادم MCP، وملفات CLAUDE.md. ينتقل استدعاء النموذج فقط. وتنتقل معه أربعة أمور: الشبكة التي يعبرها الطلب، والحساب الذي يدفع التكلفة، ونماذج Claude المسموح لك باستدعائها، والميزات من جانب الخادم المتاحة فعلياً.
نادراً ما يكون السؤال هو ما إذا كان ذلك سيعمل. إنه يعمل. السؤال هو أيّ من هذه الأمور الأربعة يهمك أكثر.
مسارات التوجيه الثلاثة، وتكلفة كل منها
الاتصال المباشر بـAnthropic عبر اشتراك. تسجّل الدخول باستخدام حساب claude.ai على خطة Pro أو Max أو Ultra أو Team أو Enterprise. تُرسل الطلبات إلى API الخاص بـAnthropic. في خطط Pro وMax وUltra وTeam، تدفع لكل مقعد، ويُحدَّد الاستخدام وفق حدود الخطة بدلاً من احتسابه لكل رمز مميز. أما خطط Enterprise الحالية فهي الاستثناء: لا تشمل رسوم المقعد أي استخدام، وتُحتسب تكلفة كل رمز مميز فوقها وفق أسعار API القياسية. كما تنتقل عقود Enterprise الأقدم القائمة على المقاعد إلى هذا النموذج عند التجديد. هذا هو مسار التوجيه الوحيد الذي يصل إلى الواجهات المبنية فوق الحساب، مثل Claude Code على الويب، وتطبيق الهاتف المحمول، وRemote Control. بالنسبة إلى الفريق، تتضمن خطة Team تسجيل الدخول الأحادي وإعدادات يديرها الخادم لتهيئة Claude Code على مستوى المؤسسة، بينما تضيف خطة Claude Enterprise سجلات التدقيق وSCIM وعناصر تحكم مخصصة للاحتفاظ بالبيانات وCompliance API فوق ذلك.
الاتصال المباشر بـAnthropic باستخدام مفتاح API. تنشئ مفتاحاً في Anthropic Console وتدفع لكل رمز مميز. تستخدم هذه الطريقة البنية التحتية والمناطق نفسها التي يستخدمها الاشتراك، من دون مقاعد، ويظهر الاستخدام في لوحة المعلومات الخاصة بـAnthropic. يعتمد الخيار الأرخص من الاثنين على عدد الساعات التي يعمل فيها الوكيل فعلياً كل يوم. وهذا هو موضوع مقارنة تكلفة API بالاشتراك وموضوع تكلفة Claude Code عملياً.
نقطة نهاية تابعة لجهة خارجية على Bedrock أو Vertex. يستخدم حساب AWS أو Google Cloud الخاص بك النموذج. لا يكون Anthropic ضمن مسار الطلب وقت الاستدلال. وتُضاف تكلفة الرموز المميزة إلى فاتورة تتلقاها مسبقاً، ضمن سياسات IAM (إدارة الهوية والوصول) وسجلات التدقيق التي تديرها مسبقاً. توجد ثلاثة خيارات أخرى تابعة لجهات خارجية: Microsoft Foundry وClaude Platform على AWS وClaude Models على Google Cloud (تديره Anthropic). وتتبع هذه الخيارات البنية نفسها: يحدد متغير بيئة واحد موفر الخدمة، ويدفع حساب السحابة التكلفة. يستخدم مسار Google Cloud الذي تديره Anthropic CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD=1، وهو منفصل عن Vertex.
ملاحظة حول التسمية، اعتباراً من أكتوبر 2026: أعادت Google تسمية Vertex AI إلى Google Cloud's Agent Platform. تستخدم وثائق Anthropic الاسم الجديد، بينما لا تزال مطالبة تسجيل الدخول في Claude Code تعرض Google Vertex AI، ولا تزال متغيرات البيئة تعرض VERTEX.
إقامة البيانات هي السبب الحقيقي وراء اعتماد الفرق لهذا الأسلوب
في Bedrock، يذهب الطلب إلى نقطة نهاية في Bedrock داخل منطقة AWS التي تختارها، وفي حسابك أنت. تُشفَّر البيانات غير النشطة باستخدام AES-256 ومفاتيح تديرها AWS، ويمكنك توفير مفتاحك الخاص عبر AWS KMS (خدمة إدارة المفاتيح). في Vertex، المقابل هو مفاتيح تشفير تديرها Google، مع إتاحة CMEK (مفاتيح تشفير يديرها العميل). يخضع الوصول لأدوار IAM التي تستخدمها بالفعل، وتظهر الاستدعاءات في CloudTrail أو، عند تفعيل تسجيل تدقيق Data Access، في Cloud Audit Logs. بالنسبة إلى فريق خاضع للامتثال التنظيمي، فهذا هو جوهر الحجة، وهي حجة قوية.
هناك تفصيلان يجعلان الأمر أقل إطلاقاً مما توحي به المواد التسويقية.
ملف الاستدلال عبر المناطق ليس منطقة واحدة. في Bedrock، يحل Claude Code نماذجه المضمّنة الافتراضية إلى معرّفات ملفات الاستدلال عبر المناطق، وتأتي البادئة التي يفضّلها من المنطقة التي حُدِّدت له: us. في منطقة us-*، وeu. في منطقة eu-*، وapac. في منطقة ap-*، وus-gov. في GovCloud. يمكن لملف عبر المناطق معالجة الطلب من منطقة أخرى داخل النطاق الجغرافي نفسه، لذلك فالضمان الذي تحصل عليه يخص نطاقاً جغرافياً، لا مدينة. إذا كان متطلبك يحدد منطقة واحدة، فمرّر الطلب عبر ملف استدلال للتطبيق مدعوم بنموذج أساسي في تلك المنطقة، بدلاً من ملف عبر المناطق، واضبط ANTHROPIC_MODEL على ARN الخاص به.
لا تزال بعض حركة الشبكة تصل إلى Anthropic. يكون جمع القياس عن بُعد، والإبلاغ عن الأخطاء، والأمر /feedback معطلاً افتراضياً في Bedrock وVertex، ويكتب /feedback أرشيفاً ضمن ~/.claude/feedback-bundles/ على جهازك، بدلاً من رفع أي شيء. هناك استثناءان يعملان مع كل مزوّد. قبل جلب عنوان URL، ترسل أداة WebFetch اسم المضيف، واسم المضيف فقط، إلى api.anthropic.com للتحقق من قائمة حظر الأمان. كما تظل استطلاعات جودة الجلسة ظاهرة. عطّل الأولى باستخدام skipWebFetchPreflight في ملف الإعدادات، والثانية باستخدام CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1. يؤدي ضبط CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC أيضاً إلى إيقاف الاستطلاعات، إلى جانب بقية حركة الشبكة غير الأساسية، لكنه لا يؤثر في فحص WebFetch، الذي يملك خيار إلغاء اشتراك مستقلاً. عندما تضبط المنصة المضيفة CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST، يصبح جمع القياس عن بُعد مفعلاً افتراضياً بدلاً من ذلك.
في ما يتعلق بالتدريب: وفق الشروط التجارية، لا تدرّب Anthropic النماذج على الشيفرة أو المطالبات المرسلة عبر Claude Code، ويُعد استخدام منصات الجهات الخارجية استخداماً تجارياً. لا يُتاح Development Partner Program، وهو البرنامج الاختياري الذي يسمح بالتدريب، لمستخدمي Bedrock أو Vertex على الإطلاق. في Vertex، تتطلب نماذج Fable مشاركة المطالبات والاستجابات مع Anthropic لمراقبة إساءة الاستخدام؛ وينطبق الأمر نفسه على النماذج المسجّلة في Cyber Verification Program. يخضع الاحتفاظ الصفري بالبيانات على نقاط النهاية هذه لاتفاقك مع AWS أو Google ومتطلبات الاحتفاظ الخاصة بالنموذج.
وجّه Claude Code إلى Amazon Bedrock
تحدث خطوتان مرة واحدة لكل حساب AWS قبل أن يصبح إعداد العميل مهماً. افتح وحدة تحكم Amazon Bedrock، واختر نموذج Anthropic من كتالوج النماذج، ثم أرسل نموذج حالة الاستخدام؛ يُمنح الوصول مباشرة بعد الإرسال. بعد ذلك، أرفق سياسة IAM تسمح بالاستدعاءات التي يجريها Claude Code.
bedrock:InvokeModelbedrock:InvokeModelWithResponseStreambedrock:ListInferenceProfilesbedrock:GetInferenceProfile
يتيح ListInferenceProfiles لـClaude Code التحقق عند بدء التشغيل من النماذج التي يستطيع حسابك استدعاءها فعلياً. ويتيح GetInferenceProfile له حل ARN لملف استدلال تطبيق إلى النموذج الأساسي الذي يشير إليه، حتى يختار بنية الطلب الصحيحة. من دون هذا الإذن، تظل الطلبات ناجحة، لأن Claude Code يعيد المحاولة مرة واحدة باستخدام البنية الأخرى. وتظهر المشكلة في رحلة إضافية ذهاباً وإياباً لكل نموذج جديد، وليس في شكل خطأ. كما تسمح السياسة التي تنشرها Anthropic بـaws-marketplace:ViewSubscriptions وaws-marketplace:Subscribe عند استدعائهما عبر Bedrock، وهذا يغطي خطوة الاشتراك في النموذج.
أسرع طريقة لإعداد العميل هي المعالج. شغّل claude، واختر منصة تابعة لجهة خارجية ثم Amazon Bedrock، أو اكتب /setup-bedrock في جلسة سجّلت الدخول إليها مسبقاً. يقرأ المعالج الملفات الشخصية من المجلد ~/.aws، ويتحقق من النماذج التي يمكنك استدعاءها، ويكتب النتيجة في كتلة env داخل ~/.claude/settings.json، لذلك لا يعتمد أي شيء على ملف تعريف shell.
لنشر الإعداد باستخدام نص برمجي، عيّن المتغيرات بنفسك.
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1تأتي بيانات الاعتماد من سلسلة بيانات اعتماد AWS SDK القياسية، لذلك كل ما يعمل بالفعل مع CLI الخاص بـaws يعمل هنا أيضاً: aws configure، أو ملف SSO شخصي، أو دور مفترض، أو مفتاح Bedrock API.
aws sso login --profile=your-profile-name
export AWS_PROFILE=your-profile-nameexport AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-keyيُعد رمز bearer أبسط خيار، لكنه يحتاج إلى معالجة حذرة لأنه سر موجود في متغير بيئة. تصدر AWS مفاتيح قصيرة الأجل تستمر حتى 12 ساعة، ومفاتيح طويلة الأجل تستمر حتى تاريخ تحدده، وتوصي باستخدام النوع طويل الأجل للاستكشاف فقط. على خادم بناء مشترك، فضّل دوراً تنتهي صلاحيته. وينطبق المنطق نفسه على كل بيانات الاعتماد الأخرى التي يستطيع الوكيل قراءتها، وهذا هو موضوع إبقاء الأسرار بعيدة عن متناول وكيل ذكاء اصطناعي.
فخ المنطقة. يفك Claude Code المنطقة بالترتيب التالي: AWS_REGION، ثم AWS_DEFAULT_REGION، ثم region في ملف AWS الشخصي النشط، ثم us-east-1. الخطوة الأخيرة قيمة افتراضية وليست خطأ، لذلك قد يرسل فريق لم يعيّن منطقة في أي موضع، وافترض التوجيه الأوروبي، طلباته إلى منطقة في الولايات المتحدة من دون عرض أي تحذير. شغّل /status داخل Claude Code لعرض المنطقة التي جرى حلها والمصدر الذي جاءت منه. لتأكيد ما يستطيع حسابك استدعاءه في منطقة معينة، شغّل aws bedrock list-inference-profiles --region your-region.
يوفّر Bedrock أيضاً نقطة نهاية Mantle، التي تستخدم بنية Anthropic API الأصلية. اخترها باستخدام CLAUDE_CODE_USE_MANTLE=1؛ فهي تستخدم بيانات اعتماد AWS نفسها، لكنها تتطلب أذونات IAM إضافية منفصلة في bedrock-mantle:.
تشغيل Claude Code على Google Vertex AI
فعّل واجهة API واحصل على بيانات الاعتماد.
gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default loginاطلب الوصول إلى نماذج Claude التي تريدها في Model Garden. انتظر من 24 إلى 48 ساعة للموافقة. امنح roles/aiplatform.user، إذ يتضمن الإذن aiplatform.endpoints.predict المستخدم لاستدعاء النماذج وحساب الرموز معاً.
ثم اختر المزوّد.
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-IDيقبل CLOUD_ML_REGION قيمة global، أو موقعاً متعدد المناطق مثل eu أو us، أو منطقة واحدة. توفّر نقطة النهاية العامة أفضل إتاحة وأقل تحكماً في مكان معالجة الطلب، لذلك يتطلب شرط إقامة البيانات عادةً تحديد موقع بدلاً منها. يختلف دعم النماذج بين هذه الصيغ الثلاث. عندما يكون أحد النماذج التي تحتاج إليها غير متاح عبر نقطة النهاية العامة، ثبّت ذلك النموذج وحده على موقع محدد باستخدام متغيره VERTEX_REGION_CLAUDE_*، واترك كل شيء آخر على النقطة العامة. راجع صفحة مواقع Vertex AI الحالية بدلاً من الاعتماد على قائمة قديمة.
فخ المشروع. يحدد ANTHROPIC_VERTEX_PROJECT_ID وجهة الطلبات. يوجّه Claude Code الطلبات إلى ذلك المشروع حتى عندما يحدد GCLOUD_PROJECT أو GOOGLE_CLOUD_PROJECT أو ملف بيانات الاعتماد المشار إليه بواسطة GOOGLE_APPLICATION_CREDENTIALS مشروعاً مختلفاً. على جهاز يشير فيه gcloud إلى مشروع، ويسمي فيه ANTHROPIC_VERTEX_PROJECT_ID المتبقي مشروعاً آخر، تُسجّل التكاليف على المشروع الثاني، ولا يظهر أي تحذير بذلك أثناء الجلسة.
تحقق بعد تغيير أي مزوّد. شغّل /status للتحقق من المزوّد النشط والإعدادات. إذا لم تصل المتغيرات إلى العملية، فتحقق من تصديرها في الصدفة التي شغّلت claude. انقلها إلى كتلة env في ملف الإعدادات. وهذه أيضاً طريقة لإبقاء قيمة مثل AWS_PROFILE خارج كل عملية أخرى تشغّلها.
النماذج التي تحصل عليها، ومدى تأخر وصولها
لا تعني الأسماء المستعارة مثل sonnet وopus أنها تشير إلى الأحدث. في نقطة نهاية تابعة لجهة خارجية، تُحل هذه الأسماء إلى النموذج الافتراضي المضمّن في Claude Code لدى ذلك المزوّد، وقد يتأخر هذا النموذج عن الإصدار الحالي، وقد لا يكون مفعّلاً لحسابك أصلاً. عندما لا يتوفر النموذج الافتراضي، ينتقل Claude Code إلى نموذج أقدم أو أدنى مستوى خلال تلك الجلسة ويطبع إشعاراً بذلك. لا يُحفَظ النموذج البديل، لكن يمكن لـ Claude Code تذكّر حالات رفض الوصول إلى النماذج على الجهاز لمدة تصل إلى يوم واحد، كما يعيد عند التشغيل التحقق من رفض محفوظ للنموذج الافتراضي الحالي بعد مرور عشر دقائق على آخر تحقق.
عند طرح التغيير على فريق، ثبّت الإصدارات.
# Copy the exact IDs from your provider's own model catalog.
export ANTHROPIC_DEFAULT_OPUS_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_SONNET_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='<provider model id>'خذ المعرّفات من نظرة عامة على النماذج ومن كتالوج المزوّد الذي تستخدمه، لأن التنسيق يختلف حسب المزوّد: يتطلب Bedrock معرّف ملف استدلال أو ARN، بينما يتطلب Vertex اسم نموذج عادي. لا تنسخ هذه المعرّفات من مقال، بما في ذلك هذا المقال. يُعد تثبيت الإصدار وسيلة للتحكم في التكلفة أيضاً، لأن النموذج الأساسي الافتراضي من فئة Opus، وتكلفة Opus لكل رمز أعلى من Sonnet؛ لذلك تُحاسَب عملية نشر لا تثبّت أي نموذج بالسعر الأعلى. لتعيين نموذج واحد كافتراضي للجلسة بدلاً من ذلك، اضبط ANTHROPIC_MODEL على معرّفه الكامل.
يمثل وصول النموذج أوضح مفاضلة في هذه المقارنة. في واجهة Anthropic البرمجية الخاصة، يعمل النموذج في يوم إطلاقه. أما في Bedrock وVertex، فيعمل بعد أن يفعّله المزوّد السحابي في منطقتك ويمنح حسابك صلاحية الوصول إليه. إذا كان يجب تشغيل بعض الأعمال على أحدث نموذج، فأبقِ مسار توجيه واحداً يمكنه الوصول إليه. هذه هي الحالة العملية لـ توجيه نماذج مختلفة إلى مهام مختلفة.
ما تتخلى عنه عند استخدام Bedrock وVertex
تعمل جميع الوظائف المحلية لدى كل موفّر: الوكلاء الفرعيون، وhooks، وأوامر slash، والمهارات، والإضافات، ونقاط التحقق، والعزل، وملف الإعدادات المُدار، ومقاييس OpenTelemetry. أما الفجوات فتوجد جميعها على جانب الخادم.
الوظائف غير المتاحة على أيٍّ من نقطتي النهاية: Advisor، وChannels، وCode Mode، ولوحة التحليلات، والإعدادات المُدارة من الخادم، وأوامر /design-sync و/import. كما لا يتوفر أي شيء يتطلب حساب claude.ai، ويشمل ذلك Claude Code على الويب، وتطبيق الهاتف المحمول، وRemote Control، والروتينات، والقطع الأثرية.
في Bedrock فقط: الوضع السريع غير متاح، كما أن أداة WebSearch غير موجودة فيه؛ لذلك لا يستطيع Claude إجراء بحث من جلسة موجّهة إلى Bedrock. لكنه يستطيع قراءة صفحة باستخدام WebFetch عند تزويده بعنوان URL. أما البحث على الويب فيعمل على Vertex مع نماذج Claude 4 التوليدية والإصدارات الأحدث. كما يدعم Vertex الوضع السريع على Fable 5.2 مع Claude Code v2.1.322 أو إصدار أحدث في global أو us أو eu، مع استخدام السرعة القياسية كخيار بديل إذا رفض الموفّر الوضع السريع.
متاحة جزئياً لدى كليهما: يعمل الوضع التلقائي على مجموعة محدودة من النماذج الأحدث فقط، ولا تصل المراسلة بين الجلسات إلا إلى جلساتك الأخرى على الجهاز نفسه، كما يحتاج /loop الذي يختار الفاصل الزمني بنفسه إلى Claude Code v2.1.248 أو إصدار أحدث. يمكن الوصول إلى Desktop عبر Claude Desktop على 3P، أو عبر توجيه البوابة المُعدّ في التطبيق أو بواسطة مسؤول. راجع صفحة Anthropic الخاصة بـتوفر الميزات قبل أن تعد فريقك بتوفر ميزة، لأن هذه القائمة تتغير.
من يتحمل الفاتورة
الاشتراك ونقطة النهاية التابعة لجهة خارجية عمليتا شراء منفصلتان. ولا يحل أي منهما محل الآخر.
من المهم توضيح ذلك، لأن الخطأ لا يظهر بوضوح. إذا عيّنت CLAUDE_CODE_USE_BEDROCK=1 على جهاز سجّلت فيه الدخول أيضاً باستخدام مقعد Max، فستُحتسب تكلفة حركة الشبكة بواسطة AWS: لكل رمز وفق أسعار Bedrock عند الطلب، أو مقابل السعة الموفّرة إذا كان هذا ما اشتراه حسابك. يستمر تحصيل تكلفة المقعد شهرياً، ولا يغطي أي جزء من حركة الشبكة هذه. ولا توجد أيضاً واجهة موحّدة لعرض التكلفة: تنتقل تفاصيل الإنفاق إلى AWS Cost Explorer أو Google Cloud Billing، ولا تتوفر لوحة تحليلات Anthropic لدى أي من موفري الخدمة. ويختفي الأمر /logout أيضاً، لأنه لا توجد جلسة Anthropic لإنهائها. بيانات الاعتماد هي بيانات اعتماد السحابة.
توجد الأسعار في صفحة موفر الخدمة نفسه وقد تتغير، لذلك راجع أسعار Amazon Bedrock أو أسعار Vertex AI بدلاً من الاعتماد على أي رقم يرد في مقالة. ولا تتغير نقطة أساسية: تُحتسب تكلفة الاستدلال عند الطلب على نقاط النهاية هذه لكل رمز، لذلك تكون تكلفة وكيل يعمل طوال اليوم بحسب استخدامه، من دون حد للخطة لإيقافه. والبديل الذي يبيعه موفرا السحابة هو السعة الموفّرة، وهي سعة محجوزة برسوم ثابتة طوال مدة احتفاظك بها. تفرض AWS رسومها بالساعة، ويستخدمها Claude Code عند تعيين ARN الخاص بالسعة الموفّرة معرّفاً للنموذج. ومن الأفضل حساب ما إذا كان أي من الخيارين يتفوق على شراء مقاعد للجميع قبل الإطلاق، لا بعد وصول الفاتورة الأولى؛ إذ تجري المقارنة بين تكلفة المقعد والحساب لكل رمز في خطتي Team وEnterprise على مستوى الفريق.
تختلف حدود المعدل والحصص باختلاف كل مسار
في اشتراكات Pro وMax وUltra وTeam وEnterprise الأقدم المعتمدة على المقاعد، ترتبط الحدود بالحساب وتُعاد تهيئتها وفق جدول زمني. عند بلوغ أحدها، يجب الانتظار، ما لم تكن أرصدة الاستخدام مفعّلة: يمكن لمشتركي Pro وMax وUltra، ولمنظمات Team وEnterprise الأقدم المعتمدة على المقاعد، مواصلة العمل بعد تجاوز الحد بالأسعار القياسية لواجهة API حتى بلوغ حد الإنفاق. لا تفرض خطط Enterprise الحالية المعتمدة على الاستخدام حدود استخدام على مستوى الخطة أو المقعد؛ إذ تُحتسب الرسوم حسب الاستهلاك، ويمكن للمسؤولين ضبط حدود إنفاق للمنظمة وللأفراد. يوضّح كيفية عمل حدود الاستخدام هذا السلوك.
في مفتاح Anthropic API، ترتبط الحدود بالمنظمة، وتُعبَّر عنها بعدد الطلبات والرموز في الدقيقة، وترتفع مع زيادة مستوى استخدامك.
في Bedrock وVertex، تكون الحدود حصصاً سحابية لا علاقة لها بأي خطة من Anthropic. في Bedrock، تُحدَّد الحصص لكل حساب ومنطقة، ومعظمها لكل نموذج، إضافة إلى حصة يومية للرموز تشمل النماذج المدعومة في ذلك الحساب وتلك المنطقة. في Vertex، تُحدَّد الحصص لكل مشروع وموقع. وعلى نقاط النهاية العالمية ومتعددة المناطق، تشترك نماذج Claude التي أُطلقت بعد May 26, 2026 في حصة واحدة لكل سلالة نموذج: إذ تسحب كل إصدارات عائلة النموذج من المجموعة نفسها في موقع معيّن، بينما تحتفظ نقطة النهاية العالمية وكل نقطة نهاية متعددة المناطق بمجموعات منفصلة. يعني الخطأ 429 عادةً نفاد إحدى هذه الحصص، لكنه قد يعني أيضاً، عند استخدام السعة المشتركة بنظام الدفع حسب الاستخدام، أن المزوّد يعاني نقصاً في السعة؛ لذلك أعد المحاولة مع التراجع التدريجي قبل تغيير أي شيء. إذا كانت المشكلة في حصتك، فالحل موجود في وحدة تحكم المزوّد: اطلب زيادة، أو انتقل إلى موقع تتوفر فيه سعة. تحتسب Bedrock الحصة وفق قاعدة token burndown بدلاً من عدد ثابت للطلبات، بينما تُشترى السعة المحجوزة في أي من السحابتين بصيغة معدل نقل مُوفَّر. في Vertex، تحقّق عند التحقيق في الخطأ 429 من أن نقطة النهاية أحادية المنطقة تخدم النموذج الأساسي والنموذج الصغير السريع معاً؛ وتُعد CLOUD_ML_REGION=global نقطة البداية الموثّقة لتحسين التوافر. وتغطي صفحة الحصص من Google طلب الزيادة.
أنماط الفشل، مع النصوص التي ستظهر لك
Could not load the default credentials، على Vertex. بيانات الاعتماد الافتراضية للتطبيق مفقودة أو منتهية الصلاحية. شغّل gcloud auth application-default login، أو اجعل GOOGLE_APPLICATION_CREDENTIALS يشير إلى ملف مفتاح حساب خدمة.
خطأ 404 يذكر اسم النموذج، على Vertex. النموذج غير مفعّل في Model Garden لهذا المشروع، أو غير متاح في الموقع الذي ضبطته. تُخدَّم بعض النماذج فقط عبر نقطة النهاية العامة أو في موقع متعدد المناطق مثل eu، ولا تُخدَّم مطلقاً في منطقة محددة.
on-demand throughput isn't supported، على Bedrock. مرّرت معرّف نموذج أساس مجرداً لنموذج لا يُخدَّم إلا عبر ملف تعريف استدلال. استخدم معرّف ملف تعريف الاستدلال بدلاً منه.
AWS default-chain credential resolve timed out. توقفت خطوة في سلسلة بيانات اعتماد AWS، مثل مساعد credential_process ينتظر إدخالاً لا يمكنه استلامه. تنتهي مهلة الحل الذي يملأ ذاكرة التخزين المؤقت لبيانات الاعتماد بعد 60 ثانية افتراضياً. إذا كانت سلسلتك تحتاج فعلاً إلى وقت أطول، مثل تدفق SSO عبر المتصفح مع MFA (المصادقة متعددة العوامل) خلف غلاف، فارفع الحد بالمللي ثانية باستخدام CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS. عند ضبط CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1، تحلّ كل طلبات API السلسلة من دون هذا الحد.
خطأ عند بدء Bedrock streaming response has content-type. يعيد شيء ما بين Claude Code وBedrock كتابة التدفق. يرسل Bedrock التدفقات بتنسيق binary event-stream وبنوع المحتوى application/vnd.amazon.eventstream، ولذلك فإن البوابة التي تعيد إرساله كأحداث مرسلة من الخادم تعيد نصاً لا يستطيع Claude Code فك ترميزه. أصلح البوابة كي تمرّر نص الاستجابة ورأس Content-Type من دون تغيير.
فتح علامات تبويب المتصفح في حلقة أثناء AWS SSO. تقطع VPN المؤسسية أو وكيل يفحص TLS عملية تسجيل الدخول، ويقرأ Claude Code الاتصال التالف على أنه فشل في المصادقة، ثم يعيد تشغيل الأمر awsAuthRefresh ويتكرر ذلك بلا نهاية. أزل awsAuthRefresh من ملف الإعدادات، وشغّل aws sso login يدوياً قبل بدء Claude Code.
اختيار مسار التوجيه
اختر الاتصال المباشر بـAnthropic إذا كنت تريد النماذج الجديدة فور إطلاقها ومجموعة الميزات الكاملة. اختر مفتاح API إذا كنت تريد الفوترة حسب عدد الرموز من دون شراء مقاعد. اختر Bedrock أو Vertex عندما يكون الشرط هو تنفيذ الاستدلال داخل حساب سحابي تديره بالفعل، وتقبل توفر النماذج لدى المزوّد وقائمة الميزات الأقصر مقابل ذلك. تستحق صفحات الإعداد التي يجدر حفظها في الإشارات المرجعية أن تكون صفحات Anthropic نفسها الخاصة بـAmazon Bedrock وGoogle Vertex AI، إلى جانب قائمة AWS الخاصة بـالنماذج حسب المنطقة.
لا يغيّر أي من الخيارات الثلاثة المكان الذي ينفّذ فيه الوكيل نفسه. Claude Code هو عملية محلية تقرأ ملفاتك وتشغّل أوامرك، أيّاً كانت نقطة النهاية التي تستجيب لها. لذلك تضع الفرق التي تريد تشغيله في مكان آخر غير الحاسوب المحمول وكيل البرمجة على VPS وتصدّر المتغيرات نفسها هناك.
FAQ
هل يغطي اشتراك Claude الخاص بي استخدام Claude Code على Bedrock أو Vertex؟
لا. إن مقعد Pro أو Max أو Ultra أو Team أو Enterprise ونقطة النهاية التابعة لجهة خارجية عمليتان منفصلتان للشراء، ولا يغطي أحدهما الآخر. عند ضبط CLAUDE_CODE_USE_BEDROCK=1 أو CLAUDE_CODE_USE_VERTEX=1، تُحاسَب حركة الشبكة من AWS أو Google Cloud وفق عدد الرموز وبأسعارهما عند الطلب، أو تُحتسب مقابل الإنتاجية الموفّرة التي اشتريتها، وتظهر في فاتورة تلك السحابة، بينما يستمر احتساب المقعد للخدمات التي يغطيها. وينتقل تتبّع الإنفاق أيضاً إلى AWS Cost Explorer أو Google Cloud Billing، لأن لوحة تحليلات Anthropic غير متاحة على أي من المزوّدين.
إلى أي منطقة يرسل Claude Code طلباتي على Amazon Bedrock؟
إلى المنطقة التي حددها، والتي سيعرضها لك /status. يتحقق Claude Code من AWS_REGION، ثم AWS_DEFAULT_REGION، ثم region في ملف AWS النشط، ويستخدم us-east-1 إذا لم تكن أي من هذه القيم مضبوطة. ثم تُحيل نماذجه الافتراضية المضمّنة إلى ملفات تعريف للاستدلال عبر المناطق، وتتبّع بادئتها تلك المنطقة، مثل us. أو eu.. ويمكن لملف تعريف عبر المناطق معالجة الطلب من منطقة أخرى داخل المنطقة الجغرافية نفسها. عندما تكون هناك حاجة إلزامية إلى منطقة محددة، استخدم ملف تعريف لاستدلال التطبيق مدعوماً بنموذج أساسي في تلك المنطقة بدلاً من ملف تعريف عبر المناطق، واضبط ANTHROPIC_MODEL على ARN الخاص به.
لماذا لا يظهر أحدث نموذج Claude في حسابي على Bedrock أو Vertex؟
لأن كل مزوّد سحابي يتيح النماذج وفق جدول زمني خاص به، ويجب منح حسابك صلاحية الوصول بالإضافة إلى ذلك. في Vertex، تطلب الوصول من Model Garden، وقد تستغرق الموافقة من 24 إلى 48 ساعة. وحتى ذلك الحين، تُحيل الأسماء المستعارة مثل sonnet وopus إلى النموذج الافتراضي المضمّن في Claude Code لذلك المزوّد. وإذا لم يكن هذا النموذج الافتراضي متاحاً في حسابك، ينتقل Claude Code إلى نموذج أقدم أو أقل مستوى لهذه الجلسة ويعرض إشعاراً. ثبّت ANTHROPIC_DEFAULT_SONNET_MODEL وما يماثله على معرّفات تحققت من تمكينها.
هل يتوفر البحث على الويب في Claude Code على Amazon Bedrock؟
لا. أداة WebSearch غير متاحة على Bedrock، لذلك لا يستطيع Claude إجراء بحث من جلسة موجّهة إليه. لكنه يستطيع قراءة صفحة محددة باستخدام WebFetch عندما تزوّده بعنوان URL. أما في Google Vertex AI، فيعمل البحث على الويب مع نماذج جيل Claude 4 وما بعده. وهذا أحد فروق القدرات القليلة التي تصب في مصلحة Vertex.
هل أحتاج إلى حساب Anthropic لتشغيل Claude Code على Bedrock أو Vertex؟
لا. بيانات المصادقة هي بيانات اعتماد AWS أو Google Cloud الخاصة بك، ولذلك لا يتوفر /logout على أي من المزوّدين. لكن يظل هناك اتصال واحد بـAnthropic، أيّاً كان المزوّد الذي تستخدمه: قبل جلب عنوان URL، ترسل أداة WebFetch اسم المضيف، واسم المضيف فقط، إلى api.anthropic.com للتحقق منه مقابل قائمة حظر أمنية. اضبط skipWebFetchPreflight في ملف الإعدادات لتعطيل ذلك، واربطه بقواعد أذونات WebFetch إذا كنت تريد أيضاً تقييد النطاقات التي يمكن لـClaude الوصول إليها.