ما يفعله الوكيل
بروكسي Claude Code هو أي خادم تشغله بين واجهة سطر الأوامر (CLI) للبرمجة من Anthropic والنموذج الذي يجيب. يقرأ Claude Code متغير بيئة لعنوان واجهة برمجة التطبيقات ويرسل طلباته إلى هناك. إذا كان هذا العنوان وكيلًا، فإن الوكيل يقرر ما يحدث فعليًا: يمكنه تسجيل حركة المرور، أو إضافة قواعد، أو توجيه المكالمة إلى نموذج مختلف.
التفاصيل الرئيسية هي تنسيق النقل. يستخدم Claude Code تنسيق Messages من Anthropic. تستخدم واجهة برمجة التطبيقات في https://api.claudecodeproxyapi.com/v1 تنسيق Chat Completions من OpenAI، مع معرف النموذج uncensored. الاثنان متقاربان في الروح لكنهما ليسا قابلين للتبديل، لذا لا يمكنك لصق عنوان URL الخاص بنا مباشرة في Claude Code. يجب أن تعيد طبقة الترجمة كتابة كل طلب وكل استجابة، بما في ذلك أجزاء البث المتدفق ومكالمات الأدوات.
ما الذي يجلس أين
| الجزء | يتحدث | الوظيفة |
|---|---|---|
| واجهة سطر الأوامر (CLI) الخاصة بـ Claude Code | تنسيق Anthropic Messages | يخطط للتعديلات، يستدعي الأدوات، يعرض الـ diff |
| وكيل الترجمة (محلي) | كلا التنسيقين | يحوّل الطلبات والتدفقات، يربط أسماء النماذج |
| هذه واجهة برمجة التطبيقات (API) | OpenAI Chat Completions | يشغل نموذج الأوزان المفتوحة، ويحسب التكلفة لكل رمز |
تتعامل مشاريع المجتمع مع الجزء الأوسط. وكيل LiteLLM و claude-code-router هما اثنان موثقان علنًا لهذا الغرض. كلاهما برامج تابعة لجهة خارجية، لذا تحقق من وثائقهم الحالية للإصدارات والخيارات (flags) المدعومة قبل البناء عليها. إذا فشل شيء ما في الطريق، فإن دليل استكشاف أخطاء الوكيل وإصلاحها هو المكان الذي يجب أن تبدأ منه، كما يحتوي هذا الموقع أيضًا على مقال إعداد خطوة بخطوة منفصل.
قبل أن تضبطه: كن صادقاً بشأن النموذج
تم بناء Claude Code حول نماذج Anthropic الخاصة. استبدال نموذج مختلف يغير السلوك، ولا يمكن لأي وكيل إخفاء ذلك. النموذج هنا هو نموذج مفتوح الأوزان تشغله جهة مستقلة ومضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس Claude، وليس واجهة برمجة تطبيقات (API) رسمية من Anthropic أو أي بائع آخر.
ما يقدمه لك فعليًا للعمل على نمط الوكلاء:
- مكالمات الأدوات مع
tools، وtool_choiceوtool_callsالمتدفقة، مع إرجاع النتائج كرسائلrole: "tool". - نافذة سياق بحجم 100,000 رمز، للموجّه والإكمال معاً.
- وضع JSON مع
response_format، والبث المتدفق عبر SSE.
ما يجب عليك التحقق منه بنفسك: مدى التزامه بدورة وكيل طويلة، وتكرار إنشاء استدعاءات أدوات غير صالحة، وكيفية تعامله مع لغتك وإطار العمل. قم بتشغيل ثلاث أو أربع مهام حقيقية من مستودعك قبل نقل سير عمل كامل. رصيد التجربة بقيمة $0.50، الذي يمكنك الحصول عليه بنقرة واحدة بعد التسجيل، يكفي لذلك.
اختبر الخادم الأساسي أولاً
قبل التعامل مع Claude Code، تأكد من أن جانب API يعمل مع طلب عادي، بما في ذلك استدعاء أداة، لأن الوكلاء يعتمدون على ذلك:
curl https://api.claudecodeproxyapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the files in the src folder."}],
"tools": [{
"type": "function",
"function": {
"name": "list_files",
"description": "List files in a directory",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"]
}
}
}],
"tool_choice": "auto"
}'
يحتوي الجواب الجيد على إدخال tool_calls مع list_files وسلسلة حجة JSON. إذا رأيت ذلك، فإن الخادم الأساسي جاهز وأي مشكلة لاحقة تعود إلى تكوين الوكيل أو واجهة سطر الأوامر.
مساران، ومتى تختار كل منهما
المسار 1: وكيل ترجمة لـ Claude Code
اختر هذا إذا كنت تحب واجهة Claude Code، وطلبات الأذونات الخاصة بها، وسير العمل الخاص بها، وتريد نموذجًا مختلفًا خلفها. تقوم بتشغيل الوكيل محليًا، وتوجه واجهة سطر الأوامر إليه، وتربط أسماء النماذج التي ترسلها واجهة سطر الأوامر إلى uncensored. يتم تغطية المتغيرات الدقيقة في الوثائق ومقال الإعداد.
المسار 2: عميل يدعم واجهة OpenAI
يمكن لعدة مساعدين مفتوحي المصدر لكتابة الأكواد وإضافات المحررات، بما في ذلك Aider و Continue و Cline، استخدام أي نقطة نهاية متوافقة مع OpenAI مباشرة. تدخل عنوان URL الأساسي والمفتاح واسم النموذج ولا توجد طبقة ترجمة تحتاج إلى صيانتها. إذا لم تكن بحاجة تحديداً إلى واجهة Claude Code، فهذا هو المسار الأقصر ويحتوي على أجزاء أقل قد تتعطل.
قاعدة عامة: اختر المسار 2 لتجربة سريعة للنموذج على الكود، والمسار 1 عندما يعتمد فريقك بالفعل على سير عمل Claude Code.
تكلفة جلسة كتابة الأكواد
يعيد الوكلاء إرسال الكثير من السياق، لذا فإن رموز الإدخال تهيمن على الفاتورة. خذ جلسة من 30 طلبًا، كل منها يحتوي على 20,000 رمز من الإدخال (ملفات، سجل، مخرجات أداة) و800 رمز من الإخراج:
- المدخلات: 30 × 20,000 = 600,000 رمز، وهو ما يعادل 0.6 × $0.15 = $0.09
- المخرجات: 30 × 800 = 24,000 رمز، وهو ما يعادل 0.024 × $0.50 = $0.012
- المجموع: $0.102
الأسعار هي $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. الفوترة من رصيد مسبق الدفع بدون اشتراك، الطلبات الفاشلة أو المرفوضة لا تُحسب، والرصيد لا ينتهي. الشحنات تبدأ من $20 إلى $500 مع مكافآت +5% من $50، +10% من $100 و+15% من $200. يقبل هذا الموقع الشحنات بالعملات المشفرة فقط (USDT على TRC20، USDC على Base). تحتوي صفحة الأسعار على الجدول الكامل، وصفحة المفاتيح هي المكان الذي يمكنك فيه التسجيل باستخدام Google أو البريد الإلكتروني.
الحدود التي تؤثر على دورات الوكلاء
يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 طلب في الدقيقة. قد تصل الوكلاء التي توزع المهام الفرعية إلى حد التوازي أولاً. تجيب واجهة برمجة التطبيقات بعد ذلك بـ HTTP 429 مع الكود concurrency، بينما يعيد حد معدل الطلبات rate_limited. يؤدي الحمل الزائد المؤقت أيضًا إلى إرجاع 429، مع Retry-After: 5. يحاول الوكيل الجيد إعادة المحاولة على 429 بعد التأخير، ويحتفظ الطلب المتدفق بمكانه حتى ينتهي البث، لذا فإن البث العالق يُحتسب ضمن حدودك.
يمكن أن يصل حجم جسم الطلب إلى 8 MB. ضع ذلك في الاعتبار إذا كانت أداتك تلصق ملفات كبيرة في الموجّهات، واحتفظ بالموجه بأكمله ضمن نافذة السياق التي تتكون من 100,000 رمز.
ملاحظات الأمان للوكيل المحلي
يحتفظ الوكيل بمفتاح الخادم الأساسي الخاص بك، لذا تعامل معه مثل أي بيانات اعتماد. اربطه بـ localhost، وليس بواجهات الشبكة جميعها، إلا إذا كنت بحاجة حقاً إلى وصول آلات أخرى إليه. احفظ المفتاح في متغير بيئة أو مدير أسرار بدلاً من ملف يذهب إلى التحكم في الإصدارات. إذا شاركت الوكيل مع فريق، امنحه مفتاح رئيسي خاص به حتى تتمكن من تدويره دون لمس المفتاح الأساسي.
تذكر أيضًا ما يرسله الوكيل. تقوم واجهة سطر الأوامر للبرمجة بإرسال محتويات الملفات، ومخرجات الأوامر وموجهاتك إلى النموذج. لا تُستخدم الموجهات للتدريب هنا، لكنك لا تزال بحاجة إلى إبقاء الأسرار مثل المفاتيح الخاصة وملفات .env خارج دليل العمل الذي يمكن للوكيل قراءته.
طريقة عادلة لتقييم النموذج على الأكواد الخاصة بك
اختر ثلاث مهام متزايدة الصعوبة من مستودع حقيقي: إصلاح ملف واحد، تغيير يلمس ثلاثة ملفات، وإعادة هيكلة صغيرة مع اختبارات. قم بتشغيل كل منها بنفس الموجه مرتين، مرة واحدة مع نموذجك الحالي ومرة أخرى مع uncensored، واحتفظ بملاحظات حول أربعة أشياء: هل تم تطبيق التعديلات بنجاح، هل تم تحليل مكالمات الأدوات، كم مرة كانت هناك حاجة لإعادة المحاولة، وما هي تكلفة كل تشغيل. ساعة من هذا تخبرك أكثر من أي لوحة صدارة.
إذا كان النموذج مفتوح الأوزان لا يفي بالمهام الأصعب، فقد لا تزال تجده مناسبًا للمهام الأقل تعقيدًا مثل كتابة الاختبارات أو رسائل commit أو شرح الأكواد غير المألوفة. نظرًا لأن الفوترة تعتمد على الدفع حسب الاستخدام من رصيد مسبق الدفع دون اشتراك، فلا توجد عقوبة لاستخدامه لتلك المهام فقط.
