getdeepseekapi.comالدليل
كيفية استخدام DeepSeek API في Claude Code: الخيارات الفعلية
إذا كنت تعمل على معرفة كيفية استخدام DeepSeek API في Claude Code، فإن أول شيء يجب معرفته هو أن Claude Code يتصل بنقاط النهاية على طراز Anthropic، بينما يتحدث هذه الخدمة بتنسيق OpenAI. وسيط ترجمة صغير يغلق الفجوة، وتوضح هذه الصفحة كيفية إعداده.
تم التحديث
نقاط رئيسية
- يتوقع Claude Code API رسائل Anthropic؛ تقدم هذه الخدمة /v1/chat/completions المتوافق مع OpenAI.
- يمكن لوسيط محلي مثل LiteLLM الترجمة بين التنسيقين.
- تقبل Aider و Continue و Cline عنوان URL الأساسي المتوافق مع OpenAI مباشرة، بدون وسيط.
- هذا ليس API الرسمي من DeepSeek: إنه نموذج واحد مفتوح الأوزان بمعرف
uncensored.

ابدأ بما سيعمل وما لن يعمل
توضيحان يوفران ساعة من الارتباك. أولاً، هذه الخدمة ليست واجهة برمجة التطبيقات (API) الرسمية لـ DeepSeek، وليست موجّهاً (router) لـ DeepSeek أو أي مورد آخر. تستضيف نموذجًا واحدًا مفتوح الأوزان، وتشغله جهة مستقلة، تحت معرف النموذج uncensored. إذا كنت بحاجة إلى نماذج DeepSeek الخاصة بها، انتقل إلى DeepSeek مباشرةً. ثانيًا، بُني Claude Code حول Messages API الخاصة بـ Anthropic. يمكنك تغيير الوجهة التي ترسل إليها الطلبات، لكن ما ترسله لا يزال بتنسيق JSON الخاص بـ Anthropic.
تكشف هذه الخدمة عن POST /v1/chat/completions و GET /v1/models بتنسيق OpenAI. لن يعمل توجيه Claude Code مباشرةً إليها، لأن المسارات (paths) والأحمال (payloads) تختلف. الحل هو طبقة ترجمة. تقوم بتشغيل وكيل وسيط (proxy) صغير على جهازك يقبل المكالمات بتنسيق Anthropic من Claude Code ويعيد توجيهها كمكالمات بتنسيق OpenAI إلى https://api.getdeepseekapi.com/v1. توجد أدوات لهذا الغرض بالضبط، والقسم التالي يهيّئ واحدة منها.
قبل أن تبدأ، تحقق من توقع واحد. يميل Claude Code بشدة إلى استدعاء الدوال (tool calling) لقراءة الملفات وتعديلها وتشغيل الأوامر. تدعم هذه الواجهة استدعاء الدوال، بما في ذلك tool_calls المتدفق (streamed)، لكن مدى جودة أي نموذج معين في قيادة حلقة وكيل طويلة هو شيء يجب اختباره على مستودعك الخاص، وليس شيئًا يجب افتراضه.
احصل على مفتاح API وتأكد من نقطة النهاية
أنشئ حسابًا باستخدام Google أو البريد الإلكتروني وكلمة المرور، ثم افتح صفحة مفتاح API. يمكن للمستخدمين الجدد الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة. يستمر لمدة 7 أيام، ولا يتطلب تفاصيل الدفع، وهو كافٍ لاختبار كل ما يلي. لاحظ أن المفتاح التجريبي يسمح بـ 2 طلب متزامن و60 طلب في الدقيقة، وهو أمر مهم لأدوات الوكلاء التي تُطلق عدة استدعاءات في وقت واحد.
export UNCENSORED_API_KEY="paste-your-key-here"
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
إذا أعاد ذلك إكمالًا (completion)، فإن الجزء الخلفي (upstream) جاهز. كل ما تبقى هو توصيل الوكيل الوسيط به.
الخيار 1: وكيل LiteLLM أمام Claude Code
يُعد LiteLLM مشروعاً مفتوح المصدر، حيث يمكن لخادم الوكيل الخاص به أن يقدم نقطة نهاية متوافقة مع Anthropic ويوجّه الطلبات إلى واجهات خلفية متوافقة مع OpenAI. تحقق من مستنداته لمعرفة مجموعة الميزات الحالية، لأن هذا الجزء من النظام البيئي يتطور بسرعة.
التثبيت والتكوين
pip install 'litellm[proxy]'
cat > litellm-config.yaml <<'EOF'
model_list:
- model_name: uncensored
litellm_params:
model: openai/uncensored
api_base: https://api.getdeepseekapi.com/v1
api_key: os.environ/UNCENSORED_API_KEY
EOF
litellm --config litellm-config.yaml --port 4000
تخبر البادئة openai/ LiteLLM باستخدام المحوّل المتوافق مع OpenAI؛ ويُرسَل الاسم الذي يليها إلى الخادم البعيد كاسم النموذج. اترك الطرفية قيد التشغيل.
وجّه Claude Code نحو الوكيل الوسيط
يقرأ Claude Code نقطة النهاية ومعلومات الاعتماد من متغيرات البيئة. في طرفية ثانية:
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude
رمز المصادقة هنا هو فقط ما يتوقعه الوكيل الوسيط المحلي؛ المفتاح الحقيقي يبقى في بيئة الوكيل الوسيط. ضبط النموذج الصغير والسريع أيضًا مهم، لأن Claude Code يستخدم نموذجًا ثانيًا للمهام الخلفية الخفيفة. إذا تركته غير مضبوط، فقد يحاول استدعاء اسم نموذج Anthropic الذي لا يعرفه الوكيل الوسيط. يمكن للإصدارات الأحدث تسمية هذا الإعداد بشكل مختلف، لذا قم بتشغيل claude --help أو اقرأ مستندات إعدادات Claude Code الحالية إذا بدا أن متغيرًا يتم تجاهله.
الخيار 2: أدوات تأخذ عنوان URL الأساسي لـ OpenAI مباشرة
إذا كان هدفك هو مساعد برمجة بالذكاء الاصطناعي بدلاً من Claude Code نفسه، فإن عدة أدوات تتخطى الوكيل الوسيط لأنها تتحدث بالفعل بتنسيق OpenAI. يتيح لك كل منها تعيين عنوان URL أساسي مخصص واسم النموذج.
- Aider هو مبرمج زوجي في الطرفية. يقرأ
OPENAI_API_BASEوOPENAI_API_KEY، وتضع بادئة النموذج بـopenai/. - Continue هو ملحق محرر حيث يمكن أن يحمل إدخال النموذج
apiBaseوموفرًا على طراز OpenAI. - يوفر Cline موفرًا متوافقًا مع OpenAI في إعداداته مع حقول لعنوان URL الأساسي والمفتاح ومعرف النموذج.
مع Aider، الإعداد الكامل يتكون من ثلاثة أسطر:
export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored
تغير هذه القوائم الخاصة بها غالبًا، لذا تعامل مع أسماء الحقول المذكورة أعلاه كدليل واتبع مستندات كل مشروع الحالية. القيم التي تحتاجها لا تتغير أبدًا: عنوان URL الأساسي https://api.getdeepseekapi.com/v1، مفتاحك، ومعرف النموذج uncensored.
اكتب حلقة وكيل خفيفة بنفسك
عندما يكون مساعد البرمجة الكامل مبالغة، يكفي نص برمجي قصير مع استدعاء الدوال لتغطية مساحة كبيرة. يتيح هذا النص البرمجي للنموذج طلب قراءة ملف، ثم يعيد إرسال محتوى الملف كرسالة role: "tool".
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a text file from the project",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "What does main.py do? Read it first."}]
for _ in range(5):
r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = r.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"]) as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
يمنع حدّ التكرار البالغ خمس مرات النموذج المُربَك من العمل إلى الأبد. في الأداة الحقيقية، يجب أيضاً التحقق من المسارات حتى لا يتمكن النموذج من قراءة ملفات خارج المشروع.
حدود المعدل، التكلفة وإصلاح أخطاء 429
أدوات الوكلاء كثيفة الطلبات. قد تُطلق مهمة واحدة عشرات الطلبات، حيث يعيد كل منها إرسال سياق متزايد. مع المفتاح الكامل، تحصل على 8 طلبات متزامنة و300 طلب في الدقيقة. يشير رمز 429 مع concurrency إلى تداخل عدد كبير من الاستدعاءات، ويشير رمز 429 مع rate_limited إلى تجاوز الحد الأقصى للطلبات في الدقيقة. أثناء الحمل الزائد المؤقت، سترى رمز 429 مع Retry-After: 5. يمكن لـ LiteLLM إعادة المحاولة تلقائياً إذا أضفت إعداد إعادة المحاولة؛ تحقق من مستنداته.
التكلفة متواضعة لأن التسعير هو $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. لنفترض أن جلسة وكيل تُجري 40 استدعاءً ترسل كل منها 30,000 رمز سياق وتسترد 600 رمز. المدخلات هي 1,200,000 رمز، وتكلف 1.2 x $0.15 = $0.18. المخرجات هي 24,000 رمز، وتكلف 0.024 x $0.50 = $0.012. تبلغ التكلفة الإجمالية للجلسة $0.192. نافذة السياق هي 100,000 رمز، لذا اجعل الملفات التي تحملها مركزة.
عند انتهاء رصيد التجربة، قم بشحن الرصيد بمبلغ صحيح من $20 إلى $500 عبر العملات المشفرة (USDT على TRC20، USDC على Base). المكافآت هي +5% من $50، و+10% من $100، و+15% من $200. راجع صفحة التسعير والوثائق للتفاصيل.
استكشاف أخطاء إعداد الوكيل الوسيط
| العرض | السبب | ما يجب تجربته |
|---|---|---|
| يبلغ Claude Code عن نموذج غير معروف | اسم النموذج الخلفي غير مُعين | قم بتعيين متغير النموذج السريع الصغير إلى uncensored أيضاً |
| رفض الاتصال | الوكيل الوسيط لا يعمل أو يختلف المنفذ | ابدأ تشغيل LiteLLM وطابق المنفذ في ANTHROPIC_BASE_URL |
| خطأ 401 من الخادم البعيد | مفتاح خاطئ في بيئة الوكيل الوسيط | أعد تصدير UNCENSORED_API_KEY وأعد تشغيل الوكيل الوسيط |
| فشل استدعاءات الأدوات أو حدوث حلقة | يعاني النموذج من تنسيق الوكيل | خفض درجة الحرارة، أو قصر الموجّه، أو استخدم Aider بدلاً من ذلك |
| أخطاء 429 متكررة | حدّ الطلبات المتزامنة لمفتاح الرصيد التجريبي هو 2 | قم بشحن الرصيد للحصول على مفتاح كامل بـ 8 فتحات متزامنة |
هناك عادتان تحافظان على أمان الإعداد. شغّل الوكيل على localhost فقط، حتى لا يتمكن أي شخص آخر على شبكتك من إنفاق رصيدك، واحتفظ بالمفتاح الحقيقي في متغيرات البيئة الخاصة بالوكيل بدلاً من ملف المشروع الذي ينتهي به المطاف في نظام التحكم بالإصدارات. أيضاً، راقب رأس الاستجابة X-Balance-USD أثناء جلسة طويلة أولى، لأن حلقات الوكلاء قد تستهلك رموزاً أكثر مما تتوقع. إذا انخفض الرصيد أسرع من التقدير أعلاه، فقم بتقليل حجم الملفات التي تقدمها أو حدد عدد الخطوات.
الطلبات التي تفشل لا تُحسب تكلفتها، لذا فإن التجريب رخيص. لا تُستخدم الموجّهات في التدريب. للمقارنة مع البوابات الأخرى، اقرأ نظرتنا العامة على مفاتيح API.
المزيد من الأدلة
أسئلة وأجوبة
هل يمكن لـ Claude Code الاتصال مباشرة بهذا الـ API؟
لا. يستخدم Claude Code تنسيق رسائل Anthropic، بينما يستخدم هذا الـ API تنسيق إكمال المحادثات الخاص بـ OpenAI. ضع وسيط ترجمة مثل LiteLLM بينهما.
هل هذه هي واجهة برمجة التطبيقات الرسمية لـ DeepSeek؟
لا. يستضيف نموذجًا مفتوح الأوزان مستقلًا واحدًا تحت المعرف uncensored، وليس له علاقة بـ DeepSeek أو أي مورد آخر.
أي الأدوات تعمل بدون وسيط؟
الأدوات التي تحتوي على إعداد مزود متوافق مع OpenAI، مثل Aider و Continue و Cline. اضبط عنوان URL الأساسي والمفتاح ومعرف النموذج uncensored.
هل يعمل استدعاء الدوال؟
نعم، بما في ذلك استدعاء الدوال المتدفق (streamed tool_calls) والنتائج المرسلة كرسائل role tool. اختبر سير عمل الوكيل الخاص بك لترى كيف يتعامل النموذج مع ذلك.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذه هي الإعدادات الكاملة.