كيفية استخدام Google Gemini 2.5 Pro مع Open Codex CLI

Open Codex CLI هو أداة مفتوحة المصدر تجلب قوة نماذج اللغة الكبيرة (LLMs) مباشرة إلى سير العمل في محطة الأوامر الخاصة بك. يركز هذا الدليل بشكل خاص على الاستفادة من أحد أكثر النماذج تقدمًا المتاحة اليوم – جيميني 2.5 برو من جوجل – ضمن بيئة Open Codex CLI.

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

تقدم هذه المقالة دليلًا شاملًا خطوة بخطوة لتثبيت وتكوين واستخدام Open Codex CLI تحديدًا مع جيميني 2.5 برو (بالإشارة إلى gemini-2.5-pro-preview-03-25 نسخة النموذج المتاحة في وقت الكتابة، كما هو محدد في تكوين Open Codex CLI) ونماذج شقيقة مثل gemini-2.0-flash. سواء كنت مطورًا محترفًا يتطلع إلى تحسين سير العمل الخاص بك أو مبتدئًا في مساعدين البرمجة بالذكاء الاصطناعي، ستتعلم كيفية الاستفادة من هذه المجموعة القوية.

لماذا Open Codex CLI مع جيميني؟

هذا مذهل. خلال بضع ساعات فقط، قام صديقي بفصل Open AI Codex ليعمل مع جيميني 2.5 برو 🤯 pic.twitter.com/gENT01q82P

— Sawyer Hood (@sawyerhood) 17 أبريل 2025

يجمع استخدام Open Codex CLI مع جيميني 2.5 برو مجموعة مقنعة من الفوائد:

• سير العمل القائم على المحطة: بالنسبة للمطورين الذين يفضلون سطر الأوامر، يوفر Open Codex CLI تكاملاً سلسًا. لا حاجة للتبديل بين محررك، ومحطة الأوامر، ونافذة متصفح منفصلة للمساعدة بالذكاء الاصطناعي. يؤدي هذا إلى تكرار أسرع وقليل من الانقطاعات.
• مفتوح المصدر ومرن: كأداة مفتوحة المصدر (open-codex على npm)، توفر الأداة الشفافية وإمكانية المساهمات المجتمعية. يدعم قدرتها على العمل مع مزودين متعددين (جيميني، OpenAI، OpenRouter، أولاما) يمكنك من المرونة لتغيير النماذج أو المزودين حسب الحاجة دون تغيير أدواتك الأساسية.
• قدرات ذكاء اصطناعي قوية: يجلب جيميني 2.5 برو تفكيرًا متطورًا، وتوليد كود، وقدرات فهم. يتيح ذلك مهامًا أكثر تعقيدًا، واقتراحات أفضل لجودة الكود، وتحليلات أعمق مباشرة في سطر الأوامر.
• مركز على العمل: على عكس الروبوتات البسيطة، تم تصميم Open Codex CLI للعمل. يمكنه قراءة الملفات المحلية لديك للحصول على سياق، واقتراح تعديلات على الملفات (تصحيحات)، وتنفيذ أوامر شل ضمن حاوية آمنة، مما يمكّن التطوير المدفوع بالدردشة الحقيقي.
• مركز على الأمان: يدمج CLI آليات حاويات (حزام الأمان على أنظمة macOS، موصى به Docker على Linux) لتنفيذ العمليات التي قد تكون خطرة مثل أوامر الشل بأمان، خاصة عند استخدام أوضاع الموافقة التلقائية. يدير الأوامر مع تعطيل الشبكة وعزل الدليل افتراضيًا في أوضاع الاستقلالية العليا.
• توافق مع التحكم في النسخ: تم تصميم الأداة للعمل جنبا إلى جنب مع Git. افتراضيًا، تتطلب الموافقة قبل تعديل الملفات، مما يسمح لك بمراجعة التغييرات قبل أن تؤثر على دليل عملك، مما يضمن وجود شبكة أمان دائمًا.

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

قبل أن تبدأ، تأكد من أنك تمتلك:

