🚀 使用 Gemini CLI 的完整步骤指南(含 Node 安装、API 启用、环境变量配置)
✅ 前提条件(Step 0):安装 Node.js 和 Gemini CLI
-
确保已安装 Node.js,版本需 ≥ 18
-
运行 Gemini CLI:
-
临时运行(首次尝试):
npx https://github.com/google-gemini/gemini-cli -
或者全局安装:(推荐)
npm install -g @google/gemini-cli gemini
-
-
选择主题并登录:
-
执行
gemini命令后,按照提示选择主题(颜色方案)。 -
使用你的 个人 Google 账号登录,即可获得:
-
✅ Step 1:创建 Google Cloud 项目并设置环境变量
- 打开 Google Cloud Console, 创建一个新的 Project。
- 复制该项目的 Project ID(例如:
my-awesome-project-123)。
✅ 设置环境变量
-
Windows(CMD) :
setx GOOGLE_CLOUD_PROJECT your_project_id -
macOS / Linux(Bash/Zsh) :
echo 'export GOOGLE_CLOUD_PROJECT=your_project_id' >> ~/.zshrc # 如果你用的是 bash 就改成 ~/.bashrc source ~/.zshrc # 或者 ~/.bashrc
✅ Step 2:启用 Gemini 所需 API(Cloud AI Companion)
-
打开以下链接(将
xxxxxx替换为你的 Project ID):https://console.cloud.google.com/apis/api/cloudaicompanion.googleapis.com/overview?project=xxxxxx -
点击“启用”按钮,激活
Cloud AI Companion API。
✅ Step 3:登录使用 Gemini CLI
-
重启终端(或打开新的终端窗口)。
-
运行:
gemini选择
Login with Google选项。
- 登录成功后即可使用 Gemini Pro 模型(根据 Google 配额限制,有可能自动降级为 flash 模型,通常是响应时间较慢或使用次数过多时)。