Gemini CLI 官网入口在哪：下载、文档与安装路径

Gemini CLI 是 Google 维护的开源终端 AI 代理，可直接在本地或 Cloud Shell 中使用 Gemini 完成任务。截至 2026 年 11 月抓取时，官方入口仍是 https://github.com/google-gemini/gemini-cli，文档入口是 https://geminicli.com/docs/。现在值得先辨清入口，是因为 Google 已在 2026 年 6 月 18 日调整个人账户与 AI 套餐的对应关系，照旧教程安装可能选错工具。

下文标注“按官方页面推下来”的内容是基于入口与安装方式作出的操作判断；版本号、价格、权限和命令均按所列官方来源抄录。

三个官方入口分别管什么

最常搜到的“Gemini CLI 官网”其实包含三个不同入口：GitHub 仓库负责源代码、发行版本和安装说明，geminicli.com 是产品主页，geminicli.com/docs/ 是使用文档。Google Cloud 用户还可以从 Gemini CLI 专页进入。

要找的内容	官方入口	具体位置	适合谁
源代码、发行版、安装命令	https://github.com/google-gemini/gemini-cli	仓库首页 → README → Installation	想确认命令、检查源码或下载发行版的用户
产品主页	https://geminicli.com/	页面首页	想确认项目身份和最新入口的用户
使用文档	https://geminicli.com/docs/	文档首页	已经安装，准备登录、配置或排查问题的用户
Google Cloud 场景	https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli	Gemini CLI 页面	使用 Gemini Code Assist 或 Cloud Shell 的用户

这里最容易走错的是 Antigravity CLI。官方仓库当前说明：Gemini CLI 面向拥有 Gemini Code Assist Standard、Enterprise，或 Gemini Code Assist for GitHub on Google Cloud 的组织，同时兼容旧有付费 Gemini API 与 Vertex AI 密钥；个人免费访问和 Google AI Pro、Ultra 账户已于 2026 年 6 月 18 日转向 Antigravity CLI。

因此，不能只看名字里都有“Gemini”就认定两个工具相同。按官方入口与账户范围推下来，需要多代理交互式编码终端或个人 AI 套餐账户的用户，应先检查 Antigravity CLI；已有 Code Assist 企业权限、旧有付费 API 或 Vertex AI 密钥的用户，才继续按 Gemini CLI 仓库的路径操作。

开始安装前先确认三件事

1. 确认账户权限。打开 https://github.com/google-gemini/gemini-cli ，查看 README 顶部的 Which Google CLI do you need?。需要确认账户属于 Code Assist Standard、Enterprise、Code Assist for GitHub on Google Cloud，还是使用旧有付费 API、Vertex AI 密钥。

2. 确认本机具备运行环境。先打开终端，执行下面的命令查看 Node.js 和 npm 是否存在：

node -v
npm -v

3. 确认安装方式。macOS、Linux 用户通常可直接使用 npm；已经使用 Homebrew 的用户可走 Homebrew。只做一次临时试用时，不必先全局安装，直接运行 npx 即可。

是否付费也取决于接入方式。Google Cloud 文档说明，各 Gemini Code Assist 版本提供可供 Gemini CLI 使用的配额；Gemini CLI 也支持使用 Gemini API 密钥并按用量付费。免费个人账户和 Google AI Pro、Ultra 套餐则不应再按旧说明直接套用到当前 Gemini CLI。

最快的官方安装路径

临时试用：直接用 npx

这是仓库 Quick Install 中标注的“无需安装”方式，也是第一次接触 Gemini CLI 时最短的路径：

npx @google/gemini-cli

命令会直接获取并启动 Gemini CLI。若只是想确认命令能否拉取、当前账户能否进入交互界面，这一轮足够；不必同时再装 Homebrew 或 MacPorts 版本。

全局安装：npm

如果准备长期在终端中使用，执行：

npm install -g @google/gemini-cli

安装后执行：

gemini

gemini 是官方仓库在工具对照表中使用的 CLI 名称。若终端已经打开，安装后若仍提示找不到命令，先关闭当前终端并重新打开，再运行 gemini，避免旧终端尚未刷新命令搜索路径。

macOS 或 Linux：Homebrew

已经使用 Homebrew 的用户可以执行：

brew install gemini-cli

随后同样运行：

gemini

Homebrew 的价值是让安装、更新与卸载都纳入现有的包管理流程；第一次使用且没有配置 Homebrew 时，直接采用 npm 更省事。

macOS：MacPorts

已经使用 MacPorts 的用户可以执行：

sudo port install gemini-cli

这条路径需要管理员权限，也更适合已经维护 MacPorts 环境的电脑。不要为了安装 Gemini CLI 临时引入一套不熟悉的包管理器。

四种方式不要叠加安装。已经通过 npm 装过，就不要再用 Homebrew 装第二份，否则排查版本问题时可能同时看到两个安装来源。

下载页、文档和登录入口怎么走

需要查看发行版时，进入官方仓库首页，点击顶部的 Releases，再选择目标版本。GitHub 仓库同时提供 Code 菜单，可用于获取源码文件；不想使用 Git 命令时，可以从该菜单选择 ZIP 下载。

需要查询参数、认证方式或配置项时，直接访问：

https://geminicli.com/docs/

不要从搜索引擎摘要或第三方“安装大全”拼接命令。仓库 README 中的安装区会随版本调整，而独立文档页更适合核对当前配置项。涉及 Google Cloud 配额、Cloud Shell 和 Code Assist 的问题，再进入 Google Cloud 的 Gemini CLI 专页交叉核对。

登录 GitHub 时，如果跳转后没有进入仓库，可直接打开：

https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fgoogle-gemini%2Fgemini-cli

登录完成后再回到仓库。GitHub 登录页当前显示的错误原文是：

There was an error while loading. Please reload this page .

对应处理是刷新当前登录页，确认地址栏仍是 GitHub 官方域名，再重新登录。如果页面显示：

You can't perform this action at this time.

先完成登录或创建账户，然后从上面的回跳地址重新进入仓库；仍无法操作时，可改用仓库 Code → Download ZIP 获取文件，不要在来源不明的下载站安装。

怎么确认已经装成功

安装成功的可观察标志不是“终端没有报错”这么简单，而是 gemini 能正常启动并进入交互界面。临时试用路径则以 npx @google/gemini-cli 启动后出现可输入提示的界面为准。

同时检查三个结果：终端能够执行 gemini；界面正常显示输入区域；登录或认证阶段没有阻止你继续。这样可以区分“包已经下载”“命令已经安装”和“账户已经能实际使用”三个状态。包下载成功但认证失败，并不代表安装过程已经全部完成。

官方来源与后续入口

• Gemini CLI 官方 GitHub 仓库：源代码、README、安装命令、发行版和当前账户范围。
• Gemini CLI 官方文档：安装后的使用、配置与问题排查入口。
• Gemini CLI 产品主页：项目官网入口。
• Google Cloud 的 Gemini CLI 文档：Code Assist、Cloud Shell、配额及 API 密钥接入说明。
• GitHub 登录回跳入口：登录后直接返回 Gemini CLI 仓库。

参考来源

• Gemini CLI | Gemini for Google Cloud | Google Cloud Documentation
• Gemini CLI
• Gemini CLI – Gemini CLI