Windows (WSL)

شغّل OpenCode على Windows باستخدام WSL لأفضل تجربة.

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

الإعداد

ثبّت WSL

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

بعد إعداد WSL، افتح terminal داخل WSL وثبّت OpenCode باستخدام إحدى طرق التثبيت.
Terminal window
```
curl -fsSL https://opencode.ai/install | bash
```
استخدم OpenCode من WSL

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

تطبيق سطح المكتب + خادم WSL

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

ابدأ الخادم داخل WSL مع --hostname 0.0.0.0 للسماح بالاتصالات الخارجية:
Terminal window
```
opencode serve --hostname 0.0.0.0 --port 4096
```
اربط تطبيق سطح المكتب على http://localhost:4096

عند استخدام --hostname 0.0.0.0، اضبط OPENCODE_SERVER_PASSWORD لحماية الخادم.

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

عميل الويب + WSL

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

شغّل opencode web من terminal داخل WSL بدلًا من PowerShell:
Terminal window
```
opencode web --hostname 0.0.0.0
```
افتحه من متصفح Windows عبر http://localhost:<port> (يعرض OpenCode الرابط)

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

الوصول إلى ملفات 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/