Gemini CLI 安装与使用教程:现在还能免费用吗、怎么迁移

Gemini CLI 是 Google 开源的终端 AI 编程智能体。2026-06-18 起个人免费档已换成 Antigravity CLI,目前主要面向付费 API Key 和企业用户。

NNathaniel bigo··原创首发·AI 辅助撰写
5 分钟读完
资料核对于 2026-10-07 · 依据官方文档与公开资料整理
本文根据 Gemini CLI 官方 GitHub 仓库、官方文档站、Google 开发者博客整理,资料核对于 2026-10-07。功能和价格变化快,以官网为准。

是什么

Gemini CLI 是 Google 推出的开源命令行 AI 智能体,采用 Apache 2.0 许可证,代码托管在 GitHub 的 google-gemini/gemini-cli 仓库。它把 Gemini 模型带进终端:读代码、改文件、执行 shell 命令、联网搜索,都在命令行里完成。

需要特别说明它的现状:2026 年 5 月 19 日,Google 宣布把面向个人用户的终端智能体统一到 Antigravity CLI。官方文档站横幅写明:免费档和 Google One(含 Google AI Pro / Ultra)用户的 Gemini CLI 已于 2026 年 6 月 18 日被 Antigravity CLI 取代。此后 Gemini CLI 仍面向两类用户继续服务:使用 付费 Gemini API Key(含 Gemini Enterprise Agent Platform)的开发者,以及通过 Gemini Code Assist 标准版 / 企业版 许可使用的组织。

Gemini CLI 终端界面:用自然语言让它创建 hello.py 并显示写文件操作

图片来源:Gemini CLI 官方 GitHub 仓库 README

能做什么

  • 理解和修改代码库:在项目目录里直接问「这个模块做什么」「帮我修这个报错」,它会读取文件并给出修改。
  • 内置工具:文件读写、执行 shell 命令、网页抓取、Google 搜索增强(grounding),不用自己拼脚本。
  • MCP 扩展:通过 Model Context Protocol 接入自定义工具和服务,也支持扩展(Extensions)、Hooks、子智能体等能力。
  • 项目记忆文件:在项目里放 GEMINI.md 写清约定和背景,每次会话都会读取。
  • 会话检查点:可保存和恢复对话进度,长任务中断后不用从头再来。
  • 接入 GitHub 工作流:官方提供 GitHub Action,可在 Issue 和 PR 里调用。

怎么上手

  1. 准备 Node.js 环境,执行 npm install -g @google/gemini-cli 安装;macOS / Linux 也可用 brew install gemini-cli,或用 npx @google/gemini-cli 免安装试跑。
  2. 在终端进入项目目录,输入 gemini 启动。
  3. 选择认证方式:个人开发者现在应使用付费 Gemini API Key(在 Google AI Studio 创建并开启结算);企业用户使用组织提供的 Gemini Code Assist 许可或 Vertex AI。
  4. 先让它熟悉项目:「读一下这个仓库,告诉我怎么在本地跑起来」。
  5. 在项目根目录写一个 GEMINI.md,列出代码风格和禁止事项。

如果你是免费档或 Google AI Pro / Ultra 个人用户,官方建议改用 Antigravity CLI,并提供了把技能、MCP 服务器等配置迁移过去的指南。

免费与付费

  • 工具本身:开源免费。
  • 模型调用:2026-06-18 之后,个人免费登录档已停止服务;通过付费 API Key 调用时按 Gemini API 的用量计费,具体单价以 Google AI 官方定价页为准。
  • 企业:持有 Gemini Code Assist 标准版 / 企业版许可的组织,官方表示访问不受影响,并继续获得更新和新模型。

注意:GitHub 仓库 README 里仍保留「个人账号每天 1,000 次免费请求」的旧说明,与官方博客和文档站的最新公告不一致,应以公告为准。

适合谁 / 不适合谁

适合:

  • 已有付费 Gemini API Key、想在终端里调用 Gemini 做编程的开发者。
  • 企业里已采购 Gemini Code Assist、需要沿用现有流程的团队。
  • 想研究或二次开发开源终端智能体代码的人。

