opencode/packages/web/src/content/docs/ar/ide.mdx

---
title: IDE
description: امتداد OpenCode لـ VS Code و Cursor وغيرها من بيئات التطوير
---

يتكامل OpenCode مع VS Code و Cursor أو أي IDE يدعم terminal. ما عليك سوى تشغيل `opencode` في terminal للبدء.

---

## الاستخدام

- **تشغيل سريع**: استخدم `Cmd+Esc` (Mac) أو `Ctrl+Esc` (Windows/Linux) لفتح OpenCode في عرض terminal مقسّم، أو للتركيز على جلسة terminal موجودة إذا كانت قيد التشغيل بالفعل.
- **جلسة جديدة**: استخدم `Cmd+Shift+Esc` (Mac) أو `Ctrl+Shift+Esc` (Windows/Linux) لبدء جلسة terminal جديدة لـ OpenCode حتى لو كانت هناك جلسة مفتوحة. يمكنك أيضا النقر على زر OpenCode في واجهة المستخدم.
- **وعي بالسياق**: شارك تلقائيا تحديدك الحالي أو تبويبك مع OpenCode.
- **اختصارات الإشارة إلى الملفات**: استخدم `Cmd+Option+K` (Mac) أو `Alt+Ctrl+K` (Linux/Windows) لإدراج مراجع الملفات. مثلا: `@File#L37-42`.

---

## التثبيت

لتثبيت OpenCode على VS Code والتفرعات الشائعة مثل Cursor و Windsurf و VSCodium:

1. افتح VS Code
2. افتح terminal المدمجة
3. شغّل `opencode` - سيتم تثبيت الامتداد تلقائيا

أما إذا كنت تريد استخدام IDE الخاص بك عند تشغيل `/editor` أو `/export` من واجهة TUI، فستحتاج إلى ضبط `export EDITOR="code --wait"`. [اعرف المزيد](/docs/tui/#editor-setup).

---

### التثبيت اليدوي

ابحث عن **OpenCode** في Extension Marketplace وانقر **Install**.

---

### استكشاف الأخطاء وإصلاحها

إذا فشل تثبيت الامتداد تلقائيا:

- تأكد من أنك تشغّل `opencode` داخل terminal المدمجة.
- تأكد من تثبيت CLI الخاصة بـ IDE لديك:
  - لـ VS Code: أمر `code`
  - لـ Cursor: أمر `cursor`
  - لـ Windsurf: أمر `windsurf`
  - لـ VSCodium: أمر `codium`
  - إذا لم تكن مثبتة، شغّل `Cmd+Shift+P` (Mac) أو `Ctrl+Shift+P` (Windows/Linux) وابحث عن "Shell Command: Install 'code' command in PATH" (أو ما يعادله في IDE لديك)
- تأكد من أن VS Code لديه الصلاحية لتثبيت الامتدادات