GEMINI CLI

Gemini CLI - Windows 安装配置

在 Windows 上安装 Gemini CLI，并通过配置文件连接千模岛 API。

#前置要求

Node.js 18 或更高版本
可用的千模岛 API Key
从模型广场选择一个可用的 Gemini 模型

#步骤 1：安装 Node.js

#方法一：使用官方安装包（推荐）

访问 https://nodejs.org
下载 LTS 版本的 Windows Installer（.msi）。
运行安装程序并按默认设置完成安装。
安装程序会自动把 Node.js 加入 PATH。

#方法二：使用包管理器

Winget（Windows 11 或 Windows 10 自带）：

winget install OpenJS.NodeJS.LTS

Chocolatey：

choco install nodejs-lts

Scoop：

scoop install nodejs-lts

#验证安装

node --version
npm --version

#步骤 2：全局安装 Gemini CLI

# 全局安装
npm install -g @google/gemini-cli

# 验证安装
gemini --version

#步骤 3：配置 Gemini CLI

#3.1 创建 .gemini 文件夹

mkdir $env:USERPROFILE\.gemini
cd $env:USERPROFILE\.gemini

#3.2 创建 .env 文件

$envContent = @"
GOOGLE_GEMINI_BASE_URL=https://www.qianmodao.com
GEMINI_API_KEY=sk-your-api-key
GEMINI_MODEL=<从模型广场选择的模型名称>
"@
[System.IO.File]::WriteAllText(
  (Join-Path $PWD ".env"),
  $envContent,
  [System.Text.UTF8Encoding]::new($false)
)

也可以在 %USERPROFILE%\.gemini 目录中手动创建 .env：

GOOGLE_GEMINI_BASE_URL=https://www.qianmodao.com
GEMINI_API_KEY=sk-your-api-key
GEMINI_MODEL=<从模型广场选择的模型名称>

#3.3 创建 settings.json 文件

$settingsContent = @"
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@
[System.IO.File]::WriteAllText(
  (Join-Path $PWD "settings.json"),
  $settingsContent,
  [System.Text.UTF8Encoding]::new($false)
)

也可以在同一目录中手动创建 settings.json：

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

#步骤 4：启动 Gemini CLI

gemini

# 启动后输入
你好，请介绍一下你自己

能够正常返回内容，即表示 API 地址、密钥和模型配置已经生效。

#常用命令

# 进入交互模式
gemini

# 非交互式提示
gemini -p "创建一个React组件"

# 分析代码文件
gemini -p "分析 file.js 并指出可以改进的地方"

# 查看帮助
gemini --help

#故障排除

#问题：PowerShell 执行策略错误

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

#问题：JSON 配置文件错误

如果 JSON 解析失败，请确认 settings.json 使用 UTF-8 编码且未带 BOM。

#问题：命令未找到

npm config get prefix
$env:PATH

#问题：API 连接失败

Get-Content $env:USERPROFILE\.gemini\.env

#问题：权限错误

请以管理员身份打开 PowerShell 后重新安装。

#下一步

获取 API 密钥：访问千模岛 API 控制台获取你的 Gemini CLI 专用令牌。