آموزش Gemini CLI با کلید llmapi

به‌روزرسانی: 2026-10-06

Gemini CLI ایجنت متن‌باز گوگل برای ترمینال است که مثل Claude Code می‌تواند کد را بخواند، ویرایش کند و دستور اجرا کند. llmapi خود Gemini API را هم پیاده کرده، پس Gemini CLI بدون هیچ واسطه‌ای به آن وصل می‌شود.

راه‌اندازی با یک دستور

macOS و Linux:

curl -fsSL https://llmapi.cheap/install.sh | sh

Windows (PowerShell):

irm https://llmapi.cheap/install.ps1 | iex

نیازی به نصب Node.js نیست. کلید sk-llm-… را وارد کنید (یا دستور آماده با کلید خودتان را از داشبورد کپی کنید).

فقط Gemini CLI (macOS/Linux):

curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only gemini

این دستور چه چیزهایی را تغییر می‌دهد؟

در ~/.gemini/.env سه مقدار GEMINI_API_KEY، GOOGLE_GEMINI_BASE_URL و GEMINI_MODEL ست می‌شوند؛ خط‌های دیگر فایل حفظ می‌شوند.
در ~/.gemini/settings.json روش احراز هویت (security.auth.selectedType) روی gemini-api-key و نام مدل (model.name) روی gemini-3.8-flash-high قرار می‌گیرد.

از هر دو فایل نسخهٔ پشتیبان .llmapi-backup ساخته می‌شود.

راه‌اندازی دستی

فایل ~/.gemini/.env را بسازید یا ویرایش کنید:

GEMINI_API_KEY=YOUR_API_KEY
GOOGLE_GEMINI_BASE_URL=https://llmapi.cheap
GEMINI_MODEL=gemini-3.8-flash-high

سپس در Gemini CLI روش ورود را روی «Gemini API key» بگذارید (همان security.auth.selectedType: "gemini-api-key" در ~/.gemini/settings.json). آدرس پایه برای Gemini CLI بدون /v1 است.

تغییر مدل

مقدار GEMINI_MODEL را در ~/.gemini/.env عوض کنید.
یا هنگام اجرا: gemini --model gemini-3.1-pro-high

مدل‌های مناسب Gemini CLI:

شناسه	توضیح
`gemini-3.8-flash-high`	پیش‌فرض؛ Flash با سطح استدلال بالا
`gemini-3.8-flash`	سطح استدلال متوسط
`gemini-3.8-flash-low`	سریع‌تر، برای کارهای ساده
`gemini-3.1-pro-high` / `gemini-3.1-pro-low`	قوی‌ترین Gemini برای مسائل سخت
`gemini-3-flash`	نسل قبلی Flash

همهٔ این مدل‌ها در دورهٔ آزمایشی رایگان هم فعال‌اند.

مشکلات رایج

Gemini CLI صفحهٔ ورود گوگل را باز می‌کند: روش احراز هویت روی Google login مانده است. در settings.json آن را روی gemini-api-key بگذارید یا دستور یک‌خطی را دوباره اجرا کنید.
کلید شناخته نمی‌شود: شاید GEMINI_API_KEY دیگری در shell شما export شده باشد که روی فایل .env اولویت دارد. آن را حذف کنید.
آدرس پایه اشتباه: GOOGLE_GEMINI_BASE_URL باید دقیقاً https://llmapi.cheap باشد.
خطای usage limit: سهمیهٔ پنج‌ساعته یا هفتگی تمام شده؛ پیام خطا زمان شارژ دوباره را می‌گوید.

سؤالات متداول

می‌توانم با Gemini CLI از مدل‌های Claude استفاده کنم؟

Gemini CLI برای مدل‌های Gemini ساخته شده است. اگر Claude می‌خواهید، Claude Code یا OpenCode گزینهٔ بهتری است.

دورهٔ آزمایشی برای Gemini CLI کافی است؟

بله. ۲ میلیون کردیت روی همهٔ مدل‌های Gemini دارید که تا یک ساعت بعد از اولین درخواست معتبر است.

تفاوت high و low در Gemini 3.8 Flash چیست؟

سطح استدلال (reasoning). high قبل از جواب بیشتر فکر می‌کند و برای کارهای چندمرحله‌ای بهتر است؛ low سریع‌تر جواب می‌دهد. بیشتر در معرفی Gemini 3.8 Flash بخوانید.

شروع کنید

حساب بسازید، کلید API خودکار ساخته می‌شود؛ بعد دستور یک‌خطی را اجرا کنید و Gemini CLI را همین حالا امتحان کنید. پلن‌ها را در بخش قیمت‌ها ببینید.