وكيل البرمجة OpenCode مفتوح المصدر: يقدّم المستودع anomalyco/opencode نفسه بأنه «وكيل البرمجة المفتوح المصدر بالذكاء الاصطناعي». هو وكيل يعمل في الطرفية (terminal) (مع تطبيق سطح مكتب في طور بيتا)، ويقرأ مستودعك ويقترح تعديلات ويشغّل أوامر، بالنموذج الذي تختاره. بلغ عدد نجومه نحو 219900 في أكتوبر 2026، وهذا يجعله من أكثر مستودعات السلسلة متابعة.
وكيل برمجة ينفّذ أوامر ويكتب ملفات هو فاعل إضافي في سلسلة التسليم لديك. يتبع هذا المقال README ووثائق المشروع: ما هو، والتثبيت، وما يُرى من الواجهة، وحدود الأمان التي يصفها المشروع بنفسه، وكيف تُتابَع السجلات والرموز والتكاليف. وللمراقبة على مستوى المؤسسة، راجع مراقبة وكيل برمجة في المؤسسة.
توضيح للأمانة: لم تثبّت span.observer أداة OpenCode ولم تختبرها. الأوامر مأخوذة من README والوثائق. اللقطة الأولى منشورة في المستودع؛ واللقطتان الأخريان مقتطفان من هذه الوثائق صيّرناهما بأنفسنا.
وكيل البرمجة OpenCode مفتوح المصدر: ما الذي يقوله المستودع
- الجهة: المستودع ملك لمنظمة GitHub المسماة
anomalyco. ويحمل ملف LICENSE عبارة «Copyright (c) 2025 opencode». - الترخيص: MIT.
- أرقام قُرئت يوم 22 أكتوبر 2026 من صفحة المستودع: نحو 219900 نجمة، ونحو 29400 فرع، و20722 commit في الفرع
dev. - الإصدار: يلزم التحقق، انظر أدناه. يصف CHANGELOG في المستودع «OpenCode V2» وآخر مدخل فيه هو v2.1.2 بتاريخ 21 أكتوبر 2026، بينما كانت صفحة الإصدارات تعرض v1.19.3 بتاريخ 16 أكتوبر. للمشروع خطا إصدارات، V1 وV2، ولم يعودا يُثبَّتان جنبًا إلى جنب افتراضيًا.
- الوكلاء المدمجون:
build(وصول كامل، وهو الافتراضي) وplan(للقراءة فقط: يرفض تعديل الملفات ويطلب الإذن قبل أوامر shell)، ويُبدَّل بينهما بمفتاح Tab. ووكيل فرعيgeneralللبحوث المعقدة. - النماذج: المشروع مستقل عن أي مزوّد؛ وتصف الوثائق إعداد المزوّدين والنماذج. وتُظهر اللقطة أدناه نموذجًا من Claude وخدمة «OpenCode Zen».
جولة في الواجهة
هذه لقطة الطرفية المنشورة في المستودع (وهي من الصفحة الرئيسية للمشروع ومن إصدار أقدم). تعرض ترويسة الجلسة عدد الرموز (tokens) ونسبة السياق المستخدم والتكلفة بالدولار. وتُسرد استدعاءات الأدوات (Grep وGlob وRead) على امتداد المحادثة، ثم يطرح الوكيل سؤالًا قبل تعديل أي شيء.

هذا العداد مفيد للمراقبة: تعرض كل جلسة تكلفتها بالرموز على الشاشة، قبل ربط أي مقياس. وتذكّر الاختصارات في الأسفل بالوظائف الرئيسية: Esc للمقاطعة، وTab لتغيير الوكيل، وCtrl+T لمتغيرات النموذج، وCtrl+P للوحة الأوامر.
التثبيت بحسب README
الخطوة 1: ثبّت CLI
يقترح README سكربتًا وعدة مديري حزم:
curl -fsSL https://opencode.ai/v2/install | bash
npm i -g @opencode/cli@latest
brew install anomalyco/tap/opencode-v2
brew install opencode
sudo pacman -S opencode
mise use -g opencode
nix run github:anomalyco/opencode
تمرير سكربت بعيد إلى shell ممارسة محفوفة بالمخاطر: فضّل مدير حزم، أو اقرأ السكربت قبل تنفيذه. يحترم السكربت الترتيب $OPENCODE_INSTALL_DIR ثم $XDG_BIN_DIR ثم $HOME/bin ثم $HOME/.opencode/bin. ويوضح دليل الترحيل أن تثبيت V1 المُدار بحزمة يجب إزالته قبل تثبيت V2.
الخطوة 2: تطبيق سطح المكتب (بيتا)
يعطي README حزم macOS (Apple Silicon وIntel) وWindows وLinux (.deb و.rpm و.AppImage) والأمر brew install --cask opencode-desktop لـ macOS.
الخطوة 3: اضبط الأذونات
تصف الوثائق إعدادًا باسم permission تكون فيه قيمة كل إجراء allow أو ask أو deny. وتسود آخر قاعدة مطابقة؛ لذلك توضع القاعدة العامة "*" أولًا. ومثال الصفحة:

