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

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

OpenCode هو أداة ترميز آلية. الأداة متاحة كتطبيق طرفي، وتطبيق سطح المكتب، بالإضافة إلى إضافة IDE.

يُنصح AI-Corporate باستخدام OpenCode للمطورين والمديرين وغيرهم من المستخدمين المتقدمين. يمكن لـ OpenCode تعديل الملفات وتنفيذ المهام بشكل مستقل. راقب دائمًا التغييرات المقترحة.

لمزيد من المعلومات، راجع موقع OpenCode والتوثيق الرسمي لـ OpenCode.

التثبيت​

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

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

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

npm install -g opencode-ai

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

brew install anomalyco/tap/opencode

الاتصال بالبرمجة​

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_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-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

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

macOS وLinux​

export AI_CORPORATE_CODEREN_API_KEY="aic.مفتاح-ال API-خاصتك"

Windows​

setx AI_CORPORATE_CODEREN_API_KEY "aic.مفتاح-ال API-خاصتك"

افتح بعد ذلك طرفية جديدة.

بدء OpenCode​

اذهب إلى مجلد المشروع:

cd المسار/إلى/مشروعك

ابدأ OpenCode:

opencode

اختر في OpenCode النموذج لاختيار نموذج AI-Corporate Coderen إذا لم يحدث تلقائيًا.

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

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

الطريقة المقترحة:

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

المتغيرات البيئية وOpenCode​

يمكنك حفظ مفتاح Coderen API في ملف .env محلي ضمن مجلد المشروع:

AI_SCHOOL_CODEREN_API_KEY=ais.مفتاح-ال API-خاصتك

تأكد أن OpenCode يقوم بتحميل هذا المتغير البيئي. في PowerShell يمكنك تعيين المتغير مؤقتًا ليدوم حتى الجلسة الحالية من الطرفية:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.مفتاح-ال API-خاصتك"

إذا رأيت Authorization header with Bearer token is required، فسترسل الأداة المفتاح بدونها كـ Authorization: Bearer .... إذا رأيت Unknown parameter، فاحذف الإعدادات الخاصة بمزود الخدمة التي لا يدعمها نقطة نهاية Coderen من AI-Corporate.