Gemini CLI

一句话： Gemini CLI 是 Google 官方开源的终端 AI Agent。它把 Gemini 模型、文件读写、shell、web fetch、Google Search grounding 和 MCP 接到一个命令行工具里，最大卖点是 1M token 上下文 + 个人账号免费额度。

2026-09 更新（v0.59.0）：本版本只有两个实质改动，且都是安全修复——防止 MCP OAuth 元数据发现与认证中的 SSRF；restricted 模式下强制 fail-closed 工作区信任并过滤 mcpServers（未信任的工作区不再加载 MCP server 定义）。习惯 clone 完仓库立刻进目录开工的同学，会发现 MCP 工具「消失」了，先在受信任目录里跑即可。详见 AI 编程周报 2026-09-13。

2026-09 更新（v0.60.0 / v0.61.0，9-23 同日发布）：这一批的主题是把「不可信输入」当威胁模型来处理，三项改动值得单独记：① fix(core): prevent indirect prompt injection via build file modifications and untrusted flags（#29250）——间接提示注入是 agent 工具最难防的一类攻击：不是用户在 prompt 里下指令，而是agent 读到的构建文件 / 配置 / 未信任 flag 里藏着指令。修完之后，「clone 一个陌生仓库就开工」的风险显著下降。② fix(sandbox): harden filesystem boundaries and isolate runtime state（#29214）——沙盒的文件系统边界收紧、运行时状态隔离，与 2026 年 agent 工具的主线一致（见 Agent 沙箱）。③ Feat/gemini 3.8 flash 3.5 flash lite（#29443）——Gemini 3.8 Flash 与 3.5 Flash Lite 进入 CLI 模型列表。同时 fix(core): preserve explicit versioned Flash model IDs（#29252）修掉了「显式指定的带版本 Flash 模型 ID 被改写」的问题——脚本里写死了模型 ID 的流水线，这一版之前可能被静默换模型，升级后请复核一次。本段依据为官方仓库 Release 与 PR 记录；第三方汇总站对 v0.61.0 的描述（「增强提示注入防护 + 加固沙盒隔离」）与上述官方 commit 一致，可交叉印证。

2026-09-28 更新（版本通道与 v0.61.0 之后的动向，通道结论已被下方 2026-10-07 一节取代）：截至本站 2026-09-28 核对官方仓库，当时最新稳定版仍是 v0.61.0（2026-09-23 23:59 发布）。以下为该日的通道快照，当前 stable 请以下方 2026-10-07 一节为准：

• Stable：v0.61.0——当时生产环境应钉在这一版。
• Preview：v0.62.0-preview.0 于 2026-09-23 23:47 发布（比 v0.61.0 早 12 分钟），v0.61.0-preview.1 亦在其后；preview 主要装的是 PTY 生命周期、OAuth refresh token 保留、Windows 诊断路径格式化、终端缓冲内存管理等一批工程性修复。
• Nightly：已推进到 v0.63.0-nightly.20260926.g2fe7c2d3f（2026-09-26 01:20），含 fix(core): clean up temporary directory when background shell execution exits（#29437）、fix(acp): resolve session before config initialization（#29463）、fix(core): align policy redirection gates, path validation, and workflow parsing（#29506）等。

别被版本号大小误导：0.63.0-nightly 的数字比 0.61.0 大，但它是每日构建通道，稳定性不保证；0.62.0-preview.0 的发布时间甚至早于 0.61.0。选版请按通道而非按数字。另外注意：Gemini CLI 的 Release 页同日发布多个 tag，核对时务必看 tag 名里的 -preview / -nightly 后缀与发布时间戳。

2026-10-07 更新（v0.63.0 转正 + 通道现状，官方 Releases 逐条核对）：v0.62.0 已于 2026-09-29 21:17 UTC 发布，v0.63.0 于 2026-10-06 20:38 UTC 发布并成为当前 stable。当前三条通道：

v0.63.0 这一版没有新模型或新能力，主线是工程性修复，四项值得单独记：

