انتقل إلى المحتوى الرئيسي

تثبيت OpenCode واستخدامه

OpenCode هو أداة ترميز تعمل بالذكاء الوكالاتي. الأداة متاحة كتطبيق طرفي، وتطبيق سطح مكتب، وامتداد IDE.

توصي AI-School باستخدام OpenCode بشكل رئيسي للمعلمين والمسؤولين والطلاب ذوي الخبرة البرمجية الكبيرة. يمكن لـ OpenCode العمل بشكل أكثر استقلالية من Aider وبالتالي يمكنه تنفيذ العديد من التغييرات بسرعة أكبر.

مزيد من المعلومات موجودة على موقع OpenCode الإلكتروني OpenCode-website وفي الوثائق الرسمية لـ OpenCode.

متى تختار OpenCode؟​

اختر OpenCode عندما يكون المستخدم:

  • لديه خبرة في الطرفية، ومحررات الشفرة وGit
  • يفهم كيفية تعديل الملفات محليًا
  • يمكنه فحص التغييرات قبل استخدامها
  • يرغب في معالجة مهام برمجة أكثر تعقيدًا

للتعلم الجماعي البرمجي مع المبتدئين، غالبًا ما تكون Aider أنسب.

التثبيت​

أسهل طريقة تثبيت وفقًا لـ وثائق OpenCode هي:

curl -fsSL https://opencode.ai/install | bash

يمكنك أيضًا تثبيت OpenCode باستخدام Node.js:

npm install -g opencode-ai

أو باستخدام Homebrew على macOS وLinux:

brew install anomalyco/tap/opencode

الاتصال بـ Coderen​

يدعم OpenCode مزودين مخصصين متوافقين مع OpenAI providers. أنشئ ملفًا باسم opencode.json في مجلد المشروع.

استخدم فيه نقطة نهاية Coderen والنماذج المسموحة:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

ثم ضع مفتاح API كمتغير بيئي.

يمكنك أيضًا استخدام ملف .env في مجلد المشروع لذلك:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

تحقق بعد فتح نافذة طرفية جديدة مما إذا كان OpenCode يستطيع قراءة هذا المتغير. إذا لم يرسل OpenCode مفتاحًا، ستظهر لك AI-School رسالة خطأ مفادها أن رأس Authorization مع Bearer token مطلوب.

macOS وLinux​

export AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.jouw-api-sleutel"

ثم افتح نافذة طرفية جديدة.

بدء OpenCode​

انتقل إلى مجلد المشروع:

cd pad/naar/je/project

ابدأ OpenCode:

opencode

استخدم اختيار النموذج في OpenCode لاختيار نموذج AI-School Coderen إذا لم يتم اختياره تلقائيًا بعد.

حل المشاكل​

مطلوبAuthorization header مع Bearer token​

عادةً ما يعني هذا الخطأ أن OpenCode لا يرسل مفتاح API. تحقق من:

  • أن AI_SCHOOL_CODEREN_API_KEY يسمى بالضبط هكذا
  • أن القيمة تبدأ بـ ais.
  • أنك فتحت نافذة طرفية جديدة بعد setx
  • أن ملف .env موجود في مجلد المشروع حيث تبدأ OpenCode

Unknown parameter​

بعض الأدوات ترسل معطيات إضافية خاصة بمزوّدين محددين. إذا ظهرت لديك رسالة مثل Unknown parameter، فاحذف هذا الإعداد من تكوين OpenCode أو استخدم تكوين مزود أبسط. نقطة نهاية Coderen تتوقع طلبات دردشة متوافقة مع OpenAI مع النموذج والرسائل والإعدادات الأساسية المعتادة.

العمل الآمن مع OpenCode​

نظرًا لأن OpenCode يعمل بشكل وكيل، من المهم فحص التغييرات.

طريقة العمل الموصى بها:

  1. اعمل في مستودع Git.
  2. ابدأ بمهام صغيرة.
  3. افحص الفروقات قبل استخدام الكود.
  4. اختبر التطبيق بعد التغييرات.
  5. التزم بالتغييرات التي تفهمها فقط.

بالنسبة للطلاب ذوي الخبرة المنخفضة، من الحكمة استخدام OpenCode بشكل توضيحي أولاً وتحت إشراف مدرس.