CLI gemini-cli 把Gemini大模型直接搬进你的终端

在终端里直接跟大模型对话、让它读你的代码库、改文件、跑脚本，已经成为很多开发者的日常。但要把一个强力模型接进 shell，往往要自己搭前端、管密钥、写工具调用，门槛不低。Google 官方的 Gemini CLI 把这条路铺平了：一个轻量的开源 AI 代理，让你在终端里就能直接调用 Gemini，从一句 prompt 到模型之间几乎零距离。

它是 Google 开源的 AI 代理，定位很直白——把 Gemini 的能力直接带进你的终端，既能当对话助手，也能当读代码、改工程、做自动化的编码代理。

项目基本信息

一、项目介绍

Gemini CLI 是一个开源的 AI 代理，把 Gemini 直接放进终端。它提供轻量入口，让你最快捷地从 prompt 到达模型。值得注意的是，Google 在 2026 年 6 月把面向普通用户和 Google One 的体验迁移到了 Antigravity CLI，README 也注明 Gemini CLI 没有针对最新的 Gemini 4 Argon 做优化——要用最新模型体验，官方建议走 Antigravity。但作为开源、可自托管、可接 MCP 的终端代理，它依然是社区里使用最广的 Gemini 接入方式之一。

二、核心优势

第一，零安装即用。npx @google/gemini-cli 一条命令拉起，不必先全局安装。第二，代码理解与上手快。能查询、编辑大型代码库，用自然语言调试问题。第三，多模态入口。可以从 PDF、图片或草图直接生成新应用，而不只是处理文本。第四，自动化与集成。能非交互式跑脚本做 PR 查询、复杂 rebase 等操作，还能接 MCP 服务器扩展能力（如 Imagen / Veo / Lyria 媒体生成）。第五，发布节奏稳定。每周有 preview / stable / nightly 三种渠道，便于跟进或回滚。

三、适用场景

适合想在终端里用上 Gemini 的开发者：读不懂的大型仓库快速问答、按自然语言改代码、把重复操作写成脚本自动化、以及把各类 MCP 能力接进命令行工作流。对已经习惯在 shell 里干活、又想随手调模型的同学，它比打开网页版顺手得多。

四、安装教程

最快方式，免安装直接跑：

npx @google/gemini-cli

全局安装：

npm install -g @google/gemini-cli

macOS / Linux 用 Homebrew：

brew install gemini-cli

受限环境可用 Anaconda：先 conda create -y -n gemini_env -c conda-forge nodejs，激活后再 npm install -g @google/gemini-cli。常见报错：全局装完 gemini 命令找不到，多半是 npm 全局 bin 没进 PATH，用 npm prefix -g 查路径并 source；网络拉不到包时先确认能访问 npm registry。

五、使用示例

在当前目录启动：

gemini

带上多个目录一起加载：

gemini --include-directories ../lib,../docs

指定模型：

gemini -m gemini-2.5-flash

认证有三种：用 Google 账号 OAuth 登录（组织付费 Code Assist 许可要 export GOOGLE_CLOUD_PROJECT）、用 Gemini API Key（export GEMINI_API_KEY）、或走 Vertex AI（export GOOGLE_API_KEY 加 export GOOGLE_GENAI_USE_VERTEXAI=true）。启动后你可以直接说「解释这个仓库的认证流程」或「帮我把这个 rebase 冲突解掉」，它会读代码、给方案、改文件。

六、常见问题

问：Gemini CLI 和 Antigravity CLI 什么关系？答：2026-06 起普通用户体验迁到 Antigravity；Gemini CLI 仍是开源终端代理，但官方注明它未针对最新 Gemini 4 Argon 优化。问：一定要联网吗？答：要，它调用的是 Google 托管的 Gemini 服务。问：能接别的工具吗？答：能，通过 MCP 服务器扩展，包括媒体生成等能力。问：脚本里怎么用？答：支持非交互模式，适合写进 CI 或自动化流水线。

七、总结

Gemini CLI 把「在终端里用 Gemini」这件事做得足够轻：一条 npx 就能起，代码理解、多模态、MCP 扩展一应俱全，是 shell 党随手调模型的好选择。它的短板也明确——官方已把最新模型体验导向 Antigravity，且未针对 Gemini 4 Argon 优化。如果你要的是开源、可脚本化、能接 MCP 的 Gemini 终端入口，它依然是最顺手的那个；若追求最新模型上限，按官方建议转 Antigravity 更合适。