OpenCode: دليل عملي للبرمجة من الطرفية وربط النماذج

ابدأ بخطأ برمجي تفهمه وحساب نموذج تملكه بالفعل. بعد مراجعة تعديل حقيقي ومعرفة تكلفته، يمكنك الحكم على ما إذا كان اشتراك برمجة إضافي يستحق مكانه ضمن أدواتك.

شرح OpenCode: ما الذي يفعله؟

يقرأ OpenCode المشروع ويعدّل الملفات وينفّذ الأوامر عبر واجهة داخل الطرفية. الطرفية هي مساحة العمل، والنموذج هو المحرّك الذي تربطه بها. تغيير المحرّك يغيّر طريقة الاستدلال والسرعة والسعر، بينما يظل مستودعك هو المشروع الذي يجري العمل عليه. نظرة عامة على OpenCode، التكامل مع Ollama

المزوّد هو الخدمة التي توفّر النموذج. ومفتاح API هو بيانات اعتماد تتيح للبرنامج استخدام تلك الخدمة واحتساب التكلفة على حساب الفوترة المرتبط بها. أما النموذج المحلي فيعمل عبر خادم استدلال على جهازك. هذه اختيارات مستقلة عن اختيار واجهة الوكيل.

ولا يكفي أن يكون المزوّد متوافقًا نظريًا؛ جرّبه في مهمة فعلية. استدعاء الأدوات يعني طلب إجراء مثل قراءة ملف أو تنفيذ أمر. وينبّه OpenCode إلى أن عددًا قليلًا نسبيًا من النماذج يجيد استدعاء الأدوات وتوليد الشيفرة معًا. اختبر النموذج في مهمة صغيرة قبل الاعتماد عليه لإعادة هيكلة واسعة. إرشادات اختيار النموذج

تثبيت OpenCode وفتح مشروعك

ثبّت الأداة باتباع الوثائق الرسمية، ثم شغّلها من داخل المستودع الذي تريد العمل عليه. إذا كان Node.js وnpm مثبتين لديك، فهذه طريقة التثبيت بالحزمة كما توثّقها الخدمة:

npm install -g opencode-ai
cd /path/to/project
opencode

استبدل مسار المشروع بمسارك الفعلي. وتعرض وثائق OpenCode أيضًا الأمر curl -fsSL https://opencode.ai/install | bash، وتوصي عند استخدام Homebrew بالأمر brew install anomalyco/tap/opencode. اختر طريقة تثبيت واحدة. على Windows، توصي الوثائق باستخدام WSL، وهي بيئة Windows لتشغيل أدوات Linux، وتعرض كذلك خيارات npm وChocolatey وScoop. التثبيت الرسمي والتشغيل الأول

يفتح OpenCode TUI، أي واجهة مستخدم نصية داخل الطرفية. الأوامر التي تبدأ بـ /، ومنها /connect، تُكتب داخل هذه الواجهة. أما الأوامر التي تبدأ بـ opencode، مثل opencode stats، فتُنفّذ في سطر أوامر الطرفية.

اعمل داخل مستودع Git وابدأ بفرع جديد. يسجّل Git تغييراتك لتفحص الفروق، أي الأسطر التي أُضيفت وحُذفت بدقة، قبل تثبيت أي تغيير في سجل المستودع.

ربط حساب النموذج الذي تدفع له بالفعل

نفّذ /connect، واختر المزوّد، وأكمل مسار المصادقة الموثّق له. ثم نفّذ /models واختر النموذج. المزوّدون الشائعون مُعدّون مسبقًا، لكن نقاط الاتصال المخصصة والخوادم المحلية قد تحتاج إلى إعداد إضافي. اختيار النموذج

هذه مسارات موضّحة في صفحة المزوّدين العامة لدى OpenCode؛ ولا تعني أن كل حساب مدفوع سيتيح وصولًا بعينه. تعليمات الاتصال بالمزوّدين

الاشتراك في خدمة محادثة لا يمنحك تلقائيًا رصيدًا لاستخدام API. توضح Anthropic أن Claude Pro لا يشمل استخدام Claude Console API. ويحذّر قسم Anthropic في وثائق OpenCode أيضًا من إضافات المصادقة باشتراكات Claude Pro/Max. استخدم مفتاح Anthropic API لهذا المسار، أو استخدم Claude Code مع الاشتراك. وتميّز OpenAI كذلك بين أسعار رموز API والاستخدام المشمول في الاشتراك. فوترة Claude Pro، تحذير OpenCode بشأن Anthropic، تسعير اشتراكات OpenAI وAPI