• 长跑 agent 循环的内存与输出收敛：fix(core): bound tool output size and optimize memory lifecycle in long-running agent loops（#29451）——工具输出有上限、内存生命周期优化，跑长时间 agent 循环不再越跑越吃内存。
• 状态持久化改为原子写 + 损坏可恢复：fix(cli): persist state atomically and recover from backup on corruption（#29558），配套 fix(core): implement append-only delta patching and bounded history windowing in ChatRecordingService（#29568）——Ctrl+C 强退后回话记录不再被删（#29584 亦为此类）。
• 文件工具串行化 + 写入原子化：fix(core): serialize file tool operations and make writes atomic（#29499）——并发写同一文件的竞争窗口收窄。
• 认证链路：fix(auth): prevent infinite auth loop from file contention, headless keyring, and supervisor state drops（#29448）；fix(cli): retry directory removal on Windows locking errors during extension updates（#29540）。

另有两条对日常使用体感明显：Ctrl+C 紧急中止现在能真正送到取消处理器（#29586），Ctrl+O 展开时不再多余清屏（#29640）。

别被版本号大小误导：0.65.0-nightly 的数字比 0.63.0 大，但它是每日构建通道；0.64.0-preview.0 的发布时间甚至早于 0.63.0 约 12 分钟。选版请按通道而非按数字，核对时务必看 tag 名里的 -preview / -nightly 后缀与发布时间戳。

2026-10-14 更新（v0.64.0 转正，官方 Releases API 逐 tag 一手核对）：七天的 stable 停滞结束

更正：本站此前「0.64 仍未转正 / 生产应钉 v0.63.0」的口径已于 2026-10-13 20:44 UTC 失效——v0.64.0 已发布为 stable 并成为 Latest。

这一版没有新模型、没有新能力，官方 Release Notes 从头到尾是 fix / chore / refactor——但它是长任务用户最该升的一版，五条值得单独记：

关于 Gemini 4 Argon：谷歌已于 2026-10-13 宣布 Gemini 4 Argon 全球开放（模型 ID gemini-4-argon，$2/$10 首发价至 11-30，之后 $4/$20，1M 统一输入输出上限）。v0.64.0 的 Release Notes 中未出现任何模型相关条目，本站也未核对 CLI 侧模型清单——Argon 是否已在 CLI 中可选，目前属待核实，请勿按「模型发布了 = CLI 能用」推断。

本站此前那条推断被这一版直接推翻，修正如下：我们从「v0.63.0 连续七天保持 stable」推出「通常意味着一个较大的改动正在 preview 通道里憋着」——结果 0.64 是纯修复版。修正后的判据：stable 停滞既可能是憋大功能，也可能是「先还完可靠性债才敢开新周期」，单凭停滞时长下不结论，必须打开 Release Notes 看条目类型（feat 还是 fix）。 详见 v0.64.0 转正资讯。

2026-10-22 更新（v0.65.0 转正，官方 Releases API 逐 tag 一手核对）：又是 fix 为主的一版，但 Release Notes 里带了一条唯一的 feat

更正：本站「2026-10-17 复核」写下的「stable 仍为 v0.64.0，v0.65.0-preview.0 未转正」已于 2026-10-20 失效——v0.65.0 已转正为 stable（tag 时间戳 2026-10-20T21:17:57Z，经 GitHub Releases API 读取 prerelease: false 确认）。生产请从 v0.64.0 改钉 v0.65.0。

又一次验证了「同日多 tag、数字不反映先后」：v0.66.0-preview.0（21:04）比 v0.65.0 stable（21:17）早 14 分钟发布，而 nightly 已经跑到 v0.67.0。选版按通道不按数字；通过 Releases API 取「第一条 release」时必须显式过滤 prerelease 与 draft——这次若不过滤，取到的是 v0.67.0-nightly。

这版 Release Notes 里只有一条 feat，其余全是 fix / perf / chore：

