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

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

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

توصي AI-Public بـ 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

الاتصال بـ Coderen (Coderen)​

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

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

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

ضع مفتاح API في متغير بيئي لاحقاً.

macOS وLinux​

export AI_PUBLIC_CODEREN_API_KEY="aip.jouw-api-sleutel"

Windows​

setx AI_PUBLIC_CODEREN_API_KEY "aip.jouw-api-sleutel"

بعدها افتح نافذة طرفية جديدة.

تشغيل OpenCode​

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

cd pad/naar/je/project

ابدأ OpenCode:

opencode

استخدم في OpenCode اختيار النموذج لاختيار نموذج AI-Public Coderen إن لم يتم ذلك تلقائياً.

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

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

أفضل الممارسات المقترحة:

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

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

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

AI_PUBLIC_CODEREN_API_KEY=aip.jouw-api-sleutel

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

$env:AI_PUBLIC_CODEREN_API_KEY="aip.jouw-api-sleutel"

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

WhatsApp