Gemini CLI 怎么用?2026 谷歌免费终端 AI 编程助手完整教程(附安装与实操步骤)
Gemini CLI 是谷歌开源的免费终端 AI 智能体。本教程手把手带你安装、登录并跑通第一个实操任务,讲清它与 Claude Code 的区别、免费额度与上手技巧。
很多人第一次听说 Gemini CLI 都会问一句:这不就是「命令行版的 ChatGPT」吗?其实不止。Gemini CLI 是谷歌开源的一个终端 AI 智能体(AI agent),你在黑框框里用大白话下指令,它就能自己读文件、跑命令、查资料、改代码——而且个人 Google 账号就能免费用。这篇 Gemini CLI 教程会带你从安装、登录到第一个实操任务一次跑通,并说清楚它到底适合谁、坑在哪。
Gemini CLI 是什么?和 Claude Code 有什么区别
Gemini CLI 是谷歌在终端里提供的 AI 编程与自动化助手,采用 Apache-2.0 开源协议,任何人都能审计、fork、二次修改。它内置了 Google 搜索接地、文件读写、Shell 命令执行、网页抓取等工具,还支持 MCP(Model Context Protocol) 扩展,能接你自己的数据源。
它和 Anthropic 的 Claude Code 定位几乎一样,都是「代理式」终端助手。最大差异在成本:Gemini CLI 用个人 Google 账号登录就送每分钟 60 次、每天 1000 次的免费额度,模型是 Gemini 3 系列,上下文窗口高达 100 万 token。对预算敏感的个人开发者,这个免费额度非常香。想对比另一款主流工具,可以看这篇 Claude Code 完整教程。
Gemini CLI 怎么安装?三步搞定
安装几乎没有门槛,前提是本机装好 Node.js 18 以上版本。
- 全局安装:打开终端,运行
npm install -g @google/gemini-cli。 - 不想全局装?直接
npx https://github.com/google-gemini/gemini-cli先试跑一次。 - 启动:装完输入
gemini回车,首次运行会弹出浏览器让你用 Google 账号授权登录,选一个主题配色即可进入。
装好后输入 gemini --help 能看到全部命令。根据谷歌官方公告,登录后即刻享有免费额度,无需绑卡。
第一个实操任务:让它帮你读懂一个项目
光装好没用,来跑个真任务。假设你接手一个陌生代码仓库:
- 用
cd进入项目目录,再输入gemini启动。 - 直接打字:
帮我梳理这个项目的目录结构,并用中文解释每个核心文件是做什么的。它会自己调用文件读取工具扫一遍再总结。 - 追问:
把 README 缺失的「快速开始」部分补上,写好后让我确认再保存。 - 想联网核实版本号?加一句
用 Google 搜索查一下这个依赖的最新稳定版,它会用内置搜索接地工具去查。
关键技巧:在项目根目录放一个 GEMINI.md 文件,把项目背景、代码规范、你的偏好写进去,Gemini CLI 每次都会自动读它,回答质量立刻上一个台阶。这一步和写好 AI 提示词一样,是决定效果的分水岭。
Gemini CLI 能做什么?不止写代码
| 场景 | 具体用法 |
|---|---|
| 代码辅助 | 读懂旧项目、批量重构、写单元测试、修 bug |
| 长文档处理 | 100 万 token 上下文,一次性喂进整份规范、日志分析 |
| 脚本自动化 | 写好后用 gemini -p "指令" 非交互式跑,接进 CI/CD |
| 联网查资料 | 内置 Google 搜索接地,回答带最新信息 |
| 多模态 | 丢图片、PDF 进去让它解读 |
Marco 观点:什么人该现在就上手
我的判断很直接:如果你已经在用 Claude Code,Gemini CLI 值得当「免费副驾」并存,而不是二选一。 理由有三。第一,1000 次/天的免费额度足够覆盖大部分个人日常需求,用它跑一些「不心疼额度」的批量小活最划算。第二,它的 Google 搜索接地在「查最新资料 + 写代码」这种混合任务上体验很顺。第三,开源可自托管,对数据敏感的团队更好交代。
坑也要说清楚:多数新手不是卡在命令,而是卡在登录授权和 Node 环境——先把这两件事理顺再谈别的。另外免费额度虽高但不适合无人值守的高频生产任务,重度商用还是要走付费 API。对中小团队,我的建议是「Gemini CLI 练手 + 探索,重活按需上付费模型」。
常见问题 FAQ
Q:Gemini CLI 免费吗? A:用个人 Google 账号登录即免费,额度为每分钟 60 次、每天 1000 次请求,无需绑定信用卡。
Q:Gemini CLI 和 Gemini 网页版有什么不同? A:网页版是聊天窗口;CLI 是能读写你本地文件、执行命令的智能体,适合开发和自动化,动手能力强得多。
Q:一定要会编程才能用 Gemini CLI 吗? A:不必精通,但需要会基本的终端操作(cd、运行命令)。非开发者也能用它做文档分析、脚本化整理。
Q:Gemini CLI 支持中文吗? A:支持,直接用中文下指令和对话即可,回答也可以指定中文。
延伸阅读
- Anthropic 经济指数现在能直接问 Claude 了:AI 到底在抢谁的活?2026 全解析
- Claude Code 是什么、怎么用?2026 新手到自动化工作流完整教程
- Google Gemini 3.6 Flash 发布全解析:价格、跑分与怎么用
写在最后
Gemini CLI 把「问 AI 怎么做」升级成了「让 AI 直接去做」,而且门槛低到一条 npm 命令。别只收藏不动手——今天就装上,拿一个真实项目跑一遍,你会对「终端里的 AI 智能体」有全新的体感。想持续获取这类 AI 工具实战教程,欢迎关注 Marco聊科技,订阅我们的免费 AI 资源合集,第一时间拿到可复现的上手步骤。