Gemini API CLI: מה ה-README של גוגל אומר על לתת לסוכן הקידוד שלכם Gemini וסוכנים מנוהלים
ה-CLI הניסיוני gemini-api של גוגל נותן ל-Codex, Claude Code או כל סוכן shell לקרוא למודלי Gemini, יצירת מדיה וסוכנים מנוהלים ברקע. מה ה-README אומר, מה הוא משמיט, ומה לבדוק קודם.
ה-gemini-api של גוגל הוא כלי שורת פקודה ניסיוני, שפורסם כקוד פתוח Apache 2.0, שנותן לכל סוכן עם גישת shell לקרוא למודלי Gemini, לייצר מדיה ולהפעיל סוכנים מנוהלים של Gemini. ה-README שלו מזכיר את Codex, Claude Code, Antigravity, OpenClaw ו-Hermes כמארחים לדוגמה. ה-README גם אומר שהוא בבטא, ששינויים שוברים עלולים להתרחש בין שחרורים, ושכדאי לנעול גרסת שחרור ב-CI. הרעיון פשוט: הסוכן שלכם מתכנן, ו-Gemini הוא עוד כלי אחד שהוא יכול להריץ.
קראתי את דף המאגר וה-README בלבד. לא התקנתי את ה-CLI, לא קראתי ל-API ולא קראתי את הערות השחרור, תיעוד ה-API או המקור. כל מה שלמטה הוא מה שה-README אומר.
מה זה
ה-README מתאר את gemini-api כ-CLI חסר מצב ל-Gemini API, שנבנה לשימוש headless על ידי סוכני קידוד וכלי עזר, ושמיש באותה מידה מסקריפטי shell ו-CI. זה בינארי Go יחיד ל-macOS, Linux ו-Windows.
בדף המאגר ראיתי: Apache 2.0, נוצר 29 באפריל 2026, כ-318 כוכבים, 19 issues פתוחים, ושפות כולל Go, Python, TypeScript ו-shell. ה-README אומר שגוגל לא מקבלת pull requests כרגע ומפנה משוב ל-GitHub Issues.
מה הפקודות מכסות
ה-README מקבץ פקודות ככה:
- יצירה:
generate(טקסט ורב-מודלי),image,tts,music,video. ה-README מפרט מודל ברירת מחדל לכל אחת, למשלgemini-3.8-flashל-generateו-gemini-nano-banana-2.1ל-image. - הבנה:
analyze(PDFs, תמונות, אודיו, וידאו, CSV או קבצי טקסט, URLs של YouTube) ו-transcribe(ל-Markdown, טקסט, JSON או SRT). - ניהול:
agent(run, status, cancel, ויצירה או ניהול של הגדרות סוכנים),files(upload, list, get, delete, עם שמירה של 48 שעות),models,configure,authו-whoami. - מתקדם:
environments(סביבות sandbox והקבצים שלהן),credentials(אישורים שמורים בצד שרת לסוכנים מנוהלים),webhooksו-triggers(טריגרי cron לסוכנים מנוהלים).
שמות מודלים וברירות מחדל הם של ה-README. לא בדקתי אותם מול ה-API החי.
בנוי לסוכנים לקרוא
שלוש בחירות עיצוב בולטות כי הן מכוונות לסוכן, לא לאדם.
--usageמדפיס את עץ הפקודות המלא, דגלים, ברירות מחדל, משתני סביבה ומפתחות config בפורמט קריא-מכונה, כך שסוכן יכול לגלות את הכלי מהבינארי עצמו.--schemaמדפיס את ה-JSON Schema לכל פקודה שלוקחת גוף בקשה, ו---bodyנותן לסוכן לשלוח בקשה מלאה.--dry-runמאמת קלטים ומדפיס את בקשת ה-HTTP המתורגמת עם אישורים מצונזרים. ה-README אומר שהוא לא עושה קריאת רשת ולא קורא את ה-keychain של מערכת ההפעלה.
יש גם --agent-mode, שלפי ה-README נותן מעטפות שגיאה JSON מובנות ב-stderr ופלט TOON קומפקטי ב-stdout. קודי יציאה מפרידים הצלחה (0), כשלי ריצה או API (1), שגיאות שימוש (2) וכשלי אימות (3).
דגל ה---dry-run הוא השימושי ביותר לכל מי שנותן לסוכן להריץ את זה ללא השגחה, כי אפשר לראות מה יישלח קודם.
זרימת העבודה של סוכן מנוהל
ה-README מראה השקת סוכן Gemini מנוהל ברקע, עם Deep Research כדוגמה:
1. מריצים gemini-api agent run עם שם סוכן, --background ו---stream=false. ה-CLI מחזיר מזהה interaction מיד.
2. בודקים התקדמות או מושכים את התוצאה עם gemini-api agent status INTERACTION_ID. אפשר גם להזרים התקדמות או לבטל את הריצה.
ה-README גם מתאר עבודה רב-תורנית עם מצב: מעבירים previous_interaction_id בגוף הבקשה כדי להמשיך שיחה. הוא אומר שה-CLI לא שומר מצב שיחה מקומי. אינטראקציות בצד שרת וקבצים שהועלו מטפלים בשמירה שלהם ב-API, וזרימת העבודה שלכם שומרת את המזהים שהיא רוצה להשתמש מחדש.
זה אומר שהסוכן שלכם חייב לאחסן את מזהי ה-interaction בעצמו. אם הוא מאבד אחד, ה-README לא נותן דרך שיכולתי לראות לשחזר אותו מצד ה-CLI. לא בדקתי את תיעוד ה-API לנקודת קצת list.
מפתחות וסודות
ה-README אומר להגדיר משתנה סביבה GEMINI_API_KEY, או לאחסן אותו עם gemini-api configure ב-keychain של מערכת ההפעלה (macOS Keychain, Linux Secret Service או Windows Credential Manager) או ב-~/.config/gemini-api/config.yaml. gemini-api whoami מראה את הקונפיגורציה הפעילה ומקור האישורים.
שתי נקודות משנות לשימוש סוכן. מפתח ה-API יושב בסביבה של כל shell שהסוכן שולט בו, אז כל דבר שהסוכן יכול להריץ יכול לקרוא אותו. פקודת ה-credentials של ה-README מנהלת אישורים בצד שרת לסוכנים מנוהלים, אבל ה-README לא מסביר למה האישורים האלה יכולים להגיע. לא קראתי הלאה.
סעיף ההתקנה של ה-README גם מציע מתקין curl ... | bash, מתקין PowerShell iwr ... | iex, go install, ובינארים מוכנים מראש משחרורים. אם אתם לא רוצים לצינור סקריפט ל-shell, נתיבי ה-go install והבינארי מוכן מראש באותה רשימה.
מה הייתי בודק
אלה הצעות שלא בדקתי, לא תוצאות.
1. לנעול גרסה. ה-README אומר ששינויים שוברים עלולים להתרחש. נעלו שחרור, וקראו את הערות השחרור לפני שאתם עוברים.
2. Dry-run קודם. תנו לסוכן שלכם להריץ כל פקודה חדשה עם --dry-run ולקרוא את הבקשה לפני שהוא עושה קריאה אמיתית.
3. היקף מפתח. השתמשו במפתח API נפרד לשימוש סוכן, כך שאפשר לבטל אותו בלי לגעת בשלכם.
4. עלות רקע. לפני שנותנים לסוכן להפעיל סוכנים מנוהלים ברקע, בדקו תמחור Gemini API לאותם סוכנים. ה-README לא נותן מחירים.
5. שמירה. בדקו כמה זמן אינטראקציות בצד שרת נשמרות, והאם "store": false, שה-README מראה בגוף בקשה, עושה מה שאתם צריכים.
6. מזהים אבודים. בדקו מה קורה כשהסוכן מפיל מזהה interaction באמצע משימה.
מה לא הייתי מסיק
- שהוא מוכן לייצור. ה-README קורא לו ניסיוני ובטא.
- שזרימות עבודה של סוכנים זולות. ה-README לא אומר דבר על עלות, ולא הסתכלתי.
- שמודלי הדוגמה ושמות הסוכנים עדכניים. הם מה-README ביום שקראתי אותו.
- שסוכן שמשתמש ב-CLI הזה מבודד. ה-CLI הוא לקוח. איפה שהוא רץ תלוי בכם.
- שהוא עובד כמתואר. לא הרצתי אותו.
שאלות נפוצות
מהו ה-Gemini API CLI?
לקוח שורת פקודה ניסיוני, Apache 2.0, ל-Gemini API, בנוי כך שסוכנים בעלי shell יכולים לקרוא למודלי Gemini, יצירת מדיה וסוכנים מנוהלים.
אילו סוכנים יכולים להשתמש בו?
ה-README מזכיר את Codex, Claude Code, Antigravity, OpenClaw ו-Hermes, ואומר שכל סוכן עם גישת shell יכול.
איך מתקינים אותו?
ה-README מפרט מתקין shell, מתקין PowerShell, go install github.com/google-gemini/gemini-api-cli/cmd/gemini-api@latest, ובינארים מוכנים מראש מ-GitHub Releases.
איך מאמתים?
מגדירים GEMINI_API_KEY, או מריצים gemini-api configure לאחסן את המפתח ב-keychain של מערכת ההפעלה או קובץ config. gemini-api whoami מראה מה פעיל.
איך מריצים משימה ארוכה בלי להשאיר stream פתוח?
משתמשים ב-gemini-api agent run עם --background --stream=false. הוא מחזיר מזהה interaction. מושכים את התוצאה מאוחר יותר עם gemini-api agent status.
האם אפשר לראות בקשה לפני שהיא נשלחת?
כן. --dry-run מאמת את הקלט ומדפיס את בקשת ה-HTTP המתורגמת עם אישורים מצונזרים, בלי קריאת רשת.
האם זה ישתנה?
ה-README אומר שהוא בבטא ושינויים שוברים עלולים להתרחש בין שחרורים, וממליץ לנעול שחרור ספציפי.
מקורות
כל העמודים נקראו ב-27 באוקטובר 2026.
- google-gemini/gemini-api-cli repository and README: תיאור, סקירת פקודות, דגלי ממשק סוכן, זרימות עבודה, סטטוס, רישיון.
לא נקראו: הערות GitHub Releases, תיעוד Gemini API ו-Interactions API, קוד המקור של ה-CLI, ועמודי תמחור כלשהם.
קריאה נוספת
- Anthropic Python SDK 2.4.0: מגבלות הוצאה, בקשות העלאה ושתי שגיאות מגבלת סשן חדשות
Anthropic Python SDK 2.4.0 יצא ב-2 בנובמבר עם שיטות admin ב-GA ושתי שגיאות סשן חדשות לסוכנים מנוהלים. קראתי את ערות הגרסה והגדרות הטיפוסים ב-tag כדי לראות מה מגבלות הוצאה, בקשות העלאה וסיבות העצירה החדשות באמת אומרות.
- Computer Use ב-Gemini API זמין באופן כללי: Intents, החלטות בטיחות, ולולאת הלקוח שאתם עדיין בונים
ה-changelog של Gemini API מפרט את Computer Use כזמין באופן כללי ב-30 באוקטובר. קראתי את עמוד התיעוד כדי להפריד מה ה-API עושה (מציע פעולות UI עם intent והחלטת בטיחות) ממה שאתם עדיין צריכים לבנות ולאבטח.
- Self-hosted Claude Managed Agents: שירות הסוכנים של Anthropic רץ עכשיו על התשתית שלך
Anthropic פתחה את self-hosted Claude Managed Agents בבטא פרטית: אתה מארח את שירות הסוכנים, את מסד הנתונים ואת ארגזי החול, וקריאות המודל הולכות ל-Claude API או לספק שאתה בוחר. מה רץ איפה, אילו הרשאות קיימות, מה עדיין יוצא מהרשת שלך, ומה כדאי לבדוק לפני שמתחייבים.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS