Gemini CLI 安装教程（Windows）

0. 前置：安装 Node.js

先装 Node.js（建议 22+）：Nodejs Windows

1. 安装 Gemini CLI

先用 npm 全局安装（推荐先用这个）：

npm install -g @google/generative-ai-cli

验证命令是否存在：

gemini --version

如果你安装后没有 gemini 命令，再试下面这个包名（不同版本可能不同）：

npm install -g @google/gemini-cli
gemini --version

2. 配置 Gemini CLI（接入词元AI）

2.1 配置文件在哪里？

Gemini CLI 的配置目录：%USERPROFILE%\.gemini\

什么意思？

• 完整路径是：C:\Users\你的用户名\.gemini\

2.2 创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.gemini"

2.3 写入环境变量配置文件

创建 .env 文件（注意替换 API Key）：

@'
GOOGLE_GEMINI_BASE_URL=https://api.ci-yuan-ai.com
GEMINI_API_KEY=你的词元AI Key
GEMINI_MODEL=gemini-2.5-pro
'@ | Set-Content -Path "$env:USERPROFILE\.gemini\.env" -Encoding UTF8

必须替换：把 你的词元AI Key 替换成你从词元AI官网复制的真实 Key

配置说明：

• GOOGLE_GEMINI_BASE_URL - 词元AI的服务地址
• GEMINI_API_KEY - 你的 API Key
• GEMINI_MODEL - 默认使用的模型（gemini-2.5-pro 是最新版本）

2.4 可选：写入认证配置

让 Gemini CLI 明确使用 API Key 模式：

@'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
'@ | Set-Content -Path "$env:USERPROFILE\.gemini\settings.json" -Encoding UTF8

3. 启动并验证

重开终端后运行：

gemini

你也可以直接发一条消息测试：

gemini "Hello"