关键问题写在前面(安装放在最后,安装很简单):
1. login auth的时候报错:connect ETIMEDOUT
原因:网络链路不通,代理设置不完备,二层代理无法解决
解决方法:全局 + TUN模式代理
2. login 环境变量缺失,导致访问路由失败:GEMINI_API_KEY和GOOGLE_CLOUD_PROJECT 二者选其一
原因:Google 账号分为 Personal(个人)和 Workspace(工作)两类,两类账号对应的授权方式不同,需要使用者授权!
解决方法:
获取地址如下:
export GEMINI_API_KEY=<AI studio获取API keys>
export GOOGLE_CLOUD_PROJECT=
<google cloud创建project_id>
注意 google cloud project创建后,需要enable,否则是会报错!
个人开发者的使用限制
三种方式
- 要免费使用 Gemini CLI,只需使用个人 Google 帐户登录即可获得免费的 Gemini Code Assist 许可证。
- 该免费许可证允许您访问 Gemini 2.5 Pro 及其庞大的 100 万个令牌上下文窗口。
- gemini cli提供了业界最高的限额:每分钟 60 个模型请求,每天 1,000 个请求,均免费。
- Google 搜索功能每天最多可免费使用 500 次请求
- 文本、图像和视频处理均可在免费套餐内使用
如果是需要同时运行多个代理的专业开发人员,或者更喜欢使用特定模型,则可以使用Google AI Studio或Vertex 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.初次配置(选择风格)
4.授权登陆
点击后,会跳转到浏览器中进行授权
希望上述分享可以帮助大家快速了解 Gemini CLI 并安装成功!
END