Gemini CLI 安装教程（Windows）
跳到主要内容

Gemini CLI 安装教程（Windows）

前置：安装 Node.js​

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

安装 Gemini CLI​

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

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

验证命令是否存在：

gemini --version

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

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

配置 Gemini CLI（接入Constreet）​

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.constreet.cc
GEMINI_API_KEY=你的Constreet Key
GEMINI_MODEL=gemini-2.5-pro
'@ | Set-Content -Path "$env:USERPROFILE\.gemini\.env" -Encoding UTF8

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

配置说明：

  • GOOGLE_GEMINI_BASE_URL - Constreet的服务地址
  • 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

启动并验证​

重开终端后运行：

gemini

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

gemini "Hello"