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

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

OpenCode هو أداة ترميز بوكالة. الأداة متاحة كتطبيق طرفي، وتطبيق سطح مكتب، وت addon للـ 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​

يدعم OpenCode مقدمي متوافقين مع 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.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-public-coderen/gpt-5.4-mini",
  "small_model": "ai-public-coderen/gpt-5.4-mini"
}

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

macOS وLinux​

export AI_PUBLIC_CODEREN_API_KEY="aip.مفتاح-الواجهة-الخاصة-بك"

Windows​

setx AI_PUBLIC_CODEREN_API_KEY "aip.مفتاح-الواجهة-الخاصة-بك"

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

بدء OpenCode​

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

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

ابدأ OpenCode:

opencode

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

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

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

الممارسات الموصى بها:

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

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

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

AI_PUBLIC_CODEREN_API_KEY=aip.مفتاح-الواجهة-الخاصة-بك

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

$env:AI_PUBLIC_CODEREN_API_KEY="aip.مفتاح-الواجهة-الخاصة-بك"

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