وكيل Claude Code: توجيه Claude وGPT-5 وGemini عبر عبّارة TrueFoundry AI Gateway

Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
مقدمة
يُعد Claude Code أقوى مساعد برمجة يعمل بالذكاء الاصطناعي متاح اليوم. ونادراً ما يعود المهندسون الذين يعتمدونه إلى الطرق القديمة. ولكن عندما يبدأ العشرات أو المئات من المهندسين في استخدامه في وقت واحد، تظهر مشكلة جديدة: يتواصل Claude Code، بشكل افتراضي، مباشرة مع واجهة برمجة تطبيقات Anthropic. مصادقة كل مطور تتم باستخدام مفتاحه الخاص، ويستخدم نماذج Anthropic حصرياً، ويولد إنفاقاً على واجهة برمجة التطبيقات يكون مخفياً تماماً عن فريق المنصة حتى تصل الفاتورة الشهرية.
وكيل Claude Code هو الحل. من خلال توجيه Claude Code إلى نقطة نهاية وكيل بدلاً من توجيهه مباشرة إلى Anthropic، تكتسب نقطة تحكم مركزية لكل استدعاء نموذج عبر مؤسسة الهندسة بأكملها: رؤية شاملة لمن ينفق وماذا ينفق، والقدرة على فرض حدود للميزانية قبل تجاوزها، وإمكانية الوصول إلى النماذج من أي مزود - GPT-5 وGemini 2.5 Pro وLlama عبر Bedrock - من خلال نفس الواجهة التي يعرفها Claude Code بالفعل، والقدرة على نشر تكوين العبّارة مرة واحدة وتطبيقها على جميع المطورين دون المساس بالأجهزة الفردية.
TrueFoundry AI Gateway هي وكيل Claude Code المخصص للمؤسسات. إنها نقطة نهاية متوافقة مع Anthropic ومجهزة للاستبدال المباشر يربطها Claude Code بتغيير متغير بيئة واحد. بمجرد الاتصال، يتدفق كل طلب Claude Code عبر العبّارة مما يمنحك القابلية للملاحظة، والتحكم في التكاليف، والتوجيه متعدد النماذج، وسياسات أمان المؤسسات التي تنطبق على المؤسسة بأكملها، وليس فقط المطورين الذين يتذكرون تكوينها.
يشرح هذا الدليل بدقة ما يفعله وكيل Claude Code، ولماذا تعتبر TrueFoundry AI Gateway الخيار المناسب لفرق الهندسة في المؤسسات، وكيفية تكوينها، بما في ذلك كل من تدفقات مفتاح API القياسي واشتراك Claude Max.
ما هو وكيل Claude Code؟
يأتي Claude Code مع مقبض تكوين واحد لتغيير واجهته الخلفية: متغير البيئة ANTHROPIC_BASE_URL. عند ضبطه، يرسل Claude Code جميع طلبات API الخاصة به - الرسائل، استدعاءات النماذج، استجابات التدفق إلى ذلك العنوان URL بدلاً من https://api.anthropic.com.
هذا المتغير الواحد هو الأساس لكل وكيل Claude Code. الوكيل هو أي خادم يقوم بما يلي:
- قبول طلبات API بتنسيق Anthropic من Claude Code
- إضافة عناصر تحكم أو توجيه أو إمكانية ملاحظة عند طبقة الوكيل
- إعادة توجيه الطلبات إلى المزود الفعلي للنموذج (Anthropic، OpenAI، Google، Bedrock، المضيف محلياً)
- إعادة الاستجابات إلى Claude Code بالتنسيق الذي يتوقعه
أبسط وكيل ممكن هو وكيل عكسي يوفر التسجيل. وأكثرها تطوراً هي عبّارة الذكاء الاصطناعي للمؤسسات التي تتعامل مع المصادقة، وفرض الميزانية، وتوجيه النماذج عبر المزودين، والتخزين الدلالي المؤقت، وضوابط الأمان، ومسارات التدقيق الكاملة - كل ذلك بشفافية، دون إجراء أي تغييرات على طريقة سلوك Claude Code للمطور.
لماذا تبني الفرق وكيل Claude Code أو تعتمده؟
- التحكم في التكاليف: المطورون المتعددون الذين يستخدمون Claude Code مع مفاتيح Anthropic الفردية يولدون إنفاقاً ينكشف فقط في نهاية الشهر. يعترض الوكيل كل طلب ويفعل الحدود اليومية لكل مطور قبل أن تتجاوز التكاليف الميزانية.
- الوصول إلى نماذج متعددة: واجهة Claude Code قوية، لكن نماذج Claude ليست دائماً الخيار الأفضل أو الأكثر فاعلية من حيث التكلفة لكل مهمة. يتيح لك الوكيل توجيه المهام من مستوى haiku إلى GPT-4o-mini أو Gemini Flash، والمهام من مستوى opus إلى أفضل نموذج متاح دون أي تغييرات من جانب العميل.
- أمان المؤسسات: مفاتيح API المباشرة على أجهزة المطورين المحمولة تعتبر مخاطرة أمنية. يركز الوكيل أوراق الاعتماد: يصادق المطورون لدى الوكيل، ويحتفظ الوكيل بمفاتيح المزود. ولا يحتاج أي مفتاح Anthropic للوجود على جهاز المطور على الإطلاق.
- الحوكمة على مستوى الفريق: يمكن للمطورين الفرديين تكوين
ANTHROPIC_BASE_URLالخاص بهم. ولكن فرض ذلك عبر فريق بأكمله يتطلب آلية نشر مركزية - إدارة الأجهزة المحمولة (MDM)، أو الإعدادات المُدارة بواسطة الخادم، أو مشروع مشترك.claude/settings.jsonمُفحوص في التحكم في الإصدارات.
لماذا تعد TrueFoundry AI Gateway وكيل Claude Code المناسب؟
هناك ثلاث طرق لإنشاء وكيل Claude Code: بناء الوكيل الخاص بك، أو استخدام وكيل عكسي بسيط، أو استخدام عبّارة ذكاء اصطناعي مخصصة لهذا الغرض. بناء الوكيل الخاص بك يعني صيانة وأمان وموثوقية عبّارة واجهة برمجة تطبيقات إنتاجية على مسؤوليتك. يضيف الوكيل العكسي البسيط سجلات ولكنه لا يوفر أي من عناصر التحكم. تمنحك TrueFoundry AI Gateway كل ما يحتاجه فريق الهندسة في المؤسسة بالفعل دون الحاجة إلى بنائه أو صيانته.
TrueFoundry AI Gateway هي طبقة وكيل موحدة بين Claude Code ومزودي النماذج لديك. وهي تقبل نفس تنسيق Anthropic API الذي يتحدث به Claude Code بالفعل، لذلك لا يحتاج Claude Code أبداً إلى معرفة أنه يتحدث إلى عبّارة بدلاً من التحدث مباشرة إلى Anthropic. خلف العبّارة، يمكنك توصيل أي مزود: Anthropic المباشر، AWS Bedrock، Google Vertex AI، Azure OpenAI، OpenAI، أو النماذج الخاصة بك المضافة محلياً.
إليك ما يراه Claude Code في الواقع:
كل طلب Claude Code يتدفق عبر TrueFoundry يكتسب تلقائياً:
~3–4ms مهلة عبّارة p95، و+350 RPS على vCPU واحد. عند أوقات استجابة Claude Code (بالثواني وليس بالمللي ثانية)، لا تضيف العبّارة أي كمون ملموس.
الخطوة 1: توجيه Claude Code إلى TrueFoundry AI Gateway
التكوين الأساسي عبارة عن متغير بيئة واحد:
التكوين الدائم - وهو ما تريده للاستخدام الإنتاجي - يتطلب تعديل settings.json الخاص بـ Claude Code. يتم دعم مسارين:
- عام (ينطبق على جميع المشاريع):
~/.claude/settings.json - خاص بمشروع معين (مُفحص في التحكم في الإصدارات):
.claude/settings.jsonفي دليل المشروع الخاص بك
التكوين القياسي لمفتاح API
استخدم هذا عندما يتطابق المطورون مع مفتاح TrueFoundry API (النمط المؤسسي الموصى به — لا توجد مفاتيح Anthropic على أجهزة المطورين):
ما يفعله كل حقل:
ANTHROPIC_BASE_URL— يعيد توجيه جميع طلبات Claude Code إلى TrueFoundryANTHROPIC_AUTH_TOKEN— مفتاح TrueFoundry API؛ يصادق المطور لدى العبّارة (يستبدل مفتاح Anthropic API)ANTHROPIC_MODEL— النموذج الافتراضي لجلسات Claude CodeANTHROPIC_DEFAULT_OPUS_MODEL،ANTHROPIC_DEFAULT_SONNET_MODEL،ANTHROPIC_DEFAULT_HAIKU_MODEL— يربط أسماء النماذج المدمجة في Claude Code (/model opus،/model sonnet،/model haiku) بالنماذج المكونة في TrueFoundry الخاصة بكCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS— يعطل ميزات Claude Code التجريبية لسلوك عبّارة مستقرANTHROPIC_CUSTOM_HEADERS— يوجه رأسx-tfy-anthropic-betaإلى Anthropic للميزات التجريبية مثل إدارة السياق
هام: يكتشف Claude Code إمكانيات النموذج (التفكير الممتد، ToolSearch، كتل أدوات التراخيص التجريبية) عن طريق مطابقة السلسلة النصية لمعرف النموذج. تأكد من أن ANTHROPIC_DEFAULT_OPUS_MODEL، ANTHROPIC_DEFAULT_SONNET_MODEL، وANTHROPIC_DEFAULT_HAIKU_MODEL تحتوي على معرف نموذج Anthropic مألوف مثل claude-opus-4-7، claude-sonnet-4-6، أو claude-haiku-4-5. إذا كنت تستخدم نموذج TrueFoundry الافتراضي، فـتأكد من أن اسم العرض الخاص به يحتوي على معرف النموذج الأساسي - مثل your-account/claude-haiku-4-5 — لكي تنجح مطابقة السلاسل النصية.
تكوين اشتراك Claude Code Max
إذا كان فريقك يستخدم اشتراكات Claude Code Max، فإن Claude Code يحجز رأس Authorization لمصادقة حساب Anthropic. استخدم x-tfy-api-key في ANTHROPIC_CUSTOM_HEADERS بدلاً من ذلك:
لماذا يعتبر هذا النمط جيداً لمستخدمي Max:
- تحتفظ باشتراك Anthropic Max لمصادقة جلسة Claude Code - يتدفق رأس
Authorizationإلى Anthropic كما هو - تتم مصادقة TrueFoundry بشكل منفصل عبر
x-tfy-api-key- تحكم العبّارة الطلب بينما تتولى Anthropic الفواتير عبر اشتراكك - تحصل على حوكمة مركزية (الرؤية، الكوتا، RBAC، السجلات، ضوابط الأمان) دون تغيير سير عمل Claude Code اليومي
راجع توثيق TrueFoundry Claude Code للحصول على دليل التكامل الكامل، وتكامل Claude Code Max للحصول على خيار اشتراك Max.
الخطوة 2: استخدام GPT-5 وGemini وأي نموذج عبر Claude Code
هنا يتحول وكيل Claude Code من خيار مريح إلى تحولي. بمجرد توجيه Claude Code عبر TrueFoundry، يمكنه الوصول إلى أي نموذج من أي مزود وليس فقط Anthropic. يمكنك إضافة حسابات المزودين في لوحة تحكم عبّارة TrueFoundry (OpenAI، Google Vertex AI، AWS Bedrock، Azure OpenAI، xAI، أو النشر المحلي الخاص بك)، وتصبح تلك النماذج متاحة عند نفس نقطة نهاية العبّارة.
توجيه أسماء النماذج المستعارة لـ Claude Code إلى نماذج غير تابعة لـ Anthropic
لاستخدام GPT-5 لفتحة "opus" الخاصة بـ Claude Code (المستوى الأكثر قدرة على الإطلاق للنماذج لديك)، قم فقط بتحديث الاسم المستعار للنموذج:
في هذا التكوين:
/model opus← GPT-5 (لمهام الهندسة والمعمارية المعقدة والتخطيط)/model sonnet← Claude Sonnet 4 (لمهام البرمجة القياسية)/model haiku← Gemini 2.5 Flash (لمهام سريعة وخفيفة الوزن مثل التحقق من البريد الإلكتروني، والبحث السريع)
تجربة المطور متطابقة تماماً. لا يزال المطورون يستخدمون /model opus أو --model haiku. ولا يحتاجون إلى معرفة المزود الموجود خلف كل اسم مستعار، أو إدارة أوراق الاعتماد لـ OpenAI أو Google.
استخدام النماذج الافتراضية للتوجيه المتقدم
تتيح لك TrueFoundry's Virtual Models إنشاء معرف نموذج واحد يوجه الطلبات عبر مزودين متعددين باستخدام توجيه قائم على الوزن أو الأولوية أو الكمون. وجه الاسم المستعار لنموذج Claude Code إلى نموذج افتراضي، وتتولى العبّارة منطق التوجيه بشفافية.
مثال: تجاوز الفشل القائم على الأولوية عبر المزودين
إذا واجه حساب Anthropic الرئيسي حدود معدل الطلبات، يتم التراجع تلقائياً إلى Bedrock Claude، ثم إلى GPT-4 - دون أن يلاحظ أي مطور ذلك:
مثال: تقييم A/B قائم على الوزن
اختبار نموذج جديد بنسبة 10% من حركة مرور Claude Code قبل التزام الفريق بأكمله:
ثم وجه الاسم المستعار sonnet لـ Claude Code إلى هذا النموذج الافتراضي. 10% من طلبات Claude Code sonnet تذهب إلى GPT-5 مع مقاييس كاملة للتكلفة والجودة في لوحة تحكم العبّارة لمقارنة النتائج.
الخطوة 3: عناصر تحكم المؤسسات التي تنطبق على كل طلب Claude Code
بمجرد توجيه Claude Code عبر TrueFoundry، يرث كل طلب حوكمة بمستوى المؤسسات ليس لأن المطورين قاموا بتكوينها، بل لأنها تُفرض عند طبقة العبّارة.
حدود الميزانية: إيقاف تجاوز التكاليف قبل حدوثه
تُفعل TrueFoundry's hierarchical budget limiting قبل استهلاك الرموز (tokens)، وليس بعد وصول الفاتورة الشهرية. وتتراكب القواعد وتندمج:
يحصل كبار المهندسين على 50 دولاراً/اليوم. وجميع الآخرين يتلقون 10 دولارات/اليوم كحد افتراضي. ويبلغ حد إجمالي إنفاق Opus عبر المؤسسة بأكملها 1000 دولار/الشهر — لذا حتى لو كان كل مطور ضمن حده الشخصي، فلا يمكن تجاوز ميزانية النموذج على مستوى المؤسسة.
تحديد معدل الطلبات (Rate Limiting): حماية البيئات المحلية والرقابية

