3分钟安装使用Gemini CLI,在国内使用Gemini CLI教程!

927 阅读7分钟

命令行工具(CLI)作为开发者日常工作中不可或缺的效率利器,随着AI能力的深度融合,CLI正从传统的命令执行器,演变为更智能、更具交互性的开发助手。Google也推出了其创新的AI命令行代理——Gemini CLI。这款工具旨在将强大的Gemini模型直接引入开发者的终端环境,让AI的强大能力触手可及。

Gemini CLI 不仅仅是一个简单的AI工具,它更像是一个能够理解复杂指令、自主规划并执行多步任务的智能代理,彻底改变了开发者与终端的交互方式,将AI辅助从IDE扩展到了纯命令行界面。

环境准备

在安装Gemini CLI之前,需要确保系统满足以下基本要求:

  • • Node.js
    在安装Gemini CLI之前,请务必确保系统已安装Node.js,并且版本为18或更高。可以在终端中运行node -v命令来检查当前Node.js版本。

  • • 注册GAC
    在国内使用需要在gacode进行注册,注册完成即可授权使用,如无权限使用,发送任意邮件到gaccode@163.com邮箱即可。

1、安装 Node.js

需要安装Node.js环境,可以通过以下的方式安装:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs

确认是否安装成功。

node --version
npm --version

出现具体的版本信息则代表环境安装成功,这里需要确保Node.js为18.0 或更高版本,之后就可以继续下一步了。

确保 npm 与 Node.js可用后,就可以通过以下命令安装代理的Gemini Cil,该命令会从配置的源下载并安装程序包。

npm install -g https://gaccode.com/gemini/install

回到终端窗口,愉快的开始使用gemini,

运行后会打开一个网页按流程注册登录后授权,如授权后提示403报错现“No Active Subscription” 提示联系请发送任意邮件到gaccode@163.com即可获取权限。如授权后提示403报错现“No Active Subscription” 提示联系请发送任意邮件到gaccode@163.com即可获取权限。

模型切换

您可以覆盖默认模型(gemini-2.5-pro)以使用不同的 Gemini 模型:

`# 例如:使用 gemini-3-pro-preview gemini --set-model gemini-3-pro-preview

清除模型覆盖(使用默认)

gemini --set-model`

模型覆盖保存在 ~/.gemini/model_override 文件中,会在会话之间保持。

初识Gemini CLI:你的智能终端助手

什么是Gemini CLI?

Gemini CLI是一款开源的AI代理,它采用独特的“思考-行动”(ReAct)循环机制,结合其内置工具和Model Context Protocol (MCP) 服务器,直接在终端中完成从简单到复杂的各类任务。这意味着它不仅能理解自然语言指令,还能智能地规划并执行一系列操作来达成目标,例如代码生成、文件操作、甚至与外部服务的交互。

尽管Gemini CLI在代码辅助方面表现卓越,能够高效地协助开发者修复bug、创建新功能、甚至提高测试覆盖率,但其功能远不止于此。它是一个极其多功能的本地实用工具,可以广泛应用于内容生成、复杂问题解决、深度研究乃至日常任务管理等多个领域,极大地拓展了终端的可能性。

值得注意的是,Gemini CLI是Google AI编码助手Gemini Code Assist的核心技术支撑。这意味着无论开发者选择在传统的终端环境,还是在VS Code等集成开发环境(IDE)中使用Gemini Code Assist的代理模式,都能享受到一致且强大的AI辅助体验,确保工作流的连贯性和高效性。

Gemini CLI 的核心亮点

Gemini CLI的推出,带来了多项引人注目的特性,使其成为开发者工具箱中的新宠:

  • • 慷慨的免费使用额度与强大的模型支持
    对于个人开发者而言,Gemini CLI提供了一个极具吸引力的免费使用层级。只需使用个人Google账户登录,即可免费获得Google最先进的Gemini 2.5 Pro模型支持,并享受高达100万个Token的巨大上下文窗口。在预览期间,Google还提供了每分钟60次请求和每天1000次请求的免费额度,这对于绝大多数日常开发和探索性工作来说,是绰绰有余的。
    Google选择为个人开发者提供如此慷慨的免费使用额度,包括强大的Gemini 2.5 Pro模型和百万级Token上下文窗口,这极大地降低了开发者尝试和采纳 Gemini CLI 的门槛,使得大量用户能够无成本地体验其强大功能。这种广泛的用户基础有助于快速形成社区效应,收集反馈,并培养用户对Google AI工具的粘性。这表明Google可能更看重通过免费策略快速占领市场,建立用户生态,而非短期内直接从个人用户身上获取高额利润,为未来更深层次的商业化或企业级解决方案奠定基础。
  • • 终端内的全能AI能力
    Gemini CLI的独特之处在于它将强大的AI能力直接带入终端,允许用户使用自然语言进行编码、调试、文件操作和命令执行,从而极大地简化了开发工作流。它能够通过集成Google搜索来“接地气”,利用实时网络信息增强提示的准确性和相关性;同时,它还支持高度自定义的提示和指令,甚至能够自动化复杂的开发任务并无缝集成到现有的工作流中,实现真正的智能自动化。
  • • 高度可扩展与定制化
    Gemini CLI被设计为高度可扩展和可定制的工具。它基于Model Context Protocol (MCP) 等新兴开放标准构建,支持通过项目中的GEMINI.md文件进行系统提示和行为配置,以及个人用户和团队级别的设置。作为一个完全开源的项目(采用Apache 2.0许可证),它邀请开发者查看其源代码,理解其内部运作机制,并积极贡献力量,共同报告bug、提出功能建议、增强安全性,使其成为一个真正由社区驱动、个性化的开发环境。
    Gemini CLI作为开源项目并采用开放标准,这不仅仅是技术上的开放,更是一种生态系统建设的信号。开源特性鼓励开发者深入了解代码、提出改进建议并直接贡献代码,从而加速了工具的迭代速度和功能丰富度。同时,基于开放标准的扩展性意味着第三方开发者可以更容易地为Gemini CLI开发插件或集成,进一步拓宽其应用场景,最终可能形成一个充满活力的、自生长的AI开发工具生态系统。
  • • 丰富的内置工具与Shell模式
    Gemini CLI内置了多种实用工具,极大地增强了其在终端中的能力。这些工具包括但不限于:grep(用于在文件中进行文本搜索)、terminal(直接执行终端命令)、file read/write(进行文件内容的读写操作)、Web search(执行网页搜索以获取实时信息)、Web fetch(抓取网页内容进行分析)等。此外,通过其独特的Shell模式,用户可以直接用自然语言向Gemini提问或发出指令,Gemini会智能地将其转换为可执行的Shell命令,并根据需要执行,极大地简化了复杂的命令行操作。

****