Gemini CLI بالعربي 2026: أصلح مشروعك واكتب الكود من الطرفية مجاناً

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

لكن السرعة لها ثمن إن بدأت بطريقة خاطئة. الأداة التي تستطيع قراءة المشروع وتشغيل أوامر تستطيع أيضاً توسيع التعديل، أو إرسال سياق لم تنتبه إلى حساسيته. لذلك لن نبدأ بطلب «ابنِ تطبيقاً كاملاً». سنبدأ بنسخة Git نظيفة، ومجلد موثوق، وتعليمات مشروع قصيرة، ومهمة يمكن قياس نجاحها: إصلاح نموذج تواصل عربي في موقع شركة سعودية مع الحفاظ على RTL والنسخة الإنجليزية.

Gemini CLI بالعربي يصبح مفيداً عندما تتعامل معه كمطور مساعد يعمل داخل حدود واضحة، لا كزر يكتب وينشر الكود وحده.

ما هو Gemini CLI بالعربي وما الذي يميّزه؟

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

هذه القدرة لا تعني صحة النتيجة تلقائياً. جودة العمل تبدأ بنطاق مثل: «افحص سبب انقلاب أيقونة الهاتف في RTL ولا تعدّل خارج مكوّن التواصل واختباره». أما «أصلح الموقع» فيترك مساحة واسعة للتخمين. صاحب المشروع يستطيع استخدام الأداة لفهم المستودع أو إعداد تقرير، لكنه يحتاج مطوراً عند المصادقة والمدفوعات وقواعد البيانات وأي تغيير يمس بيانات العملاء.

إذا كنت تقارنه بأداة أخرى، اقرأ دليل Claude Code بالعربي ومقارنة مساعدي البرمجة. لا تبحث عن فائز مطلق؛ قارن فهم مستودعك، وضوح الموافقات، جودة العربية، التكلفة، وسياسة البيانات.

هل Gemini CLI مجاني فعلاً في 2026؟

توجد طريقة مجانية عملية للاستخدام الفردي عبر تسجيل الدخول بحساب Google. تعرض صفحة الحصص الرسمية الحدود الحالية لكل طريقة مصادقة، ومنها حساب Code Assist الفردي ومفتاح Gemini API المجاني. الأرقام تتغير، لذلك تحقق من المصدر وقت الاستخدام ولا تبنِ ميزانية مشروع على رقم ثابت في مقال.

السؤال الواحد قد يستهلك عدة طلبات عندما يبحث الوكيل ويقرأ وينفذ ويراجع. اكتب هدفاً ومعيار قبول وحدوداً في رسالة واحدة بدلاً من رسائل مبعثرة. الخطة المجانية ممتازة لمشروع شخصي وتجربة خفيفة، لكن الشركة يجب أن تقارن إدارة الهوية، السجلات، شروط البيانات والفصل بين الحساب الشخصي والعمل، لا أن تختار أكبر حصة فقط.

توصي وثيقة المصادقة غالباً بتسجيل الدخول في المتصفح للمستخدم المحلي، بينما يفيد مفتاح API في السيناريو غير التفاعلي. لا تضع المفتاح في مستودع أو برومبت؛ استخدم متغيرات البيئة أو مدير أسرار معتمداً.

تثبيت Gemini CLI على ويندوز خطوة بخطوة

وفق وثيقة التثبيت الرسمية تحتاج Node.js 20 أو أحدث، ويمكن العمل عبر PowerShell. افحص النسخة أولاً، ثم ثبّت الحزمة المستقرة:

node --version
npm --version
npm install -g @google/gemini-cli
gemini --version

إذا كان node غير معروف، ثبّت إصدار LTS من المصدر الرسمي ثم أعد فتح PowerShell. ويمكن التجربة من دون تثبيت دائم عبر npx @google/gemini-cli. في جهاز شركة، اتبع قائمة البرامج المعتمدة ولا تتجاوز إدارة التقنية. استخدم الإصدار المستقر لمعظم الأعمال؛ preview وnightly للاختبار وقد تحمل تغيرات غير مكتملة.

بعد نجاح التثبيت لا تشغّل الأداة من جذر القرص أو مجلد يجمع عدة عملاء. انتقل إلى مستودع واحد، ابدأ gemini، واختر طريقة الدخول المناسبة. الحساب الشخصي لتجربة شخصية، أما كود الشركة فيحتاج حساب العمل ومساراً توافق عليه المؤسسة.

جهّز المشروع قبل أول أمر

