方法一、通过 npm 安装 Gemini cli

1、准备环境

npm 依赖 Node.js 运行环境，需要先安装：

• 访问 Node.js 官网，下载 Windows 版安装包。
• 运行安装包，勾选 “Add to PATH”（自动配置环境变量），完成安装。
• 验证：打开 CMD 或 PowerShell，输入以下命令，显示版本即成功：

node -v   # 如 v20.18.0
npm -v    # 如 10.8.2

2、通过 npm 安装 Gemini cli 根据

目前 npm 上的 Gemini CLI 多为第三方工具，以较流行的 gemini-cli 为例，

• 安装 cli 包

在命令行中运行，

npm install -g gemini-cli

注意：若提示权限不足，在 Windows 中可右键 CMD/PowerShell 选择 “以管理员身份运行” 后重试。

• 验证安装

输入以下命令，若显示版本信息则安装成功，

gemini --version

• 配置 API 密钥

运行配置命令，

gemini config set apiKey "Gemini API 密钥"

• 使用 cli 交互

不同工具的命令格式略有差异，参考常见用法，

gemini

gemini ask "什么是人工智能？"

gemini chat

gemini ask "写一段 Python 代码" --model gemini-pro

注意事项

若配置好 gemini cli 后，在命令行输入 gemini 并成功登录 Google 账号后，在命令行中看到如下类似提示，

failed to login

这个问题是因为 Gemini CLI 需要关联一个 Google Cloud 项目 来管理 API 调用和配额，即使使用的是个人 Google 账号也需要配置。以下是详细的解决步骤：

步骤1、创建或选择 Google Cloud 项目

1. 访问 Google Cloud 控制台，使用与 Gemini CLI 登录相同的 Google 账号登录。
2. 点击顶部的项目选择器（显示 “Select a project” 或已有项目名称的区域）。
3. 若没有现有项目，点击 “NEW PROJECT”，输入项目名称，点击 “CREATE” 完成创建。
4. 选择刚创建的项目，复制其项目 ID。

步骤2、启用 Gemini API（Vertex AI API）

1. 在 Google Cloud 控制台中，导航到 “API 和服务” > “库”。
2. 搜索 “Vertex AI API”（Gemini API 属于 Vertex AI 服务），点击进入详情页后点击 “启用”。

步骤3、配置环境变量

在 Windows PowerShell 中设置环境变量，

env:GOOGLE_CLOUD_PROJECT = "your-project-id"

若需永久生效，可通过系统属性配置：

• 右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”。
• 在 “用户变量” 中点击 “新建”，变量名填 Google_Cloud_Project，变量值填项目 ID，点击 “确定” 并重启终端。

步骤4、重新验证登录

关闭当前 PowerShell 窗口，重新打开一个新的 PowerShell 终端，输入 gemini 命令，此时应能正常完成登录和认证。

方法二、使用官方 Python 库

Google 提供了 google-generativeai 库，可通过 Python 脚本实现 CLI 功能，步骤如下：

1、安装官方库

在 CMD/PowerShell 中运行，

pip install google-generativeai

2、创建 cli 脚本

在任意目录创建一个 Python 脚本，示例内容如下，

import google.generativeai as genai
import sys


genai.configure(api_key="API 密钥")

model = genai.GenerativeModel('gemini-pro')

if len(sys.argv) < 2:
    print("请输入问题，例如：python gemini_cli.py '你好，Gemini'")
    sys.exit(1)
prompt = ' '.join(sys.argv[1:])

response = model.generate_content(prompt)
print(response.text)

获取 Gemini API 密钥的获取方法如下，

1. 访问 Google AI Studio 并登录 Google 账号。
2. 点击 “Get API key”，创建一个新项目并生成 API 密钥（免费额度足够测试使用）。
3. 保存密钥（后续配置需用到）。