Gemini CLI安装使用教程：免费AI编程工具配置指南

前言：为什么选择Gemini CLI

当身边的开发者纷纷用上了AI辅助编程工具，你是否还在坚持"古法编程"？目前市面上主流的AI编程工具中，Claude Code虽然强大，但存在封号风险且价格不菲。而Google推出的Gemini CLI提供了一个免费且强大的替代方案——它基于Gemini 2.5 Pro模型，每天提供1000次免费请求，对于个人开发者来说几乎是零成本的AI编程助手。

关于Gemini 2.5 Pro：这是Google DeepMind于2025年推出的旗舰多模态大语言模型，在代码生成、数学推理和长上下文理解方面表现突出。其上下文窗口高达100万token，意味着它可以一次性处理相当于一本厚书的代码库，这对于大型项目的重构和分析尤为重要。在主流编程能力评测基准（如HumanEval、SWE-bench）中，Gemini 2.5 Pro与Claude 3.5 Sonnet、GPT-4o处于同一梯队，但Google通过免费API额度策略大幅降低了使用门槛。

当前AI编程工具市场已形成多足鼎立的格局：Anthropic的Claude Code专注于深度代码理解和重构，OpenAI的Codex系列深度集成于GitHub Copilot，微软通过VS Code插件生态构建了庞大的用户基础，而Cursor则以AI原生IDE的形态快速崛起。Gemini CLI的差异化策略在于：以命令行形态切入、不绑定特定编辑器、提供慷慨的免费额度，主要面向习惯终端操作的开发者群体以及希望低成本尝鲜AI编程的新手用户。

本文将手把手带你完成Gemini CLI的安装配置，并通过一个实际案例展示它的编程能力。

Node.js环境安装：运行Gemini CLI的前提条件

Gemini CLI基于Node.js运行，因此首先需要确保系统已经安装了Node.js环境。如果你在终端执行命令时提示找不到npm，那就需要先安装Node.js。

Node.js与npm简介：Node.js是基于Chrome V8引擎构建的JavaScript运行时环境，自2009年发布以来已成为前后端开发的核心基础设施。npm（Node Package Manager）是随Node.js捆绑安装的包管理工具，目前托管超过200万个开源软件包，是全球最大的软件注册表。简单来说，npm之于Node.js，就像App Store之于iPhone——它让开发者可以一键安装和管理各类工具与依赖库。

Node.js下载与安装步骤

1. 前往Node.js官网（https://nodejs.org）下载对应系统的安装包
2. Mac用户直接下载.pkg文件，双击运行
3. 按照安装向导一路点击"继续"→"同意"→输入密码→完成安装

安装完成后，在终端输入node -v和npm -v验证是否安装成功。看到版本号输出即代表环境准备就绪。

Gemini CLI安装：一条命令搞定

环境准备好后，就可以正式安装Gemini CLI了。Google官方提供了通过npm一键安装的方式。

Gemini CLI安装命令

在终端中执行以下命令：

npm install -g @google/gemini-cli

如果遇到权限错误，Mac/Linux用户需要在命令前加上sudo：

sudo npm install -g @google/gemini-cli

命令解析：npm install -g中的-g标志表示全局安装（global），意味着该工具会被安装到系统级目录，可在任意路径下直接调用，而非仅限于当前项目目录。这也是为什么安装一次后，你可以在电脑的任何文件夹里直接输入gemini命令来启动它。

输入系统密码后等待安装完成。当再次执行安装命令没有任何输出时，说明已经安装成功。

创建工作目录

安装完成后，建议创建一个专门的工作目录来测试：

mkdir gemini-test
cd gemini-test

然后在该目录下输入gemini命令启动CLI工具。看到交互界面出现，就代表安装成功了。

Gemini CLI账号认证与登录配置

首次启动Gemini CLI时，需要完成Google账号的认证流程。

Google账号认证步骤

1. 选择登录方式：系统会提示选择验证方式，直接选择第一种（浏览器登录）即可
2. 浏览器授权：系统会自动打开浏览器，选择一个已开通Gemini服务的Google账号进行登录
3. 确认授权：在浏览器中完成授权后，终端会提示"You were successfully signed into Google"
4. 重启CLI：按下R键重启Gemini CLI

重启后可以看到终端显示已连接到Gemini模型，此时就可以开始使用了。首次使用可能还需要解锁一次访问权限，按照提示操作即可。

实战演示：用Gemini CLI自动生成抽奖程序

配置完成后，让我们通过一个实际案例来体验Gemini CLI的AI代码生成能力。

用自然语言下达编程任务

在Gemini CLI中直接输入需求描述：

你给我用HTML代码写一个随机的年会抽奖程序出来，可以直接运行的那种

AI自动编码过程：Agent模式的魔力

Gemini CLI收到指令后，会进入"thinking"状态进行分析和规划，然后自动开始编写代码。这背后运行的是AI Agent（智能代理）工作模式：它不仅能生成代码片段，还能主动规划任务步骤、调用文件系统操作、执行Shell命令，并在关键节点请求用户授权确认。这种"规划→执行→反馈"的循环机制，正是它区别于普通代码补全工具（如GitHub Copilot）的核心所在——后者只是被动响应光标处的上下文，而Agent模式的工具能主动推进整个开发任务直至完成。

在这个过程中，它会多次询问你是否允许执行某些操作（如创建文件、写入内容等），你只需要点击"同意"即可。

整个过程中，开发者的操作被简化到了极致——键盘上只需要"同意"和"执行"两个动作，完全不需要自己手写一行代码。

生成的抽奖程序效果

Gemini CLI自动生成了一个完整的index.html文件，包含：

• 开始抽奖按钮：点击后名单开始滚动
• 停止按钮：点击后随机停在某个名字上
• 中奖提示：弹出"恭喜中奖"的动画效果

直接在浏览器中打开这个HTML文件就能运行，无需任何额外配置。从下达需求到拿到可运行的成品，整个过程不超过两分钟。

Gemini CLI对开发者意味着什么

开发效率的质变

Gemini CLI这类AI编程工具带来的不仅仅是效率提升，而是开发模式的根本性转变。开发者的角色正在从"代码编写者"转变为"需求描述者和代码审核者"。这一转变在软件工程领域被称为意图驱动编程（Intent-Driven Programming）——开发者只需清晰表达"想要什么"，而非"如何实现"，AI负责填补中间的技术细节。

大幅降低编程门槛

更值得关注的是，这种工具正在降低编程的准入门槛。产品经理甚至运营人员也可以借助Gemini CLI完成简单的开发任务，只要稍微懂一些代码基础就行。具体来说：

• 非专业开发者可以快速实现简单的功能需求
• 专业开发者可以将精力集中在架构设计和复杂逻辑上
• 团队协作效率将得到显著提升

Gemini CLI核心优势一览

特性	说明
免费额度	每天1000次请求，个人使用完全够用
模型能力	基于Gemini 2.5 Pro，代码生成质量高
使用门槛	命令行交互，自然语言描述需求即可
稳定性	相比某些工具，封号风险较低
Agent能力	主动规划和执行多步骤任务，而非仅补全代码

总结

如果你还在"古法编程