شرح OpenCode بالعربي: الإعداد مع مفتاح خبير

لتستخدم OpenCode مع خبير، ثبّت الإصدار الأول من OpenCode، وأضف مزوّدًا باسم khabeer إلى ملف opencode.json بعنوان خبير الأساسي، واحفظ مفتاح API من خبير في متغير البيئة KHABEER_API_KEY. ثم شغّل opencode في مشروعك واختر نموذجًا من خبير، فيُدفع كل طلب من رصيدك. ومع الاشتراك يتولى تطبيق 5abeer AI هذا الإعداد عنك.

ما الذي تحصل عليه#

• OpenCode كما هو، مع خبير مزوّدًا جاهزًا في قائمة النماذج.
• نماذج Claude وGPT وGemini المتاحة في OpenCode، بأقل من سعرها الرسمي.
• استخدامك وتكلفته في لوحة التحكم، لكل مفتاح.

قبل أن تبدأ#

• طرفية على macOS أو Linux أو Windows.
• مفتاح API لمزوّد النموذج الذي ستستخدمه (أنشئ مفتاحًا). الإعداد أدناه يستخدم نموذجًا من Claude، فيحتاج إلى مفتاح لنماذج Claude.

مع اشتراك: تطبيق 5abeer AI#

إذا كان لديك اشتراك في خبير يشمل OpenCode، فإن تطبيق 5abeer AI يضبطه على اشتراكك بنقرة واحدة، دون مفتاح API ودون أن تفتح أي ملف. يعمل التطبيق على Mac وWindows وLinux، والتفاصيل في ما الذي تشغّله كل باقة. أما بمفتاح API فاتبع الإعداد اليدوي أدناه.

الإعداد اليدوي#

1. 1

   ثبّت OpenCode#

   npmmacOS / LinuxHomebrew

   انسخ

   npm install -g opencode-ai

   تأكد من التثبيت بالأمر opencode --version.

2. 2

   أضف الإعداد#

   ضع هذا الإعداد في ملف opencode.json داخل مجلد مشروعك، أو في ~/.config/opencode/opencode.json ليعمل في كل مشاريعك. يقرأ OpenCode المفتاح من متغير البيئة KHABEER_API_KEY.

   opencode.jsonmacOS / LinuxWindows

   انسخ

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "khabeer": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "5abeer",
         "options": {
           "baseURL": "https://api.5abeer.ai/v1",
           "apiKey": "{env:KHABEER_API_KEY}"
         },
         "models": {
           "claude-sonnet-5.5": {
             "name": "Claude Sonnet 5.5"
           }
         }
       }
     },
     "model": "khabeer/claude-sonnet-5.5"
   }
   

   opencode.json

3. 3

   شغّله#

   Terminalانسخ

   cd your-project
   opencode

   اكتب أي طلب. إذا وصلك الرد فالإعداد يعمل.

اختر النموذج#

هذه النماذج تعمل في OpenCode الآن. أضف معرّف النموذج إلى القائمة models في ملف الإعداد، ثم اختره من داخل OpenCode بالأمر /models. تذكّر أن كل مفتاح يعمل مع نماذج المزوّد الذي أنشأته له فقط.

إذا ظهر خطأ#

• INVALID_API_KEY: المفتاح غير صحيح، أو متغير البيئة غير محفوظ في الطرفية التي شغّلت منها OpenCode.
• MODEL_PLATFORM_NOT_ALLOWED: اخترت نموذجًا من مزوّد غير مزوّد المفتاح.
• INSUFFICIENT_BALANCE: الرصيد لا يكفي لهذا الطلب.

كل الرموز ومعانيها في الأخطاء وحلولها.

أسئلة شائعة#

أي إصدار من OpenCode يشرحه هذا الدليل؟#

الإصدار الأول، المثبّت من npm باسم opencode-ai، أو بسكربت التثبيت من opencode.ai، أو من مستودع Homebrew anomalyco/tap. الإصدار الثاني يستخدم ملف إعداد مختلفًا، فلا ينطبق عليه هذا الإعداد.

لماذا لا تظهر نماذج خبير؟#

يعرض OpenCode النماذج المكتوبة في القائمة models لدى المزوّد فقط. تأكد أن ملف الإعداد في مجلد مشروعك أو في ~/.config/opencode/، ثم افتح /models من جديد.

هل أستخدم نماذج Claude وGPT معًا؟#

نعم، بمفتاح لكل مزوّد. كل مفتاح يعمل مع نماذج المزوّد الذي أنشأته له فقط، فأضف مزوّدًا ثانيًا في الإعداد بالمفتاح الآخر.

كيف يُحسب الطلب؟#

يُدفع كل طلب من رصيدك حسب التوكنات التي يستخدمها، بسعر النموذج في خبير. التفاصيل في الأسعار والرصيد.