افتح المشروع بالطريقة المعتادة وشغّل الاختبارات أو البناء لتعرف الحالة الأساسية. ثم نفذ git status. احفظ التغييرات الحالية في commit واضح أو stash إذا كنت تفهم أثره، وأنشئ فرعاً مثل fix/rtl-contact-form. الفرع أبسط وسيلة تمنع خلط تجربة الوكيل بالنسخة المستقرة.

راجع .gitignore وتأكد من استبعاد .env والسجلات والنسخ الاحتياطية. بعدها ابدأ بطلب قراءة فقط. إذا افترض الوكيل إطاراً غير موجود أو اقترح عشرين ملفاً لمشكلة صغيرة، صحح المسار وقلص الخطة قبل أي تنفيذ.

افحص المشروع للقراءة فقط.
الهدف: فهم خلل اتجاه أيقونة الهاتف ورسالة التحقق في نموذج التواصل العربي.
لا تعدّل ملفات، ولا تثبّت حزم، ولا تنفذ أمراً يغير البيانات.
أعطني البنية، والملفات المرتبطة مع السبب، وطريقة إعادة المشكلة،
ثم خطة تعديل صغيرة ومعايير قبول واختبارات.
اذكر ما لا تعرفه ولا تفترض إعداداً غير موجود.

ملف GEMINI.md: ذاكرة مفيدة وليست مستودع أسرار

يستخدم Gemini CLI ملف GEMINI.md كسياق دائم للمشروع. تشرح الوثائق الرسمية طبقات السياق على مستوى المستخدم والمشروع والمجلد. اكتب قواعد قصيرة قابلة للاختبار: طريقة البناء، أسلوب الكود، حدود الملفات، قواعد العربية وRTL، ومعيار الإنجاز.

# Project
موقع سعودي ثنائي اللغة: العربية RTL والإنجليزية LTR.

# Commands
- Install: npm ci
- Tests: npm test
- Build: npm run build

# Rules
- افحص واقترح خطة قبل التعديل.
- لا تضف حزمة بلا موافقة.
- لا تعدّل .env أو مخطط قاعدة البيانات.
- استخدم نظام الترجمة الموجود ولا تكتب النص داخل المكوّن.
- اختبر RTL وLTR والوصول بلوحة المفاتيح.
- اعرض git diff وما لم تختبره.

راجع الملف عبر pull request لأنه يؤثر في كل جلسة. لا تضع فيه مفاتيح أو أمراً للنشر التلقائي. وإذا كانت مجلدات معينة لها قواعد خاصة، يمكن إضافة سياق أقرب إليها، لكن كثرة الطبقات تربك؛ افحص الذاكرة المحملة فعلياً.

تطبيق عملي: إصلاح نموذج عربي دون كسر الإنجليزية

لدينا موقع شركة خدمات في الرياض. عند اختيار العربية تنقلب أيقونة السهم المطلوبة، لكن أيقونة الهاتف تنقلب أيضاً. ورسالة الخطأ تظهر بصرياً ولا ترتبط بالحقل لقارئ الشاشة. المطلوب إصلاح العيبين مع اختبار يمنع رجوعهما.

أعد المشكلة بنفسك وسجل المسار واللغة وحجم الشاشة. اطلب من الوكيل قراءة المكوّن والأنماط والاختبار والترجمة، ثم تحديد مصدر التحويل. بعد قبول الخطة، اسمح بأصغر مجموعة ملفات. لا تحديث للحزم، ولا إعادة تنسيق عامة. الحل المتوقع يحصر التحويل في سهم الاتجاه ويربط رسالة الخطأ بالحقل وفق نمط الوصول الموجود، ويختبر العربية والإنجليزية.

نفّذ الخطة لإصلاح مشكلتين فقط:
- لا تعكس أيقونة الهاتف في RTL؛ اعكس سهم الاتجاه فقط.
- اربط رسالة التحقق بالحقل وفق نمط الوصول في المشروع.
لا تثبّت حزم، ولا تحدّث lockfile، ولا تعد تنسيق ملفات أخرى.
حافظ على النسخة الإنجليزية وواجهة المكوّن.
حدّث اختباراً يغطي RTL وLTR ورسالة الخطأ.
شغّل الاختبار المستهدف ثم البناء، واعرض ملخص الفرق والمخاطر.

إذا فشل الاختبار، اطلب تفسير الفشل وهل سببه التغيير أم البيئة. لا تطلب محاولات مفتوحة حتى «تصبح خضراء»، فقد يغيّر الوكيل سلوكاً صحيحاً لإسكات الاختبار. ضع سقفاً للمحاولات ثم ارجع للخطة.

الأمان: العزل والثقة والموافقات والاستعادة