不适合:

  • 想零成本使用的个人用户:免费通道已关闭,建议看 Antigravity CLI。
  • 不熟悉命令行的新手,图形界面工具会更友好。

注意事项

  • 地区限制:Gemini API 与 Google AI Studio 官方支持的国家和地区列表中不包括中国大陆和香港,相关服务受同样限制。
  • 命令执行风险:它可以执行 shell 命令和改文件,建议在 Git 仓库里使用、开启沙箱,并在确认前看清要执行的命令。
  • 产品还在调整:Google 已把个人用户的重心放到 Antigravity,Gemini CLI 后续路线以官方公告为准。
  • 核对输出:AI 生成的代码和命令都需要人工检查和测试后再上线。

Nathaniel 的更多内容

  1. 01

    Mastra 是什么、怎么用:TypeScript 的 AI 智能体与工作流框架

    Mastra 自称「面向 AI 应用和智能体的现代 TypeScript 框架」,提供 40 多家模型的统一路由、自主智能体、图式工作流、人工审批暂停与恢复、记忆、评测和可观测性,核心框架采用 Apache-2.0 许可。

    其他 AI 工具0
  2. 02

    NextChat(ChatGPT-Next-Web)是什么、怎么部署:一键搭建自己的 AI 聊天网页,全平台客户端

    NextChat 即原来的 ChatGPT-Next-Web,是 MIT 许可的开源 AI 聊天客户端,主打零配置:填入自己的 API Key 就能用 GPT、Claude、Gemini、DeepSeek 等模型,可一键部署到 Vercel 或用 Docker 自托管。

    其他 AI 工具0
  3. 03

    Whisper 语音识别模型是什么、怎么用:OpenAI 开源模型的本地安装、模型大小与显存要求

    Whisper 是 OpenAI 以 MIT 许可开源的通用语音识别模型,支持多语言转写、语音翻译和语种识别,提供 tiny 到 large 以及 turbo 多种大小,可用一条 pip 命令安装后在本机离线转写音频。

    其他 AI 工具0
  4. 04

    Stable Diffusion WebUI(AUTOMATIC1111)是什么:下载安装、硬件要求与使用教程

    Stable Diffusion WebUI(AUTOMATIC1111)是最知名的开源本地 AI 绘图界面,免费在自己电脑上运行 Stable Diffusion 模型,支持文生图、图生图、局部重绘和海量扩展,需要独立显卡。

    其他 AI 工具0
  5. 05

    Wolfram Alpha 是什么、怎么用、Pro 版多少钱:给出分步解题过程的计算知识引擎

    Wolfram|Alpha 是 Wolfram 公司的计算知识引擎,直接计算数学、物理、化学、金融等问题的答案;Pro 版提供分步解答、带提示的练习题、文件上传分析和更长的计算时间。

    其他 AI 工具0
  6. 06

    Activepieces 是什么、怎么用:可自部署的开源自动化平台(Zapier 替代),AI 智能体与 MCP

    Activepieces 是开源的 AI 自动化平台,定位为 Zapier 的开源替代:可视化搭建工作流和 AI 智能体,集成(称为 pieces)用 TypeScript 编写,其中 280 多个可作为 MCP 服务器使用,社区版以 MIT 许可发布。

    其他 AI 工具0

