OpenCode — وكيل ترميز مفتوح لجهازك

01 / الميزات

مصمم لمسارات تطوير حقيقية.

وكيل مفتوح المصدر يكتب معك في الطرفية أو IDE أو تطبيق سطح المكتب.

01↗LSP enabled يحمّل خوادم اللغة المناسبة للنموذج تلقائياً.
02↗Multi-session شغّل عدة وكلاء بالتوازي على المشروع نفسه.
03↗Share links انشر رابط جلسة للمراجعة أو التصحيح.
04↗GitHub Copilot سجّل الدخول عبر GitHub لاستخدام حساب Copilot.
05↗ChatGPT Plus/Pro سجّل الدخول عبر OpenAI لاستخدام ChatGPT Plus أو Pro.
06↗Any model أكثر من 75 مزود LLM عبر Models.dev، بما في ذلك النماذج المحلية.
07↗Any editor واجهة طرفية وتطبيق سطح مكتب وامتداد IDE.

اقرأ التوثيق ↗

02 / البداية

من التثبيت إلى أول تعديل.

المسار الرسمي قصير: ثبّت، اكتب قواعد المشروع، صِل نموذجاً، ثم بدّل بين Plan وBuild.

1. ثبّت سطح المكتب أو CLI من صفحة التنزيل. الإصدار الحالي v1.18.31 لـ Windows وmacOS وLinux.
2. شغّل opencode في مشروع، ثم /init لكتابة AGENTS.md. أضف الملف إلى Git حتى ترى الجلسات اللاحقة القواعد نفسها.
3. استخدم /connect لإضافة مفتاح مزود، أو سجّل الدخول إلى Copilot أو ChatGPT أو Claude أو Zen. النماذج المجانية تعمل دون حساب.
4. أرفق الملفات بـ @. يقترح Plan العمل بينما يبقى edit وbash على ask أو deny. Build هو الوكيل الافتراضي والأدوات مفعّلة.

03 / الأسطح

ثلاثة أسطح، وكيل واحد.

«Any editor» يعني طرفية وتطبيق سطح مكتب وامتداد IDE. الطرفية ما زالت مسار التثبيت الافتراضي.

الطرفية

المسار الافتراضي. السمة واختصارات المفاتيح في tui.json. إعداد التشغيل في opencode.json. ليسا الملف نفسه.

سطح المكتب

علامات تبويب للجلسات النشطة على macOS وWindows وLinux. يحتاج Windows إلى WebView2. النافذة الفارغة عادة من ذلك التشغيل. موقّع منذ v1.3.4.

امتداد IDE

الوكيل نفسه داخل المحرر. صفحة التنزيل تسرد Terminal أولاً ثم Desktop ثم Extensions.

التراجع والمشاركة

/undo و/redo يعيدان أو يستعيدان آخر دور للمستخدم وتغييرات ملفاته. Git مطلوب. /share ينشر الجلسة فقط عند تشغيل الأمر.

04 / Adoption

وكيل ترميز مفتوح، علناً.

أكثر من 195,000 نجمة على GitHub و950 مساهماً وأكثر من 13,000 التزام. يستخدمه أكثر من 16 مليون مطور كل شهر.

Fig 1. 195K GitHub Stars

Fig 2. 950 Contributors

Fig 3. 16M Monthly Devs

05 / Privacy

الخصوصية أولاً، افتراضياً.

لا تُخزَّن الشيفرة أو السياق، ليعمل في بيئات حساسة. الأسئلة الشائعة تذكر استثناءين. ملاحظات الخصوصية →

الافتراضي: الخدمة لا تخزّن الشيفرة أو السياق. يمكن تشغيل الوكيل حيث لا يجوز ترك نسخة بعيدة.
يُخزَّن: تُحفظ البيانات عند استخدام النماذج المجانية أو إنشاء رابط قابل للمشاركة. تبقى المحادثة خاصة حتى تشغّل /share.
على القرص: الجلسات المحلية في ~/.local/share/opencode أو %USERPROFILE%\.local\share\opencode، بما في ذلك auth.json.
التوقيع: CLI وسطح المكتب موقّعان منذ v1.3.4. قارن هاش مثبّت Windows x64 قبل أي استثناء لمكافح الفيروسات.

