01beginner3 min read دقيقة قراءة
البدء مع Gemini CLI
ثبّت Gemini CLI مفتوح المصدر وسجّل الدخول بحسابك على Google وابدأ أول جلسة برمجة مدعومة بالذكاء الاصطناعي في الطرفية.
التثبيتالمصادقةgoogle-oauthمفتاح-apirepl
ثبّت Gemini CLI مفتوح المصدر وسجّل الدخول بحسابك على Google وابدأ أول جلسة برمجة مدعومة بالذكاء الاصطناعي في الطرفية.
Gemini CLI هو مساعد برمجة بالذكاء الاصطناعي مفتوح المصدر قائم على الطرفية من Google. بخلاف امتدادات المحرر، يعمل مباشرة في shell الخاص بك — تتفاعل معه في REPL تفاعلي، أو تمرر له prompts عبر flags، أو توصّله في pipelines CI.
يستخدم Gemini 2.5 Pro افتراضياً، الذي يتضمن نافذة سياق تبلغ مليون رمز. يمكنك تحميل قواعد أكواد كاملة، ومجموعات توثيق كبيرة، أو ملفات سجل متعددة مباشرة في السياق.
حقائق رئيسية:
ثلاث طرق تثبيت — اختر بناءً على سير عملك:
يدعم Gemini CLI ثلاث طرق مصادقة:
شغّل gemini بدون حجج. في أول تشغيل يفتح متصفحاً لـ OAuth من Google:
حدود الخطة المجانية عبر OAuth:
هذه الحدود سخية بما يكفي لمعظم سير عمل التطوير.
لحدود أعلى أو الأتمتة، أنشئ مفتاح API على aistudio.google.com:
export GEMINI_API_KEY="AIza..."
geminiأو أضف إلى ملف إعدادات shell الخاص بك (~/.zshrc أو ~/.bashrc):
echo 'export GEMINI_API_KEY="AIza..."' >> ~/.zshrc
source ~/.zshrcللاستخدام المؤسسي مع حساب GCP الخاص بك:
export GOOGLE_CLOUD_PROJECT="my-project"
export GOOGLE_CLOUD_LOCATION="us-central1"
gemini --vertexتشغيل gemini (أو gemini في دليل مشروع) يفتح REPL التفاعلي. REPL هو محادثة مستمرة — كل رسالة لها وصول إلى التاريخ الكامل.
لدى Gemini CLI ثلاث قنوات إصدار:
للتبديل بين القنوات:
npm install -g @google/gemini-cli@preview
# أو
npm install -g @google/gemini-cli@nightlyالقناة الثابتة هي @google/gemini-cli بدون tag. استخدم @preview أو @nightly لإصدارات ما قبل الإصدار.
Gemini CLI مثبّت عالمياً ومصادق عليه بحسابك على Google — الخطة المجانية تمنحك 1,000 طلب يومياً مع نافذة سياق مليون رمز. الوحدة التالية تغطي الأدوات المدمجة (نظام الملفات وأوامر shell وجلب الويب وبحث Google) وأوامر slash التي تتحكم في سلوك CLI أثناء الجلسة.