其余条目（truncateString 保留行终止符、IdeServer.stop() 在 MCP 会话打开时能正常 resolve、A2A server 把工具拒绝隔离到当前调用、ask_user 问题文本保留、扩展 allowlist 校验失败时不阻断其他扩展加载等）可在 Release Notes 原文逐条查看，本站不逐一转录。

把它和 v0.64.0 放在一起看：连续两个 stable 版本都是**「崩溃 / 状态 / 信任边界」类修复**，没有新模型、没有新能力。结合本站 10-14 修正后的判据（看 Release Notes 的条目类型，而不是看 stable 停滞时长），可以更明确地说：Gemini CLI 在 2026 年 10 月这一轮的周期主题是可靠性收尾，不是功能扩张。 换成选型语言——如果你的犹豫是「要不要等下一个大版本」，这两版不构成等待理由；如果你的犹豫是「要不要升级」，这两版都是低风险的正收益。

关于 Gemini 4 Argon：v0.65.0 的 Release Notes 同样未出现任何模型相关条目。Argon 虽已于 2026-10-13 全球开放（见 发布资讯），本站仍未核对 CLI 侧模型清单，「Argon 是否已在 CLI 中可选」继续保持待核实，请勿按「模型发布了 = CLI 能用」推断。

2026-10-29 更新（v0.66.0 转正，官方 Releases API 逐 tag 一手核对 + Release Notes 原文）：又是满屏 fix，但官方这次在 CLI 里挂了条「未针对 Gemini 4 优化」的横幅

更正：本站「2026-10-22 更新」写下的「v0.66.0-preview.0 仍未转正，生产应钉 v0.65.0」已于本次核对失效——v0.66.0 已转正为 stable（tag 时间戳 2026-10-27T20:26:28Z，经 GitHub Releases API 读取 prerelease: false 确认）。生产请从 v0.65.0 改钉 v0.66.0。

本版唯一超出「修 bug」范畴的一条：PR #29774 "Add Banner about Gemini CLI not being optimized for Gemini 4"——官方在自家 CLI 里主动提示：该 CLI 尚未针对 Gemini 4 做优化。

口径必须收窄：这是「未优化」的声明，不等于「不可用」，也不等于「已适配」。本站仍未核对 CLI 侧的实际模型清单，因此继续保留「Gemini 4 系列是否已在 CLI 中可选」为待核实，请勿按「模型发布了 = CLI 能用」或「横幅说没优化 = 完全用不了」两个方向中的任何一个去推断。

其余条目几乎全是 fix，四条对个人体感最直接：

• PR #29725 "fix(ui): implement synchronized output and isolate spinner rendering"——输出同步 + spinner 渲染隔离，滚动与 spinner 互相干扰的问题收窄。
• PR #29742 "fix(cli): prevent right-hand border bleed in scrollable tool containers"——可滚动工具容器的右边框溢出修复。
• PR #29757 "fix(cli): verify active binary update to prevent PATH shadowing false success"——修的是「提示更新成功、实际被 PATH 里的旧二进制挡住」的假成功。升级后行为没变的，先查这个。
• PR #29832 / #29792（"preserve user-level ~/.gitconfig"、"disable interactive credential and SSH prompts in getSafeGitEnv"）——保留用户级 git 配置，并关掉 shell / git 环境里的交互式凭据与 SSH 提示，减少无人值守场景卡在交互输入上。

另有 PR #29750（加载 .env 之后再解析 settings 占位符）、#29769（加固 SKILL.md 单行 frontmatter 解析）、#29768（slash 命令冲突去重状态复位）、#29827（用 StringDecoder 解码流式 Node HTTP activity chunks）、#29790（bootstrap 父进程向子进程转发终止信号）等。

行动建议：① 生产钉 v0.66.0；② 升级后 CLI 行为没变化的，按 #29757 那条先确认 PATH 里是否还有旧二进制；③ 脚本里用 headless 模式的，本版修了 git 环境交互提示，值得复测一次长时间任务；④ 等 Gemini 4 在 CLI 里可用的，继续盯官方 Release Notes 的模型条目，本站不作时间预测。 2026-10-13 更新（历史记录，已被上方 10-14 更新取代）：当时连续四轮无新 stable，0.64 仍未转正

