ادعُ أصدقاء واحصل على رموز مجانية!اعرف المزيد

دمج Gemini CLI مع نماذج CodingPlanX المخصصة

قم بتكوين Google Gemini CLI باستخدام مفتاح API الخاص بـ CodingPlanX.ai.

دليل تكامل Gemini CLI

يدعم CodingPlanX.ai كل من Claude Code و OpenAI Codex و Google Gemini CLI. بمجرد شراء خطة، تتشارك هذه الأدوات الثلاثة نفس حصة الخطة، مما يسمح لك باختيار الأداة التي تناسب سير عملك بمرونة.

ما هو Gemini CLI؟

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

النماذج المتاحة

يمكنك الوصول إلى نماذج Gemini التالية عبر CodingPlanX.ai:

النموذجالوصف
gemini-3-pro-previewأحدث إصدار معاينة (موصى به)
gemini-2.5-proإصدار مستقر

أحدث إصدار: Gemini CLI v0.33.1 (2026-03-12)، يتميز بنظام الإضافات (Extensions)، والسمات المخصصة، والمزيد.

نظرة عامة على التكوين

يتطلب Gemini CLI تعيين متغيرات البيئة التالية:

  • GOOGLE_GEMINI_BASE_URL - رابط نقطة نهاية الخدمة
  • GEMINI_API_KEY - مفتاح API (نفس المفتاح المستخدم في Claude Code)
  • GEMINI_MODEL - النموذج المحدد

تكوين macOS

الخطوة 1: تثبيت بيئة Node.js

يتطلب Gemini CLI تشغيل Node.js.

الطريقة 1: باستخدام Homebrew (موصى به)

إذا كان لديك Homebrew مثبتًا، فهي أسهل طريقة لتثبيت Node.js:

# تحديث Homebrew
brew update

# تثبيت Node.js
brew install node
الطريقة 2: التنزيل من الموقع الرسمي
  1. قم بزيارة https://nodejs.org/
  2. قم بتنزيل إصدار LTS لنظام macOS
  3. افتح ملف .pkg الذي تم تنزيله
  4. اتبع تعليمات المثبت
ملاحظات macOS
  • إذا واجهت مشكلات في الصلاحيات، فقد تحتاج إلى استخدام sudo.
  • قد يتطلب التنفيذ لأول مرة إذنًا في إعدادات النظام (System Settings).
  • يوصى باستخدام Terminal أو iTerm2.
التحقق من تثبيت Node.js

بمجرد التثبيت، افتح الطرفية (Terminal) وأدخل:

node --version
npm --version

إذا تم عرض الإصدارات، فقد كان التثبيت ناجحًا!

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

قم بتثبيت Gemini CLI عالميًا باستخدام npm:

npm install -g @google/gemini-cli

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

gemini --version

الخطوة 3: تكوين متغيرات بيئة Gemini CLI

قم بتعيين متغيرات البيئة التالية للاتصال بخدمة البروكسي:

الإعداد المؤقت (الجلسة الحالية)

قم بتشغيل هذه الأوامر في الطرفية الخاصة بك:

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

استبدل cr_xxxxxxxxxx بـ مفتاح API لـ CodingPlanX.ai. يمكنك استخدام نفس مفتاح API الذي تستخدمه لـ Claude Code.

الإعداد الدائم (ملف تعريف Shell)

أضف الأسطر التالية إلى ملف تكوين الصدفة (shell) الخاص بك (مثل ~/.zshrc):

# تكوين Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

ثم قم بتطبيق التغييرات:

source ~/.zshrc

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

اختبر المتغيرات في الطرفية الخاصة بك:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

تكوين Linux / WSL2

الخطوة 1: تثبيت بيئة Node.js

يتطلب Gemini CLI تشغيل Node.js.

الطريقة 1: باستخدام nvm (موصى به)

يسهل nvm إدارة إصدارات Node.js المتعددة:

# تثبيت nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# إعادة تحميل تكوين الصدفة
source ~/.bashrc

