Gemini API CLI 实验预览：给编程 agent 的 API 密钥 CLI，不是 Gemini CLI

Google AI Studio 的介绍页标注发布日期为 2026 年 10 月 19 日（约合北京时间 10 月 19–20 日，视美西发帖时刻而定）。页面介绍 Gemini API CLI 的实验预览——命令二进制名为 gemini-api——面向终端与已有 shell 权限的编程 agent，强调无依赖、无状态。Google AI Studio / DeepMind 员工账号也在 X 于 2026 年 10 月 22 日转发同一预览（约合北京时间 10 月 22 日 23:12）。按预览工具理解即可，不要当成稳定 GA。

官方页与 GitHub README 写明的用途：把 gemini-api 放进 PATH，配置 Gemini API 密钥，让宿主 agent（Codex、Claude Code、Cursor、Antigravity 或其他可执行 shell 的 agent）用常规命令调用 Gemini——文本生成、图像 / TTS / 音乐 / 视频、多模态分析与转写，以及返回 interaction id、可轮询的托管 agent 运行。媒体类命令被描述为把文件写到磁盘并只打印路径，减轻 agent 上下文被二进制撑爆。鉴权走 API 密钥：导出 GEMINI_API_KEY，或用 gemini-api configure 写入系统钥匙串 / 本地配置。仓库许可证为 Apache 2.0。

这是 experimental / 实验预览（介绍页还写 v0.4.x 随 Gemini Interactions API 演进）——不是命令面已冻结的正式版。我们未安装、也未实测 gemini-api。它与 Gemini CLI 不是同一条产品线：后者的套餐用量上限，站内已有专文 Gemini CLI 各套餐的用量上限怎么算。本文写的是 Gemini API CLI（API 密钥）；那篇写的是 Gemini CLI 限额。两名混用会走到错误安装与鉴权路径。

站内相邻的 Google agent 语境可参见 Google Gemini agent：同时调用 Gemini 和 Claude 与 面向 agent 的隔离运行时 Agent Compute Engine。官方未给出 gemini-cli 与 gemini-api 的完整旗标对照表；我们不编造对照。