1. نظام التشغيل: macOS 12 أو أحدث، توزيع Linux حديث (مثل Ubuntu 20.04+، Debian 10+)، أو Windows 10/11 باستخدام Windows Subsystem for Linux (WSL2). لا يتوفر دعم مباشر لنظام Windows.
2. Node.js: مطلوب الإصدار 22 أو أحدث. يوصى عمومًا باستخدام إصدارات LTS (الدعم الطويل الأجل). يمكنك التحقق من إصدارك عن طريق تشغيل node -v في محطة الأوامر الخاصة بك. قم بتنزيل Node.js من nodejs.org.
3. حساب Google Cloud & مفتاح API الخاص بجيميني: ستحتاج إلى مفتاح API للمصادقة على الطلبات الموجهة إلى نماذج جيميني. يمكنك الحصول على واحد من Google AI Studio أو Google Cloud Console. احتفظ بهذا المفتاح بشكل آمن، حيث أنه مرتبط بحسابك.
4. المعرفة الأساسية بتشغيل المحطة: يُفترض أن لديك معرفة أساسية بكيفية استخدام واجهة سطر الأوامر لنظامك (Terminal، iTerm، Bash، Zsh، إلخ).

الخطوة 1: تثبيت Open Codex CLI

الطريقة الموصى بها لتثبيت Open Codex CLI هي بشكل عالمي عبر npm (مدير حزم Node)، الذي يأتي مدمجًا مع Node.js. افتح محطة الأوامر الخاصة بك ونفذ:

npm install -g open-codex

بدلاً من ذلك، إذا كنت تستخدم Yarn كمدير حزم، يمكنك تشغيل:

yarn global add open-codex

يعمل هذا الأمر على تنزيل حزمة open-codex وجعل أمر open-codex متاحًا من أي مكان في محطة الأوامر الخاصة بك. تجنب استخدام sudo للتثبيتات العالمية لـ npm؛ إذا واجهت مشكلات في الأذونات، فمن الأفضل إصلاح أذونات npm.

يمكنك التحقق من التثبيت عن طريق تشغيل open-codex --version أو open-codex --help.

الخطوة 2: تكوين الوصول إلى جيميني

لاستخدام نماذج جيميني، يحتاج Open Codex CLI إلى مفتاح API الخاص بك ويحتاج إلى معرفة أنك تريد استخدام مزود gemini. هناك طريقتان رئيسيتان لتكوين ذلك:

الطريقة 1: متغير البيئة (موصى به للبدء السريع/الاختبار)

أسهل طريقة لتقديم مفتاح API الخاص بك هي من خلال متغير البيئة. يبحث Open Codex CLI على وجه التحديد عن GOOGLE_GENERATIVE_AI_API_KEY عندما يتم اختيار مزود gemini.

في محطة الأوامر الخاصة بك، نفذ الأمر التالي مع استبدال "YOUR_API_KEY_HERE" بمفتاح API الخاص بجيميني الحقيقي:

export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE"

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

لتجعل مفتاح API متاحًا بشكل دائم، تحتاج إلى إضافة سطر export إلى ملف تكوين الصدفة لديك. تشمل الملفات الشائعة:

• ~/.zshrc (لـ Zsh، الافتراضي على إصدارات macOS الحديثة)
• ~/.bashrc أو ~/.bash_profile (لـ Bash)

أضف السطر export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE" إلى الملف المناسب، واحفظه، ثم قم إما بإعادة تشغيل المحطة الخاصة بك أو تشغيل source ~/.zshrc (أو المسار ذي الصلة) لتطبيق التغييرات.

يمكنك بعدها تحديد جيميني كمزود في كل مرة باستخدام علامة --provider:

open-codex --provider gemini "ما هي عاصمة فرنسا؟"

الطريقة 2: ملف التكوين (موصى به للتثبيت المستمر)

لإعداد أكثر ديمومة، خاصة إذا كنت تخطط لاستخدام جيميني بشكل متكرر، يمكنك استخدام ملف تكوين Open Codex CLI. يبحث CLI عن ملف تكوين في ~/.codex/config.json.

قم بإنشاء الدليل إذا لم يكن موجودًا: mkdir -p ~/.codex

قم بإنشاء وفتح ملف التكوين: nano ~/.codex/config.json (أو استخدم محرر النصوص الذي تفضله).

أضف المحتوى التالي بصيغة JSON لتحديد جيميني كمزود افتراضي:

{
  "provider": "gemini"
}

