الانتقال إلى المحتوى الرئيسي
يتّبع Forge تصميم شجرة واحدة وثلاثة أبواب أمامية: بيان المُلحق، والمُثبِّت المُقوّى، وثنائي npm العام، جميعها تشير إلى الشجرة نفسها global/ + source/. اختر القناة الملائمة لأداتك.

اختر قناة

المُلحق (موصى به)

لأداتَي Claude Code وCodex. تُوصَل الحواجز تلقائيًا؛ لا شيء يُدمج.

npm العام

لأي أداة. واجهة سطر أوامر forge من سجل npm العام.

تثبيت github:

لا حاجة إلى سجل — ثبّت مباشرة من المستودع.

مساهم / تطوير محلي

استنساخ + npm link، أو bash install.sh لإعداد الروابط الرمزية.

المتطلبات

  • Node.js >= 20
  • صفر تبعيات وقت التشغيل — كل شيء مبني داخل Node. الطبقات الاختيارية (تضمينات FORGE_EMBED، وPlaywright لأمر uicheck visual) اختيارية ولا تضيف أي تبعيات مطلوبة.

سوق المُلحقات

المسار الموصى به لأداتَي Claude Code وCodex لا يحتاج رمزًا ولا استنساخًا:
يوصل المُلحق الحواجز عبر ${CLAUDE_PROJECT_DIR} بحيث تعمل بوّابتا ما قبل الفعل والإكمال بشكل ضمني.

npm العام

لأي أداة، من npm العام:

تثبيت github: دون سجل

مساهم / تطوير محلي

المُثبِّت مُقوّى: عديم الأثر، ومبني على الروابط الرمزية، مع نسخة احتياطية، ودون curl | sh.

التحقّق

مهما كانت القناة التي استعملتها، تأكّد من التثبيت:
يُظهر forge doctor أيضًا إشعارًا غير مُلحّ بشأن “التزامات متأخرة عن المنبع” لعمليات استنساخ git. اضبط FORGE_NO_UPDATE_CHECK=1 لإسكاته. كل مسار يفشل بلطف — دون اتصال أو رأس منفصل يُبلَّغ عن “غير معروف”، لا خطأ.

إبقاء Forge محدَّثًا

والآن أعدّ المستودع

انتقل إلى البدء السريع لتشغيل forge init وأول فحص للركيزة.