ملاحظة المؤلف: OpenCode هو مساعد برمجة مفتوح المصدر يعمل عبر الطرفية (Terminal)، ويدعم مجموعة متنوعة من نماذج اللغة الكبيرة مثل Claude وOpenAI وGemini. يقدم هذا المقال دليلاً كاملاً للتثبيت والتكوين والاستخدام، لمساعدة المطورين الجدد على البدء بسرعة مع هذه الأداة التي يثق بها أكثر من 650 ألف مطور.
هل ترغب في استخدام الذكاء الاصطناعي للمساعدة في البرمجة عبر الطرفية، ولكنك لا تريد التقيد بمزود خدمة واحد؟ OpenCode هو الحل الأبرز مفتوح المصدر حالياً، حيث يتجاوز عدد النجوم على GitHub الـ 70 ألفاً، ويستخدمه شهرياً أكثر من 650 ألف مطور.
القيمة الجوهرية: بنهاية هذا المقال، ستتعلم كيفية تثبيت وإعداد OpenCode، وربطه بنماذج ذكاء اصطناعي متنوعة، وإتقان الوظائف الأكثر عملية في التطوير اليومي.
النقاط الأساسية لمساعد البرمجة بالذكاء الاصطناعي OpenCode
| النقطة | التوضيح | القيمة |
|---|---|---|
| مفتوح المصدر بالكامل | مرخص بموجب MIT، الكود مستضاف على GitHub | استخدام مجاني وقابل للتخصيص بحرية |
| دعم نماذج متعددة | Claude، OpenAI، Gemini، ونماذج محلية | مرونة في اختيار الذكاء الاصطناعي الأنسب |
| الخصوصية أولاً | لا يتم تخزين الكود، ويدعم التشغيل المحلي | مناسب للشركات والمشاريع الحساسة |
| واجهة طرفية أصلية | واجهة TUI أنيقة، تشغيل بأسلوب vim | لا داعي لمغادرة الطرفية، كفاءة أعلى |
| تعاون متعدد الأطراف | هندسة عميل/خادم (Client/Server) | يدعم التشغيل عن بعد والتحكم عبر الهاتف |
ما هو OpenCode
OpenCode هو مساعد برمجة بالذكاء الاصطناعي يعمل عبر سطر الأوامر، تم تطويره باستخدام لغة Go. بخلاف الأدوات التجارية مثل Claude Code وCursor، فإن OpenCode مفتوح المصدر بالكامل، مما يتيح للمطورين حرية اختيار مزود الذكاء الاصطناعي — سواء كان Claude أو OpenAI أو Google Gemini، أو حتى النماذج مفتوحة المصدر التي تعمل محلياً.
يعتمد المشروع على إطار عمل Bubble Tea لبناء واجهة مستخدم طرفية (TUI) أنيقة توفر تجربة تفاعلية سلسة. يمكنك استخدامه داخل VS Code أو Cursor أو أي بيئة تطوير متكاملة (IDE) تدعم الطرفية.
المزايا الأساسية لـ OpenCode
الخصوصية والأمان: لا يقوم OpenCode بإرسال كودك إلى خوادم بعيدة بشكل افتراضي. التحكم في اختيار مزود النموذج ونطاق مشاركة البيانات يقع بالكامل بين يديك. وإذا استخدمت نماذج محلية، يمكن الحفاظ على سرية سير العمل بالكامل.
اختيار مرن للنماذج: رغم أن الخدمة الرسمية توصي بـ OpenCode Zen، إلا أنه يمكنك ربط أي خدمة ذكاء اصطناعي متوافقة بحرية. من خلال منصات التجميع مثل APIYI، يمكنك استخدام واجهة موحدة لاستدعاء نماذج متنوعة مثل Claude وGPT وGemini وغيرها.
دليل تثبيت وتكوين OpenCode
طرق التثبيت
يدعم OpenCode طرق تثبيت متعددة، اختر الطريقة التي تناسب نظامك:
| المنصة | أمر التثبيت | الوصف |
|---|---|---|
| التثبيت التلقائي | curl -fsSL https://opencode.ai/install | bash |
موصى به، يكتشف النظام تلقائياً |
| npm | npm i -g opencode-ai@latest |
الخيار الأول لمستخدمي Node.js |
| Homebrew | brew install opencode-ai/tap/opencode |
لمستخدمي macOS/Linux |
| Scoop | scoop install opencode |
لمستخدمي Windows |
| Chocolatey | choco install opencode |
بديل لمستخدمي Windows |
خطوات التكوين السريع
بمجرد اكتمال التثبيت، اتبع الخطوات التالية للتكوين:
الخطوة الأولى: تشغيل OpenCode
# ادخل إلى دليل مشروعك
cd your-project
# ابدأ تشغيل OpenCode
opencode
الخطوة الثانية: الاتصال بمزود الذكاء الاصطناعي
نفّذ الأمر /connect في واجهة OpenCode، ثم اختر مزود خدمة الذكاء الاصطناعي الخاص بك وأكمل عملية المصادقة.
الخطوة الثالثة: تهيئة المشروع
نفّذ الأمر /init؛ سيقوم OpenCode بتحليل بنية قاعدة الأكواد الخاصة بك وإنشاء ملف التكوين AGENTS.md لمساعدة الذكاء الاصطناعي على فهم سياق المشروع بشكل أفضل.
مثال بسيط للغاية
فيما يلي مثال على تكوين OpenCode باستخدام منصة APIYI:
# إعداد متغيرات البيئة
export OPENAI_API_KEY="your-apiyi-key"
export OPENAI_API_BASE="https://vip.apiyi.com/v1"
# تشغيل OpenCode
opencode
عرض مثال لملف التكوين الكامل
{
"providers": {
"apiyi": {
"apiKey": "your-apiyi-key",
"baseURL": "https://vip.apiyi.com/v1",
"models": [
"claude-sonnet-4-20250514",
"gpt-4o",
"gemini-2.0-flash"
]
}
},
"defaultProvider": "apiyi",
"defaultModel": "claude-sonnet-4-20250514"
}
موقع ملف التكوين:
- macOS/Linux:
~/.config/opencode/config.json - Windows:
%APPDATA%\opencode\config.json
نصيحة للتكوين: احصل على مفتاح API عبر منصة APIYI (apiyi.com)، حيث يمكنك استخدام واجهة موحدة لاستدعاء النماذج الرائدة مثل Claude وGPT وGemini دون الحاجة للتسجيل في حسابات مزودين متعددين بشكل منفصل.
تفاصيل الميزات الأساسية لـ OpenCode
التبديل بين الوضعين
يوفر OpenCode وضعين عمل مدمجين، يمكنك التبديل بينهما بالضغط على مفتاح Tab:
| الوضع | الوظيفة | حالات الاستخدام |
|---|---|---|
| وضع Build | صلاحيات كاملة للقراءة والكتابة، يمكنه تعديل الملفات | التطوير الفعلي وتعديل الكود |
| وضع Plan | وضع للقراءة فقط، للتحليل دون إجراء تعديلات | مراجعة الكود واستكشاف قواعد الأكواد غير المألوفة |
مميزات وضع Plan:
- يرفض عمليات تحرير الملفات افتراضياً.
- يتطلب تأكيداً قبل تنفيذ أوامر bash.
- مثالي لفهم منطق الكود قبل البدء في التعديلات الفعلية.
صيغة الإشارة إلى الملفات
استخدم الرمز @ للإشارة إلى ملفات محددة، مما يمنح الذكاء الاصطناعي سياقاً أكثر دقة:
@src/components/Button.tsx هذا المكون لديه مشكلة في تعريف أنواع props، ساعدني في إصلاحه
الأوامر الشائعة
| الأمر | الوظيفة |
|---|---|
/init |
تهيئة المشروع وإنشاء ملف AGENTS.md |
/connect |
الاتصال بمزود ذكاء اصطناعي أو التبديل بين المزودين |
/undo |
التراجع عن التعديل الأخير |
/redo |
إعادة تنفيذ التعديل الذي تم التراجع عنه |
/share |
إنشاء رابط لمشاركة المحادثة |
/clear |
مسح الجلسة الحالية |
الأوامر المخصصة
يدعم OpenCode إنشاء أوامر مخصصة عبر حفظ الموجهات الشائعة في ملفات Markdown:
<!-- ~/.config/opencode/commands/review.md -->
يرجى إجراء مراجعة للكود في الملف الحالي، مع التركيز على الجوانب التالية:
1. مشاكل الأداء المحتملة
2. الثغرات الأمنية
3. قابلية قراءة الكود
4. مدى الالتزام بأفضل الممارسات
بعد الحفظ، يمكنك تنفيذ الأمر /review في OpenCode لاستدعائه.
ميزات OpenCode المتقدمة
التكامل مع GitHub
يمكن دمج OpenCode مباشرة في سير عمل GitHub. استخدم /opencode أو /oc في تعليقات طلبات السحب (PR) أو المشكلات (Issue) لتفعيله:
- تحليل المشكلات: اجعل OpenCode يفسر ويحلل الـ Issue.
- الإصلاح التلقائي: يعمل OpenCode على فرع جديد، ويقدم طلب سحب (PR) تلقائياً عند الانتهاء.
- تنفيذ آمن: يتم تشغيل جميع العمليات بشكل معزول داخل GitHub Actions Runner.
التكامل مع LSP
يدعم OpenCode بروتوكول خادم اللغة (LSP)، مما يوفر:
- تلميحات ذكية للأكواد بلغات متعددة.
- تشخيص الأخطاء في الوقت الفعلي.
- مراقبة تلقائية لتغييرات الملفات.
دعم بروتوكول MCP
يدعم OpenCode بروتوكول سياق النموذج (Model Context Protocol – MCP)، حيث يمكنك إضافة خوادم MCP مخصصة لتوسيع نطاق وظائف الأداة.
نصائح استخدام OpenCode
مقترحات لسير عمل عالي الكفاءة
| السيناريو | الممارسة الموصى بها |
|---|---|
| استكشاف مشروع جديد | استخدم وضع Plan أولاً لفهم البنية المعمارية |
| إصلاح الأخطاء (Bug) | استخدم @ للإشارة إلى الملفات ذات الصلة |
| إعادة هيكلة الكود | نفذ العمل بخطوات تدريجية، واستخدم /undo للتأكد من كل خطوة |
| مراجعة الكود | انتقل إلى وضع Plan لإجراء تحليل للقراءة فقط |
أفضل الممارسات
- استفد من وضع Plan: عند عدم التأكد، استخدم وضع القراءة فقط للاستكشاف لتجنب التعديلات غير المقصودة.
- أشر إلى الملفات بدقة: استخدم
@filenameلتزويد الذكاء الاصطناعي بالسياق اللازم، مما يجعل النتائج أكثر دقة. - نفذ المهام المعقدة بخطوات: قم بتقسيم المهام الكبيرة إلى أجزاء صغيرة، وأكمل كل خطوة بعد التأكد منها.
- استخدم /init بانتظام: قم بإعادة التهيئة بعد حدوث تغييرات في هيكل المشروع للحفاظ على مزامنة السياق.
الأسئلة الشائعة
س1: ما هي نماذج الذكاء الاصطناعي التي يدعمها OpenCode؟
يدعم OpenCode مزودي خدمات الذكاء الاصطناعي الرئيسيين، بما في ذلك OpenAI (سلسلة GPT)، وAnthropic (سلسلة Claude)، وGoogle (سلسلة Gemini)، وAWS Bedrock، وGroq، وAzure OpenAI وغيرها، كما يدعم النماذج مفتوحة المصدر التي تعمل محلياً.
س2: كيف يمكنني استخدام نماذج متعددة في وقت واحد لإجراء اختبارات مقارنة؟
نوصي باستخدام منصات التجميع مثل APIYI (apiyi.com)، حيث يمكنك استدعاء نماذج مختلفة عبر واجهة برمجية موحدة متوافقة مع OpenAI. كل ما عليك فعله هو تغيير معامل النموذج (model) للمقارنة السريعة بين نتائج Claude وGPT وGemini.
س3: هل يتم إرسال كود OpenCode إلى السحابة؟
يعتمد ذلك على مزود الذكاء الاصطناعي الذي تختاره. إذا كنت تستخدم نموذجاً محلياً، فلن يغادر الكود جهاز الكمبيوتر الخاص بك نهائياً. أما عند استخدام الخدمات السحابية، فيتم إرسال الكود إلى مزود الخدمة المعني لمعالجته، لكن OpenCode نفسه لا يخزن أي بيانات للكود.
س4: كيف أبدأ الاختبار بسرعة؟
نوصي باستخدام منصة تجميع واجهات برمجية تدعم نماذج متعددة للاختبار:
- قم بزيارة APIYI (apiyi.com) وسجل حساباً.
- احصل على مفتاح الواجهة البرمجية (API Key) والرصيد المجاني.
- اتبع أمثلة التكوين المذكورة في هذا المقال لضبط متغيرات البيئة.
- قم بتشغيل
opencodeللبدء.
ملخص
النقاط الأساسية لمساعد البرمجة OpenCode AI:
- مفتوح المصدر ومجاني: مرخص بموجب MIT، حائز على أكثر من 70 ألف نجمة على GitHub، ويثق به أكثر من 650 ألف مطور.
- مرونة تعدد النماذج: يدعم النماذج الرائدة مثل Claude وOpenAI وGemini وغيرها، مع إمكانية التبديل بينها بحرية.
- خصوصية خاضعة للتحكم: لا يمر الكود عبر خوادم OpenCode، ويدعم النماذج المحلية للعمل دون اتصال بالإنترنت تماماً.
- كفاءة وسهولة في الاستخدام: تجربة أصلية في واجهة الأوامر (Terminal)، تبديل بين وضعين، وقدرات تخصيص غنية.
بالنسبة للمطورين الذين يرغبون في استخدام الذكاء الاصطناعي للمساعدة في البرمجة من خلال الجهاز الطرفي، فإن OpenCode هو الحل مفتوح المصدر الأكثر استحقاقاً للتجربة حالياً.
نوصي بتجربة ميزة التبديل السريع بين النماذج عبر APIYI (apiyi.com)، حيث توفر المنصة رصيداً مجانياً وواجهة موحدة بالتنسيقات الأصلية لـ OpenAI وClaude وGemini.
📚 المصادر والمراجع
⚠️ توضيح بخصوص تنسيق الروابط: جميع الروابط الخارجية تستخدم تنسيق
اسم المصدر: domain.comلتسهيل النسخ ولكن دون إمكانية النقر المباشر، وذلك لتجنب فقدان قوة تحسين محركات البحث (SEO).
-
الموقع الرسمي لـ OpenCode: الموقع الرسمي للمشروع، يوفر تحميل حزم التثبيت والوثائق
- الرابط:
opencode.ai - الوصف: للحصول على أحدث الإصدارات والدروس التعليمية الرسمية
- الرابط:
-
مستودع OpenCode على GitHub: الكود المصدري المفتوح ومناقشات المشكلات (Issues)
- الرابط:
github.com/opencode-ai/opencode - الوصف: عرض الكود المصدري وتقديم تقارير عن الأخطاء (Bugs)
- الرابط:
-
وثائق OpenCode الرسمية: دليل تفصيلي للإعداد والاستخدام
- الرابط:
opencode.ai/docs - الوصف: تعمق في الميزات المتقدمة وخيارات التكوين
- الرابط:
-
منصة المطورين APIYI: خدمة تجميع واجهات برمجة التطبيقات (API) لنماذج متعددة
- الرابط:
apiyi.com - الوصف: الحصول على واجهة موحدة لاستدعاء نماذج مثل Claude وGPT وGemini وغيرها
- الرابط:
المؤلف: الفريق التقني
التواصل التقني: نرحب بالنقاش في قسم التعليقات، ولمزيد من المعلومات يمكنكم زيارة مجتمع APIYI التقني عبر apiyi.com
