OpenCode الاستخدام: وكيل مفتوح المصدر، والنماذج الصينية تُوصل بحرية
Claude Code و Codex في الدرسين السابقين مرتبطان على التوالي بنماذج واشتراكات Anthropic و OpenAI؛ في هذا الدرس الذي يستغرق 12 دقيقة، نلقي نظرة على OpenCode من المعسكر مفتوح المصدر — الأداة نفسها مفتوحة المصدر ومجانية، والنماذج تُوصل بحرية: مزوّدون صينيون مثل DeepSeek و Kimi و Zhipu و Tongyi موجودون جميعًا في دليل النماذج الرسمي، فأي مفتاح تملكه يمكنك استخدامه. يركّز هذا الدرس التعليمي لـ OpenCode على واجهة سطر الأوامر بوصفها الشكل الرئيسي — الموقع الرسمي يصفها بأنها «وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر»، وهناك أيضًا نسخة لسطح المكتب ونسخة ويب نمر عليها سريعًا. (وقت التحقق من الحقائق 2026-11-05؛ دليل النماذج والأوامر قد يتغير مع تحديثات الإصدارات، فارجع إلى الوثائق الرسمية.)
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- تثبيت OpenCode CLI على macOS / Linux (وعلى Windows استخدم الملف الثنائي المستقل الرسمي)، وتشغيله بضغطة واحدة من مجلد المشروع
- الاتصال بالنماذج عبر
/connect: مزوّدون صينيون مثل DeepSeek و Kimi و Zhipu و Tongyi موجودون جميعًا في الدليل الرسمي، الصق مفتاح API واستخدمه فورًا - اختيار النموذج عبر
/modelsوإسناد أول مهمة، ومشاهدته يقرأ الملفات ويعدّل الكود وينفّذ الأوامر بنفسه - عمليات سلسة:
@للإشارة إلى الملفات،!لتنفيذ shell مباشرة،/undoللتراجع عن الخطأ - مراقبة الاستخدام عبر
opencode statsوالترقية عبرopencode upgrade، وإدارة بيانات الاعتماد عبرopencode auth
المأزق الذي أنت فيه الآن
- Claude Code يتطلب اشتراك Claude، و Codex يتطلب حساب ChatGPT؛ أما ما لدي جاهز فهو مفاتيح API لـ DeepSeek / Kimi / Zhipu
- الحديث عن الكود في نسخة الويب مع نسخ ولصق الملفات ذهابًا وإيابًا، وبعد التعديل عليّ لصقها بنفسي مرة أخرى
- سمعت أن OpenCode أداة برمجة بالذكاء الاصطناعي مفتوحة المصدر ومجانية، لكن بعد تثبيتها وقفت حائرًا: من أين تأتي النماذج؟ وكيف أستخدم واجهة الطرفية؟
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- وكيل برمجة مفتوح المصدر غير مرتبط بمزوّد نماذج — يقبل أي مفتاح API، والنماذج الصينية تعمل مباشرة
- تشغيل الوكيل في الطرفية باستخدام حساب نموذج صيني جاهز (API بالاستخدام أو باقة Coding Plan)
- أداة مفتوحة المصدر في جوهرها: الكود المصدري متاح علنًا على github.com/anomalyco/opencode، عدّله كما تشاء
ولا تريد:
- الاشتراك في خدمة خارجية خصيصًا لاستخدام وكيل برمجة
- نقل الكود ورسائل الأخطاء ذهابًا وإيابًا في مربع محادثة ويب
- أن تُحبس في منظومة نموذج واحد — اليوم DeepSeek وغدًا Kimi، غيّر المفتاح يتغيّر النموذج
🎒 التحضير قبل البدء
- الاطلاع على دليل الاستخدام اليومي، ومعرفة أن هذه الصفحة تتحدث عن OpenCode من بين الأدوات الأربع (المعسكر مفتوح المصدر)
- حساب نموذج واحد على الأقل: مفتاح API من مزوّد صيني (DeepSeek / Kimi / Zhipu وغيرها)، أو اشتراك ChatGPT Plus / Pro، أو الاتصال أولًا بـ OpenCode Console لتجربة النماذج المجانية — للاطلاع على تكلفة كل مسار انظر مقارنة الأسعار
- مجلد مشروع للتدريب (بحيث تكتب
cdوتبدأ العمل مباشرة) - 12 دقيقة دون مقاطعة
💡 الدرسان السابقان ليسا شرطًا مسبقًا
لا يتطلب هذا الدرس سوى الاطلاع على دليل الاستخدام اليومي. إن Claude Code الاستخدام و Codex الاستخدام مستقلان عن هذا الدرس، لكن مبدأ «وصف المهمة بوضوح كأنك تُسند عملًا» يصلح للجميع.
الفكرة الجوهرية
الموقع الرسمي لـ OpenCode يلخّصه في جملة واحدة: وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر (open source AI coding agent)، وهو متوفر بثلاثة أشكال: طرفية وسطح مكتب وويب. والفرق الجوهري بينه وبين الدرسين السابقين: النماذج غير مرتبطة. Claude Code يعمل بنماذج Claude، و Codex يعمل بنماذج GPT؛ أما OpenCode فهو في جوهره مجرد «قشرة وكيل»، ودليل نماذجه يأتي من models.dev، وفيه أكثر من مئة مزوّد محلي وأجنبي تختار منهم بحرية — وهذا بالضبط ما يجعله الأكثر ملاءمة للمستخدمين في الصين: الدليل يضم عددًا كبيرًا من المزوّدين الصينيين والباقات المحلية.
وبوضعه جنبًا إلى جنب مع الدرسين السابقين:
| Claude Code | Codex | OpenCode | |
|---|---|---|---|
| النماذج | سلسلة Claude | سلسلة GPT | غير مرتبطة: دليل models.dev وفيه أكثر من مئة مزوّد تختار بحرية |
| الدفع | اشتراك Claude أو مفتاح API | اشتراك ChatGPT أو مفتاح API | الأداة نفسها مفتوحة المصدر ومجانية، ورسوم النماذج تُدفع للمزوّد الذي تتصل به (وهناك اشتراك اختياري OpenCode Go) |
| المصدر البرمجي | مغلق المصدر | مغلق المصدر | مفتوح المصدر (github.com/anomalyco/opencode) |
| الشكل | طرفية / IDE / سطح مكتب / ويب | CLI / IDE / سطح مكتب / ويب | طرفية / سطح مكتب / ويب |
الاستخدام في سطر واحد: ** ابدأ بـ /connect لربط الحساب، ثم /models لاختيار النموذج**. هناك أربع طرق لإدخال بيانات الاعتماد:
| طريقة بيانات الاعتماد | كيف تعمل |
|---|---|
| مفتاح API | الصق المفتاح واحفظه كحساب لهذا المزوّد |
| OAuth | يفتح المتصفح أو يستخدم رمز الجهاز للتفويض |
| أمر | شغّل أمر استخراج المفتاح الذي يوفره المزوّد واحفظ المخرجات كمفتاح |
| متغير بيئة | يقرأ المتغير من عملية الخدمة دون حفظه على القرص |
الأشكال الثلاثة في سطر واحد: إلى جانب CLI، يتوفر OpenCode أيضًا بنسخة سطح مكتب (نزّل حزمة التثبيت من الموقع الرسمي) ونسخة ويب (ينشئ opencode pair رابط دخول للاستخدام مرة واحدة، صالح لمدة 5 دقائق ويُلغى بعد أول استخدام) — لن نتوسع فيهما في هذا الدرس، فـ CLI هو المسار الرئيسي.
**كيف تختار بين Claude Code و Codex وكيف تجمع بينها؟ ** إذا أردت استخدام نموذج شركة معينة فاختر أداة تلك الشركة الرسمية؛ أما إذا كان لديك مفتاح نموذج صيني، أو لا تريد الارتباط بنظام بيئي واحد، فإن OpenCode هو الخيار المقابل. الجمع بينها ممكن تمامًا — فجميع الأدوات الثلاث تدعم آلية ملف تعليمات المشروع، ويعتمد OpenCode على AGENTS.md (ويُستخدم نفس الملف بالتبادل مع Codex؛ ومنذ v2.3.1 إذا لم يوجد AGENTS.md في الدليل فسيقرأ CLAUDE.md أيضًا، راجع AGENTS.md و CLAUDE.md)؛ وللاطلاع على المقارنة الكاملة لاختيار الأدوات الأربع انظر مقارنة الأدوات، ولجدول التكاليف الكامل انظر مقارنة الأسعار.
اتبع خطواتي
الخطوة 1: تثبيت OpenCode CLI
لماذا: OpenCode هو أداة سطر أوامر تُثبَّت بشكل مستقل، وكل ما يأتي بعدها يتطلب تثبيتها أولًا.
الطريقة A: سكربت التثبيت الرسمي (موصى به، macOS / Linux)
curl -fsSL https://opencode.ai/v2/install | bashالطريقة B: مدير الحزم (macOS / Linux)
brew install anomalyco/tap/opencode-v2npm install -g @opencode/cliحزمة npm تعتمد على سكربت postinstall لاختيار الملف الثنائي المناسب لمنصتك: يحتاج pnpm إلى سماح صريح (pnpm add -g --allow-build=@opencode/cli @opencode/cli)، ويحتاج bun إلى إضافة ثقة (bun install -g --trust @opencode/cli)؛ وهناك قنوات أخرى مثل yarn و AUR (paru -S opencode-beta) و mise (يتطلب mise الإصدار 2026.10.9 أو أحدث، أما الإصدارات الأقدم فتثبّت OpenCode 1).
لمستخدمي Windows: ملف ثنائي مستقل أو نسخة سطح المكتب
ينص الموقع الرسمي صراحة على أن «مدير حزم Windows غير مدعوم». أمامك طريقان: نزّل الملف الثنائي المستقل لـ CLI من الموقع الرسمي (ملف zip، بنسختي ARM64 / x64) وفك ضغطه للاستخدام مباشرة؛ أو ثبّت تطبيق سطح المكتب مباشرة.
بعد التثبيت، تحقق:
opencode --versionينبغي أن ترى: الطرفية تطبع رقم الإصدار.
- تحقق سريع:
opencode --versionيطبع رقم الإصدار
الخطوة 2: تشغيل OpenCode والتعرف على واجهة الطرفية
لماذا: الشكل الرئيسي لـ OpenCode هو واجهة طرفية بملء الشاشة (TUI)، فتعرّف عليها عند أول تشغيل، فكل العمليات اللاحقة تجري هنا.
cd /path/to/your/project
opencodeينبغي أن ترى: واجهة طرفية بملء الشاشة، مع مربع إدخال في الأسفل. اكتب مباشرة وصف المهمة واضغط Enter للإرسال؛ استخدم Shift+Enter للسطر الجديد (أو Ctrl+Enter / Alt+Enter / Ctrl+J).
لا تريد ملء الشاشة؟ هناك مدخلان آخران:
| المدخل | الأمر | مناسب لـ |
|---|---|---|
| واجهة مصغرة | opencode mini | لمن يفضل مربع إدخال بسيطًا |
| مهمة واحدة للسكربتات / CI | opencode run "Explain this repository" | دون فتح واجهة، والمخرجات تذهب مباشرة إلى الطرفية |
- تحقق سريع: شغّلت
opencodeفي مجلد المشروع ورأيت مربع الإدخال وأمكنني الكتابة
الخطوة 3: OpenCode جوهر الدرس — ربط النماذج الصينية عبر /connect
لماذا: OpenCode لا يتضمن نماذج بذاته، ولا يصبح «حيًا» إلا بعد ربط حسابك. والنماذج الصينية هي تحديدًا نقطة قوته: يضم دليل النماذج الرسمي (المصدر models.dev) عددًا كبيرًا من المزوّدين الصينيين والباقات المحلية — وهذا أكبر سبب لاختياره بدلًا من أداتي الدرسين السابقين.
في الجلسة اكتب:
/connectينبغي أن ترى: قائمة اختيار المزوّدين. اختر مزوّدًا (مثل DeepSeek) والصق مفتاح API حسب التعليمات.
دليل المزوّدين الصينيين (مقتطف؛ كثيرًا ما يكون للمزوّد الواحد عدة إدخالات: نسخة دولية / نسخة محلية / نسخة باقة، فتأكد من الإدخال الذي فعّلته):
| المزوّد | الإدخالات في الدليل (أمثلة) | متغير بيئة بيانات الاعتماد |
|---|---|---|
| DeepSeek | DeepSeek | DEEPSEEK_API_KEY |
| Moonshot AI (月之暗面 Kimi) | Moonshot AI (China) و Kimi For Coding | MOONSHOT_API_KEY / KIMI_API_KEY |
| Zhipu AI (智谱 AI) | Zhipu AI و Zhipu AI Coding Plan و Z.AI | ZHIPU_API_KEY |
| Alibaba Tongyi (阿里通义) | Alibaba (China) و Alibaba Coding Plan | DASHSCOPE_API_KEY / ALIBABA_CODING_PLAN_API_KEY |
| MiniMax | MiniMax (minimax.cn) و MiniMax Token Plan | MINIMAX_API_KEY |
| ByteDance Volcengine Ark (字节火山方舟) | Volcengine Ark و Volcengine Ark Coding Plan | ARK_API_KEY / ARK_CODING_PLAN_API_KEY |
| SiliconFlow (硅基流动) | SiliconFlow (China) | SILICONFLOW_CN_API_KEY |
| Tencent (腾讯) | Tencent Coding Plan (China) | TENCENT_CODING_PLAN_API_KEY |
| StepFun (الصينية) | StepFun (China) | STEPFUN_API_KEY |
| ModelScope | ModelScope | MODELSCOPE_API_KEY |
نأخذ الاتصال بـ deepseek عبر opencode كمثال؛ يمكن الاتصال دون فتح الواجهة (معرّف المزوّد هو الاسم الموجود في الدليل):
opencode auth login deepseek --method keyينبغي أن ترى: مطالبة بإدخال API key، الصقه ثم احفظه كحساب.
تحقق بعد الاتصال:
opencode auth listيجب أن ترى: قائمة بحسابات المزوّدين المتصلين.
💡 لا تملك أي key على الإطلاق؟ ابدأ بتجربة النماذج المجانية الرسمية
بعد التسجيل في OpenCode Console (opencode.ai/console) والاتصال، ستظهر في الدليل مجموعة من النماذج المجانية (مثل GLM-5.3-Flash Free و DeepSeek V4.1 Flash Free)، لتجربة سير العمل دون إنفاق أي مال.
- تحقق صغير: يمكنني رؤية المزوّد الذي اتصلت به للتو في
opencode auth list
الخطوة 4: /models لاختيار النموذج وإسناد أول مهمة
لماذا: الاتصال بالمزوّد يعني فقط «توفر مصدر للبضاعة»، وما زال عليك إخبار OpenCode بأي نموذج سيُستخدم هذه المرة. بعد الاختيار يمكنك إسناد المهام كما في الدرسين السابقين.
في الجلسة اكتب:
/modelsيجب أن ترى: قائمة نماذج المزوّدين الذين اتصلت بهم (مثل DeepSeek V4.1 Flash 1017 ضمن دليل DeepSeek وغيره)، والاختيار يعني التبديل، ويسري على الجلسة الحالية فقط.
أسند أول مهمة — كما في درس Codex، ابدأ بجعله يشرح لك هذا المشروع:
Explain how authentication works in this projectيجب أن ترى: OpenCode يقرأ الملفات بنفسه ويعرض بنية المشروع؛ وعند طلب تعديل الكود يقوم بتحرير الملفات مباشرة، وعند الحاجة للتحقق يشغّل الأوامر محليًا.
لتبديل النموذج في أي وقت استخدم /models (أو اضغط Ctrl+X ثم M؛ وF2 للتنقل بين النماذج المستخدمة حديثًا).
- تحقق صغير: يمكنني رؤية نماذج المزوّد الذي اتصلت به في
/models، وقد اخترت أحدها
الخطوة 5: عمليات يومية سلسة — @ للإشارة إلى ملف، ! لتشغيل أمر، /undo للتراجع
لماذا: سهولة استخدام الوكيل تتوقف على هذه الأفعال الصغيرة. العمليات اليومية لـ OpenCode مجمّعة في جدول واحد:
| ماذا تريد أن تفعل | العملية |
|---|---|
| الإشارة إلى ملف معين | Review @src/auth.ts for error handling problems (يمكن إضافة أرقام الأسطر @src/auth.ts#20-45) |
| تشغيل shell مباشرة | !git status (يبقى الناتج في الجلسة ويمكنه رؤيته) |
| عرض جميع الأوامر | أدخل /؛ وCtrl+P يفتح لوحة الأوامر |
| بدء جلسة جديدة | /new أو Ctrl+X ثم N |
| العودة إلى جلسة قديمة | /sessions |
| التراجع عن الخطأ | /undo يتراجع عن آخر رسالة وما قام به؛ و/redo يستعيد |
| طرح سؤال صغير «غير معتمد» | /btw why did the test in step 2 fail? (الإجابة لا تدخل في السياق) |
يجب أن ترى: @ يفتح قائمة بحث عن الملفات تضيق كلما كتبت أكثر؛ و! يدخل وضع shell، وEsc للخروج دون تنفيذ.
- تحقق صغير: استخدمت
@للإشارة إلى ملف، و!لتشغيل أمر، و/undoللتراجع مرة واحدة
الخطوة 6: إدارة الحسابات والاستخدام والتحديثات
لماذا: OpenCode يعمل بمبدأ «الأداة أداة، ورسوم النماذج تُدفع للمزوّد» — عليك أن تعرف عدد الحسابات المتصلة وأين يُنفق المال.
opencode auth list
opencode stats
opencode stats --costيجب أن ترى: auth list يعرض الحسابات المحفوظة؛ وstats يعطي إحصاءات استخدام قابلة للمشاركة، أضف --cost لعرض تفاصيل التكاليف.
لترقية الإصدار:
opencode upgradeكلمتان عن أمان بيانات الاعتماد: يُخزَّن API key ورمز OAuth في قاعدة بيانات SQLite محلية (استعلم عن المسار بـ opencode debug paths db، وعادةً يكون ~/.local/share/opencode/opencode.db)؛ لا تعدّل قاعدة البيانات يدويًا، فإضافة الحسابات وحذفها تتم دائمًا عبر /connect أو أوامر opencode auth.
- تحقق صغير: يمكنني رؤية استهلاكي في
opencode stats
نقطة تحقق ✅
opencode --versionيطبع رقم الإصدار، ويمكن تشغيل واجهة الطرفية في دليل المشروع/connectاتصلت بمزوّد واحد على الأقل، وopencode auth listيعرضه/modelsاخترت النموذج وأسندت أول مهمة، ورأيته يقرأ الملفات ويعدّلها بنفسه- أعرف استخدام
@للإشارة إلى ملف، و!لتشغيل أمر، و/undoللتراجع opencode statsيعرض الاستخدام، وأعرف أين تُخزَّن بيانات الاعتماد وكيفية إدارتها
تنبيهات للمزالق
❌ لا يمكن التثبيت عبر مدير الحزم على Windows
التوثيق الرسمي واضح: «مدير حزم Windows غير مدعوم». الطريقة الصحيحة: نزّل ملف CLI الثنائي المستقل من الموقع الرسمي (فك ضغط zip)، أو ثبّت تطبيق سطح المكتب؛ لا تضيّع الوقت مع winget / scoop.
❌ حجب السكربتات عند تثبيت حزمة npm عبر pnpm / bun، فلا تعمل بعد التثبيت
تعتمد حزمة npm على سكربت postinstall لاختيار الملف الثنائي المناسب للمنصة؛ pnpm يحجب السكربتات افتراضيًا و bun لا يثق بها افتراضيًا. طريقة السماح: pnpm add -g --allow-build=@opencode/cli @opencode/cli، bun install -g --trust @opencode/cli. لا يتأثر مستخدمو npm.
❌ الشعور بأن «النموذج أصبح أغبى» بعد تسجيل الدخول باشتراك ChatGPT
يضيف OpenCode افتراضيًا حدًّا أعلى للسياق للنماذج التي تُسجَّل الدخول إليها عبر ChatGPT (GPT-6.1 Sol والنماذج الأحدث 500,000، والنماذج الأقدم 272,000)، بما يتوافق مع القيم الافتراضية في Codex، حتى لا يُستهلك استهلاك الباقة بسرعة كبيرة. بدءًا من الإصدار v2.3.1، بعد تسجيل الدخول بحساب ChatGPT تتضمن قائمة النماذج أيضًا GPT 6.2 Sol و GPT 6.2 Astra (بما في ذلك النسخة fast). @@I18N_KEEP_000042@@ إذا كنت تريد فعلًا إزالة هذا الحد، عطّل هذه الإضافة المدمجة في الإعدادات:
{ "plugins": ["-opencode.provider.openai-context-caps"] }(البادئة - تعني تعطيل هذا المكون الإضافي المدمج وحده فقط، دون التأثير على بقية المكونات.)
❌ كتابة API key كنص صريح في ملف الإعدادات ثم دفعه إلى المستودع
يجب حفظ بيانات الاعتماد عبر /connect أو opencode auth login (تدخل قاعدة البيانات المحلية)، أو تمريرها لعملية الخدمة عبر متغيرات البيئة؛ كتابتها في opencode.jsonc ثم دفعها إلى git يعادل ترك المفتاح في الباب. الاستخدام المؤقت بمتغيرات البيئة مقبول أيضًا: DEEPSEEK_API_KEY=<你的key> opencode --standalone.
نصائح متقدمة (اختياري)
اترك للمشروع «دليل استخدام». ضع AGENTS.md في جذر المشروع، واكتب فيه أوامر البناء واتفاقيات الكود ومتطلبات التحقق؛ في كل جلسة يقرأ OpenCode هذا الملف أولًا، أما النسخة العامة فتوضع في ~/.config/opencode/AGENTS.md. بدءًا من الإصدار v2.3.1 (2026-11-18)، يقرأ OpenCode أيضًا CLAUDE.md: إذا لم يكن هناك AGENTS.md في دليل معيّن يقرأ CLAUDE.md في ذلك الدليل، وعند غياب AGENTS.md العام يرجع إلى ~/.claude/CLAUDE.md؛ وإذا لم ترد هذا السلوك الاحتياطي فاضبط متغير البيئة OPENCODE_DISABLE_CLAUDE_CODE. عند وجود النسختين تكون AGENTS.md هي المرجع. للاطلاع على شرح تفصيلي لطريقة الكتابة انظر AGENTS.md و CLAUDE.md: اترك للذكاء الاصطناعي دليل مشروع.
لا ترى ما يحدث في كل خطوة؟ بدءًا من الإصدار v2.3.0 (2026-11-13)، تعمل الوكلاء الفرعيون افتراضيًا في الخلفية ثم تعود لتقديم التقرير بعد الانتهاء؛ كما أصبح سجل واجهة الطرفية أكثر هدوءًا افتراضيًا (session.verbosity افتراضيًا low، وتُطوى سلسلة استدعاءات الأدوات في سطر نشاط واحد). لرؤية كل خطوة، اضبط Verbosity في الإعدادات إلى medium أو high.
اربط نموذجًا محليًا وتعمل بشكل غير متصل تمامًا. إذا كنت قد ثبّت Ollama، فشغّل الخدمة بـ ollama serve واسحب نموذجًا بـ ollama pull qwen3:8b، وسيكتشف OpenCode تلقائيًا النماذج المتوفرة على 127.0.0.1:11434 دون الحاجة إلى ربط حساب؛ كما أن LM Studio و vLLM يدعمان الاكتشاف المدمج.
أضف بنفسك أي مزوّد غير موجود في الدليل. يمكن ربط أي API متوافق مع OpenAI كمزوّد مخصص عبر opencode.jsonc:
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"acme": {
"name": "Acme",
"env": ["ACME_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://llm.acme.example/v1" },
"models": { "qwen3-coder": { "name": "Qwen 3 Coder" } }
}
}
}لديك اشتراك ChatGPT؟ استخدمه مباشرة. اختر OpenAI عبر /connect، ثم اختر طريقة تسجيل الدخول Sign in with ChatGPT — يُحتسب الاستخدام ضمن باقة Plus / Pro الخاصة بك، وتظهر النماذج بدون تكلفة.
تريد «استخدامًا غير محدود باشتراك شهري»؟ انظر OpenCode Go. اشتراك رسمي لحزمة نماذج برمجية: Go $10/شهريًا، Go Plus $40/شهريًا، Go Teams $20/لكل عضو شهريًا؛ بعد الاشتراك من لوحة التحكم تتصل عبر /connect كأي مزوّد عادي. الخيار اختياري تمامًا، وعدم الاشتراك لا يؤثر على أي وظيفة.
التشغيل في السكربتات و CI. ينفّذ opencode run مهمة واحدة دون فتح الواجهة: opencode run --model anthropic/claude-sonnet-5-5 "Refactor parseToken"؛ أضف --continue لمتابعة الجلسة السابقة.
خلاصة هذا الدرس
✅ OpenCode المسار اليومي للدرس التعليمي = تثبيت CLI ← /connect ربط النموذج (اختر أي مزوّد محلي) ← /models اختيار النموذج ← إسناد المهام ← @/!//undo عمليات سريعة ← stats مراقبة الاستخدام.
✅ إنه وكيل مفتوح المصدر غير مرتبط بنموذج معين: الأداة نفسها مجانية ومفتوحة المصدر، ورسوم النماذج تُدفع للمزوّد الذي تتصل به؛ ودليل النماذج المحلية هو الأكثر اكتمالًا — DeepSeek و Kimi و Zhipu و Tongyi و MiniMax و Volcengine Ark و SiliconFlow و Tencent و Step و ModelScope جميعها موجودة.
✅ ثلاثة أشكال: CLI (محور هذا الدرس)، ونسخة سطح المكتب، ونسخة الويب (رابط لمرة واحدة عبر opencode pair، صالح لمدة 5 دقائق).
✅ أربع طرق لربط بيانات الاعتماد (مفتاح API / OAuth / أمر / متغير بيئة)، وتُحفظ بيانات اعتماد الحساب في قاعدة بيانات SQLite محلية (متغيرات البيئة لا تُكتب على القرص)، وتتم الإدارة فقط عبر أمرَي /connect و opencode auth.
✅ دليل المشروع يعتمد على AGENTS.md، ويشترك مع Codex في نفس الملف، فلا حاجة لإعادة كتابته عند تغيير الأداة؛ اعتبارًا من الإصدار v2.3.1، عند عدم وجود AGENTS.md سيتم الرجوع تلقائيًا إلى قراءة CLAUDE.md.
مراجعة العمليات الأساسية:
| العملية | كيف تُنفَّذ | ملاحظات |
|---|---|---|
| التثبيت | curl -fsSL https://opencode.ai/v2/install | bash | بدائل: brew و npm؛ على Windows استخدم الملف الثنائي المستقل |
| التشغيل | في مجلد المشروع opencode | نسخة مبسطة opencode mini؛ للسكربتات opencode run |
| ربط النموذج | /connect اختر المزوّد والصق المفتاح | الطريقة عبر سطر الأوامر opencode auth login <厂商> --method key |
| اختيار النموذج | /models | يسري على الجلسة الحالية فقط؛ F2 يتنقل بين أحدث النماذج |
| إحالة ملف / تشغيل أمر | @src/auth.ts / !git status | @ يمكن إضافة أرقام الأسطر #20-45 |
| التراجع | /undo و /redo | يتراجع عن آخر رسالة وما أنجزه من أعمال |
| عرض الاستخدام | opencode stats و opencode stats --cost | للترقية استخدم opencode upgrade |
استعراض الدرس القادم
بعد كل هذا الاستخدام لسطر الأوامر، الدرس الأخير موجه لمن لا يريدون لمس الطرفية إطلاقًا: WorkBuddy طريقة الاستخدام: منصة عمل ذكاء اصطناعي لسطح المكتب من Tencent.
ستتعلم:
- ما هو WorkBuddy: منصة عمل ذكاء اصطناعي لسطح المكتب من Tencent، يمكن تسجيل الدخول بمسح رمز WeChat
- كيف تجعل الذكاء الاصطناعي يبني مواقع وتطبيقات مصغرة دون كتابة أوامر سطر الأوامر
- كيف تُحسب النقاط وكيف تختار الباقة
- جدول التكاليف الكامل للأدوات الأربع في مقارنة الأسعار