يمكنك أيضًا تعيين نموذج جيميني افتراضي إذا رغبت. يحدد Open Codex CLI gemini-2.5-pro-preview-03-25 كنموذج "عملي" افتراضي وgemini-2.0-flash كنموذج "كامل السياق" افتراضي لجيميني. لتعيين النموذج القوي 2.5 برو كنموذج افتراضي لمعظم التفاعلات، استخدم:

{
  "provider": "gemini",
  "model": "gemini-2.5-pro-preview-03-25"
}

احفظ الملف واخرج من المحرر.

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

مع ضبط ملف التكوين، يمكنك الآن ببساطة تشغيل open-codex وسيتحول للاستخدام المزود المحدد جيميني:

open-codex "ما هي عاصمة فرنسا؟"

الخطوة 3: الاستخدام الأساسي مع جيميني

الآن بعد أن تم تثبيت Open Codex CLI وتكوينه لجيميني، دعنا نستكشف كيفية التفاعل معه.

الوضع التفاعلي (REPL)

للحصول على تجربة شبيهة بالمحادثة، قم بتشغيل CLI بدون موجه محدد:

open-codex
# أو إذا لم تقم بتعيين المزود الافتراضي في config.json:
# open-codex --provider gemini

يبدأ هذا حلقة القراءة والتقييم والطباعة (REPL) حيث يمكنك كتابة الموجهات، والحصول على الاستجابات، وإجراء محادثة مستمرة مع جيميني.

❯ open-codex --provider gemini
مرحبًا بك في Open Codex CLI! اكتب طلبك ثم اضغط على Enter مرتين للإرسال.
> حدثني عن نموذج جيميني 2.5 برو.

اضغط Enter مرتين لإرسال الموجه. سيستجيب جيميني في المحطة. يمكنك متابعة المحادثة من خلال كتابة الأسئلة المتابعة.

المطالبة المباشرة

لطلبات لمرة واحدة، يمكنك تمرير الموجه مباشرة كوسيط. إذا لم تكن قد قمت بتعيين القيم الافتراضية في config.json، ستحتاج إلى علم المزود. يمكنك أيضًا تحديد النموذج الدقيق باستخدام علم --model أو -m:

• باستخدام النموذج الافتراضي لجيميني (إذا تم تعيينه في config):

open-codex "اشرح مفهوم الإغلاق في بايثون."

• بتحديد المزود والنموذج بشكل صريح:

open-codex --provider gemini --model gemini-2.5-pro-preview-03-25 "اكتب نص برمجي bash للعثور على جميع الملفات التي تزيد عن 10MB في الدليل الحالي ومجلداته الفرعية."

• باستخدام نموذج جيميني مختلف (مثل Flash لمهام أسرع/أرخص):

open-codex --provider gemini --model gemini-2.0-flash "تلخيص النقاط الرئيسية في وثائق React حول الرافعات."

سيقوم CLI بمعالجة الطلب مع جيميني ويطبع الاستجابة مباشرة على الإخراج القياسي.

الخطوة 4: الاستفادة من ميزات Open Codex مع جيميني

تكمن القوة الحقيقية لـ Open Codex CLI في قدرتها على التفاعل مع بيئة التطوير المحلية لديك، بتوجيه من جيميني.

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

يمكن لجيميني، عبر Open Codex CLI، قراءة الملفات في مشروعك الحالي للحصول على سياق لطلباتك. يمكنه أيضًا اقتراح تغييرات (كتابات أو تصحيحات) على ملفاتك.

• قراءة الملفات: عندما تذكر أسماء الملفات في موجهك، غالبًا ما يقرأ CLI هذه الملفات تلقائيًا لتوفير السياق لجيميني.

# افترض أن لديك ملفًا يسمى 'calculate.js'
open-codex --provider gemini "اقرأ 'calculate.js' واقترح تحسينات للقراءة."

• كتابة/تصحيح الملفات: إذا طلبت من جيميني تعديل ملف، سيقوم CLI بإنشاء فرق (ملخص للتغييرات المقترحة) وسيسأل عن موافقتك قبل تطبيق أي شيء.

open-codex --provider gemini "أضف دالة جديدة تسمى 'subtract' إلى 'calculate.js' تأخذ حجتين وتعيد فرقها."

سيقوم CLI بإخراج التغييرات المقترحة وسؤال: هل تريد تطبيق التصحيح؟ [y/N]. اضغط y للقبول أو n للرفض.

