ai2saveai2save

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 (ماك/لينكس) لتأكيد المسار.