06 / الأذونات

Allow أو ask أو deny.

منذ v1.1.1 كل قاعدة هي allow أو ask أو deny. opencode --auto يوافق على ask غير المرفوضة. وضع Plan يبقي edit وbash متوقفين بينما يفكر النموذج.

external_directory: يُفعَّل عندما يغادر أداة مجلد العمل. الافتراضي ask. توسيع ~ لا يتجاوز هذا الحاجز.
doom_loop: يُفعَّل إذا تكرر استدعاء الأداة نفسها ثلاث مرات بنفس الإدخال. الافتراضي ask.
ملفات .env: read مسموح، لكن *.env و*.env.* افتراضياً deny. *.env.example يبقى allow.
الأنماط: أدوات الملفات والصدفة يمكنها السماح بـ git * ورفض rm *. سؤال ask يعرض once أو always لبقية الجلسة أو reject.

افتراضيات الأذونات ↗

07 / FAQ

أسئلة، بإجابات مباشرة.

وكيل مفتوح المصدر يكتب ويشغّل الشيفرة بأي نموذج — طرفية أو سطح مكتب أو امتداد IDE.

ثبّت من صفحة التنزيل، شغّل opencode في مشروع، ثم /init. صِل مزوداً، وأرفق الملفات بـ @، واستخدم Plan/Build.

ليس بالضرورة. النماذج المجانية تعمل دون حساب. يمكنك أيضاً ربط OpenAI أو Anthropic أو xAI أو نماذج محلية أو Zen.

نعم. الأسئلة الرسمية تذكر Claude Pro/Max وChatGPT Plus/Pro وGitHub Copilot.

لا. سطح المكتب يغطي macOS وWindows وLinux، إضافة إلى امتداد IDE.

الوكيل مجاني ويأتي بنماذج مجانية. المزود المتصل قد يضيف رسومه.

الشيفرة والسياق لا يُخزَّنان افتراضياً. تُخزَّن البيانات للنماذج المجانية أو رابط قابل للمشاركة. الجلسات المحلية تبقى على القرص.

نعم. المصدر عام برخصة MIT. اسم المشروع على GitHub هو anomalyco/opencode.

نعم. سطح المكتب ينشر win-x64 وwin-arm64. الوثائق ما زالت توصي بـ WSL لمسار الطرفية. سطح المكتب يحتاج WebView2. انظر دليل WSL.

محركات استدلالية صنّفت DLL مؤقتة عند أول تشغيل كـ Wacatac أو PDM:Trojan.Win32.Generic. تحقق من SHA256، فضّل بناء سطح المكتب الموقّع v1.18.31، ولا تعطّل Smart App Control. الخطوات: دليل مكافح الفيروسات.

في Windows PowerShell: Get-FileHash .\opencode-desktop-win-x64.exe -Algorithm SHA256. ملخص v1.18.31 في قسم السلامة.

08 / Models

نماذج موثوقة مختارة للوكلاء.

اربط نماذج مختبرة لوكلاء البرمجة. استخدم النماذج المجانية أو مفاتيحك أو Copilot أو ChatGPT أو تشغيلاً محلياً دون الالتزام بمورد واحد.

/connect

أضف مزوداً والصق مفتاح API، أو سجّل الدخول إلى Copilot أو ChatGPT أو Claude أو Zen.

/models

افتح المنتقي. شغّل opencode models لسرد ما يمكنك استدعاءه. تُكتب النماذج كـ provider/model مثل openai/gpt-4.1.

OpenCode Zen

نماذج منتقاة اختبرها المشروع لوكلاء البرمجة، لتقليل مقامرة جودة المزود.

نماذج محلية

اربط نماذج محلية عبر قائمة 75+ مزود نفسها على Models.dev. النماذج المجانية المرفقة تعمل دون حساب.

معرفة المزيد عن النماذج ↗

وكيل مفتوح لشيفرتك.