تخطَّ إلى المحتوى
وثائق V1
الإعداد

Windows (WSL)

رغم أن OpenCode يمكن تشغيله مباشرة على Windows، نوصي باستخدام Windows Subsystem for Linux (WSL) للحصول على أفضل تجربة. يوفر WSL بيئة Linux تعمل بسلاسة مع ميزات OpenCode.


  1. ثبّت WSL

    إذا لم تقم بذلك بعد، ثبّت WSL باستخدام دليل Microsoft الرسمي.

  2. ثبّت OpenCode داخل WSL

    بعد إعداد WSL، افتح terminal داخل WSL وثبّت OpenCode باستخدام إحدى طرق التثبيت.

    الطرفية
    curl -fsSL https://opencode.ai/install | bash
  3. استخدم OpenCode من WSL

    انتقل إلى مجلد مشروعك (يمكنك الوصول لملفات Windows عبر /mnt/c/ و/mnt/d/ وغيرها) ثم شغّل OpenCode.

    الطرفية
    cd /mnt/c/Users/YourName/project
    opencode

إذا كنت تفضّل تطبيق OpenCode لسطح المكتب لكن تريد تشغيل الخادم داخل WSL:

  1. ابدأ الخادم داخل WSL مع --hostname 0.0.0.0 للسماح بالاتصالات الخارجية:

    الطرفية
    opencode serve --hostname 0.0.0.0 --port 4096
  2. اربط تطبيق سطح المكتب على http://localhost:4096


لأفضل تجربة ويب على Windows:

  1. شغّل opencode web من terminal داخل WSL بدلًا من PowerShell:

    الطرفية
    opencode web --hostname 0.0.0.0
  2. افتحه من متصفح Windows عبر http://localhost:<port> (يعرض OpenCode الرابط)

تشغيل opencode web من WSL يضمن وصولًا صحيحًا لنظام الملفات وتكاملًا أفضل مع terminal، مع بقائه متاحًا من متصفح Windows.


يمكن لـ WSL الوصول إلى جميع ملفات Windows عبر مجلد /mnt/:

  • قرص C: → /mnt/c/
  • قرص D: → /mnt/d/
  • وهكذا…

مثال:

الطرفية
cd /mnt/c/Users/YourName/Documents/project
opencode

  • شغّل OpenCode داخل WSL للمشاريع المخزنة على أقراص Windows حتى يكون الوصول للملفات سلسًا
  • استخدم إضافة WSL في VS Code مع OpenCode لسير عمل تطوير متكامل
  • إعدادات OpenCode وجلساته تُخزَّن داخل بيئة WSL في ~/.local/share/opencode/