关于gemini cli安装遇到所有问题,请参考本文解决

692 阅读2分钟

关键问题写在前面(安装放在最后,安装很简单):

1. login auth的时候报错:connect ETIMEDOUT

image.png 原因:网络链路不通,代理设置不完备,二层代理无法解决
解决方法全局 + TUN模式代理

2. login 环境变量缺失,导致访问路由失败:GEMINI_API_KEY和GOOGLE_CLOUD_PROJECT 二者选其一

image.png 原因:Google 账号分为 Personal(个人)和 Workspace(工作)两类,两类账号对应的授权方式不同,需要使用者授权!

解决方法

env.png 设置如图的环境变量;

获取地址如下:
export GEMINI_API_KEY=<AI studio获取API keys>
export GOOGLE_CLOUD_PROJECT= <google cloud创建project_id>

注意 google cloud project创建后,需要enable,否则是会报错

image.png

个人开发者的使用限制

三种方式

image.png
  • 要免费使用 Gemini CLI,只需使用个人 Google 帐户登录即可获得免费的 Gemini Code Assist 许可证。
  • 该免费许可证允许您访问 Gemini 2.5 Pro 及其庞大的 100 万个令牌上下文窗口。
  • gemini cli提供了业界最高的限额:每分钟 60 个模型请求,每天 1,000 个请求,均免费。
  • Google 搜索功能每天最多可免费使用 500 次请求
  • 文本、图像和视频处理均可在免费套餐内使用

如果是需要同时运行多个代理的专业开发人员,或者更喜欢使用特定模型,则可以使用Google AI StudioVertex AI密钥进行基于使用情况的计费,或者获取 Gemini Code Assist 标准版或企业版许可证。

安装方法:

确定已经安装 Node.js 版本 18+。

1. 使用 npx 运行(无需安装)

npx https://github.com/google-gemini/gemini-cli

2.全局安装

npm install -g @google/gemini-cli

如果您全局安装了它,则可以使用以下命令运行它(认证也只需要一次):

gemini

3.初次配置(选择风格)

gemini1.png

4.授权登陆

image.png

点击后,会跳转到浏览器中进行授权 gemini4.png

希望上述分享可以帮助大家快速了解 Gemini CLI 并安装成功!

END