Gemini CLI安装使用教程：免费调用Gemini 3 Pro写代码

为什么选择Gemini CLI

在AI编程工具这条赛道上，开发者的选择越来越多，但钱包的压力也越来越大。Claude Code会员费用不菲且时不时传出封号消息，OpenAI的充值门槛同样不低。这时候，Google推出的Gemini CLI就显得格外香了——开通Google One AI Premium会员（约几十元/年），就能用上Gemini 2.5 Pro、Gemini 3 Pro等顶级模型，还能在命令行里直接写代码，性价比拉满。

Gemini CLI的定位和Anthropic的Claude Code类似，都是基于命令行的AI编程客户端。它能在终端里直接跟大模型对话，帮你创建文件、修改代码、生成完整页面，全程不用切出开发环境。

AI编程工具赛道的现状

AI编程工具（AI Coding Assistant）是指利用大语言模型帮助开发者编写、调试和优化代码的软件工具。这个赛道从2022年GitHub Copilot正式发布后迅速升温，目前主要玩家包括GitHub Copilot（基于OpenAI Codex）、Cursor（集成多种模型的IDE）、Claude Code（Anthropic推出的命令行工具）以及Google的Gemini CLI。这些工具的核心差异在于交互方式（IDE插件 vs 命令行）、底层模型能力、定价策略和生态整合度。命令行类工具（CLI-based）的优势在于不依赖特定IDE，可以与任何开发环境配合使用，且对系统资源占用更少——这也是Gemini CLI和Claude Code选择这种形态的原因。

安装前准备：配置Node.js环境

安装Gemini CLI之前，先确认本地已经装好了Node.js，而且版本号必须大于20。

Node.js是一个基于Chrome V8引擎的JavaScript运行时环境，它让JavaScript代码能够脱离浏览器在服务器端或本地计算机上运行。npm（Node Package Manager）是Node.js的默认包管理器，也是全球最大的开源软件注册表，托管了超过200万个JavaScript包。Gemini CLI要求Node.js 20+是因为它依赖了该版本引入的一些新特性，如原生fetch API、改进的ES模块支持以及更稳定的权限模型等。

Node.js安装步骤

1. 打开 nodejs.org 官网
2. 根据你的操作系统（Windows/macOS/Linux）下载对应安装包
3. 双击安装包，一路点"下一步"就行
4. 装完之后，打开终端输入以下命令验证：

node -v

终端显示的版本号大于v20，说明Node.js环境没问题，可以继续下一步。

一分钟安装Gemini CLI

Gemini CLI有两种安装方式可选：

• 临时运行：npx @google/gemini-cli（不安装，跑一次就完事）
• 全局安装：npm install -g @google/gemini-cli（推荐日常开发使用）

npx是npm 5.2+版本自带的命令，它允许你直接执行npm包中的命令而无需全局安装——适合偶尔尝鲜的场景。而全局安装（-g参数）会将包安装到系统级目录，使得gemini命令在任何路径下都可用，适合日常高频使用。

如果你打算长期用，建议直接全局安装：

npm install -g @google/gemini-cli

保持网络畅通，不到一分钟就能装完。装好之后，输入gemini命令试一下：

gemini

终端出现Gemini的Logo图标，说明安装成功了。

账号登录与模型配置

登录Google账号

第一次启动Gemini CLI，系统会让你选择认证方式：

1. 登录Google账号（推荐Pro会员用这个）
2. 填写Gemini API Key（通过Google AI Studio获取）

这两种认证方式的本质区别在于：账号登录走的是Google的消费者产品通道，调用配额与订阅等级绑定，Pro会员通常享有更高的每日请求次数和更快的响应优先级；API Key走的是开发者平台通道，免费层有每分钟请求数限制（RPM）和每日token上限，灵活性更高但需要自行管理密钥安全。

选第一种后，浏览器会自动弹出Google登录页面。建议用Google One AI Premium会员账号登录，Pro会员的调用额度更高、响应速度也更快。Google One AI Premium除了提供2TB云存储外，还包含Gemini高级模型的完整使用权限以及NotebookLM Plus等附加产品的访问权。

验证通过后关掉浏览器，回到终端就能看到登录信息已经配好了。

切换到Gemini 3 Pro最新模型

Gemini CLI默认用的是Gemini 2.5模型，不是最新版。想用上Gemini 3 Pro，需要手动改一下配置：

