# كيفية تثبيت واجهة سطر أوامر Gemini على Ubuntu: دليل خطوة بخطوة شامل

دليل خطوة بخطوة لتثبيت واجهة سطر أوامر Google Gemini على Ubuntu. يشمل إعداد Node.js 20+، التثبيت العام عبر npm، المصادقة، التحقق، وإصلاح المشكلات الشائعة على Ubuntu LTS.

Canonical URL: https://a2a-mcp.org/blog/how-to-install-gemini-cli-on-ubuntu-ar

Language: ar

Published: 2026-04-07

Updated: 2026-04-07

## المتطلبات المسبقة

قبل البدء في تثبيت Gemini CLI على Ubuntu، قم بإعداد ما يلي:

- **إصدار Ubuntu**: 20.04 LTS أو أحدث (22.04 و 24.04 و 26.04 مدعومة بالكامل).
- **الوصول الإداري**: امتيازات Sudo لإدارة الحزم.
- **اتصال بالإنترنت**: مطلوب لتنزيل Node.js وحزم npm والمصادقة.
- **حساب Google**: مطلوب لتسجيل الدخول عبر OAuth للوصول إلى نماذج Gemini.
- **الأجهزة الموصى بها**: على الأقل 4 جيجابايت من ذاكرة الوصول العشوائي واثنين من نواة المعالج لضمان أداء سلس أثناء الجلسات التفاعلية.

**المعرفة الأساسية المفترضة**: تعرف كيفية فتح طرفية وتشغيل أوامر `apt` و `bash` الأساسية.

## الخطوة 1: تحديث حزم النظام

ابدأ بتحديث قائمة الحزم الخاصة بك وترقية الحزم الموجودة لمنع تعارضات التبعيات:

```bash
sudo apt update && sudo apt upgrade -y
```

تضمن هذه الخطوة حصولك على أحدث تحديثات الأمان ومعلومات المستودع.

## الخطوة 2: تثبيت Node.js الإصدار 20 أو أحدث

يتطلب Gemini CLI **Node.js الإصدار 20 أو أحدث**. غالبًا ما تتضمن مستودعات Ubuntu الافتراضية إصدارات أقدم (مثل Node 18 على Ubuntu 24.04).

### الطريقة الموصى بها: مستودع NodeSource

```bash
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
```

### بديل: استخدام nvm (مدير إصدارات Node)

لتسهيل إدارة الإصدارات:

```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
nvm alias default 20
```

تحقق من التثبيت:

```bash
node --version
npm --version
```

يجب أن ترى ناتجًا مشابهًا لـ `v20.x.x` لـ Node.js وإصدار npm مطابق.

## الخطوة 3: تثبيت Gemini CLI

### التثبيت العام (موصى به للاستخدام اليومي)

```bash
npm install -g @google/gemini-cli
```

هذا يجعل أمر `gemini` متاحًا على مستوى النظام.

### اختبار سريع بدون تثبيت دائم

إذا كنت تريد تجربته أولاً:

```bash
npx @google/gemini-cli
```

### التثبيت على مستوى المستخدم (لتجنب مشكلات الصلاحيات)

إذا واجهت أخطاء صلاحيات مع التثبيت العام:

```bash
mkdir -p ~/.local/bin
npm config set prefix '~/.local'
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @google/gemini-cli
```

## الخطوة 4: التحقق من التثبيت

تحقق من تثبيت Gemini CLI بشكل صحيح:

```bash
gemini --version
```

من المتوقع أن يُظهر الناتج الإصدار الحالي لـ Gemini CLI.

## الخطوة 5: التشغيل والمصادقة

شغّل CLI للمرة الأولى:

```bash
gemini
```

ستطلب الأداة منك تسجيل الدخول باستخدام حساب Google. ستفتح نافذة متصفح تلقائيًا. أكمل عملية OAuth وعُد إلى الطرفية.

بعد المصادقة الناجحة، يتم تحميل واجهة Gemini CLI التفاعلية. استخدم `/help` لرؤية الأوامر المتاحة.

**الممارسة الأفضل**: انتقل إلى دليل مشروعك قبل التشغيل:

```bash
cd ~/my-project
gemini
```

## المشاكل الشائعة واستكشاف الأخطاء وإصلاحها

- **'gemini: command not found'**: أعد تشغيل الطرفية أو نفذ `source ~/.bashrc`. تحقق من متغير PATH الخاص بك باستخدام `echo $PATH`.

- **Permission denied during npm install**: استخدم طريقة التثبيت على مستوى المستخدم المذكورة أعلاه بدلاً من `sudo npm`.

- **Node.js version error**: أعد تشغيل إعداد NodeSource أو بدّل الإصدارات باستخدام nvm. تأكد باستخدام `node --version`.

- **Authentication fails**: عطّل مانعات الإطارات المنبثقة في المتصفح، تأكد من تمكين الكوكيز، وحاول مرة أخرى. امسح ذاكرة التخزين المؤقت لـ npm إذا لزم الأمر: `npm cache clean --force`.

- **Network timeout or download errors** (مثل: ripgrep prebuilt): تأكد من اتصال إنترنت مستقر. أعد محاولة التثبيت أو استخدم `npx` كحل مؤقت.

- **Missing build tools**: قم بتثبيت تبعيات التطوير:

```bash
sudo apt install -y build-essential python3
```

- **WSL-specific issues**: نفذ الأوامر في طرفية Ubuntu عادية بدلاً من WSL إذا حدثت أخطاء في التجميع.

لمزيد من المساعدة، راجع مستودع GitHub الرسمي: https://github.com/google-gemini/gemini-cli.

## الخطوات التالية

- استكشف الأوامر الأساسية: اكتب `/help`، أو `/model`، أو `/settings` داخل واجهة سطر الأوامر.
- الاستخدام في المشاريع: اطلب من Gemini شرح الكود، إعادة هيكلة الوظائف، أو إنشاء ملفات جديدة باستخدام أوامر اللغة الطبيعية.
- التخصيص: حرّر ملفات الإعداد في `~/.config/gemini-cli/` للسمات، النماذج الافتراضية، والإضافات.
- التحديث المنتظم: نفذ `npm update -g @google/gemini-cli` للحصول على أحدث التحسينات.
- دمج الأدوات: جرّب الإضافات المدمجة وخوادم MCP لسير العمل المتقدمة المستندة إلى الوكلاء مثل دمج git.

أنت الآن جاهز لاستخدام Gemini CLI كمساعد قوي للبرمجة بالذكاء الاصطناعي مباشرةً في طرفية Ubuntu الخاصة بك. ابدأ بطلبات بسيطة في مجلد المشروع وابني تدريجياً مهام وكيل أكثر تعقيداً.

برمجة سعيدة مع Gemini!