يتعامل Rate limiting عند العبّارة مع سيناريوهات متخصصة لـ Claude Code:
- خطوط أنابيب CI: يجب تحديد معدل تشغيل Claude Code في CI بشكل مستقل عن جلسات المطورين التفاعلية. يجب ألا تستهلك مجموعة الاختبارات التي تستدعي Claude Code لمراجعة الكود نفس الكوتا المخصصة لجلسة البرمجة النشطة للمطور.
- نماذج التطوير مقابل الإنتاج: تتيح لك حدود المعدل المعتمدة على البيانات الوصفية (metadata) توجيه طلبات
environment: devإلى نموذج أرخص وتحديد معدل طلباتها — دون التأثير على البيئة الإنتاجية. - حماية وحدات GPU المحلية: إذا كنت تشغل نماذج محلية كهدف رئيسي لـ Claude Code، فيمكنك تحديد معدل نقطة النهاية المحلية والتوسع التلقائي نحو Cloud API عند اكتمال السعة.
تخصيص التكلفة: معرفة بالضبط من ينفق وماذا ينفق
يتم نسب كل طلب Claude Code تتم معالجته بواسطة TrueFoundry تلقائياً إلى المستخدم المصادق عليه. تعرض analytics dashboard التكلفة مقسمة حسب المطور والفريق والنموذج والتاريخ - مع إمكانية التصفية بآي علامة بيانات وصفية تمررها عبر رأس X-TFY-METADATA.
للفرق التي تستخدم تخصيص التكاليف القائم على المشاريع، قم بتزويد طلبات Claude Code ببيانات project_id أو feature الوصفية ليتم تعيين كل طلب تلقائياً إلى مركز التكلفة الصحيح:
تتم تصدير جميع التتبعات عبر OpenTelemetry إلى Grafana أو Datadog أو Splunk أو مجموعة أدوات القابلية للملاحظة الحالية لديك.
الخطوة 4: النشر عبر فريق الهندسة بأكمله
تكوين settings.json لمطور واحد أمر سهل. لكن فرض تكوين وكيل موحد عبر كل مطور في مؤسستك يتطلب استراتيجية نشر. تدعم TrueFoundry ثلاثة أساليب:
الخيار أ: إعدادات مُدارة عبر MDM (موصى به للمؤسسات)
دفع ملف managed-settings.json إلى كل جهاز مؤسسي عبر حل MDM الخاص بك (Jamf، Kandji، Mosyle، Intune) وقفله ضد التعديل على مستوى نظام التشغيل. هذا هو نهج إعدادات النقاط النهاية المُدارة لـ Claude Code.
مسارات مستوى النظام:
- macOS:
/Library/Application Support/ClaudeCode/managed-settings.json - Linux:
/etc/claude-code/managed-settings.json
هذا التكوين مقاوم للتلاعب، وينطبق فوراً عند بدء التشغيل دون الاعتماد على الشبكة، ولا يتطلب أي إجراء من المطور. كل جهاز يتلقى ملف تعريف MDM يتم توجيهه تلقائياً عبر TrueFoundry.
الخيار ب: إعدادات مُدارة عبر الخادم من خلال وحدة تحكم المشرف لـ Anthropic
تكوين الإعدادات مركزياً عبر Claude Admin Console (Admin Settings ← Claude Code ← Managed settings). يتم تقديم الإعدادات من خوادم Anthropic عندما يصادق المطورون باستخدام أوراق اعتماد المؤسسة الخاصة بهم - دون الحاجة لنشر الملفات.
لا يتطلب هذا النهج بنية تحتية لـ MDM ويعمل على أجهزة BYOD. يتم تقديم الإعدادات عند وقت المصادقة ويصعب على المستخدمين تجاوزها.
الخيار ج: ملف settings.json على مستوى المشروع في التحكم في الإصدارات
تضمين .claude/settings.json في جذر كل مستودع. أي مطور يستنسخ المستودع ويشغل Claude Code في ذلك الدليل يطبق تلقائياً إعدادات المشروع بما في ذلك URL عبّارة TrueFoundry وتكوين النموذج.
هذا الخيار هو الأقل احتكاكاً للفرق التي لديها هياكل مستودعات موحدة. يرث المطورون الجدد تكوين الوكيل بمجرد الاستنساخ.
الخطوة 5: ملحق VS Code وClaude Agent SDK
ملحق VS Code
يعمل ملحق Claude Code لـ VS Code بسلاسة مع TrueFoundry بمجرد تكوين CLI. الملحق ليس مستقلاً - فهو يتطلب تثبيت وتكوين CLI لـ Claude Code أولاً.
يستخدم الملحق تلقائياً تكوين CLI الخاص بك (URL الأساسي، مفاتيح API، النماذج المستعارة). لا يلزم إعداد منفصل.
ملاحظة لـ macOS/Linux: لا ترث تطبيقات الواجهة الرسمية (GUI) متغيرات بيئة الواجهة النصية (shell) بشكل افتراضي. قم دائماً بتشغيل VS Code من محطة طرفية تم فيها تكوين Claude Code لضمان التقاط الملحق لـ ANTHROPIC_BASE_URL.
Claude Agent SDK
يعمل Claude Agent SDK (الخليفة لـ Claude Code SDK) مع .claude/settings.json الحالي لديك عبر TrueFoundry. حدد setting_sources=["project"] لتحميل تكوين العبّارة برمجياً:
جميع تكوينات TrueFoundry - Anthropic المباشر، AWS Bedrock، Google Vertex AI، تعمل بشكل متطابق مع Agent SDK.
وكيل Claude Code المصنوع يدوياً (DIY) مقابل TrueFoundry AI Gateway
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.














.webp)





.webp)
.webp)
.png)

.png)
.png)
.png)
.png)
.png)
.webp)
.webp)






