Gemini CLI安装及使用教程

续Claude推出Claude Code后，Gemini也推出了Gemini CLI，而且难以相信的是居然是免费的，而且还是pro模型，项目地址：gemini-cli。

使用需要全程代理，免费版本会提交代码用于训练。

虽然有些限制：

• 每分钟 60次 模型请求
• 每天 1000次 请求

但个人使用够用了。

安装

首先保证使用node18以上的版本，然后输入以下命令。

npm install -g @google/gemini-cli
gemini

设置

选择颜色

选择校验方式

使用api校验方式（注：最新消息，目前api形式pro也免费了）；谷歌校验方式也在文章后面更新了。

api校验的方式是设置环境变量GEMINI_API_KEY，设置为自己的KEY

使用

命令行输入gemini，回车即可。

输入框支持以下内容：

• 直接输入问题
• @文件或者@文件夹
• /命令，配置编辑器、MCP、主题等
• !命令，将原生命令行的输出结果给到gemini

非交互式支持以下方式：

• gemini -p "你好" 直接填写提示词
• ls | gemini -p "你好" 管道形式将内容给到gemini

遇到的坑

自动退出

Gemini每分钟调用 telemetry 发送统计信息，由于众所周知的原因发送不了，会自动结束程序。

所以需要做的就是关闭掉它。

打开配置文件C:\Users\<your user name>\.gemini\settings.json，加上下面这句即可：

"usageStatisticsEnabled": false

保存，关闭，再次进入gemini即可

Fetch API: failed

这个也是众所周知的问题，打开gemini所在目录的文件：******\node_modules\@google\gemini-cli\dist\index.js

添加3段代码即可，以后更新可能要重新操作，端口对应自己的代理。

import { setGlobalDispatcher, ProxyAgent } from "undici"; 
const dispatcher = new ProxyAgent({ uri: new URL('http://127.0.0.1:7890').toString() });
setGlobalDispatcher(dispatcher);

安装依赖

npm install -g undici

保存后重新操作。

---

根据网友反馈，添加环境变量http_proxy也是可以的，建议先试下这种方法，比较方便。

再次更新

网上文章大多使用谷歌校验的方式，也就是方式一，据说这种方式才能用到pro模型，这里也一起把方法写下来吧。

首先进入gemini输入/auth，切换为方式1，如果不行就删除并重新安装gemini，校验方式选1。

一般来说是校验不了的，把代理的tun模式、系统模式、全局都打开，tun模式是一定要的，然后重新校验，一般就能成功了；如果还是不行，试下更新你的代理，我就是其中一个受害者。。。

然后尝试使用，喜闻乐见的还是不行，方式一校验方式需要的是环境变量GOOGLE_CLOUD_PROJECT

值对应下图的ID，从网站 https://console.cloud.google.com/ 获取

填写完毕保存，重新打开终端，再次测试，又是喜闻乐见的那样，报错没有权限。

选择对应的项目，点击启用api。

搜索gemini

启用这3个库

重新打开终端，再次测试，这次终于可以了，撒花。

然后是代理问题，最少要开启tun模式，其他系统代理、全局都不需要。

后来根据网友反馈，尝试添加环境变量http_proxy，tun模式也省略了，现在可以无痛使用了。