跳到主要内容

Gemini CLI 接入指南

Gemini CLI 是谷歌推出的命令行 AI 助手，可以在终端中与 Gemini 模型对话、分析文件、理解图片和视频。通过 【微元算力】 接入后即可使用。

安装​

步骤 1：安装 NVM（Node 版本管理器）

NVM 是用来管理 Node.js 版本的工具，安装它之后才能安装 Node.js。

  1. 打开浏览器，访问 https://github.com/coreybutler/nvm-windows/releases
  2. 找到最新版本，下载 nvm-setup.exe 文件
  3. 双击运行安装，一路点「下一步」即可完成

步骤 2：安装 Node.js

打开 PowerShell（在开始菜单搜索「PowerShell」，右键选择「以管理员身份运行」），依次输入以下命令：

# 安装最新 LTS 版本
nvm install lts

# 使用该版本
nvm use lts

# 验证安装，会显示版本号
node --version
npm --version

步骤 3：安装 Gemini CLI

继续在 PowerShell 中输入：

npm install -g @google/gemini-cli

步骤 4：验证安装

安装完成后，输入以下命令，如果显示版本号说明安装成功：

gemini --version

配置 【微元算力】​

推荐新手使用方式二（配置文件），按步骤创建文件即可，简单不易出错。

方式一：环境变量

通过图形界面设置（永久生效，推荐）：

  1. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「用户变量」中点击「新建」，分别添加以下三个变量：
    • 变量名：GOOGLE_GEMINI_BASE_URL，变量值：https://api.weytoken.com
    • 变量名：GEMINI_API_KEY，变量值：YOUR_API_KEY（替换为你的实际 API Key）
    • 变量名：GEMINI_MODEL，变量值：gemini-3-pro-preview
  3. 点击「确定」保存，重新打开终端即可生效

或者通过 PowerShell 命令设置：

# 永久设置
[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.weytoken.com', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'YOUR_API_KEY', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_MODEL', 'gemini-3-pro-preview', 'User')

方式二：配置文件

  1. 打开文件资源管理器，在地址栏输入 %USERPROFILE% 并回车，进入你的用户目录（一般是 C:\Users\你的用户名\）
  2. 查看是否有 .gemini 文件夹，如果没有，新建一个文件夹并命名为 .gemini
  3. 在 .gemini 文件夹内，需要创建以下两个文件：

第一个文件：.env

新建一个文本文件，将文件名改为 .env.（注意前后各一个点，Windows 会自动去掉末尾的点，最终文件名变为 .env），用记事本打开并粘贴以下内容：

GOOGLE_GEMINI_BASE_URL=https://api.weytoken.com
GEMINI_API_KEY=YOUR_API_KEY
GEMINI_MODEL=gemini-3-pro-preview

第二个文件：settings.json

新建一个文本文件，将文件名改为 settings.json（去掉 .txt 后缀），用记事本打开并粘贴以下内容：

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

将 YOUR_API_KEY 替换为你的实际 API Key。配置完成后需要重启 Gemini CLI 才生效。

可用模型​

模型说明上下文
gemini-3-pro-previewLMArena 第一1M
gemini-2.5-pro正式版2M
gemini-2.5-flash快速响应1M

使用方法​

交互模式​

直接输入 gemini 进入对话模式，可以连续提问：

gemini

单次查询​

在 gemini 后面加上引号和你的问题，一次性获得结果：

gemini "解释量子计算的基本原理"

文件处理​

让 Gemini 帮你阅读和总结文档，将 document.pdf 替换为你实际的文件名：

gemini --file document.pdf "总结这份文档"

功能特色​

  • 超长上下文：一次可以处理超大量的文本内容（最高支持约 400 万字）
  • 多模态：不仅能处理文字，还能理解图片和视频
  • 代码执行：能生成代码并直接运行
  • 文件处理：支持 PDF、Word、代码文件等多种格式

多模态使用​

Gemini 除了文字对话，还能理解图片和视频内容。

图像分析​

让 Gemini 描述或分析一张图片，将 photo.jpg 替换为你实际的图片文件名：

gemini --image photo.jpg "描述这张图片"

视频理解​

让 Gemini 总结视频内容，将 clip.mp4 替换为你实际的视频文件名：

gemini --video clip.mp4 "总结视频内容"

常见问题​

命令找不到​

输入 gemini 提示"不是内部或外部命令"时，说明系统找不到 Gemini CLI 的安装位置，需要手动添加：

  1. 在 PowerShell 中输入 npm config get prefix，记下显示的路径
  2. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  3. 在「用户变量」中找到 Path，双击打开，点击「新建」
  4. 将上面记下的路径粘贴进去，末尾加上 \bin（例如 C:\Users\你的用户名\AppData\Roaming\npm）
  5. 点击「确定」保存，重新打开 PowerShell 再试

API 连接失败​

  1. 打开上面创建的 .gemini 文件夹，检查 .env 文件中的地址和 API Key 是否填写正确
  2. 确认 API Key 是否有效（可以在 【微元算力】 控制台查看）
  3. 确认网络连接正常

模型不可用​

确保使用 Gemini 系列模型名称，参考上方「可用模型」表格。

Node.js 版本问题​

Gemini CLI 需要 Node.js 18 或更高版本。在终端中输入以下命令检查：

node --version

如果显示的版本号低于 18（例如 v16.x.x），需要升级：

nvm install --lts
nvm use --lts