أدوات البرمجة
Gemini CLI
تكوين Google Gemini CLI لاستخدام TokenLab API
نظرة عامة
توثق Gemini CLI 0.60.0 المتغير GOOGLE_GEMINI_BASE_URL للمصادقة عبر مفتاح API. استخدم نقطة النهاية الأصلية لـ Gemini الخاصة بـ TokenLab مع نموذج حالي يدعم gemini_generate_content. راجع مرجع التكوين الرسمي ودليل المصادقة. لا يقوم هذا الإعداد بتوجيه اشتراك Google عبر TokenLab.
التثبيت
تحتاج Gemini CLI 0.60.0 إلى Node.js 20 أو أحدث.
npm install -g @google/gemini-cli@0.60.0
gemini --versionالتكوين
استخدم تعليمات الطرفية في البدء السريع لأنظمة macOS أو Linux أو WSL أو Windows PowerShell لضبط TOKENLAB_API_KEY دون وضع المفتاح في سجل الأوامر. قم بتشغيل Gemini CLI من تلك الطرفية. للاستخدام الدائم، استخدم مدير الأسرار المحلي الخاص بك؛ لا تقم بإلحاق مفتاح بنص عادي في ملف تعريف الصدفة (shell profile) الخاص بك.
احتفظ بتسجيل دخول Google وتكوينك الحالي. لتشغيل TokenLab بشكل منفصل، اختر جذر تكوين غير مستخدم مثل ~/.gemini-tokenlab ($HOME على PowerShell) وأنشئ دليل .gemini الخاص به. انسخ ملف .gemini/settings.json الحالي وأي ملفات سياسة يحتاجها إعدادك إلى المواقع المقابلة، مع الحفاظ على الأذونات، ووضع الحماية (sandbox)، والإعدادات غير ذات الصلة. في تلك النسخة فقط، ادمج حقل المصادقة التالي؛ أنشئ ملف إعدادات إذا لم يكن موجوداً. لا تنسخ ذاكرة التخزين المؤقت لـ OAuth أو تمسح بيانات اعتمادك الأصلية. اتبع سياسة المصادقة المُدارة بدلاً من تجاوزها.
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}الاستخدام
يستخدم التشغيل أدناه ~/.gemini-tokenlab/.gemini/settings.json. اضبط المسار إذا اخترت جذراً آخر. وافق على دليل العمل من خلال مطالبة الثقة المعتادة في Gemini؛ احتفظ بسياسات الموافقة على الأدوات الحالية. يتم اختيار النموذج صراحة لهذه الجلسة.
GEMINI_CLI_HOME="$HOME/.gemini-tokenlab" GEMINI_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" GOOGLE_GEMINI_BASE_URL=https://api.tokenlab.sh gemini --model gemini-3.8-flashتنطبق هذه المتغيرات فقط على هذا التشغيل؛ يظل حسابك المحفوظ والنموذج الافتراضي وإعدادات الأذونات كما هي. قم بالتشغيل بشكل طبيعي بدون المتغيرات لاستخدام إعدادك السابق. لا تقم بحفظها بشكل دائم في ملف تعريف الصدفة الخاص بك.
التحقق
حفظ الإعدادات أو سرد النماذج لا يتحقق من مفتاح أو طلب مكتمل. تستخدم المطالبة رصيد TokenLab. تحقق من الرد وسجل الطلب المطابق له قبل تجربة الأدوات؛ قد يتم محاسبتك أيضاً على الطلبات الإضافية.
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.إنشاء الصور والفيديو في نفس الـ Agent
يمكن لـ Gemini CLI أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. ادمج هذا الإدخال في نسخة TokenLab من الإعدادات، ~/.gemini-tokenlab/.gemini/settings.json. تقرأ Gemini CLI المتغير $TOKENLAB_API_KEY من بيئة التشغيل، لذا لا يتم كتابة المفتاح في الملف:
{
"mcpServers": {
"tokenlab": {
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "$TOKENLAB_API_KEY"
}
}
}
}ابدأ تشغيل Gemini CLI باستخدام أمر التشغيل أعلاه وقم بتشغيل /mcp. يجب أن يظهر خادم tokenlab كمتصل؛ قم بالوثوق بمجلد العمل إذا لم يظهر كذلك. ثم جرب:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.يعيد create_video معرف مهمة (task ID). يقوم الـ Agent باستدعاء get_task_status حتى يصبح الفيديو جاهزاً. راجع دليل Gemini CLI MCP لمعرفة الإعدادات الأخرى.