تنفيذ الأوامر

يمكن لOpen Codex CLI أيضًا تنفيذ أوامر الشل المقترحة من جيميني. هذه ميزة قوية لكن تتطلب الحذر.

• أوضاع الموافقة: تتحكم علامة --approval-mode (أو -a) في مستوى الاستقلالية:
• suggest (افتراضي): يتطلب الموافقة الصريحة على كل تغييرات الملفات وكل أوامر الشل. موصى به للبدء.
• auto-edit: يطبق تغييرات الملفات تلقائيًا ولكنه لا يزال يطلب الموافقة على أوامر الشل.
• full-auto: يطبق تغييرات الملفات تلقائيًا ويقوم أيضًا بتنفيذ أوامر الشل (داخل الحاوية). استخدم بحذر شديد، خاصة في المستودعات غير الموثوق بها.
• العزل: في وضع auto-edit وfull-auto، يتم تشغيل الأوامر مع تعطيل الشبكة وم confined to the current working directory and temporary files for security.
• مثال (مع الوضع الافتراضي 'suggest'):

open-codex --provider gemini "قم بتثبيت مكتبة 'requests' باستخدام pip."

قد يقترح جيميني الأمر pip install requests. سيقوم CLI بعرض الأمر وسؤال: هل تريد تشغيل الأمر؟ [y/N].

سياق المشروع (codex.md)

يمكنك توفير تعليمات أو سياق دائم حول مشروعك لجيميني من خلال إنشاء ملفات codex.md. يقرأ CLI هذه الملفات بالترتيب:

1. ~/.codex/instructions.md (تعليمات شخصية عامة)
2. codex.md عند جذر المستودع الخاص بك (ملاحظات عبر المشروع)
3. codex.md في الدليل العامل الحالي (ملاحظات خاصة بالمجلد الفرعي)

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

نصائح وحيل لحل المشكلات

• أخطاء مفتاح API: تأكد من أن GOOGLE_GENERATIVE_AI_API_KEY مضبوط بشكل صحيح، ومصدّر، ويمكن الوصول إليه في جلسة المحطة الحالية لديك. تحقق مرة أخرى من الأخطاء المطبعية.
• النموذج غير موجود: تحقق من أن اسم النموذج (gemini-2.5-pro-preview-03-25، gemini-2.0-flash، إلخ) يتطابق مع النماذج المدعومة أو المكونة. تحقق من ~/.codex/config.json أو استخدم علامة --model بشكل صحيح.
• أخطاء المزود: تأكد من أن المزود مضبوط على gemini إما عبر config.json أو علامة --provider gemini.
• تسجيل مفصل: لأغراض تصحيح الأخطاء، قم بتشغيل الأوامر مع متغير البيئة DEBUG=true تحسبًا: DEBUG=true open-codex --provider gemini "موجهي". سيظهر هذا معلومات مفصلة عن الطلب/الاستجابة.
• ابدأ ببساطة: ابدأ بموجهات بسيطة وزد التعقيد تدريجيًا مع شعورك بالراحة تجاه كيفية تفاعل جيميني وCLI.
• راجع الموافقات بعناية: خاصة عند التعامل مع تعديلات الملفات أو تنفيذ الأوامر، راجع دائمًا التغييرات أو الأوامر المقترحة بعناية قبل الموافقة عليها (الإجابة y).

الخاتمة

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

من القطع السريعة من الكود والتفسيرات إلى إعادة الهيكلة المعقدة وتنفيذ السكربتات، توفر هذه المجموعة إمكانات كبيرة لزيادة الإنتاجية وتبسيط المهام. تركيز الأداة على الأمان من خلال العزل وموافقات المستخدم، جنبًا إلى جنب مع مرونة دعم المتعدد لمزودين وطبيعتها المفتوحة المصدر، تجعل Open Codex CLI خيارًا جذابًا للمطورين الذين يتطلعون للاستفادة من الذكاء الاصطناعي داخل محطة الأوامر الخاصة بهم.

جرب موجهات مختلفة، واستكشاف أوضاع الموافقة المتعددة (بالحذر!)، واكتشف كيف يمكن لجيميني وOpen Codex CLI تحسين تجربة البرمجة الخاصة بك.