استخدام OpenCode مع واجهة LLM مجانية
OpenCode وكيل برمجة مفتوح المصدر يعمل في الطرفية وعلى سطح المكتب. يقبل أي مزود متوافق مع OpenAI. يربط هذا الدليل OpenCode بنماذج مجانية عبر FreeLLMAPI. يكتب أمر واحد الإعداد ويحفظ المفتاح.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
الخطوة 1: ثبّت FreeLLMAPI
FreeLLMAPI بوابة مفتوحة المصدر. تعمل على حاسوبك في Docker، وتجمع الطبقات المجانية لـ 45 مزودًا خلف مفتاح واحد.
التثبيت على macOS أو Linux
curl -fsSL https://freellmapi.co/install.sh | bashافتح http://localhost:3001. أضف مفتاحين مجانيين على الأقل من المزودين في صفحة Keys. تمنحك Google AI Studio وGroq كل منهما مفتاحًا مجانيًا خلال دقائق. انسخ المفتاح الموحد من الصفحة نفسها.
الخطوة 2: اربط OpenCode بأمر واحد
أمر واحد
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeيفعل الأمر ثلاثة أشياء:
- يضيف مزود
freellmapiإلى~/.config/opencode/opencode.json. يسرد المزود النماذج من الكتالوج الحي مع حدود السياق الخاصة بها. - يضبط
freellmapi/autoكنموذج افتراضي. - يحفظ المفتاح في ملف بيانات الاعتماد الخاص بـ OpenCode، وهو
~/.local/share/opencode/auth.json. لا تحتاج إلى متغير بيئة، لا في الواجهة الطرفية ولا في تطبيق سطح المكتب.
ينشئ الأمر نسخة احتياطية قبل الكتابة. يدمج المزود الجديد، فتبقى مزوداتك الأخرى كما هي. إذا كان XDG_CONFIG_HOME أو XDG_DATA_HOME مضبوطًا، يستخدم الأمر هذين المجلدين.
قبل أن تبدأ مهمة طويلة، تأكد من أن البوابة تستطيع خدمة طلب الآن. يسرد هذا الاستدعاء النماذج التي لديها مفتاح صالح للاستخدام في هذه اللحظة فقط:
تحقق من النماذج الجاهزة
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"يعني النموذج بالحالة exhausted أن لديه مفاتيح، لكن كلها بلغت حدها الآن. تزول هذه الحالة عندما تنتهي فترات التبريد. شغّل npx freellmapi doctor للتأكد من وصول طلبات العميل إلى البوابة. يعرض سجل الطلبات في لوحة التحكم كل استدعاء من OpenCode. تسمّي ترويسة الاستجابة X-Routed-Via المزود والنموذج اللذين أجابا عن كل طلب. إذا حوّل الطلب إلى مزود آخر، تسمّي ترويسة X-Fallback-Trail كل محاولة فاشلة والسبب.
الإعداد اليدوي: كتلة المزود في opencode.json
للإعداد يدويًا، أضف هذه الكتلة إلى ~/.config/opencode/opencode.json، أو إلى opencode.json في مشروعك. يستخدم OpenCode الحزمة @ai-sdk/openai-compatible لنقاط النهاية /v1/chat/completions.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}ثم أضف المفتاح. شغّل OpenCode، ونفّذ /connect، واختر المزود freellmapi، وألصق المفتاح الموحد. يجب أن يطابق معرّف المزود في /connect المعرّف في الإعداد. نفّذ /models لاختيار نموذج.
limit.contextهو أقصى عدد من رموز الإدخال للنموذج.limit.outputهو أقصى عدد من الرموز يمكنه توليدها.- يستخدم الحقل
modelفي المستوى الأعلى الصيغةprovider/model. بدونه، يبقي OpenCode النموذج الذي استخدمه سابقًا. - يجب أن يكون كل معرّف نموذج تريد استخدامه موجودًا في الخريطة
models. أضف معرّفات أخرى منGET /v1/models.
providers. وتقول الوثائق إن صيغة V1 أعلاه ما زالت مدعومة. يكتب أمر إعداد FreeLLMAPI صيغة V1.اختر نماذج لـ OpenCode
OpenCode وكيل. يقرأ الملفات ويعدّلها ويشغّل الأوامر عبر استدعاءات الأدوات. يحمل كل طلب موجّه نظام وتعريفات أدوات ومحتويات ملفات. استخدم نماذج تدعم استدعاء الأدوات ونافذة سياق كبيرة.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| 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 | نعم | نعم |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | نعم | نعم |
يعرض 12 من أصل 109 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
استخدم freellmapi/auto لترك الموجّه يختار نموذجًا لكل طلب. أضف auto:smart أو auto:fast إلى الخريطة models لتوجيه الطلبات حسب الذكاء أو السرعة. يمكنك أيضًا إضافة ملف تعريفي مسمى، مثلًا auto:coding، بعد إنشائه في لوحة التحكم.
حدود الاستخدام والجلسات الطويلة
قد ترسل مهمة واحدة للوكيل عشرات الطلبات. تتوقف طبقة مجانية واحدة بسرعة أمام مهمة طويلة. يحسب FreeLLMAPI طلبات كل مفتاح ورموزه. عندما يرسل مزود الخطأ 429، يرسل الموجّه الطلب إلى النموذج التالي في السلسلة، وتستمر الجلسة.
- أضف مفاتيح من أربعة مزودين أو أكثر. يعطي المزودون الأكثر عددًا طلبات أكثر في اليوم.
- فعّل تسليم السياق بالأمر
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchفي ملف.envالخاص بـ FreeLLMAPI. عندما يتغير النموذج، يتلقى النموذج التالي ملاحظة قصيرة بأنه يكمل مهمة. - تُبقي الجلسات الثابتة المحادثة على نموذج واحد لمدة 30 دقيقة. يحافظ ذلك على ثبات الوكيل.
- ابدأ جلسة جديدة لكل مهمة. يستخدم السياق الأصغر رموزًا أقل في كل طلب.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| "Invalid API key" مع مفتاح صالح | قيمة apiKey فارغة في الإعداد تتجاوز المفتاح الذي أضفته عبر /connect | احذف apiKey من options، أو شغّل setup-opencode مرة أخرى |
| لا يستخدم OpenCode المزود الجديد | لم يُضبط الحقل model في المستوى الأعلى | اضبط "model": "freellmapi/auto" |
| Model not found | معرّف النموذج غير موجود في الخريطة models للمزود | أضف المعرّف إلى الخريطة، أو شغّل setup-opencode مرة أخرى |
مفتاح {env:VAR} فارغ | يستبدل OpenCode المتغير غير المضبوط بنص فارغ | صدّر المتغير في الجلسة الطرفية نفسها، أو احفظ المفتاح بالأمر /connect |
| تفشل استدعاءات الأدوات | يدعم النموذج استدعاء الأدوات بضعف | اختر نموذجًا من الجدول أعلاه |
| "بلغت كل النماذج حد الطلبات بعد N محاولة" | بلغ كل مفتاح حده | أضف مفاتيح من مزودين أكثر، أو انتظر فترات التبريد |
الأسئلة الشائعة
هل يمكنني استخدام OpenCode مجانًا؟
نعم. OpenCode مفتوحة المصدر. اربطه بـ FreeLLMAPI كمزود متوافق مع OpenAI. ترسل البوابة كل طلب إلى الطبقات المجانية للمزودين، لذلك تكلفة الاستدلال $0.
كيف أضيف مزود OpenAI مخصصًا متوافقًا إلى OpenCode؟
أضف مزودًا في opencode.json، يكون npm فيه @ai-sdk/openai-compatible، وفيه options.baseURL وخريطة models. ثم نفّذ /connect لحفظ المفتاح و/models لاختيار نموذج.
ما أفضل نموذج مجاني لـ OpenCode؟
استخدم نموذجًا يدعم استدعاء الأدوات ويملك سياقًا بحجم 128K على الأقل. يعرض الجدول في هذه الصفحة أقوى النماذج المجانية التي تستوفي القاعدتين اليوم. استخدم freellmapi/auto ليختار الموجّه نموذجًا.
أين يحفظ OpenCode مفاتيح الواجهة البرمجية؟
تُحفظ المفاتيح التي تضيفها عبر /connect في ~/.local/share/opencode/auth.json. يكتب أمر إعداد FreeLLMAPI المفتاح هناك، فيجده كل من الواجهة الطرفية وتطبيق سطح المكتب.
أدلة ذات صلة
- استخدم Aider مع واجهة LLM مجانية
- استخدام Codex CLI مع نماذج مجانية
- كيف تستخدم Claude Code مجاناً
- أفضل واجهات نماذج البرمجة المجانية
- عناوين Base URL لواجهات OpenAI المجانية المتوافقة
المصادر
- OpenCode docs: providers (V1 config) (تم التحقق 20 November 2026)
- OpenCode docs: config (تم التحقق 20 November 2026)
- OpenCode docs: migrate from V1 (تم التحقق 20 November 2026)
- FreeLLMAPI CLI generators (تم التحقق 20 November 2026)
- FreeLLMAPI docs: context handoff (تم التحقق 20 November 2026)