# تثبيت أحدث إصدار LTS
nvm install --lts
الطريقة 2: باستخدام مديري الحزم
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm
ملاحظات Linux / WSL2
  • يجب على مستخدمي WSL2 تثبيت Node.js داخل نظام Linux الفرعي، وليس على Windows.
  • يساعد استخدام nvm في تجنب مشكلات الصلاحيات.
  • تأكد من أن ملف تعريف الصدفة الخاص بك يقوم بتحميل nvm بشكل صحيح.
التحقق من تثبيت Node.js

افتح الطرفية وأدخل:

node --version
npm --version

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

قم بتثبيت Gemini CLI عالميًا باستخدام npm:

npm install -g @google/gemini-cli

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

gemini --version

الخطوة 3: تكوين متغيرات بيئة Gemini CLI

الإعداد المؤقت (الجلسة الحالية)
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

استبدل cr_xxxxxxxxxx بـ مفتاح API لـ CodingPlanX.ai.

الإعداد الدائم (ملف تعريف Shell)

أضف التالي إلى ملف تعريف الصدفة الخاص بك (~/.bashrc):

# تكوين Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

قم بتطبيق التغييرات:

source ~/.bashrc

إذا كنت تستخدم Zsh، فأضفه إلى ~/.zshrc وقم بتشغيل source ~/.zshrc.

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

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

تكوين Windows

الخطوة 1: تثبيت بيئة Node.js

الطريقة 1: التنزيل من الموقع الرسمي (موصى به)
  1. قم بزيارة https://nodejs.org/
  2. انقر على إصدار "LTS" لتنزيله.
  3. قم بتشغيل ملف .msi الذي تم تنزيله.
  4. اتبع معالج الإعداد، مع الاحتفاظ بالإعدادات الافتراضية.
الطريقة 2: باستخدام مدير الحزم

إذا كان لديك Chocolatey أو Scoop مثبتًا:

# باستخدام Chocolatey
choco install nodejs

# أو باستخدام Scoop
scoop install nodejs
ملاحظات Windows
  • يوصى باستخدام PowerShell بدلاً من CMD.
  • إذا واجهت أخطاء في الصلاحيات، فحاول التشغيل كمسؤول (Administrator).
  • قد تؤدي بعض برامج مكافحة الفيروسات إلى نتائج إيجابية خاطئة؛ قم بإضافتها إلى القائمة البيضاء إذا لزم الأمر.
التحقق من تثبيت Node.js

افتح PowerShell أو CMD وأدخل:

node --version
npm --version

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

npm install -g @google/gemini-cli

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

gemini --version

الخطوة 3: تكوين متغيرات بيئة Gemini CLI

إعداد PowerShell المؤقت (الجلسة الحالية)

قم بتشغيل التالي في PowerShell:

$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingplanx.ai"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

استبدل cr_xxxxxxxxxx بـ مفتاح API لـ CodingPlanX.ai.

إعداد PowerShell الدائم (على مستوى المستخدم)

قم بتشغيل التالي في PowerShell:

# تعيين متغيرات البيئة على مستوى المستخدم (دائم)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingplanx.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)

تحتاج إلى إعادة تشغيل نافذة PowerShell حتى تسري هذه التغييرات.

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

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

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

إصدار Node.js منخفض جدًا

المشكلة: يطالب Gemini CLI بأن إصدار Node.js غير متوافق.

الحل:

  1. تحقق من إصدارك: node --version
  2. يوصى باستخدام Node.js 18.x أو أعلى.
  3. الترقية باستخدام nvm: nvm install --lts && nvm use --lts

متغيرات البيئة لا تسري

المشكلة: لا يمكن الاتصال بعد تعيين متغيرات البيئة.

الحل:

  1. تأكد من أنك قمت بإعادة تشغيل الطرفية أو تشغيل أمر source.
  2. تحقق مما إذا كانت أسماء المتغيرات مكتوبة بشكل صحيح (حساسة لحالة الأحرف).
  3. تحقق من تنسيق مفتاح API الخاص بك (يبدأ بـ cr_).

مشكلات الاتصال بالشبكة

المشكلة: تعذر الاتصال بخدمات CodingPlanX.ai.

الحل:

  1. تحقق من اتصالك بالإنترنت.
  2. تحقق من تعيين GOOGLE_GEMINI_BASE_URL بشكل صحيح.