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

تثبيت واستخدام 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-متوافقين مخصصين providers. أنشئ في مجلد المشروع ملفًا باسم opencode.json.

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

{
  "$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.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-corporate-coderen/gpt-5.6-luna",
  "small_model": "ai-corporate-coderen/gpt-5.6-luna"
}

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

macOS وLinux​

export AI_CORPORATE_CODEREN_API_KEY="aic.مفتاح-واجهتك"

Windows​

setx AI_CORPORATE_CODEREN_API_KEY "aic.مفتاح-واجهتك"

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

بدء تشغيل OpenCode​

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

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

ابدأ OpenCode:

opencode

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

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

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

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

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

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

بالنسبة لـ OpenCode يمكنك حفظ مفتاح API للترميز في ملف .env محليًا في مجلد المشروع:

AI_SCHOOL_CODEREN_API_KEY=ais.مفتاح-واجهتك

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

$env:AI_SCHOOL_CODEREN_API_KEY="ais.مفتاح-واجهتك"

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

WhatsApp