لاستخدام Ollama، ثبّت Ollama وOpenCode، ثم ابدأ بالأمر ollama launch opencode واختر نموذجًا محليًا. ويتيح Ollama أيضًا الأمر ollama launch opencode --config لإتمام الإعداد دون فتح جلسة. تعرض أداة التشغيل نماذج محلية وسحابية، لذا انتبه إلى اختيارك. إعداد OpenCode مع Ollama

للإعداد المحلي اليدوي، يستخدم مثال المزوّد في وثائق OpenCode الحزمة @ai-sdk/openai-compatible والعنوان المحلي http://localhost:11434/v1، مع معرّف نموذج يطابق النموذج الذي يقدّمه خادمك. ولـ LM Studio مثال إعداد مستقل. أما الخدمة المتوافقة مع OpenAI وغير المدرجة، فتستخدم /connect → Other، مع معرّف مزوّد مطابق وعنوان وإعداد نموذج في opencode.json. المزوّدون المحليون والمخصصون

تنفيذ أول مهمة حقيقية

اختر خطأ تستطيع وصف السلوك الصحيح له قبل بدء الوكيل. نموذج تسجيل يقبل عنوان بريد إلكتروني فارغًا أنسب كبداية من طلب إعادة تصميم التطبيق بالكامل.

أولًا، هيّئ المشروع. نفّذ /init. ينشئ هذا الأمر ملف AGENTS.md أو يحدّثه؛ وهو ملف Markdown يحمل تعليمات لجلسات الوكيل اللاحقة. اقرأ الناتج وصحّح أوامره وافتراضاته قبل المتابعة. تهيئة المشروع

بعد ذلك، اطلب خطة. اضغط Tab حتى يُختار Plan. استخدم @ للإشارة إلى ملفات التنفيذ والاختبار الفعلية داخل مستودعك. في مثال البريد الفارغ، يمكنك كتابة الطلب التالي:

هذا مثال لصياغة مهمة، وليس تقريرًا عن اختبار أُنجز. استبدله بخطأ حقيقي وملفات فعلية من مشروعك. يقيّد Plan التعديلات وأوامر الطرفية عبر الأذونات، لكنه ليس بيئة تنفيذ معزولة. الوكلاء وسلوك Plan، الإشارة إلى الملفات

ثم نفّذ النطاق المتفق عليه. انتقل إلى Build باستخدام Tab، واطلب إضافة اختبار رجعي يكشف الخطأ، ثم إجراء أصغر إصلاح ممكن. اطلب من الوكيل إظهار أن الاختبار يفشل مع السلوك الأصلي وينجح بعد التعديل، ثم تشغيل الفحوص الحالية ذات الصلة. Build هو الوكيل الافتراضي، وأدواته مفعّلة. وكيل Build

أخيرًا، راجع النتيجة بنفسك. اقرأ الفروق، وتحقق من أن شرط الاختبار يطابق السلوك الذي قصدته، وافحص التغييرات غير المرتبطة بالمهمة. نجاح اختبار يتحقق من سلوك خاطئ لا يثبت الكثير. واطلب من الوكيل سرد الأوامر التي نفّذها فعلًا والإخفاقات التي لم يستطع حلّها.

إذا انحرف التعديل عن المطلوب، يستطيع /undo التراجع عن الرسالة الأخيرة وتغييراتها، ويعيد /redo رسالة سبق التراجع عنها. يعتمد الأمران على Git. التراجع والإعادة

كيف تجعل AGENTS.md وقواعد المشروع مفيدة؟

اكتب التعليمات التي يحتاجها مطوّر متمكّن للعمل في هذا المستودع. اجعلها محددة وقابلة للتحقق:

• أوامر التثبيت والبناء وفحص الشيفرة والاختبار الفعلية، مع ترتيبها حين يكون مهمًا.
• أماكن شيفرة التطبيق والحزم المشتركة والملفات المولّدة.
• القواعد الواجب اتباعها والوحدات الموجودة التي تقدّم أمثلة عليها.
• شروط اكتمال المهمة، بما فيها الفحوص المطلوبة وملخص السلوك الذي تغيّر.

ثبّت ملف المشروع في سجل المستودع ليستخدمه الفريق. أما القواعد الشخصية فمكانها ~/.config/opencode/AGENTS.md. ويمكن لـ OpenCode استخدام CLAUDE.md بديلًا عند غياب ملف قواعد OpenCode المقابل. القواعد ومواقع ملفاتها

