دليل مستخدم Gemini CLI - Google AI في سطر الأوامر لديك

Gemini CLI هي أداة ذكاء اصطناعي مفتوحة المصدر لسطر الأوامر مقدّمة من Google، تجلب قوة Gemini مباشرةً إلى سطر الأوامر لديك. توفر طريقة خفيفة للوصول إلى Gemini، وتقدّم أقصر مسار من الـ prompt إلى النموذج. من خلال تهيئة بروكسي، يمكنك استخدام خدمات Gemini CLI حتى في البيئات المقيّدة بالشبكة.

لماذا تختار Gemini CLI؟#

• Gemini 2.5 Pro قوية: الوصول إلى نافذة سياق بحجم 1 مليون رمز (token)
• أدوات مدمجة: ربط بـ Google Search، عمليات الملفات، أوامر Shell، واستخلاص بيانات الويب (web scraping)
• قابلة للتوسعة: تدعم MCP (Model Context Protocol) للتكاملات المخصّصة
• موجّهة لسطر الأوامر: مصمَّمة للمطورين الذين يعملون في سطر الأوامر
• مفتوحة المصدر: ترخيص Apache 2.0

التثبيت#

التثبيت السريع#

التشغيل الفوري باستخدام npx (بدون تثبيت)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

التثبيت العالمي باستخدام npm#

npm install -g @google/gemini-cli

التثبيت باستخدام Homebrew (macOS/Linux)#

brew install gemini-cli

متطلبات النظام#

• Node.js الإصدار 20 أو أعلى
• macOS أو Linux أو Windows

تهيئة البروكسي#

ضبط متغيرات البيئة#

قبل استخدام البروكسي، قم بتهيئة متغيرات البيئة التالية:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

نصيحة: أضِف متغيرات البيئة هذه إلى ملف .bashrc أو .zshrc أو ملف إعدادات الصدَفة (shell) حتى يتم ضبطها تلقائيًا في كل مرة تفتح فيها سطر الأوامر.

البدء السريع#

الاستخدام الأساسي#

البدء في الدليل الحالي#

gemini

تضمين أدلة متعددة#

gemini --include-directories ../lib,../docs

استخدام نموذج محدّد#

gemini -m gemini-2.5-flash

وضع السكربت غير التفاعلي#

الحصول على رد نصي بسيط:

gemini -p "Explain the architecture of this codebase"

الحصول على مخرجات JSON منظمة:

gemini -p "Explain the architecture of this codebase" --output-format json

أمثلة سريعة#

بدء مشروع جديد#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

تحليل كود موجود#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

الميزات الرئيسية#

فهم الكود وتوليده#

• الاستعلام عن قواعد كود كبيرة وتحريرها
• توليد تطبيقات جديدة من ملفات PDF أو الصور أو الرسومات التخطيطية باستخدام القدرات متعددة الوسائط (multimodal)
• تتبّع الأخطاء واستكشافها باستخدام اللغة الطبيعية

الأتمتة والتكامل#

• أتمتة المهام التشغيلية مثل الاستعلام عن pull requests أو التعامل مع عمليات rebase معقّدة
• ربط قدرات جديدة باستخدام خوادم MCP
• التشغيل بشكل غير تفاعلي داخل سكربتات لأتمتة سير العمل

الميزات المتقدمة#

• الحصول على معلومات لحظية باستخدام Google Search المدمج
• نقاط حفظ للمحادثة (conversation checkpoints) لحفظ واستعادة الجلسات المعقّدة
• ملفات سياق مخصّصة (GEMINI.md) لتخصيص السلوك لمشروعك

الأوامر الشائعة والأمثلة#

استكشاف قاعدة الكود#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

العمل مع الكود الموجود#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

أتمتة سير العمل#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

التفاعل مع النظام#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

التكامل مع GitHub#

استخدم Gemini CLI GitHub Action لدمج Gemini CLI مباشرةً في سير عمل GitHub لديك:

• مراجعات Pull Request: مراجعات كود آلية مع تعليقات سياقية واقتراحات
• فرز القضايا (Issue Triage): تصنيف قضايا GitHub وتحديد أولوياتها تلقائيًا اعتمادًا على تحليل المحتوى
• مساعدة عند الطلب: ذَكْر @gemini-cli في القضايا وطلبات الدمج للحصول على مساعدة في تصحيح الأخطاء أو الشرح أو تفويض المهام
• سير عمل مخصّص: بناء سير عمل آلي ومجدول وعند الطلب يناسب احتياجات فريقك

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

إذا واجهت مشكلات أثناء الاستخدام، فكّر في التالي:

1. التحقق من متغيرات البيئة#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. التحقق من اتصال الشبكة#

curl -I https://crazyrouter.com/

3. التحقق من رسائل الخطأ#

عادةً تشير رسائل الخطأ إلى سبب المشكلة. من المشاكل الشائعة:

• تنسيق مفتاح API غير صحيح
• مشكلات اتصال الشبكة
• تهيئة بروكسي غير صحيحة

4. تنسيق بروكسي SOCKS#

إذا كنت تستخدم بروكسي SOCKS، تأكد أن التنسيق صحيح:

socks5://<user>:<pass>@<proxy>:<port>

5. الإبلاغ عن الأخطاء البرمجية#

استخدم الأمر المدمج للإبلاغ عن المشاكل:

/bug

إصدارات النشر#

Preview#

يتم إصدار نسخ preview جديدة كل يوم ثلاثاء عند الساعة 23:59 بالتوقيت العالمي (UTC):

npm install -g @google/gemini-cli@preview

Stable#

يتم إصدار نسخ stable جديدة كل يوم ثلاثاء عند الساعة 20:00 بالتوقيت العالمي (UTC):

npm install -g @google/gemini-cli@latest

Nightly#

يتم إصدار نسخ nightly يوميًا عند الساعة 00:00 بالتوقيت العالمي (UTC):

npm install -g @google/gemini-cli@nightly

استخدام خوادم MCP#

قم بتهيئة خوادم MCP في الملف ~/.gemini/settings.json لتوسيع Gemini CLI بأدوات مخصّصة:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

الأسعار عبر Crazyrouter#

الوصول إلى نماذج Gemini بأسعار مخفّضة:

تشمل جميع الأسعار خصمًا بنسبة 45% مقارنةً بالأسعار الرسمية.

موارد ذات صلة#

• صفحة أسعار Crazyrouter
• مستودع Gemini CLI على GitHub
• توثيق Google AI

تحتاج مساعدة؟ تواصل مع الدعم أو اطّلع على توثيق Crazyrouter لمزيد من المعلومات.