الرئيسيةالوثائق
وكيل Claude Code: قم بتغيير العميل الخاص بك في ثلاثة أسطر
قم بتوصيل عميلك الحالي بوكيل LLM غير خاضع للرقابة عن طريق تحديث عنوان URL الأساسي ومفتاح API. لا يلزم تغيير الكود لعمليات إكمال الدردشة القياسية، أو البث المتدفق، أو استدعاء الدوال.
- عنوان URL الأساسي
- https://api.claudecodeproxyapi.com/v1
- النموذج
- بدون رقابة
المتطلبات المسبقة: تثبيت المكتبات
قبل إرسال الطلبات، تأكد من توفر الأدوات اللازمة في بيئة العمل. للاختبار عبر سطر الأوامر، تحتاج إلى curl. لمشاريع Python، قم بتثبيت SDK الرسمي لـ OpenAI عبر pip install openai. لـ Node.js، قم بتشغيل npm install openai. تتعامل هذه المكتبات مع البروتوكول المتوافق مع OpenAI تلقائيًا، مما يتيح لك تغيير نقطة النهاية دون تغيير منطق التطبيق.
تكوين عنوان URL الأساسي والمفتاح
وجّه عميلك إلى نقطة النهاية الخاصة proxy Claude Code. استبدل URL الأساسي القياسي لـ OpenAI بمضيفنا وقم بتزويد مفتاح API الفريد الخاص بك. يؤدي هذا التغيير في التكوين الوحيد إلى توجيه جميع حركة المرور إلى خادم النموذج غير الخاضع للرقابة مع الحفاظ على التوافق الكامل مع طرق SDK القياسية.
curl https://api.claudecodeproxyapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'اضبط BASE_URL على https://api.claudecodeproxyapi.com/v1 ومرر مفتاحك في رأس Authorization. يعمل هذا الإعداد مع أي عميل يدعم نقاط النهاية المتوافقة مع OpenAI.
الاختبار مع إكمال الدردشة
تحقق من الاتصال بطلب نصي بسيط. أرسل طلب POST إلى /v1/chat/completions بمعرف النموذج uncensored. يؤكد هذا أن مفتاحك صالح وأن الوكيل يوجه الطلبات بشكل صحيح. سيحتوي الرد على إجابة النموذج المباشرة بدون فلاتر المحتوى القياسية للمحتوى البالغ القانوني.
from openai import OpenAI
client = OpenAI(base_url="https://api.claudecodeproxyapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)استخدم عميل Python openai لإرسال رسالة. يعكس الكود الاستخدام القياسي لـ OpenAI، مما يضمن انعدام الاحتكاك عند التبديل من مزودين آخرين.
تمكين استجابات البث المتدفق
لتقليل زمن الاستجابة وعرض الرموز في الوقت الفعلي، فعّل البث المتدفق. اضبط stream=True في تكوين العميل. تُعيد الواجهة البرمجية أحداث الإرسال من الخادم (SSE) عند توليد الرموز. هذا مثالي لواجهات سطر الأوامر أو التطبيقات التي يحسّن فيها التغذية الراجعة الفورية تجربة المستخدم.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.claudecodeproxyapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);قم بتنفيذ البث المتدفق في Node.js من خلال التكرار عبر المولد غير المتزامن. يتعامل هذا النهج مع الاستجابات الجزئية بكفاءة، مما يبقي واجهة المستخدم مستجيبة حتى للإطالات الطويلة.
استخدام دوال استدعاء الأدوات
يدعم الوكيل استدعاء الدوال لتعزيز قدرات الوكيل. عرّف أدواتك في حمولة الطلب وسيعيد النموذج JSON منظم لتنفيذ الأدوات. تعمل هذه الميزة بسلاسة مع النموذج uncensored، مما يتيح سير عمل قوي للوكلاء دون قفل البائع.
إدارة مفتاح API والحدود
يشمل حسابك مفتاح API واحد، يمكن تجديده في أي وقت. لاحظ أن التجديد يلغي المفتاح القديم فوراً. راقب استخدامك لتجنب الانقطاعات؛ تعود الطلبات بخطأ 402 عندما يكون الرصيد غير كافٍ وخطأ 429 إذا تجاوزت 300 طلب في الدقيقة. نافذة السياق هي 100,000 رمز للموجّه بالإضافة إلى الإكمال.
البث المتدفق
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| المصادقة | Authorization: Bearer YOUR_KEY |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.claudecodeproxyapi.com/v1 |
| معرّف النموذج | uncensored |
| وضع JSON | response_format: {"type": "json_object"} |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| السعر | $0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
هل هذه خدمة رسمية من Claude أو OpenAI؟
لا، إنها خدمة مستقلة تعمل بنموذج مفتوح الأوزان بدون رقابة. هي متوافقة مع تنسيق OpenAI API لكنها لا تقدم نماذج GPT أو Claude.
ماذا يحدث إذا نفد رصيدك؟
ستعيد الطلبات اللاحقة خطأ 402 Payment Required. يمكنك شحن رصيد حسابك في أي وقت بالعملات المشفرة فقط (USDT على TRC20، USDC على Base) لاستعادة الخدمة. لا يتم قبول البطاقات.
هل يمكنني استخدامه مع واجهة سطر أوامر Claude Code؟
نعم، من خلال تكوين واجهة سطر الأوامر لاستخدام عنوان URL الأساسي ومفتاح API الخاصين بنا، يمكنك توجيه الطلبات عبر هذا الوكيل غير الخاضع للرقابة دون تعديل كود التطبيق الأساسي.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد بالكامل.