Gemini CLI 的安装和使用入门指南

Gemini CLI 是谷歌推出的开源 AI 命令行工具，一款类似 Claude Code 的产品。

Claude Code 这几个月比较火，确实好用，但是对于个人来说使用成本还是太贵了，让大家不得不把Claude Code 配置的大模型从 Anthropic 家的 Claude 替换成国内的一些其他模型，那这样效果就差点意思。

谷歌同期推出的 Gemini CLI，背后使用的是Gemini 2.5 Pro 模型，并且到现在对个人用户一直挺慷慨，支持用户每分钟最多60次，每天最多1000次的请求。

作为一直使用 Google Gemini 2.5 Pro 的白嫖怪，我感觉 Gemini 2.5 Pro 真挺不错的，单会话支持100W的Token上下文。所以今天分享记录一下 Gemini CLI 的安装和使用指南。

主要涉及下面几个点：

• 安装Gemini CLI 后怎么解决登录不成功的问题
• 演示用 Gemini CLI 开发一个天气预报网页程序
• 介绍 Gemini CLI 的提示和技巧

安装 Gemini CLI

Gemini CLI 需要有 Node 环境才能安装，如果电脑上还没有Node环境，推荐安装一个 NVM。用NVM 安装v20 以后的版本，我测试了一下，v18 版本的Node环境安装 Gemini CLI，没安装成功。

有了Node环境后，通过下面的 npm 命令来安装 Gemini CLI

sudo npm install -g @google/gemini-cli

安装完成后，在命令行键入 gemini 命令即可进入 Gemini CLI。

首次使用的时候会让你进行登录授权，这记得使用 Google 账号授权，这种方式支持我们每分钟免费60次，每天最多免费1000次请求（不得不说，还是大公司有钱啊）。

选择「Login with Google」后会在浏览器上打开一个Oauth2 授权的页面。

选择账号，并点击登录后会开启授权流程。

不出意外的话，你在进行到这一步时会出意外。 页面会一直转圈卡住，最后显示授权登录失败

解决授权登录失败的问题

上面这个登录授权失败的问题要解决它，首先得确定一下你是否挂了VPN，而且VPN的节点最起码要选到日本，因为 Gemini 的大模型在中国大陆、中国香港、中国台湾、新加坡都不能用，所以VPN的节点要不就选欧美节点，至少也要是日本节点，有的便宜的或者能白嫖的代理其实只有香港的网络节点，这个一定要注意。

上面的问题解决后为，我们要为终端设置代理，这是最关键的一步。我们需要为当前终端会话设置 https_proxy环境变量，将 Gemini CLI 的网络请求指向你的本地代理端口。

具体步骤，找到你的VPN工具，看一下它设置的网络请求本地代理端口，或者是像下图这样把命令复制出来看下本地代理的端口（不同的工具，界面会不一样，仅供参考）

接下来我们在终端中重新执行

export https_proxy=http://127.0.0.1:{代理端口}; gemini

这一次，再重复上吗Google 登录授权的流程，就能很顺利地到授权成功啦。

终端

用Gemini CLI 创建开发新项目

接下来我们试验一下，让Gemini 写一个查看天气预报的网页项目，我们对话框中输入

请帮我写一个天气预报的网页，默认可以查看北京、上海的天气，支持添加其他城市

Gemini CLI 根据提示词做好规划，并询问你建议和是否开始。

上面我提供的并不是一个好的提示词，这里只是为了演示方法，正式项目还是提供好各种要求和约束，比如要求它是用Vue + Vant 的技术栈等。

Gemini CLI 创建项目期间我还遇到了一些目录权限的问题，调整后Gemini 就能自己开始写代码了

我们看下项目最终的运行效果

我们再添加一个城市测试一下

不得不说“功能OK，但是样式有点丑”，这跟我们给的提示词太宽泛有关系，正式项目我们还是要提供一个相对完备的提示词，做好各种约束，而且还可以利用Gemini对多模态的支持把一下设计图给到它，这样才能让Gemini 写出更接近生产级的项目。

在Gemini 开发过程中一直有这个提示

这是因为Mac 命令行工具打开后工作目录默认在用户目录， 所以我们最好的方式是在终端把工作目录存放到开发项目的目录后，再运行 gemini， 这样开启的会话里就不会再有这个提示了。

Gemini CLI 开发现有项目

我们在终端 Gemini CLI 的会话窗口中通过 @{文件路径} 即可把对应的文件或者目录提交给Gemini 的上下文中，比如我直接把我一直更新的付费专栏的Go项目的目录提交给Gemini，让它分析一下项目的设计和架构信息

内容太长，下面直接放Gemini 的总结。

看来Gemini 总结的挺好，夸这个项目也是真的会夸（哈哈哈哈哈）

更多的提示和技巧我们可以在会话框中输入 "/" 就会提示出各种可用的快捷指令。

除了在VsCode 或 Goland 自带的终端中使用Gemini CLI外，还可以安装 Gemini 扩展，不过我试了一下，感觉还不如在终端里直接用方便。

项目推荐

上面Gemini 把我的项目总结的差不多啦，项目采用DDD分层架构设计，结合事件驱动编程等多个程序设计最佳实践，以一个在线商城为例实战演示项目的搭建和开发过程。欢迎扫码订阅我的专栏《Go项目搭建和整洁开发实战》，即可获得完整的教程和实战项目。