مقدمة
OpenCode هو وكيل ترميز بالذكاء الاصطناعي مفتوح المصدر. يتوفر كواجهة terminal، وتطبيق لسطح المكتب، أو إضافة لبيئة تطوير متكاملة (IDE).

لنبدأ.
المتطلبات
لاستخدام OpenCode في terminal، ستحتاج إلى:
-
محاكي terminal حديث مثل:
-
مفاتيح API لمزوّدي نماذج اللغة (LLM) الذين تريد استخدامهم.
أسهل طريقة لتثبيت OpenCode هي عبر سكربت التثبيت.
curl -fsSL https://opencode.ai/install | bashيمكنك أيضا تثبيته عبر الأوامر التالية:
-
باستخدام Node.js
npm install -g opencode-aibun install -g opencode-aipnpm install -g opencode-aiyarn global add opencode-ai -
باستخدام Homebrew على macOS وLinux
الطرفيةbrew install anomalyco/tap/opencodeنوصي باستخدام tap الخاص بـ OpenCode للحصول على أحدث الإصدارات. صيغة
brew install opencodeالرسمية تُدار بواسطة فريق Homebrew ويتم تحديثها بوتيرة أقل. -
باستخدام Paru على Arch Linux
الطرفيةsudo pacman -S opencode # Arch Linux (Stable) paru -S opencode-bin # Arch Linux (Latest from AUR)
Windows
-
باستخدام Chocolatey
الطرفيةchoco install opencode -
باستخدام Scoop
الطرفيةscoop install opencode -
باستخدام NPM
الطرفيةnpm install -g opencode-ai -
باستخدام Mise
الطرفيةmise use -g github:anomalyco/opencode -
باستخدام Docker
الطرفيةdocker run -it --rm ghcr.io/anomalyco/opencode
دعم تثبيت OpenCode على Windows باستخدام Bun قيد العمل حاليا.
يمكنك أيضا تنزيل الملف التنفيذي من صفحة Releases.
مع OpenCode يمكنك استخدام أي مزود LLM عبر إعداد مفاتيح API الخاصة به.
إذا كنت جديدا على استخدام مزوّدي LLM، فنوصي باستخدام OpenCode Models. إنها قائمة منتقاة من النماذج تم اختبارها والتحقق منها بواسطة فريق OpenCode.
-
شغّل الأمر
/connectفي واجهة TUI، واختر opencode، ثم انتقل إلى opencode.ai/auth./connect -
سجّل الدخول، وأضف تفاصيل الدفع، ثم انسخ مفتاح API.
-
الصق مفتاح API.
┌ API key │ │ └ enter
بدلا من ذلك يمكنك اختيار أحد المزوّدين الآخرين. اعرف المزيد.
بعد أن قمت بإعداد مزوّد، يمكنك الانتقال إلى المشروع الذي تريد العمل عليه.
cd /path/to/projectثم شغّل OpenCode.
opencodeبعد ذلك، هيّئ OpenCode للمشروع عبر تشغيل الأمر التالي.
/initسيجعل هذا OpenCode يحلل مشروعك ويُنشئ ملف AGENTS.md في جذر المشروع.
يساعد هذا OpenCode على فهم بنية المشروع وأنماط الترميز المستخدمة.
أصبحت الآن جاهزا لاستخدام OpenCode للعمل على مشروعك. لا تتردد في سؤاله أي شيء!
إذا كنت جديدا على استخدام وكيل ترميز بالذكاء الاصطناعي، فإليك بعض الأمثلة التي قد تساعد.
يمكنك أن تطلب من OpenCode شرح قاعدة الشيفرة لك.
How is authentication handled in @packages/functions/src/api/index.tsيفيد هذا عندما تكون هناك أجزاء من قاعدة الشيفرة لم تعمل عليها.
يمكنك أن تطلب من OpenCode إضافة ميزات جديدة إلى مشروعك، لكننا نوصي أولا بطلب إنشاء خطة.
-
أنشئ خطة
لدى OpenCode وضع Plan يعطل قدرته على إجراء التغييرات، ويقترح بدلا من ذلك كيف سينفّذ الميزة.
انتقل إليه باستخدام مفتاح Tab. سترى مؤشرا لذلك في الزاوية السفلية اليمنى.
التبديل إلى وضع Plan<TAB>الآن لنصف ما نريده أن يفعله.
When a user deletes a note, we'd like to flag it as deleted in the database. Then create a screen that shows all the recently deleted notes. From this screen, the user can undelete a note or permanently delete it.احرص على تزويد OpenCode بتفاصيل كافية ليفهم ما تريد. يساعد أن تتحدث إليه كما لو كنت تتحدث إلى مطور مبتدئ ضمن فريقك.
-
حسّن الخطة
بعد أن يقدم لك خطة، يمكنك إعطاؤه ملاحظات أو إضافة تفاصيل أكثر.
We'd like to design this new screen using a design I've used before. [Image #1] Take a look at this image and use it as a reference.يستطيع OpenCode فحص أي صور تزوده بها وإضافتها إلى الطلب. يمكنك فعل ذلك عبر سحب الصورة وإفلاتها داخل terminal.
-
ابنِ الميزة
عندما تشعر بالارتياح للخطة، عد إلى وضع Build بالضغط على مفتاح Tab مرة أخرى.
الطرفية<TAB>ثم اطلب منه تنفيذ التغييرات.
الطرفيةSounds good! Go ahead and make the changes.
للتغييرات الأبسط، يمكنك أن تطلب من OpenCode تنفيذها مباشرة دون الحاجة لمراجعة خطة أولا.
We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.tsتأكد من تقديم قدر مناسب من التفاصيل لكي يجري OpenCode التغييرات الصحيحة.
لنفترض أنك طلبت من OpenCode إجراء بعض التغييرات.
Can you refactor the function in @packages/functions/src/api/index.ts?لكن تتضح لك لاحقا أنها ليست ما تريده. يمكنك التراجع عن التغييرات باستخدام الأمر /undo.
/undoسيقوم OpenCode الآن بعكس التغييرات التي أُجريت ويعرض رسالتك الأصلية مجددا.
Can you refactor the function in @packages/functions/src/api/index.ts?من هنا يمكنك تعديل الطلب وطلب المحاولة مرة أخرى.
أو يمكنك إعادة تنفيذ التغييرات باستخدام الأمر /redo.
/redoوهذا كل شيء! أصبحت الآن محترفا في استخدام OpenCode.
لتجعله مناسبا لك، نوصي بـ اختيار سمة، وتخصيص اختصارات لوحة المفاتيح، وإعداد منسقات الشيفرة، وإنشاء أوامر مخصصة، أو التجربة مع إعدادات OpenCode.