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

تثبيت 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 ولينكس:

brew install anomalyco/tap/opencode

الاتصال بالترميز​

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

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

{
  "$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.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.6-luna",
  "small_model": "ai-school-coderen/gpt-5.6-luna"
}

ثم ضع مفتاح 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 مع Bearer token مطلوب​

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

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

Unknown parameter​

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

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

بما أن OpenCode يعمل كوكيل، من المهم مراجعة التغييرات.

أفضل الممارسات:

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

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

WhatsApp