Google Gemini CLI 小白配置认证登录教程

小小程序员贝塔

2025-06-29 20 阅读1分钟

本文主要记录在Mac上使用Google Gemini CLI 时遇到的登录认证问题

1、配置与安装

根据 Gemini CLI github项目的官方说明,需要

Node.js version 18 以及更高的版本
Run the CLI: Execute the following command in your terminal:

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

或者手动通过

npm install -g @google/gemini-cli
gemini

选择一个主题
身份验证：出现提示时，使用您的个人Google帐户登录。这将为您提供每分钟最多60个模型请求和每天1,000个模型请求。

2、配置时遇到的几个问题

2.1、CLI terminal 跳转到google浏览器认证时无法返回

这种情况通常是系统代理的问题，可以通过使用VPN的tune模式或者配置系统代理 export https_proxy=xxx

2.2、缺少 `GOOGLE_CLOUD_PROJECT` 环境变量：

报错： GOOGLE_CLOUD_PROJECT environment variable not found.Add that to your .env and try again, no reload needed!
解决 (mac 实测 Win 应该同理)：
1. GCP 开启 Gemini Cloud API (Gemini Code Assist Standard & Enterprise)。
2. ~/.env 添加：export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID" (YOUR_PROJECT_ID 见 GCP 控制台)。
3. 重启 Gemini CLI 。

2.3、配置Gemini API Key

点击生成API KEY Google AI Studio.
设置到系统环境变量中
```
export GEMINI_API_KEY="YOUR_API_KEY"
```