الوضع الافتراضي للموافقة مهم لأنه يعرض الأوامر التي تحتاج قبولاً. لا تستخدم الموافقة الكاملة لتوفير نقرات. اقرأ الأمر والمجلد الحالي، وارفض ما لا تفهم أثره. يوفّر وضع العزل الرسمي حاجزاً يقيّد العمليات، لكنه لا يجعل مستودعاً غير موثوق آمناً تلقائياً.

المجلدات الموثوقة تمنع تحميل إعدادات مشروع غريب بصمت عند تفعيلها. المستودع قد يحتوي أوامر وhooks وخوادم MCP. افحصها قبل الثقة. كما توفر نقاط الاستعادة لقطة محلية قبل تعديل الملفات عند تفعيلها. هي طبقة إضافية وليست بديلاً عن Git؛ ولا تتراجع عن أثر خارجي كرسالة أرسلت أو سجل حُذف من خدمة.

راجع الفرق والاختبارات قبل أن تصدق ملخص الوكيل

ابدأ بـgit status ثم git diff --stat. هل عدد الملفات منطقي؟ اقرأ git diff سطراً سطراً وابحث عن حذف غير مقصود، تغيير واجهة عامة، تعطيل اختبار، أو إضافة تبعية. افصل التحسينات الجانبية في تذكرة أخرى حتى يبقى الفرق قابلاً للفهم.

اختبر على طبقات: الاختبار المستهدف، ثم الوحدة المرتبطة، ثم typecheck أو lint، ثم البناء. بعدها اختبر رحلة المستخدم: العربية والإنجليزية، الهاتف، لوحة المفاتيح، ورسالة الخطأ. نجاح الطرفية لا يثبت صحة الشكل أو تجربة قارئ الشاشة. اطلب أيضاً قائمة صريحة بما لم يُختبر.

التغيير الذي يمس المصادقة أو الدفع أو البيانات يحتاج مراجعة إنسان آخر. في فريق صغير قد تكون عشر دقائق، لكن لا تجعل الشخص الذي صاغ الطلب ووافق على التنفيذ هو الحاجز الوحيد. وعند غياب المراجع، قلل النطاق وارفع الاختبارات ولا تنشر وقت الضغط.

الخصوصية والعمل الجماعي في شركة خليجية

لا تمرر مفاتيح الإنتاج، .env، نسخ قواعد البيانات، بيانات الدفع، هويات العملاء، العقود أو سجلات تحتوي رموز جلسات. استخدم بيانات مصطنعة. إذا تسرب سر، لا تكتفِ بحذف الرسالة؛ دوّر المفتاح وافحص السجلات. راجع الشروط والخصوصية الرسمية بحسب طريقة المصادقة.

للفريق، اكتب سياسة من صفحة واحدة: المستودعات المسموحة، البيانات المحظورة، طريقة الدخول، الأوامر التي تحتاج مراجعة ثانية، ومن يوافق على إضافة أو MCP. راجع دليل خصوصية الذكاء الاصطناعي للشركات الخليجية، واستعن بالمسؤول القانوني والأمني عند البيانات الحساسة.

قِس زمن المهمة، حجم الفرق، نجاح الاختبارات من أول مرة، ملاحظات المراجع والأخطاء التي تصل إلى staging. لا تقِس أسطر الكود؛ قد يرتفع الرقم وتنخفض الجودة. التحسن الحقيقي تغيير أصغر وأوضح وأقل أخطاء.

MCP والأتمتة: قوة إضافية تحتاج حدوداً إضافية

يدعم Gemini CLI خوادم MCP التي تضيف أدوات وموارد خارجية. تشرح وثيقة MCP الرسمية كيف تُكتشف الأدوات. يمكنه قراءة تذكرة أو وثيقة، لكنه يوسع الثقة إلى الخادم وصلاحياته والبيانات التي يرسلها.

ابدأ بمصدر قراءة فقط وحساب تجريبي، وحدد أدوات مسموحة بعينها. لا تمرر متغيرات البيئة كلها، ولا تمنح صلاحية مدير حين تكفي القراءة. يشرح دليل MCP بالعربي الحوكمة بتوسع. كل اتصال يجب أن يحل مشكلة محددة، وله مالك وطريقة إلغاء وسجل اختبار.

يفيد الوضع غير التفاعلي في تلخيص نتائج CI، لكن لا تضع الوكيل في خط النشر بصلاحية كاملة. اجعل الناتج تقريراً أو patch يحتاج موافقة، وحدد زمناً ومحاولات قصوى. الأتمتة الجيدة تقلل مهمة معروفة؛ لا تخفي قراراً خطراً خلف أمر واحد.

متى تختار Gemini CLI ومتى لا تختاره؟