同主题

  1. 01

    CodeGeeX 是什么、怎么样、怎么用:智谱的 AI 编程助手插件,支持 VS Code 与 JetBrains

    CodeGeeX 是智谱推出的 AI 编程助手,以 IDE 插件形式提供代码生成与补全、自动注释、代码翻译和智能问答,模型 CodeGeeX4-ALL-9B 已开源,另有可私有化的企业版。

    其他 AI 工具0
  2. 02

    GitHub Copilot 怎么用:订阅档位、学生认证与上手指南

    GitHub Copilot 是 GitHub(微软旗下)的 AI 编程助手,以插件形式进入 VS Code、JetBrains、Xcode 等常用 IDE,也有命令行、桌面 App 和云端智能体,可直接在 GitHub 上接 Issue 提 PR。

    GitHub Copilot0
  3. 03

    Exa 是什么、怎么用、怎么收费:为大模型设计的网络搜索与内容 API

    Exa 是面向 AI 应用的按量付费搜索 API,提供 Search、Contents、Answer、Monitors 和用于深度调研的异步 Agent,注册即有 10 美元免费额度。

    其他 AI 工具0
  4. 04

    Microsoft Foundry(原 Azure AI Foundry / Azure AI Studio)是什么:微软的 AI 应用与智能体开发平台

    Microsoft Foundry 是微软 Azure 上构建、接地和治理 AI 应用与智能体的统一平台,前身为 Azure AI Studio,可访问 11,000 多个模型,包含 Foundry Models、Agent Service、Foundry IQ 等组件。

    其他 AI 工具0
  5. 05

    Chroma(ChromaDB)是什么、怎么用:几行代码就能跑起来的开源向量数据库

    Chroma 是 Apache-2.0 许可的开源向量数据库,自称「面向 AI 的开源数据基础设施」,核心 API 只有四个函数,可自动完成分词、嵌入和索引,支持内存、持久化与客户端-服务器模式。

    其他 AI 工具0
  6. 06

    AutoGen 是什么、现在还能用吗:微软多智能体框架已进入维护模式,继任者是 Microsoft Agent Framework

    AutoGen 是微软开源的多智能体应用框架,包含 Core、AgentChat、Extensions 和无代码界面 AutoGen Studio。官方仓库已声明它进入维护模式,新项目建议转向继任者 Microsoft Agent Framework。

    其他 AI 工具0

同模型

  1. 01

    NotebookLM 是什么、怎么用:官网入口与上手指南(现名 Gemini Notebook)

    NotebookLM 是 Google 的 AI 资料笔记本,2026 年 7 月改名 Gemini Notebook:把 PDF、网页、YouTube 视频等资料放进去,AI 只根据你的资料回答并标注出处,还能生成播客式音频概览和视频概览。

    Gemini0
  2. 02

    Gemini 是什么、怎么用:Google AI 助手官网入口与免费版说明

    Gemini 是 Google 的 AI 助手,和 Gmail、云端硬盘等 Google 服务打通,内置 Nano Banana 生图改图、Deep Research 和语音 Live。本文讲清入口、免费版能用什么、Plus / Pro / Ultra 区别。

    Gemini0
  3. 03

    Google AI Studio 官网入口与使用教程:免费试 Gemini、获取 API Key

    Google AI Studio 是 Google 面向开发者的 Gemini 试验场:调提示词、测模型、拿 API Key,还能用 Build 模式一句话生成并部署应用。

    Gemini0
  4. 04

    Android Studio 里的 Gemini 是什么、怎么用、免费吗:安卓开发的 AI 智能体与 Agent Mode

    Gemini in Android Studio 是内置在 Android Studio 里的 AI 开发助手:Agent Mode 可跨代码库规划多步任务并在模拟器里验证,另有 Next Edit Prediction、Compose 界面生成、Journeys 测试和崩溃分析。

    Gemini其他 AI 工具0

同产品的其他教程

  1. 01

    Google Flow 是什么、怎么用:用 Veo 做 AI 视频的官网入口与教程

    Google Flow 是谷歌推出的 AI 影视创作工具,集成 Veo 3.1 视频模型、Gemini Omni Flash 和 Nano Banana 图片模型,支持首尾帧、素材参考、延长和 Flow Agent,额度与 Google AI 订阅挂钩。

    Gemini0
  2. 02

    Jules 是什么:Google 异步编程智能体怎么用、免费每天几次

    Jules 是 Google Labs 推出的异步编程智能体:连上 GitHub 仓库后,在云端虚拟机里修 bug、写测试、升级依赖,做完提 PR 给你审。

    Gemini0
  3. 03

    Google Antigravity 是什么、怎么用:2.0 桌面版、IDE 与 CLI 使用教程

    Google Antigravity 是 Google 的智能体开发平台,包含 Antigravity 2.0 桌面应用、IDE 和 CLI,可并行管理多个 AI 智能体写代码、跑任务。

    Gemini0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~