ملف الإعداد هو opencode.json. تستطيع مصفوفة instructions فيه تحميل إرشادات موجودة، فلا تحتاج إلى نسخ دليل المساهمة إلى AGENTS.md. ويطلب المثال التالي أيضًا الموافقة قبل تعديل الملفات وتنفيذ أوامر الطرفية:

{
  "$schema": "https://opencode.ai/config.json",
  "instructions": ["CONTRIBUTING.md"],
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

استخدم اسم ملف تعليمات موجود فعلًا في مشروعك، وادمج هذه الإعدادات في ملف الإعداد الحالي. مجرد الإشارة إلى ملف آخر داخل AGENTS.md لا تؤدي تلقائيًا إلى تحميل محتواه. استخدم instructions عندما تريد تحميله. التعليمات المخصصة

تصف القواعد السلوك الذي تريده، بينما تحدد الأذونات ما إذا كان إجراء الأداة سيُنفّذ. تبدأ معظم الأذونات بالقيمة allow، لذا اضبطها عمدًا إذا أردت طلب الموافقة. إعداد الأذونات

متى تحتاج إلى إضافات OpenCode؟

الإضافة شيفرة JavaScript أو TypeScript توسّع OpenCode عبر أحداث، مثل تشغيل أداة أو انتقال جلسة إلى حالة الخمول. يمكنك استخدام هذه الآلية لإشعار محلي عند انتهاء العمل أو لمسار عمل خاص بمستودعك. أحداث الإضافات وأمثلتها

ضع الإضافة المحلية في .opencode/plugins/ لمشروع واحد، أو في ~/.config/opencode/plugins/ لجميع المشاريع. يحمّل OpenCode هذه الملفات عند بدء التشغيل. وإذا كانت الإضافة حزمة منشورة على npm، فأضفها إلى مصفوفة plugin في opencode.json؛ تعرض الوثائق أسماء مثل opencode-wakatime. تُثبَّت الحزم والاعتماديات تلقائيًا باستخدام Bun عند بدء التشغيل. راجع مصدر الإضافة وحالة صيانتها قبل إدخال شيفرة قابلة للتنفيذ إلى بيئة تطويرك. تحميل الإضافات

ابدأ بمسار العمل المدمج. أضف إضافة عندما تستطيع تحديد المهمة المتكررة التي ستغنيك عنها. تكثير الإضافات قد يضيف أعباء إعداد وتشخيص أخطاء قبل أن تحصل على أي فائدة.

كم تبلغ تكلفة OpenCode وZen؟

افصل بين مسار عمل الوكيل وفاتورة النموذج. إذا ربطت اشتراكًا قائمًا ومدعومًا، فأنت تستخدم الوصول المتاح في ذلك الحساب. ومع مفتاح API، يحتسب المزوّد التكلفة بحسب الاستخدام. أما الاستدلال المحلي، فتدخل فيه قدرة جهازك وتكاليف تشغيله. Zen خيار مستقل لشراء الوصول إلى النماذج، واستخدامه اختياري. خيارات المزوّدين

OpenCode Zen خدمة نماذج بنظام الدفع حسب الاستخدام. تعلن صفحتها العامة عن رصيد بقيمة $20 مع رسوم معالجة بطاقة تبلغ $1.23؛ أي إن عملية الشراء المعلنة تكلف $21.23، منها $20 متاحة للاستخدام. وتقول الخدمة إنها لا تضيف هامشًا على أسعار الطلبات، وإن حدود الإنفاق الشهري متاحة، وإن الرصيد يُشحن تلقائيًا بمبلغ $20 عندما ينخفض إلى $5. هذه شروط للرصيد والدفع، وليست سعر اشتراك شهري. راجع الشروط الحالية قبل شحن الحساب. صفحة تسعير Zen العامة

للربط، نفّذ /connect، واختر OpenCode Zen، وأكمل إعداد الحساب والفوترة للحصول على مفتاح API. ألصق المفتاح في OpenCode ثم استخدم /models. يظل Zen اختياريًا إذا كان مزوّد آخر يفي باحتياجاتك بالفعل. الاتصال بـ Zen

مثال لحساب تكلفة جلسة عبر Anthropic

يمكن حساب تكلفة جلسة افتراضية تستخدم Claude Sonnet 4.6 عبر API المباشر من Anthropic وفق الأسعار القياسية المنشورة: $3 لكل مليون رمز إدخال و$15 لكل مليون رمز إخراج. الرمز وحدة صغيرة من النص يعالجها النموذج أو ينتجها. لنفترض أن مجموع الجلسة، عبر جميع الطلبات، هو 200,000 رمز إدخال غير مخزّن مؤقتًا و20,000 رمز إخراج. تسعير نماذج Anthropic وأدواتها

هذا حساب رياضي، وليس قياسًا لجلسة OpenCode فعلية أو وعدًا بسعر محدد لإصلاح خطأ. يفترض الحساب أسعار API المباشر القياسية، دون تخزين مؤقت أو رسوم خدمات إضافية. احسب كل ما يدخل في الطلبات، بما فيه التعليمات وسياق المحادثة المتكرر ونتائج الأدوات. لقراءة التخزين المؤقت والكتابة إليه أسعار مختلفة، ويتغيّر المبلغ باختلاف الخدمات والنماذج. ولا يحسب هذا المثال أسعار Zen.

عشرون جلسة بهذا الاستخدام المفترض تكلف إجمالًا $18، وثلاثون جلسة تكلف $27. وللمقارنة، السعر المعلن لـ Claude Pro في الولايات المتحدة هو $20 شهريًا، ويشمل Claude Code ضمن حدود استخدام. يوضح ذلك أين قد تتجاوز ميزانية API المتغيرة سعر اشتراك ثابت لكل مستخدم؛ لكنه لا يثبت تساوي النتائج أو حدود الاستخدام، ولا يحدد الخيار الأرخص لعملك. سعر Claude Pro والفرق بينه وبين API

استخدم opencode stats في سطر أوامر الطرفية لعرض إحصاءات الاستخدام والتكلفة، أو opencode stats --days 1 لليوم الأخير. ولجلسة واحدة، يتيح لك opencode export اختيار الجلسة وتصدير بياناتها بصيغة JSON. طابق الاستخدام مع بيانات الخدمة التي تفوترك؛ فالتقدير القائم على الرموز لا يساوي سعر مهمة مشمولة في اشتراك. أوامر متابعة الاستخدام

ست مهام تستحق التجربة، مرتبة حسب فائدتها العملية

ابدأ بأعمال متكررة تستطيع تقييم نتائجها. هذه مسارات عمل مقترحة، وليست ادعاءات عن توفير وقت جرى قياسه.

يستطيع الأمر غير التفاعلي opencode run تلقّي طلب لتنفيذ عمل ضمن سكربت، بعد إعداد المزوّد ومسار العمل. انتقل إلى الأتمتة المتكررة عندما تتوافر للمهمة طريقة تحقق موثوقة. أمر التشغيل في CLI

متى تختار OpenCode أو Claude Code أو Pi؟

اختر OpenCode إذا كان اختيار النموذج عنصرًا أساسيًا في عملك، وأردت وكيلي Plan وBuild المدمجين مع قواعد المشروع ودعم الإضافات. تمنحك قائمة المزوّدين واجهة عمل موحّدة لخدمات متعددة وإعدادات محلية. هذه توصية تتعلق بمسار العمل، ولا تعني أن الأداة تنتج شيفرة أفضل. نماذج OpenCode، الوكلاء

اختر Claude Code إذا كنت تعمل أساسًا مع Claude وتريد استخدام اشتراك Claude Pro أو Max عبر التكامل الموثّق مع الطرفية أو بيئة التطوير IDE. يشترك Claude وClaude Code في حدود استخدام الخطة. قارن خيارات الفوترة في تسعير Claude Code في 2026. التكامل مع اشتراك Claude

اختر Pi إذا أردت نواة أصغر تبني حولها أسلوب عملك باستخدام الإضافات وقوالب الطلبات والمهارات والسمات. يدعم Pi أيضًا مزوّدين متعددين، لذا لا تكفي مرونة اختيار النموذج وحدها لترجيح OpenCode عليه. وتقول صفحة Pi العامة إن وضع التخطيط يمكن إضافته عبر الإضافات بدل تضمينه في النواة. أوصي بـ OpenCode لمن يريد مسار العمل المتاح جاهزًا، وبـ Pi للمطوّر الذي يريد تصميم جزء أكبر من ذلك المسار بنفسه. نظرة عامة على Pi

ولمقارنة أوسع بين وكلاء الطرفية، اقرأ Gemini CLI مقابل Claude Code. عند المقارنة، قيّم الوصول إلى النماذج ومسار العمل المفضّل وطريقة الدفع كلًّا على حدة.

فكرتان يمكن بناء خدمة حولهما

الفرصة الأقوى: مسار مراجعة خاص بكل مستودع

قد يدفع فريق هندسي صغير مقابل مسار مراجعة يرصد أخطاءه المتكررة ويقدّم ملاحظات مدعومة بأدلة يمكن إعادة إنتاجها. إشارة الاهتمام هنا هي نحو 1,300 عملية بحث شهرية في الولايات المتحدة عن “ai code review”، وفق تقدير الكلمات المفتاحية من DataForSEO الذي جرى التحقق منه في 4 أكتوبر 2026. والسعر المعلن لخطة Essentials لدى CodeRabbit هو $24 لكل مطوّر شهريًا عند الفوترة السنوية، أو $30 عند الفوترة الشهرية، ما يقدّم مرجعًا ملموسًا لفئة خدمات مدفوعة. بيانات الكلمات المفتاحية من DataForSEO، تسعير CodeRabbit

أبسط نسخة قابلة للبيع تحمّل قائمة مراجعة الفريق وتعليمات المشروع، وتفحص الفروق المقدّمة لها، ثم تُخرج تقريرًا مختصرًا يتضمن مواقع الملفات وخطوات التحقق وسجل استخدام النموذج. ابدأ بأمر محلي قابل للتكرار، ثم أضف الاستجابة لأحداث الإضافات فقط حين تقلل العمل اليدوي.

العقبة هي المنافسة والثقة. واجهة مراجعة عامة لا تقدّم ميزة كبيرة مقارنة بالأدوات الموجودة. يحتاج التخصص الواعد إلى قواعد متكررة خاصة بالمجال وإلى دليل على أن اقتراحاته تخفف جهد المراجع. عدد عمليات البحث يدل على الاهتمام بالفئة، لا على الطلب على منتج قائم على OpenCode. وهذه أقوى فرصة هنا لأن المراجعة تتكرر ويمكن تقييم فائدتها بالرجوع إلى فروق فعلية.

حزمة إعداد OpenCode مجرّبة للوكالات

قد تشتري وكالة خدمة إعداد توفّر اتصالًا يعمل مع المزوّد، وملف AGENTS.md دقيقًا، وإعدادًا بالحد الأدنى، ومهمة أولى جرت مراجعتها لكل مستودع عميل. نحو 1,600 عملية بحث شهرية في الولايات المتحدة عن “open source ai coding assistant” تشير إلى الاهتمام بهذه الفئة، بحسب فحص DataForSEO نفسه. بيانات الكلمات المفتاحية من DataForSEO

تكون النسخة الأولية القابلة للتطبيق قائمة خطوات إعداد مع إعدادات خاصة بالمستودع، وتُسلَّم معها طريقة تحقق تعمل ومسار فوترة واضح. تجنّب بناء واجهة عامة أخرى لوكلاء البرمجة. العقبة أن الوثائق المجانية تشرح التثبيت بالفعل، وأن الاهتمام في البحث لا يثبت الاستعداد للدفع. تقاضَ أجرًا على الإعداد الخاص بالعميل والتسليم الذي تواصل صيانته، إذا كانت الوكالات ترى قيمة في هذا العمل.

ما الذي يبقى مسؤوليتك؟

لا يحسم OpenCode ما إذا كان النموذج قد فهم متطلبات عملك. تظل الاختبارات ومراجعة الشيفرة وقرار النشر مسؤوليتك. وعند تغيير المزوّد، تحتاج أيضًا إلى فحص جديد لجودة الناتج والتكلفة الفعلية.

الاستدلال المحلي يستبدل فاتورة النموذج المستضاف بمتطلبات العتاد وأعمال الإعداد. أما واجهة الوكيل التي تعمل محليًا وتتصل بمزوّد سحابي، فترسل طلبات النموذج إلى ذلك المزوّد. حدّد مكان تشغيل الاستدلال بمعزل عن المكان الذي تكتب فيه الطلب.

إذا كان التعديل صغيرًا وتعرف كيف تنفّذه، فقد تستهلك دورة الإعداد والمراجعة انتباهًا أكثر من التعديل نفسه. وإذا كان المشروع غير واضح، فحدّد معايير القبول قبل تكليف الوكيل بالتنفيذ. ما يستحق الاعتماد عليه هو تغيير صحيح جرت مراجعته.

خطوتك يوم الاثنين: اختر خطأ واحدًا يمكن إعادة إنتاجه، وافتح فرعًا جديدًا، واربط مزوّدًا واحدًا، وأكمل دورة القراءة والتخطيط والتعديل والاختبار والمراجعة. سجّل النموذج الذي استخدمته والفحوص التي نجحت وكيف احتُسبت تكلفة الجلسة. هكذا تحصل على دليل تستند إليه في قرارك التالي بشأن الأدوات.

إذا أردت بناء مسار برمجة أو مراجعة خاص بمستودع فريقك، فخدمة تطوير وكلاء الذكاء الاصطناعي هي الخطوة التالية المناسبة.