下表为 2026-10-13 早些时候的快照，v0.64.0 于当日 20:44 UTC 转正后即失效，保留供追溯。

「连续多轮没有新稳定版」通常意味着一个较大的改动正在 preview 通道里憋着 该推断已被证伪：v0.64.0 转正后 Release Notes 全为 fix 类条目，无新能力。别把「停滞时长」当预测信号，去读条目类型。

2026-10-10 更新（通道现状复核，官方 Releases 逐 tag 核对）：stable 仍是 v0.63.0，0.64 还在 preview

距离上一节又过了一周，通道格局没有变——这一点本身就值得写下来，因为期间出现了三个数字更大但都不是 stable 的 tag：

两个反复出现的坑，再强调一次：① 选版按通道不按数字——0.65.0-nightly 与 0.64.0-preview.1 的数字都比 0.63.0 大，但都不是生产可用；② v0.64.0-preview.1 在 Releases API 里是 draft: true，直接按「第一条 release」取版本会取到 alpha / nightly / draft，必须显式过滤 prerelease 与 draft。同理，v0.64.0-preview.0（2026-10-06 20:26）比 stable 的 v0.63.0 早 12 分钟——时间戳比版本号更能说明问题。

行动建议：跑生产的继续钉 v0.63.0；想试 0.64 的等它转 stable，别拿 preview 跑 CI。

2026-11-06 更新（v0.67.0 转正，官方 Releases API 逐 tag 一手核对 + Release Notes 原文）：十轮之后终于落地，唯一的 feat 是「查模型」

更正：本站「2026-11-05 复核」写下的「stable 仍 v0.66.0，v0.67.0 与 v0.68.0 双 404（第十轮确认）」已于 2026-11-04 失效——v0.67.0 已转正为 stable（tag 时间戳 2026-11-04T20:27:11Z，Releases API 读回 prerelease: false）。生产请从 v0.66.0 改钉 v0.67.0。

v0.68.0 的正式 tag 本轮实测仍是 404——preview 与 stable 的号码序列各自独立，别按 preview 的号推 stable 的号（本站连续十轮记录这条，本轮再次验证）。

本版唯一的 feat 解决了本站追了一个月的问题：PR #29880 "add models command and --list-models flag for model discovery"——CLI 里可以直接查可用模型了（gemini models 或 --list-models）。此前本站连续多轮把「Gemini 4 系列是否已在 CLI 中可选」列为待核实，现在读者可以自己跑一遍拿到官方清单，本站不再对清单内容作任何推断。另一条 feat 是 IDE companion 通过 exec stdio 桥进容器沙箱（#29858）。

五条「写在 fix 里、实为判据变更」的条目，升级前请逐条过一遍：

其余条目多为工程修复：ACP 权限请求携带 MCP server 与工具元数据（#29910）、diff 前统一 CRLF（#29966）、workspace 为 home 目录时不重复加载 agent（#29847）、IDE 设置与 GEMINI.md 不再进「打开文件」上下文（#29848）、废弃设置迁移时保留 ${VAR} 占位符（#29867）、Android/Termux 下 ripgrep 受信任系统路径（#29884）。

行动建议：① 生产钉 v0.67.0；② 先用 gemini models 把清单打出来存档，以后模型变化就有 diff 可查；③ CI 里跑 gemini -p 的重点测「取消」路径——超时中断时机提前了；④ 迁移过 Claude hooks 的先查超时配置，hook 不生效通常表现为「没报错，只是没做事」。详见 11-06 版本复核资讯。

如果你已经在用 Claude Code / Codex CLI，Gemini CLI 不一定替代它们，但很适合作为「第二意见」「低成本大仓库阅读」「联网查新资料」的工具。