الرئيسية / الأدلة / استخدام OpenCode مع واجهة LLM مجانية

استخدام 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.
ملاحظة عن إصدارات الإعداد: تصف وثائق OpenCode الآن صيغة إعداد V2 بمفتاح providers. وتقول الوثائق إن صيغة V1 أعلاه ما زالت مدعومة. يكتب أمر إعداد FreeLLMAPI صيغة V1.

اختر نماذج لـ OpenCode

OpenCode وكيل. يقرأ الملفات ويعدّلها ويشغّل الأوامر عبر استدعاءات الأدوات. يحمل كل طلب موجّه نظام وتعريفات أدوات ومحتويات ملفات. استخدم نماذج تدعم استدعاء الأدوات ونافذة سياق كبيرة.

نماذج مجانية لـ OpenCode: استدعاء أدوات وسياق 128K فأكثر
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
GLM 5.3UnoRouter1M1 طلب/دقيقة
1 req/min per model
نعملا
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 طلب/دقيقة
40 RPM
نعمنعم
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaنعمنعم
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceنعملا
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditنعمنعم
Gemini 3.7 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditنعمنعم
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 طلب/دقيقة
50 طلب/يوم
50 req/day account-wide (1,000 after a $10 purchase)
نعمنعم
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 طلب/دقيقة
50 طلب/يوم
Shared rate limit
نعملا
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 طلب/دقيقة
250 طلب/يوم
70,000 رمز/دقيقة
~6M
نعمنعم
Gemini 3.6 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Qwen 3.8 27BCloudflare Workers AI262KShared 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 محاولة"بلغ كل مفتاح حدهأضف مفاتيح من مزودين أكثر، أو انتظر فترات التبريد
استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

الأسئلة الشائعة

هل يمكنني استخدام 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 المفتاح هناك، فيجده كل من الواجهة الطرفية وتطبيق سطح المكتب.

أدلة ذات صلة

المصادر

كل الأدلة · تصفح كل النماذج المجانية