اختره إذا كنت تعمل في الطرفية وتريد أداة مفتوحة المصدر تفهم عدة ملفات وتشغّل الاختبارات، وتناسبك خدمات Google. يفيد في استكشاف مستودع، إصلاح صغير، كتابة اختبار أو ترحيل منظم. ويمكن لمستخدمي Google AI Studio الاستفادة منه في سير تطوير محلي، مع إدراك اختلاف المنتجين والحصص.

لا تختَره فقط لأنه مجاني إذا كانت المؤسسة تعتمد بيئة أخرى بإدارة أفضل. ولا تستخدمه على جهاز غير مُدار، أو مجلد تختلط فيه أسرار ومشاريع، أو مشروع لا تستطيع اختباره. قارن نفس التذكرة على فرعين: زمن الفهم، دقة الخطة، حجم الفرق، نجاح الاختبارات وملاحظات المراجع.

• خطأ: تشغيله من مجلد واسع. الصحيح: جذر مستودع واحد.
• خطأ: طلب تطبيق كامل. الصحيح: شرائح بمعايير قبول.
• خطأ: الموافقة الكاملة. الصحيح: مراجعة كل أمر مؤثر.
• خطأ: قبول تنسيق ضخم. الصحيح: فرق صغير نظيف.
• خطأ: الاعتماد على الملخص. الصحيح: قراءة الفرق والاختبار اليدوي.

أسئلة شائعة عن Gemini CLI بالعربي

هل يفهم الأوامر العربية؟

نعم، يمكنك وصف المهمة بالعربية، بينما تبقى أسماء الملفات والدوال بالإنجليزية. استخدم لغة واضحة ومعيار قبول وقواعد RTL. نجاح المهمة يعتمد على اختبارات المشروع بقدر صياغة الطلب.

هل أحتاج خبرة برمجية؟

يمكن للمبتدئ طلب شرح وخطة، لكن تغيير الإنتاج يحتاج فهماً لمراجعة الأمر والفرق والاختبارات. ابدأ بمستودع تجريبي، لا متجر يستقبل طلبات حقيقية.

هل هو مجاني بدون بطاقة؟

يوجد مسار فردي مجاني عبر حساب Google، ومسار API مجاني محدود بحسب الوثائق الحالية. تحقق من الحصص والشروط وقت الاستخدام؛ الحساب المؤسسي مختلف.

هل يعمل محلياً بالكامل؟

البرنامج يعمل على جهازك لكنه يتصل بخدمة النموذج. لا تخلط CLI مع نموذج محلي. إن احتجت معالجة محلية، راجع دليل Ollama بالعربي.

هل العزل يغني عن Git؟

لا. العزل يقيّد التنفيذ ونقاط الاستعادة تساعد، لكن Git سجل التغيير وأداة المراجعة والدمج الأساسية.

ما أول مهمة مناسبة؟

خلل صغير قابل لإعادة الإنتاج، أو اختبار لسلوك قائم، أو شرح مسار بيانات في مشروع مفتوح. تجنب المصادقة والمدفوعات والترحيلات في أول تجربة.

خطة تجربة في 45 دقيقة

1. اختر مستودعاً تجريبياً ونفذ الاختبارات الأساسية.
2. أنشئ فرعاً وحدد مشكلة ومعيار قبول.
3. اطلب فحصاً للقراءة فقط.
4. راجع الخطة وقلص نطاقها.
5. أنشئ أو راجع GEMINI.md.
6. وافق على تعديل محدد وشغّل الاختبار والبناء.
7. اقرأ الفرق واختبر الواجهة وسجل ما لم يُختبر.

إذا تعذر ذلك لأن المشروع لا يملك اختباراً أو طريقة تشغيل موثقة، فهذا أول تحسين حقيقي. الوكيل لا يعوض الأساس الهندسي، لكنه يكشف غيابه بسرعة.

الخلاصة

Gemini CLI بالعربي يختصر رحلة الفهم والبحث والتعديل والاختبار داخل الطرفية. الخطة المجانية تفتح باب التجربة، بينما السياق والعزل والموافقات والاستعادة تمنحك أدوات تحكم. لكنها لا تعمل وحدها: اختر مهمة صغيرة، احمِ البيانات، اقرأ الأوامر، راجع الفرق، واختبر رحلة المستخدم.

ابدأ بإصلاح يمكن وصفه في سطرين، واحتفظ بفرع Git نظيف، واجعل الوكيل يشرح قبل أن يغير. عندما يصبح الناتج أصغر وأسهل للمراجعة وتقل الأخطاء، تكون قد استخدمت الذكاء الاصطناعي لصالح الهندسة. وإذا زاد عدد الملفات والاعتماد على الثقة، فأنت لا تحتاج برومبتاً أطول؛ تحتاج حدوداً أقصر.