# OpenCode: وكيل ذكاء اصطناعي مفتوح المصدر، والتثبيت وربط النماذج
> التثبيت على macOS وLinux وWindows، وOpenCode 1.x و2.0، وربط المزوّدين وOllama، والإعداد، والتكاليف، واستكشاف الأخطاء وإصلاحها.
Source: https://ailoot.ai/blog/ar/opencode-installation-models/
Canonical: https://ailoot.ai/blog/ar/opencode-installation-models/
Language: ar
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-190
Revision: sha256-381ff506aeec756dfb4c82aac64515779bd2843857f30e3a7300f265017cb5fc
OpenCode وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر يعمل في الطرفية: الأداة نفسها مجانية (بترخيص MIT)، ويمكنك ربطها بأي نموذج، من Claude وGPT إلى نموذج محلي عبر Ollama. تجاوز مستودع المشروع بالفعل مئتي ألف نجمة على GitHub. تبدو عبارة «Claude Code مجاني مع أي نموذج» جذابة، لكنها تحتاج إلى توضيح: الأداة مجانية، أما شروط الاستخدام فتعتمد على النموذج الذي تختاره.
فيما يلي كل شيء وفقًا للوثائق الرسمية: ما الأداة، وكيفية تثبيتها على macOS أو Linux أو Windows، وكيفية ربط نموذج، وما الذي ينبغي فعله عند التشغيل لأول مرة. وهناك قسم منفصل عن التكاليف، لأن كلمة «مجاني» هنا تنطبق على الأداة وحدها؛ فالنماذج تكلف مالًا، وهذا أكثر ما يسبب الالتباس.
[تجد في الوثائق معلومات عملية عن العمل مع Ailoot](https://ailoot.ai/docs/).
## ما OpenCode؟ شرح مبسط
النقاط الرئيسية
OpenCode وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر (بترخيص MIT) من فريق Anomaly. يعمل في الطرفية، ويتوفر أيضًا كتطبيق لسطح المكتب وامتداد للمحررات ونسخة ويب. أخبره بما ينبغي إنجازه في مشروع، وسيقرأ الملفات ويعدّل الشيفرة البرمجية وينفذ الأوامر بنفسه. الأداة مجانية، ويمكنك ربط النموذج الذي تختاره، سواء كان سحابيًا أم محليًا.
باختصار، يؤدي OpenCode ما يؤديه Claude Code: تعطيه مهمة بلغة عادية، فينفذها في مشروعك. ويختلفان من ناحيتين. الشيفرة مفتوحة بالكامل، لذا يمكنك قراءتها وفحصها. كما أن الأداة غير مرتبطة بمزوّد نموذج واحد؛ فهي تعمل مع أكثر من 75 مزوّدًا، من Anthropic وOpenAI إلى نموذج محلي يعمل على جهازك.
يطوّر المشروع فريق Anomaly. أُنشئ المستودع في 30 أبريل 2025، واعتبارًا من 4 أكتوبر 2026، لديه [أكثر من 211 ألف نجمة و28 ألف تفرّع](https://github.com/anomalyco/opencode) (جرى التحقق من ذلك بطلب إلى GitHub API). لغة البرمجة هي TypeScript. تُحدّث الوثائق باستمرار، لذا تستند التعليمات أدناه إلى الإصدار الحالي.
لا تخلط بين الأسماء: اسم حزمة npm للخط الحالي هو `opencode-ai`، واسم المستودع `anomalyco/opencode`، أما أمر الطرفية فهو ببساطة `opencode`. قد تستخدم المقالات الأقدم العنوان `sst/opencode`: فقد غيّرت المؤسسة اسمها، ويحوّل الرابط القديم الآن إلى الرابط الجديد.
**تحديث 4 أكتوبر 2026:** أصدر الفريق OpenCode 2.0، وهو الجيل الرئيسي التالي من الأداة. ما زالت تعليمات التثبيت وربط النماذج أدناه مكتوبة للخط الحالي 1.x (الذي يُثبّت بالأمر `curl -fsSL https://opencode.ai/install | bash`؛ والإصدار الحالي اعتبارًا من 30 سبتمبر 2026 هو 1.18.34): فهو يحظى بدعم نشط، وهو الإصدار الذي تثبّته الوثائق الرسمية على opencode.ai/docs. ويتناول قسم منفصل أدناه ما الذي تغيّر تحديدًا في الإصدار الثاني ومتى ينبغي الانتقال إليه.
## ما الفرق بين OpenCode وClaude Code وCodex؟
النقاط الرئيسية
لا يعمل Claude Code إلا مع نماذج Anthropic. أما Codex فهو وكيل من OpenAI مرتبط بمنظومة ChatGPT. وOpenCode أداة مفتوحة لا تقيّدك بمزوّد بعينه: فهي مجانية، ويمكنك اختيار نموذج من أكثر من 75 مزوّدًا، بما في ذلك اشتراكا ChatGPT Plus وGitHub Copilot، فضلًا عن النماذج المحلية.
| الميزة | OpenCode | Claude Code | Codex |
|----|----|----|----|
| الشيفرة | مفتوحة، MIT | مغلقة | مفتوحة |
| النماذج | أكثر من 75 مزوّدًا ونماذج محلية | Claude فقط | نماذج OpenAI |
| سعر الأداة | مجانية | اشتراك أو رموز | اشتراك ChatGPT أو رموز |
| الوصول عبر الاشتراك | ChatGPT Plus وGitHub Copilot وGitLab Duo | Claude Pro/Max (اشتراكك الخاص) | ChatGPT (اشتراكك الخاص) |
| بيئة التشغيل | الطرفية، وسطح المكتب، والمحرر، والمتصفح | الطرفية والمحرر | الطرفية والويب والمحرر |
| إعداد المشروع | AGENTS.md | CLAUDE.md | AGENTS.md |
إذا كان لديك اشتراك Claude بالفعل، فمن المنطقي أن تواصل استخدام Claude Code أداةً رئيسية؛ ولدينا [دليل تثبيت مفصّل](https://ailoot.ai/blog/ar/install-claude-code/) عنه. يناسبك OpenCode في ثلاث حالات: إذا أردت العمل عبر اشتراك ChatGPT Plus أو GitHub Copilot، أو تشغيل نموذج محلي دون فواتير API، أو استخدام واجهة واحدة لعدة نماذج. ولدينا أيضًا [مراجعة ودليل تثبيت](https://ailoot.ai/blog/ar/openai-codex-install/) لـCodex.
إذا كنت لا تزال تختار أداة، فابدأ بهذه النظرة العامة: [بماذا يبرمج الناس في 2026](https://ailoot.ai/blog/ar/ai-coding-tools/). وإذا كان OpenCode مثبتًا لديك بالفعل وتحتاج إلى ربطه بوكلاء آخرين في Devin Desktop عبر ACP، فراجع [دليل إعداد ذلك](https://ailoot.ai/blog/ar/codex-claude-agent-opencode-devin-desktop-acp/).
## ما الذي تغيّر في OpenCode 2.0؟
النقاط الرئيسية
اعتبارًا من 4 أكتوبر 2026، يتوفر OpenCode 2.0 على opencode.ai مع برنامج تثبيت خاص به وحزمة npm الجديدة `@opencode/cli`. لم تختفِ النسخة الأولى، وهي النسخة التي تثبّتها هذه المقالة: فلها فرع `V1` مستقل في الوثائق، وتحظى بدعم نشط، وما زالت الخيار الافتراضي. وفي v2، توجد ثلاثة جوانب تعمّد المطورون فيها عدم الحفاظ على التوافق مع النسخة الأولى: واجهة برمجة التطبيقات الخاصة بالإضافات، وبروتوكول الخادم، وملف إعدادات الطرفية.
يُثبّت الإصدار الثاني بالأمر `curl -fsSL https://opencode.ai/v2/install | bash`. ووفقًا لدليل الترحيل الرسمي (`opencode.ai/v2/docs/migrate-v1`)، يستخدم الإصداران الأمر نفسه `opencode`، ولم يعودا يُثبّتان جنبًا إلى جنب افتراضيًا: إذ يستبدل برنامج تثبيت v2 الملف التنفيذي لـv1، وتطلب الوثائق صراحةً إزالة الإصدار v1 أولًا قبل تثبيت v2 عبر مدير حزم. مع ذلك، تُقرأ الإعدادات من الملفات نفسها، وهي `~/.config/opencode/` و`/.opencode/`، لذلك تنتقل الإعدادات والوكلاء وخوادم MCP دون إعادة كتابة. لكن يلزم إعادة كتابة ثلاثة أشياء: الإضافات (إذ لها واجهة برمجة تطبيقات جديدة)، والتكاملات مع Server API (فقد تغيّر البروتوكول)، وإعدادات الطرفية (فأصبحت الآن في ملف `cli.json` واحد مشترك بدلًا من عدة ملفات `tui.json`).
أبرز ميزتين جديدتين في v2 هما الآتيتان. أولًا، أُطلق Console، وهي خدمة مدفوعة للفرق تشمل تتبّع الاستخدام والميزانيات والسياسات المشتركة بين جميع الأعضاء. ثانيًا، أعلن الفريق أخيرًا سعر اشتراك Go: \$10 شهريًا لـGo و\$40 شهريًا لـGo Plus مع حدود أعلى (صفحة `opencode.ai/go`، جرى التحقق منها في 4 أكتوبر 2026). كان التوثيق سابقًا يكتفي بعبارة «اشتراك منخفض التكلفة» دون ذكر رقم.
إذا كنت جديدًا وتريد تثبيت الوكيل فحسب، فاتبع التعليمات أدناه؛ فهي تغطي النسخة الأولى الحالية التي توصي بها الوثائق نفسها. فكّر في v2 إذا كنت بحاجة إلى ميزات الإضافات الجديدة أو Console للفرق، لكن استعد لإعادة كتابة بعض الإضافات القديمة لتناسب واجهة برمجة التطبيقات الجديدة. أما إذا كنت مهتمًا أكثر بتطبيق سطح مكتب مفتوح المصدر لا يتطلب طرفية، فلدينا [مراجعة ZCode](https://ailoot.ai/blog/ar/zcode-alternative-claude-code/)، وهو وكيل مشابه آخر بواجهة خاصة به.
## ما الذي تحتاج إليه قبل التثبيت؟
النقاط الرئيسية
ستحتاج إلى شيئين: محاكي طرفية حديث (تذكر الوثائق WezTerm أو Alacritty أو Ghostty أو Kitty)، وإمكانية الوصول إلى نموذج، عبر مفتاح API لمزوّد، أو اشتراك مدعوم، أو نموذج محلي من خلال Ollama. ستحتاج إلى النموذج بعد التثبيت، إذ ستربطه عند التشغيل لأول مرة.
إليك مزيدًا من التفاصيل عن الطرفية، لأنها المكان الوحيد الذي قد لا يسير فيه التثبيت كما ينبغي. يعرض OpenCode واجهة كاملة بلوحات وتمييز داخل الطرفية، ولهذا تطلب الوثائق استخدام محاكي حديث. إذا بدا شكل الواجهة غير صحيح بعد التشغيل، فابدأ بتثبيت أحد الخيارات الأربعة المذكورة: WezTerm (يعمل على جميع الأنظمة) أو Alacritty أو Ghostty أو Kitty. أما على Windows، فالمسار الرئيسي يمر عبر WSL، وله قسم خاص أدناه.
والشيء الثاني هو النموذج. يعمل OpenCode من خلال النموذج الذي تربطه؛ فهو لا يعالج الطلبات بمفرده. أمامك أربعة خيارات: اشتراك (ChatGPT Plus أو GitHub Copilot أو GitLab Duo)، أو مفتاح API من أي مزوّد، أو OpenCode Zen، وهو مجمّع النماذج التابع للفريق نفسه، أو نموذج محلي عبر Ollama. وتتناول فقرة ربط النماذج الخيارات الأربعة كلها.
من دون وصف للمشروع، سيضطر الوكيل إلى تخمين أوامر البناء وبنية الملفات والأعراف المتبعة، وهذا ما يؤدي إلى «الهلوسة». يستخدم OpenCode لهذا الغرض ملف AGENTS.md. وينطبق النهج نفسه على Claude Code وأي وكيل آخر؛ فالذي يتغير هو اسم ملف التعليمات فقط.
## كيف تثبّت OpenCode على macOS وLinux؟
النقاط الرئيسية
أمر واحد في الطرفية: curl -fsSL \| bash. تصفه الوثائق بأنه أبسط طريقة. ومن البدائل brew install anomalyco/tap/opencode وnpm install -g opencode-ai، وعلى Arch Linux يمكنك استخدام pacman أو paru.
الطريقة الموصى بها هي برنامج التثبيت الرسمي:
1. ### شغّل برنامج التثبيت
```bash
curl -fsSL https://opencode.ai/install | bash
```
يكتشف البرنامج النصي نظامك وينزّل OpenCode. إذا لم يُعثر على الأمر بعد التثبيت، فأغلق الطرفية وافتحها من جديد؛ فسيُكتشف المسار في الجلسة الجديدة.
2. ### تحقّق من نجاح التثبيت
```bash
opencode --version
```
يعرض الأمر رقم إصدار، ما يعني نجاح التثبيت. أما ظهور الرد «command not found» فيعيدك إلى الخطوة الأولى: ابدأ جلسة طرفية جديدة أو عدّل PATH يدويًا.
إذا كنت تفضّل إدارة الحزم بنفسك، فهذه هي الخيارات:
```bash
brew install anomalyco/tap/opencode
```
```bash
npm install -g opencode-ai
```
يبدأ أمر Homebrew عمدًا بـ`anomalyco/tap/`: توصي الوثائق بـtap الخاص بهم لأن فريق Homebrew يحدّث الصيغة الخاصة بالأمر `brew install opencode` بوتيرة أقل. ويعمل اسم الحزمة نفسه، `opencode-ai`، أيضًا مع bun وpnpm وyarn (`bun install -g opencode-ai` و`yarn global add opencode-ai`). وعلى Arch Linux، استخدم `sudo pacman -S opencode` من المستودع المستقر، أو `paru -S opencode-bin` للحصول على أحدث إصدار من AUR.
حدّث OpenCode بالأمر `opencode upgrade`؛ كما أنه ينزّل التحديثات بنفسه عند تشغيله إذا كان التحديث التلقائي مفعّلًا. وبعد التحديث، تحقّق من الإصدار بالأمر المألوف `opencode --version`. وتتوفر أيضًا إمكانية الإزالة المضمّنة:
```bash
opencode uninstall
```
يعرض الأمر بالتحديد ما سيُحذف ويطلب التأكيد. ويمكنك الاحتفاظ بالإعدادات وبيانات الجلسات إذا رغبت، باستخدام العَلَمين `--keep-config` و`--keep-data`.
## كيف تثبّت OpenCode على Windows؟
النقاط الرئيسية
توصي الوثائق باستخدام WSL لأداء أفضل وتوافق كامل: ثبّت Windows Subsystem for Linux، ثم ثبّت OpenCode داخله باستخدام أمر Linux المعتاد. ومن دون WSL، يمكنك استخدام Chocolatey (`choco install opencode`) أو Scoop (`scoop install opencode`) أو npm أو تطبيق سطح المكتب.
الخيار الأول الذي يوصي به المطورون أنفسهم هو WSL. ثبّته بأمر واحد في PowerShell يعمل بصلاحيات المسؤول:
```powershell
wsl --install
```
بعد إعادة التشغيل، افتح Ubuntu من قائمة ابدأ وشغّل الأمر المعتاد داخله:
```bash
curl -fsSL https://opencode.ai/install | bash
```
يمكن الوصول إلى ملفات أقراص Windows في WSL من خلال `/mnt/`: يوجد القرص C: في `/mnt/c/`، والقرص D: في `/mnt/d/`. لذلك يمكن فتح مشروع موجود في `C:\Users\Name\project` كما يلي:
```bash
cd /mnt/c/Users/Name/project
opencode
```
الخيار الثاني هو تجاوز WSL واستخدام مديري حزم Windows. في PowerShell:
```powershell
choco install opencode
```
```powershell
scoop install opencode
```
أما الخيار الثالث فهو تطبيق سطح المكتب ونسخة الويب. يُثبّت التطبيق كأي برنامج عادي ويعرض الواجهة في نافذة، دون طرفية. وتبدأ نسخة الويب بالأمر `opencode web`: فهي تفتح OpenCode في متصفح، كما توصي الوثائق بتشغيلها من WSL أيضًا لتجنّب مشكلات الوصول إلى الملفات. وتذكر الوثائق خيارات أقل شيوعًا، هي mise وDocker والملف التنفيذي الجاهز من صفحة إصدارات GitHub. ولا يزال التثبيت عبر bun على Windows قيد العمل؛ فإذا كان bun مدير الحزم الأساسي لديك، فاستخدم خيار npm.
## كيف تربط نموذجًا بـOpenCode؟
النقاط الرئيسية
في واجهة الطرفية، اكتب `/connect` واختر مزوّدًا من القائمة: OpenCode Zen للبدء دون مفاتيحك الخاصة، أو Anthropic أو OpenAI باستخدام مفتاح API، أو ChatGPT Plus أو GitHub Copilot باشتراك، أو Ollama لنموذج محلي. تُحفظ المفاتيح في ملف auth.json؛ واختر نموذجًا محددًا باستخدام `/models`.
يدعم OpenCode أكثر من 75 مزوّدًا عبر AI SDK وModels.dev، إضافة إلى النماذج المحلية. يُربط معظمها باستخدام الأمر `/connect` داخل الواجهة؛ أما النماذج المحلية، فتحتاج أيضًا إلى تحديد عنوان الخادم في الإعدادات. وتختلف الخيارات في طريقة الدفع ومتطلبات الحاسوب:
| الخيار | ماهيته | التكلفة |
|----|----|----|
| OpenCode Zen | مجمّع نماذج اختارها فريق OpenCode | الدفع مقابل كل طلب، مع شحن الرصيد |
| OpenCode Go | خطة اشتراك من الفريق للنماذج المفتوحة | \$10 شهريًا (Go) أو \$40 شهريًا (Go Plus، بحدود أعلى) |
| مفتاح API | Anthropic وOpenAI وGoogle وDeepSeek وغيرها | تدفع للمزوّد مقابل الاستخدام |
| اشتراك | ChatGPT Plus وGitHub Copilot وGitLab Duo | مدفوع مسبقًا |
| Ollama / LM Studio | نموذج محلي على جهازك | لا فواتير API، لكنك تحتاج إلى حاسوب مناسب |
توصي الوثائق المبتدئين بالبدء باستخدام OpenCode Zen. فقد اختار الفريق نماذج تعمل جيدًا خصوصًا بوصفها وكلاء، واختبر تركيباتها مع المزوّدين على مهامه الخاصة.
يجري الربط على النحو التالي: أدخل `/connect`، واختر OpenCode Zen، وسجّل الدخول وأضف وسيلة دفع على opencode.ai/auth، ثم احصل على مفتاح والصقه. بعد ذلك، سيعرض `/models` قائمة النماذج الموصى بها. وتتضمن القائمة، اعتبارًا من 4 أكتوبر 2026، مثلًا GPT 6.1 Sol وGPT 6 Astra وClaude Opus 5.5 وClaude Sonnet 5 وGLM 5.3 وKimi K2.5. وتحذّر الوثائق بصراحة من أن القائمة غير شاملة وتقادمها سريع، لأن نماذج جديدة تصدر كل أسبوع.
تُربط الاشتراكات باستخدام الأمر `/connect` نفسه: اختر ChatGPT Plus أو GitHub Copilot من القائمة وسجّل الدخول إلى حسابك، دون إعداد إضافي.
إذا اخترت Anthropic، يعرض `/connect` خيارين: إدخال مفتاح API يدويًا، أو اختيار Claude Pro/Max والمصادقة عبر المتصفح. لكن Anthropic تحظر استخدام إضافات الجهات الخارجية لاستخدام اشتراك Claude Pro/Max، وقد أزيلت الإضافات المضمّنة من هذا النوع من OpenCode بدءًا من الإصدار 1.3.0. إذا صادفت مقالًا أقدم عن «استخدام OpenCode عبر اشتراك Claude»، فهو يشير إلى تلك الإضافات التي أزيلت، لا إلى تفويض رسمي. وتعمل اشتراكات ChatGPT Plus وGitHub Copilot وGitLab Duo (الموسوم بأنه تجريبي) وAtomic Chat دون إعداد إضافي.
يحفظ OpenCode المفاتيح التي تُدخلها عبر `/connect` في الملف `~/.local/share/opencode/auth.json`. وإذا كنت لا تريد اختيار نموذج في كل مرة، فعيّن النموذج الافتراضي في ملف الإعداد `opencode.json` في جذر المشروع:
```json
{
"$schema": "https://opencode.ai/config.json",
"model": "anthropic/claude-sonnet-4-5"
}
```
التنسيق هو `provider/model`؛ ويظهر المعرّفان في مخرجات `/models`.
## كيف تربط نموذجًا محليًا عبر Ollama؟
النقاط الرئيسية
ثبّت Ollama من ollama.com، ونزّل نموذجًا باستخدام الأمر `ollama pull`؛ إذ يمكن لـOllama إعداد نفسه تلقائيًا للعمل مع OpenCode. أما الطريقة اليدوية فهي إضافة مزوّد إلى `opencode.json` بعنوان الخادم المحلي . اختر النموذج باستخدام `/models`. وإذا لم يستدعِ الوكيل الأدوات، فارفع `num_ctx` في Ollama إلى 16k–32k.
يعني هذا الخيار عدم وجود أي فواتير API: فالنموذج يعمل على حاسوبك. وإذا كنت تختار عمومًا بين النماذج المجانية، فلدينا [مراجعة منفصلة](https://ailoot.ai/blog/ar/free-coding-models/) للنماذج التي تعمل جيدًا إلى حد معقول كوكلاء، وتلك التي تفعل ذلك نظريًا فقط. لاستخدام OpenCode، ثبّت Ollama من الموقع الرسمي ونزّل نموذجًا:
```bash
ollama pull qwen3-coder
```
من التفاصيل المفيدة في الوثائق أن Ollama يمكنه إعداد نفسه تلقائيًا للعمل مع OpenCode؛ وله دليل تكامل مستقل. وإذا أردت إعداد كل شيء يدويًا، فأضف إلى `opencode.json` مزوّدًا يتضمن عنوان خادم Ollama المحلي:
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"ollama": {
"npm": "@ai-sdk/openai-compatible",
"name": "Ollama (local)",
"options": {
"baseURL": "http://localhost:11434/v1"
},
"models": {
"qwen3-coder": {
"name": "Qwen3 Coder"
}
}
}
}
}
```
بعد ذلك، سيظهر النموذج المحلي في قائمة `/models` داخل الواجهة. اختره وابدأ العمل. ومن التنبيهات العملية في الوثائق: إذا توقف الوكيل عن استدعاء الأدوات (تعديل الملفات أو تنفيذ الأوامر)، فارفع `num_ctx` في إعدادات Ollama، وابدأ بقيم تتراوح بين 16k و32k. النماذج المحلية أضعف من النماذج السحابية في مهام الوكلاء تحديدًا، وصغر السياق يزيد الأمر سوءًا. وإذا لم تكن النسخة المحلية كافية، يمكنك ربط Qwen السحابي باستخدام مفتاح؛ ويشرح دليل [كيفية الحصول على مفتاح API لـQwen Code](https://ailoot.ai/blog/ar/qwen-code-api-key/) أين تجده.
## كم تبلغ تكلفة OpenCode واستخدامه؟
النقاط الرئيسية
OpenCode نفسه مجاني: شيفرته المصدرية منشورة بموجب ترخيص MIT. أنت تدفع ثمن النموذج فقط: حسب الاستخدام الفعلي عبر مفتاح API أو Zen، أو عبر اشتراك Go، أو من خلال اشتراك ChatGPT Plus أو Copilot الذي لديك، أو لا شيء إطلاقًا، إذ إن الطلبات إلى نموذج محلي عبر Ollama مجانية.
تتعلق جميع التكاليف هنا بالنموذج، وهناك أربعة سيناريوهات. باستخدام مفتاح API أو Zen، تدفع مقابل الاستخدام الفعلي، ويعتمد المبلغ على مقدار عمل الوكيل. Go خطة اشتراك للنماذج المفتوحة من فريق OpenCode: \$10 شهريًا لـGo و\$40 شهريًا لـGo Plus مع حدود أعلى (جرى التحقق من صفحة `opencode.ai/go` في 4 أكتوبر 2026). يعتمد الحد على النموذج: فعلى سبيل المثال، يتيح Go نحو 110 طلبات كل 5 ساعات (440 شهريًا) لـKimi K3، ونحو 26,000 طلب كل 5 ساعات لـDeepSeek V4.1 Flash الأخف. وللوصول إلى نموذج محدد بعد تجاوز الحد، تذكر الوثائق سعرًا منفصلًا (\$15 شهريًا لـKimi K3 و\$60 لـGo Plus). راجع صفحة الاشتراك عند الربط للاطلاع على القائمة الكاملة للنماذج والحدود. مع ChatGPT Plus أو Copilot، تُغطّى الطلبات بالاشتراك الذي تدفع ثمنه بالفعل؛ لكن تذكّر أن للاشتراكات حدودًا خاصة بمعدل الاستخدام. وأخيرًا، لا تكلف الطلبات إلى نموذج محلي عبر Ollama شيئًا، لكنك تحتاج إلى حاسوب قوي بما يكفي لتشغيله بسرعة.
## ماذا ينبغي أن تفعل عند التشغيل لأول مرة؟
النقاط الرئيسية
انتقل إلى مجلد مشروعك، وشغّل opencode، واستخدم الأمر `/init`؛ سيفحص الوكيل المشروع وينشئ ملف AGENTS.md لوصفه. قبل تعديل أي شيء، اضغط على Tab للتبديل إلى وضع Plan؛ إذ سيقترح حلًا ويعرض التعديلات لموافقتك. تراجع عن الإجراءات الخاطئة باستخدام `/undo`.
التشغيل لأول مرة، من داخل مجلد مشروعك:
```bash
cd path/to/project
opencode
```
تُفتح الواجهة مع حقل إدخال. ابدأ باستخدام الأمر `/init`: يفحص الوكيل ملفات المستودع المهمة، ويطرح سؤالين إذا لزم الأمر، ثم يكتب ملف AGENTS.md، وهو دليل يصف بنية المشروع والأوامر المستخدمة للبناء والاختبارات والأعراف المتبعة. وتوصي الوثائق بإضافة هذا الملف إلى git؛ عندها يستخدمه OpenCode تعليمات دائمة للمشروع. ومن حيث الغرض، يعادل AGENTS.md ملف CLAUDE.md مباشرة ضمن منظومة OpenCode.
ثانيًا، استخدم وضع Plan. يبدّل مفتاح Tab بين الوكيلين الرئيسيين: يعمل Build بصلاحية كاملة للوصول إلى الملفات والأوامر، بينما خُصص Plan للتحليل والتخطيط؛ وتتطلب تعديلات الملفات وأوامر bash في وضع Plan موافقتك افتراضيًا. وتوصي الوثائق ببدء المهام الجديدة بخطة: اقرأ ما ينوي الوكيل فعله، وعدّل الصياغة، ثم ارجع إلى Build باستخدام Tab.
تقدم الوثائق هذه النصيحة:
من المفيد أن تتحدث إليه كما تتحدث إلى مطوّر مبتدئ في فريقك.
— وثائق OpenCode الرسمية، https://opencode.ai/docs/
كلما كانت المهمة أكثر تحديدًا وقدّمت سياقًا أوفر، قلّ ما ستحتاج إلى إعادة العمل عليه. أضف ملفات إلى الطلب باستخدام `@`: ابدأ بكتابة اسم، وستعثر عليها الواجهة عبر البحث التقريبي. يمكنك سحب الصور مباشرة إلى الطرفية، وتُنفّذ الرسالة التي تبدأ بـ`!` كأمر shell ويُضاف ناتجها إلى سياق الوكيل. إذا أخطأت في وصف المهمة أو نفّذ الوكيل شيئًا خاطئًا، يعيد `/undo` التغييرات إلى ما كانت عليه، ويمكنك تشغيله عدة مرات متتالية. هل غيّرت رأيك مجددًا؟ يعيد `/redo` ما أُلغي. وينشئ `/share` رابطًا لمحادثة يشاركها فريقك؛ ومن دون هذا الأمر، لا تُنشر المحادثة في أي مكان.
## ما الأشياء الأخرى التي يستطيع OpenCode فعلها؟
النقاط الرئيسية
أوامر مخصصة من ملفات markdown في مجلد `.opencode/commands`، ووكلاء فرعيون للمهام المتوازية وقراءة الشيفرة، وخوادم MCP للأدوات الخارجية، ونسخة ويب في المتصفح، ووضع الخادم للعمل عن بُعد.
**الأوامر المخصصة.** يمكن تحويل أي طلب متكرر إلى أمر: ضع ملف markdown في `.opencode/commands/`، واضبط `description` و`agent` و`model` في مقدمته، ثم اكتب قالب prompt أدناه. بعد ذلك، استدعِ الأمر باستخدام `/`. يمكن أن يكون أي شيء تطلبه بانتظام: فحوصات المشروع قبل النشر، أو مراجعة الأخطاء الأخيرة، أو إنشاء ترحيل.
**الوكلاء الفرعيون.** بالإضافة إلى Build وPlan، هناك ثلاثة آخرون: General للمهام متعددة الخطوات (يصل إلى جميع الأدوات باستثناء قائمة المهام)، وExplore لقراءة الشيفرة سريعًا دون إذن بالتعديل، وScout للبحث عن المكتبات الخارجية. استدعهم بذكر أسمائهم عبر `@` في رسالة.
**خوادم MCP.** اربط أدوات خارجية عبر قسم `mcp` في ملف الإعداد `opencode.json`؛ فكل من الخوادم المحلية والبعيدة مدعوم. يضيف كل خادم MCP أدواته إلى السياق، وقد يستهلك خادم كثير الأدوات مثل GitHub مساحة السياق بسرعة كبيرة؛ لذا لا تربط إلا ما تحتاج إليه. لدينا [دليل بإعدادات جاهزة](https://ailoot.ai/blog/ar/mcp-servers-claude-code/) لمفهوم MCP؛ وهو مكتوب عن Claude Code، لكن البروتوكول مشترك.
**نسخة الويب والخادم.** يفتح `opencode web` الواجهة في المتصفح. وللوصول من جهاز آخر، استخدم `opencode serve --hostname 0.0.0.0 --port 4096`؛ وعند إتاحة الوصول عبر الشبكة، احرص على ضبط كلمة مرور باستخدام المتغير `OPENCODE_SERVER_PASSWORD`. فالخادم غير محمي من دون كلمة مرور.
## ماذا تفعل إذا تعذّر التثبيت؟
النقاط الرئيسية
تعود معظم المشكلات إلى ثلاثة أسباب: تعذّر العثور على الأمر `opencode` (ابدأ جلسة طرفية جديدة أو عدّل PATH)، أو عدم استجابة النموذج (تحقّق من المفتاح في `/connect` ومن ملف `auth.json`)، أو ظهور الواجهة بشكل خاطئ (استخدم طرفية حديثة مثل WezTerm). ابدأ استكشاف الأخطاء من السجلات في `~/.local/share/opencode/log/`.
**ظهور “opencode: command not found” بعد التثبيت.** لم تتعرّف الطرفية على المسار الجديد بعد. أولًا، أغلق الطرفية وافتحها من جديد. وإذا لم ينجح ذلك، فاعثر على المجلد الذي وضع فيه برنامج التثبيت الملف التنفيذي، وأضف هذا المجلد إلى PATH الخاص بطرفيتك.
**النموذج لا يستجيب أو يعرض خطأ في التفويض.** تحقّق من اتصال المزوّد: أدخل `/connect` وأعِد المصادقة. تُخزّن المفاتيح في `~/.local/share/opencode/auth.json`؛ فإذا نقلت التثبيت من جهاز آخر أو حذفت مجلدات، فقد يكون الملف مفقودًا. تتناول الوثائق خطأي ProviderInitError وAI_APICallError كلًا على حدة: أعد تفويض المزوّد في الحالة الأولى، وأفرغ مجلد `~/.cache/opencode` وأعد التشغيل في الحالة الثانية.
**الواجهة معطوبة: اللوحات مبعثرة أو تظهر أحرف غير مقروءة بدلًا من الرموز.** ابدأ بفحص الطرفية. ثبّت أحد الخيارات الموصى بها — WezTerm يعمل على الأنظمة الثلاثة — وشغّل OpenCode منها.
إذا لم ينفع شيء، فتحقّق من السجلات: تجدها على macOS وLinux في `~/.local/share/opencode/log/`؛ أما على Windows، فاضغط Win+R وأدخل `%USERPROFILE%\.local\share\opencode\log`. ويُحتفظ بأحدث عشرة ملفات؛ فعّل التسجيل المفصل باستخدام العَلَم `opencode --log-level DEBUG`. باستخدام هذه السجلات، يمكنك إرسال بلاغ عن خطأ في مستودع المشروع على GitHub.
## ما الأسئلة الأخرى التي يطرحها الناس عن OpenCode؟
النقاط الرئيسية
إجابات سريعة عن الأسئلة الشائعة: OpenCode أداة مجانية، وتدفع ثمن النموذج فقط. يُربط Claude Pro/Max عبر `/connect`، وتُحظر إضافات الجهات الخارجية لهذا الغرض. ويمكنك الوصول إليه من هاتفك عبر نسخة الويب. ويُحدّث OpenCode بالأمر `opencode upgrade`.
### الأسئلة الشائعة
هل OpenCode مجاني؟
نعم، شيفرته المصدرية منشورة بموجب ترخيص MIT. قد تدفع مقابل النموذج؛ وتجد جميع الخيارات في القسم السابق عن التكاليف.
هل يمكنني ربط اشتراك Claude Pro/Max؟
نعم، يوفّر Anthropic خيار Claude Pro/Max رسميًا في `/connect`، مع المصادقة عبر المتصفح. أما المقالات الأقدم عن استخدام اشتراك Claude عبر الإضافات فقد أصبحت قديمة: فـAnthropic تحظر هذه الإضافات، وقد أزيلت من OpenCode بدءًا من الإصدار 1.3.0.
هل يتوفر OpenCode على الهاتف؟
الخيار المتاح هو نسخة الويب: شغّل `opencode serve` على حاسوب أو خادم، ثم اتصل من متصفح هاتفك. ويلزم تعيين كلمة مرور باستخدام `OPENCODE_SERVER_PASSWORD` لأي وصول عبر الشبكة.
بماذا يتفوق OpenCode على Claude Code؟
يعتمد ذلك على نماذجك واشتراكاتك: يتكامل Claude Code مع نماذج Anthropic، بينما يوفر OpenCode أكثر من 75 مزوّدًا وشيفرة مفتوحة المصدر ونماذج محلية. راجع الجدول أعلاه للاطلاع على مقارنة كاملة.
هل ينبغي أن أثبّت OpenCode 2.0 فورًا؟
ليس بالضرورة. توصي الوثائق افتراضيًا بالنسخة الأولى الحالية، وهي النسخة التي تُثبّت بالأمر curl -fsSL https://opencode.ai/install \| bash الوارد في هذا الدليل. يتوفر الإصدار الثاني منذ 4 أكتوبر 2026، لكن الإضافات والتكاملات مع Server API تعمل فيه بشكل مختلف، وستحتاج إلى إعادة كتابة بعض الشيفرة.
[افتح Ailoot](https://ailoot.ai/).
## أسئلة شائعة
### لماذا لا يوفر تثبيت OpenCode نموذجًا يعمل؟
الأداة والوصول إلى النماذج منفصلان. اربط مزودًا أو اشتراكًا مدعومًا عبر /connect أو اضبط نموذجًا محليًا، ثم اختر النموذج في /models وتحقق من مهمة مشروع محدودة.
### ماذا أفحص قبل الانتقال من OpenCode 1.x إلى 2.0؟
افحص توافق الإضافات وتكاملات API للخادم وإعدادات الطرفية. يحددها الدليل كمجالات ترحيل؛ تحقق من الإصدار المثبت واحتفظ بالإعدادات والجلسات قبل استبدال الملف التنفيذي.
## Ailoot · الشركة ومحفظة مشاريعها
تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.
الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.
توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.