يوافق الخيار --auto تلقائيًا على الطلبات التي لم تُرفض صراحةً؛ وتبقى قواعد deny مطبّقة. خصّصه لبيئة معزولة.
الأمان: ما يقوله المشروع عن نفسه
- ملف SECURITY.md في المستودع صريح: لا يضع OpenCode الوكيلَ في صندوق رمل (sandbox). نظام الأذونات مساعد للانتباه عند المستخدم وليس عزلًا. ولعزل حقيقي يوصي المشروع بتشغيل الأداة في حاوية Docker أو جهاز افتراضي.
- وضع الخادم (
opencode serveوopencode web) اختياري. وتطلب الوثائق تعريفOPENCODE_SERVER_PASSWORDلتفعيل مصادقة HTTP الأساسية؛ وبدون كلمة مرور يعمل الخادم دون مصادقة مع تحذير. - البيانات المرسلة إلى مزوّد النموذج تخضع لشروطه؛ وخوادم MCP التي تعدّها خارج نطاق ثقة المشروع.
طبّق الاحتياطات نفسها على أي وكيل ذي صلاحيات: ضوابط حماية وكلاء الذكاء الاصطناعي في الإنتاج، وإن ربطت خوادم MCP فراجع دليل خادم MCP الخاص بـ GitHub.
الحدود والنقاط المفتوحة
- خطا إصدارات: يتعايش V1 وV2. يغيّر V2 واجهة الإضافات وعقود الخادم وإعداد عميل الطرفية؛ وتُتجاهل حقول تجريبية من V1 (منها
openTelemetry)، بحسب دليل الترحيل. تحقق من الإصدار المعروض قبل اتباع أي درس. - الوتيرة: أكثر من 20000 commit؛ ثبّت الإصدار في أجهزة التطوير.
- النماذج المجانية: يذكر CHANGELOG نماذج بلا تكلفة ومتغيرًا
OPENCODE_DISABLE_FREE_MODELSلإخفائها؛ تحقق مما يُرسَل إلى أي مزوّد قبل أن تضع فيها شيفرة مملوكة. - يوضح المشروع أنه لا يقبل تقارير الأمان المولَّدة بالذكاء الاصطناعي.
مراقبة OpenCode: السجلات والرموز والتكاليف
OpenCode أداة محلية وليست خدمة: تنطلق المراقبة من الجهاز أو الحاوية. هذه الأفكار صالحة مع Dynatrace SaaS ومع Dynatrace Managed إن جمعت البيانات عبر Collector من OpenTelemetry.
- السجلات المحلية: تذكر صفحة استكشاف الأخطاء المسار
~/.local/share/opencode/log/على macOS وLinux، وهي ملفات مؤرخة يُحتفظ بأحدث عشرة منها. ويفصّلopencode --log-level DEBUGالمخرجات، ويعرضها--print-logsفي الطرفية. - الرموز والتكاليف: يعرض
opencode statsاستخدام الرموز وتكلفة الجلسات، مع الخيارات--daysو--toolsو--modelsو--project. ولمتابعة هذه التكلفة في منصة خلفية، راجع تكلفة وكيل الذكاء الاصطناعي بالرموز مع OpenTelemetry. - تصدير OpenTelemetry (يلزم التحقق): في الشيفرة المصدرية للفرع الرئيسي، تقرأ الوحدة
packages/util/src/observability.tsالمتغيرينOTEL_EXPORTER_OTLP_ENDPOINTوOTEL_EXPORTER_OTLP_HEADERSوإن عُرّفت نقطة وصول أرسلت السجلات إلى/v1/logsوالتتبعات إلى/v1/traces. هذه الميزة لا تظهر في الوثائق التي قرأناها: اختبرها على إصدارك قبل أن تعتمد عليها. - تدقيق الأوامر: القسم
permissionهو أيضًا سجل للنوايا؛ اشترطaskللإجراءينshellوeditعلى الأجهزة المشتركة.

كيف تتحقق من أن كل شيء يعمل
- يفتح
opencodeالواجهة في مستودع تجريبي. - مع الوكيل
plan، يُرفض طلب تعديل: هذا هو وضع القراءة فقط. - بعد جلسة، يُظهر
opencode statsالرموز والتكلفة. - يظهر ملف سجل مؤرخ في مجلد السجلات.
أفضل الممارسات
- شغّل الوكيل في حاوية أو جهاز افتراضي للمستودعات الحساسة.
- ابدأ بالوكيل
planوقواعدask، ثم خفّف عند الحاجة. - عرّف
OPENCODE_SERVER_PASSWORDدائمًا قبل فتح وضع الخادم أو الويب. - أبقِ مفاتيح المزوّدين خارج المستودعات والسجلات.
- تابع التكلفة لكل جلسة وراجع الفروق دون البحث عن مذنب.
الأسئلة الشائعة
هل OpenCode مجاني فعلًا؟
البرنامج بترخيص MIT. وللنماذج تكلفة بحسب المزوّد المختار، ويشير CHANGELOG إلى نماذج مجانية تتغير حدودها؛ ولا يبيع المشروع رموز مزوّديك الآخرين.
هل تذهب شيفرتي إلى طرف ثالث؟
يذهب السياق المرسل إلى مزوّد النموذج الذي تعدّه، ويوضح SECURITY.md أن تعامله مع البيانات يعود إليه. اختره بحسب سياسة البيانات لديك.
هل يعزل OpenCode الأوامر التي يشغّلها؟
لا، بحسب SECURITY.md: الأذونات ليست صندوق رمل. استخدم حاوية أو جهازًا افتراضيًا.
الخلاصة
يستحق OpenCode شعبيته لمن يريد وكيل برمجة مفتوح المصدر، حرًّا في اختيار النموذج وقابلًا للضبط بملف. ينبغي اعتماده عن علم: التحقق من إصدار V1 أو V2، وأذونات صارمة، وعزل بحاوية، ومتابعة الرموز والسجلات. ولوكيل مفتوح المصدر آخر من السلسلة نفسها، راجع OpenClaw. المصادر: مستودع anomalyco/opencode.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.