1. 在Gemini主界面输入 /settings 回车
2. 找到"Preview Model"选项，默认是false
3. 按回车切换成true
4. 按ESC退出设置界面
5. 关掉终端重新启动Gemini CLI（改完配置必须重启才生效）

重启之后，底部显示的模型名称会变成最新版本。进入Model选项可以确认，当前可选的模型包括Gemini 3 Pro和Gemini 3 Flash。

Gemini模型版本说明

Google的Gemini模型家族经历了快速迭代：Gemini 1.0（2023年12月）→ Gemini 1.5（2024年2月，引入百万级token上下文窗口）→ Gemini 2.0/2.5（2024-2025年，强化推理和代码能力）→ Gemini 3 Pro（最新版本）。Pro系列定位为高性能通用模型，擅长复杂推理、长文本理解和代码生成；Flash系列则是轻量快速版本，适合对延迟敏感的场景。Preview Model设置项的作用是让用户提前体验尚未正式GA（General Availability）的最新模型版本，这些预览版通常性能更强但可能存在稳定性波动。

实战演示：用Gemini CLI生成登录页面

创建项目目录并启动

用Gemini CLI写代码，第一步是准备好项目文件夹：

1. 新建一个英文命名的文件夹，比如gemini-demo
2. 在这个文件夹里打开终端（Windows可以右键→在此处打开CMD）
3. 输入gemini启动客户端

启动后，所有AI操作都会在当前文件夹下执行。可以先跑一下/init命令，让Gemini了解当前项目的目录结构。/init命令的作用类似于让AI进行项目扫描（Project Scanning），它会遍历当前目录结构，建立对项目整体架构的理解，从而在后续对话中给出更符合项目上下文的建议。

用自然语言生成页面代码

接下来直接用中文描述你想要什么就行：

生成一个美观大气的登录页面 login.html

回车之后，Gemini会自动在当前文件夹里创建login.html，并写入完整的页面代码。

实测下来，Gemini 3 Pro生成的登录页面质量相当不错——布局合理、样式美观，基本可以直接拿来用。

修改与迭代优化

对生成结果不满意？直接在Gemini CLI里改就行。比如把页面里的英文全换成中文：

1. 输入@符号，系统会列出当前项目里的所有文件
2. 输入文件名（支持Tab键补全），比如login.html
3. 描述你的修改需求：将页面中的所有英文改为中文
4. 回车执行

@符号引用机制是一种上下文注入（Context Injection）设计模式。当你输入@filename时，CLI会将该文件的完整内容作为上下文发送给大模型，使模型能够理解文件的当前状态并据此生成精准的修改方案。Tab补全功能则利用了终端的readline接口，实时读取文件系统来提供路径建议，避免手动输入长文件名时的拼写错误。

Gemini会自动读取文件内容，找到所有英文文本，直接在原文件里完成替换——"Welcome Back"变成"欢迎回来"，"Email"变成"邮箱"，不用手动复制粘贴任何东西。

除了翻译文本，你还能用同样的方式调整配色、添加交互功能、修改页面布局，全程只需要打字描述需求。这种工作流的本质是将传统的"阅读文档→编写代码→调试验证"循环压缩为"描述需求→确认结果"的两步流程，大幅降低了重复性编码工作的时间成本。

总结与建议

Gemini CLI给开发者提供了一个低成本又好用的AI编程方案。跟动辄上百元月费的同类工具比起来，Google One AI Premium会员的价格确实有竞争力，而且除了Gemini CLI，还能用NotebookLM等一系列Google AI产品。

对于想快速上手AI辅助编程的开发者来说，Gemini CLI的上手门槛很低：装起来一分钟，用起来就是打字聊天。不管是从零开始生成项目，还是在现有代码上迭代优化，它都能搞定。

两点需要注意：一是确保网络能正常访问Google服务，二是Node.js版本要在20以上。满足这两个条件，就可以开始体验了。

核心要点

• Gemini CLI是Google推出的命令行AI编程工具，功能类似Claude Code，但成本更低
• 安装前需确保Node.js版本大于20，通过npm全局安装仅需不到一分钟
• 登录Google Pro会员账号后，需在Settings中开启Preview Model才能使用最新的Gemini 3 Pro模型
• 支持自然语言交互，可直接生成完整页面文件并在原文件上进行迭代修改
• 使用@符号可引用项目文件，支持Tab补全，实现精准的文件级代码修改