استخدم نماذج ذكاء اصطناعي مجانية في Zed
Zed محرر شيفرة مفتوح المصدر فيه لوحة وكيل. يستطيع استخدام مزوّد متوافق مع OpenAI أو خادم Ollama. يوضح هذا الدليل كيف تربط Zed بنماذج مجانية عبر FreeLLMAPI بإحدى الطريقتين. يغطي قسم قصير في النهاية مساعد JetBrains AI.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
طريقتان لربط Zed
| الطريقة | إعداد Zed | نقطة نهاية FreeLLMAPI | المفتاح |
|---|---|---|---|
| مزوّد متوافق مع OpenAI (موصى به) | language_models.openai_compatible | http://localhost:3001/v1 | المفتاح الموحّد، في واجهة إعدادات Zed أو متغير بيئة |
| مزوّد Ollama | language_models.ollama | http://localhost:3001 (محاكاة Ollama) | لا شيء على loopback، أو المفتاح الموحّد |
تستخدم الطريقتان الموجّه نفسه ومجموعة النماذج المجانية نفسها. لا تحتاج الطريقة المتوافقة مع OpenAI إلى أي تغيير في جهة FreeLLMAPI. تحتاج طريقة Ollama إلى محاكاة Ollama، وهي متوقفة افتراضياً.
ثبّت FreeLLMAPI أولاً. افتح http://localhost:3001، وأضف مفتاحين مجانيين من مزوّدين على الأقل في صفحة Keys، ثم انسخ المفتاح الموحّد.
التثبيت على macOS أو Linux
curl -fsSL https://freellmapi.co/install.sh | bashالطريقة 1: مزوّد متوافق مع OpenAI
افتح ملف settings.json في Zed وأضف هذه الكتلة. معرّف المزوّد هو freellmapi. تمثل max_tokens نافذة السياق للنموذج.
Zed settings.json
{
"language_models": {
"openai_compatible": {
"freellmapi": {
"api_url": "http://localhost:3001/v1",
"available_models": [
{
"name": "auto",
"display_name": "FreeLLMAPI Auto",
"max_tokens": 128000,
"max_output_tokens": 8192,
"capabilities": {
"tools": true,
"images": false,
"parallel_tool_calls": false,
"prompt_cache_key": false,
"chat_completions": true
}
}
]
}
}
}
}لا تضع المفتاح في settings.json. استخدم إحدى هاتين الطريقتين:
- شغّل
agent: open settingsمن لوحة الأوامر. انتقل إلى مزوّدي LLM، وابحث عن المزوّد وأدخل المفتاح. يحفظ Zed المفتاح في سلسلة مفاتيح النظام. - اضبط متغير بيئة. يصنع Zed الاسم من معرّف المزوّد بحروف كبيرة وفواصل سفلية، ثم يضيف
_API_KEY. للمعرّفfreellmapi، يكون الاسمFREELLMAPI_API_KEY. يتقدم المتغير على سلسلة المفاتيح.
المفتاح كمتغير بيئة
export FREELLMAPI_API_KEY=<unified-key>
zedأضف مدخلاً واحداً في available_models لكل نموذج تريده في قائمة النماذج. الأسماء auto:smart وauto:fast صالحة أيضاً.
الطريقة 2: محاكاة Ollama
تستطيع FreeLLMAPI أن تعمل كخادم Ollama. وهي تخدم المسارات /api/tags و/api/chat و/api/generate و/api/show و/api/version و/api/embed. يستخدم البث JSON مفصول بأسطر جديدة، كما يفعل Ollama.
- في لوحة تحكم FreeLLMAPI، افتح Keys, Agents.
- اضبط محاكاة Ollama على
open-loopbackأوkey-required. - أضف الكتلة أدناه إلى
settings.jsonفي Zed. - افتح لوحة الوكيل واختر نموذجاً.
Zed settings.json
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}- لا يحتاج
open-loopbackإلى مفتاح، لكن فقط للطلبات القادمة من هذا الحاسوب. - إذا كانت FreeLLMAPI تعمل في Docker، فإن
open-loopbackيرفض الطلبات الواردة عبر منفذ منشور. استخدمkey-requiredواضبطOLLAMA_API_KEYعلى المفتاح الموحّد، أو أدخله في واجهة المزوّد. - يرسل Zed حجم السياق باسم
num_ctx. القيمة الافتراضية 4096 رمزاً، وهي صغيرة جداً لعمل الوكيل. اضبطcontext_window.
اختر النماذج للوحة الوكيل
تذكر وثائق Zed أن كل نموذج ومزوّد يجب أن يدعم استدعاء الأدوات. يعرض النموذج الذي لا يدعم الأدوات الوسم "No tools" في لوحة الوكيل. استخدم نماذج تدعم استدعاء الأدوات ولديها نافذة سياق كبيرة.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 طلب/دقيقة 1 req/min per model | نعم | لا |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 طلب/دقيقة 40 RPM | نعم | نعم |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | نعم | نعم |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | نعم | لا |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 طلب/دقيقة 50 طلب/يوم 50 req/day account-wide (1,000 after a $10 purchase) | نعم | نعم |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 طلب/دقيقة 50 طلب/يوم Shared rate limit | نعم | لا |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 طلب/دقيقة 250 طلب/يوم 70,000 رمز/دقيقة ~6M | نعم | نعم |
يعرض 10 من أصل 109 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
للمستويات المجانية حدود في الدقيقة وفي اليوم. عندما يرسل مزوّد الخطأ 429، تجرب FreeLLMAPI النموذج التالي في سلسلتك. أضف مفاتيح من أربعة مزوّدين أو أكثر لجلسات الوكيل الطويلة.
/v1/completions. تخدم FreeLLMAPI الاثنين. لا تعرض وثائق توقعات التعديل في Zed حقل مفتاح API لهذين المزوّدين. لم نتحقق من هذا الاقتران مع FreeLLMAPI، لذلك اختبره قبل أن تعتمد عليه.مساعد JetBrains AI
يستطيع مساعد JetBrains AI استخدام مزوّد متوافق مع OpenAI أو خادم Ollama محلي. افتح Settings, Tools, AI Assistant, Providers & API keys. يوجد خياران:
- مفتاحك الخاص، متوافق مع OpenAI: أدخل العنوان الأساسي
http://localhost:3001/v1والمفتاح الموحّد ومعرّف نموذج مثلauto. تذكر وثائق JetBrains أن BYOK يعمل مع الوكلاء دون اشتراك في JetBrains AI. - Ollama: في Third-party AI providers، اختر Ollama. أدخل
http://localhost:3001في حقل العنوان وانقر على Test Connection. ثم عيّن النماذج في Models Assignment. فعّل محاكاة Ollama في FreeLLMAPI أولاً.
تذكر وثائق JetBrains حدوداً للنماذج المحلية: لا يستطيع الوكلاء استخدامها، ولا يستطيع مساعد AI استدعاء أدوات MCP معها. يستخدم الإكمال المضمّن واقتراحات التعديل التالي نماذج JetBrains افتراضياً. لعمل الوكيل، استخدم خيار BYOK.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
401 "Invalid API key" | ليس لدى Zed مفتاح للمزوّد، أو المفتاح خاطئ | اضبط FREELLMAPI_API_KEY، أو أدخل المفتاح في إعدادات الوكيل |
| الوسم "No tools" على النموذج | الأدوات متوقفة للنموذج، أو النموذج لا يدعم استدعاء الأدوات | اضبط "tools": true واستخدم نموذجاً من الجدول |
| مزوّد Ollama لا يعرض أي نماذج | محاكاة Ollama متوقفة في FreeLLMAPI | فعّلها في Keys, Agents |
| طلبات Ollama مرفوضة من Docker | open-loopback يقبل فقط الطلبات من loopback | استخدم key-required مع المفتاح الموحّد |
| المطالبات الطويلة تفقد السياق | قيمة num_ctx هي 4096 رمزاً | اضبط context_window في إعدادات Ollama |
| رسالة الخطأ: "All models rate-limited after N attempts" | بلغت كل المفاتيح حدّها | أضف مفاتيح من مزوّدين آخرين، أو انتظر فترات التهدئة |
الأسئلة الشائعة
هل أستطيع استخدام LLM مخصص في Zed؟
نعم. أضف مزوّداً من النوع openai_compatible مع api_url وavailable_models إلى language_models في settings.json. يدعم Zed أيضاً مزوّد Ollama مع api_url مخصص.
كيف أستخدم نماذج ذكاء اصطناعي مجانية في Zed؟
وجّه مزوّداً متوافقاً مع OpenAI إلى FreeLLMAPI على http://localhost:3001/v1. ترسل البوابة كل طلب إلى المستويات المجانية للمزوّدين، لذلك تكلفة الاستدلال $0.
أين يحفظ Zed مفتاح API للمزوّد المخصص؟
يحفظ Zed المفتاح الذي تدخله في إعدادات الوكيل في سلسلة مفاتيح النظام. ويمكنك أيضاً ضبط متغير بيئة يُسمّى حسب معرّف المزوّد، مثل FREELLMAPI_API_KEY.
هل يعمل مساعد JetBrains AI مع النماذج المجانية؟
نعم. استخدم مفتاحك الخاص مع عنوان أساسي متوافق مع OpenAI، أو مزوّد Ollama. تذكر وثائق JetBrains أن الوكلاء لا يستطيعون استخدام النماذج المحلية، لذلك استخدم BYOK لعمل الوكيل.
أدلة ذات صلة
- نماذج ذكاء اصطناعي مجانية في VS Code
- Continue مع واجهة LLM مجانية
- Cline وRoo Code وKilo Code مع واجهة مجانية
- أفضل واجهات نماذج البرمجة المجانية
- عناوين Base URL لواجهات OpenAI المجانية المتوافقة
المصادر
- Zed docs: use API access (OpenAI-compatible providers) (تم التحقق 20 November 2026)
- Zed docs: use a local model (Ollama) (تم التحقق 20 November 2026)
- Zed docs: agent panel (تم التحقق 20 November 2026)
- Zed docs: edit prediction (تم التحقق 20 November 2026)
- JetBrains AI Assistant: use custom models (تم التحقق 20 November 2026)
- JetBrains AI Assistant: bring your own key (تم التحقق 20 November 2026)
- FreeLLMAPI docs: Ollama clients (تم التحقق 20 November 2026)