Node.js دليل تثبيت البيئة
Claude Code وCodex CLI وGemini CLI ومعظم سكريبتات API تعتمد على Node.js. يُنصح بتثبيت النسخة LTS، مع الحفاظ على رقم الإصدار الرئيسي 18 أو أعلى.
ويندوز
الطريقة الأولى: حزمة التثبيت الرسمية
قم بزيارة nodejs.org، وحمّل حزمة التثبيت LTS .msi، واتبع "التالي" حتى اكتمال التثبيت، مع الاحتفاظ بخيار الإضافة التلقائية إلى PATH.
الطريقة الثانية: Chocolatey
choco install nodejs-lts -y
الطريقة الثالثة: سكوب
scoop install nodejs-lts
تحقق بعد إعادة فتح PowerShell:
node --version
npm --version
نظام ماك أو إس
الطريقة الأولى: Homebrew (موصى بها)
brew install node
node --version
npm --version
الطريقة الثانية: حزمة التثبيت الرسمية
قم بزيارة nodejs.org لتحميل macOS .pkg، ثم انقر مزدوجًا على التثبيت وأعد فتح الطرفية.
لينكس
الطريقة الأولى: nvm (موصى بها، لا تحتاج إلى sudo، تدعم عدة إصدارات)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc # لمستخدمي zsh استخدم source ~/.zshrc
nvm install --lts
nvm use --lts
node --version
npm --version
الطريقة الثانية: مدير الحزم
# Debian / Ubuntu
sudo apt update
sudo apt install -y nodejs npm
# Fedora
sudo dnf install -y nodejs npm
الطريقة العامة لتثبيت CLI
npm install -g <package-name>
إذا ظهرت أخطاء صلاحيات، يُنصح أولاً بالتحقق من أن nvm أو إصدار Node الحالي يعمل بشكل صحيح، ولا يُنصح باستخدام صلاحيات المدير لتجاوز مجلدات النظام مباشرة. بعد التثبيت، استخدم where node (ويندوز) أو which node (ماك/لينكس) لتأكيد المسار.