قم بتثبيت OpenCode، وربط أول مزود ذكاء اصطناعي باستخدام /connect، وتهيئة مشروعك بـ AGENTS.md، وتعرف على الواجهات المتاحة — TUI وسطح المكتب وبيئات التطوير.
OpenCode هو وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر، متاح كواجهة طرفية (TUI)، وتطبيق سطح مكتب، وامتداد لبيئات التطوير. يدعم أكثر من 75 مزود نماذج لغوية من خلال AI SDK وModels.dev، مما يعني إمكانية الاتصال بـ Anthropic وOpenAI وGoogle والنماذج المحلية عبر Ollama وأي نقطة نهاية متوافقة مع OpenAI.
حقائق أساسية:
# npm (global)
npm install -g opencode-ai
# Homebrew (macOS/Linux)
brew install anomalyco/tap/opencode
# Yarn
yarn global add opencode-ai
# Bun
bun install -g opencode-ai
# Arch Linux
sudo pacman -S opencodeعلى Windows، يُنصح باستخدام WSL (نظام Windows الفرعي لـ Linux) للحصول على أفضل أداء وتوافق.
# Chocolatey
choco install opencode
# Scoop
scoop install opencode
# npm
npm install -g opencode-aiتعمل واجهة TUI الخاصة بـ OpenCode بشكل أفضل مع محاكيات الطرفيات الحديثة:
الطرفية الافتراضية لـ macOS وWindows Terminal تعملان ولكن قد تفتقران بعض ميزات العرض.
شغّل opencode لفتح واجهة TUI، ثم استخدم /connect لإضافة أول مزود:
OpenCode Zen هي قائمة منتقاة من النماذج المختبرة والموثقة من قِبل فريق OpenCode. تُزيل الحاجة إلى إدارة مفاتيح API لمزودين منفصلين عند البداية.
/connect ← اختر OpenCode Zen/models لعرض قائمة النماذج المنتقاة (تشمل Qwen 3 Coder 480B وغيرها)يتيح لك OpenCode تسجيل الدخول مباشرة باشتراكاتك الحالية — دون الحاجة إلى مفاتيح API منفصلة:
| الاشتراك | طريقة الربط |
|---|---|
| ChatGPT Plus/Pro | /connect ← OpenAI ← ChatGPT Plus/Pro (OAuth) |
| GitHub Copilot | /connect ← GitHub Copilot ← device flow |
| GitLab Duo | /connect ← GitLab ← OAuth |
للاستخدام في CI أو البرمجة النصية، عيّن مفتاح API كمتغير بيئة:
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
# OpenAI
export OPENAI_API_KEY="sk-..."
# أو أي مفتاح مزود — يلتقطه opencode تلقائيًا
opencodeتُخزَّن مفاتيح API المضافة عبر /connect في ~/.local/share/opencode/auth.json — محليًا على جهازك ولا تُزامَن في أي مكان.
انتقل إلى مشروعك وشغّل /init:
ينفذ /init المهام التالية:
احرص على إضافة AGENTS.md إلى Git حتى يستفيد كل أعضاء الفريق وكل جلسات OpenCode المستقبلية من نفس السياق.
بعد ربط مزود، شغّل /models للتبديل:
يستخدم OpenCode نموذجًا صغيرًا (افتراضيًا من Zen) لمهام مساعدة كتوليد عناوين الجلسات. خيار النموذج الرئيسي ينطبق فقط على محادثة البرمجة نفسها.
يُثبَّت OpenCode في ثوانٍ عبر سكريبت التثبيت أو مدير الحزم الخاص بك. يرشدك /connect لإضافة أي من المزودين الـ 75+، أو استخدم OpenCode Zen لتجربة منتقاة بدون تعقيد. شغّل /init في كل مشروع جديد لإنشاء AGENTS.md ملتزم بـ Git يمنح OpenCode سياقًا دائمًا للمشروع. الوحدة التالية تغطي سير العمل الأساسي: وضع التخطيط ووضع البناء ومراجع @file والتراجع/الإعادة.