跳到主要内容

Gemini CLI 接入指南

Gemini CLI 是谷歌推出的命令行工具，用于与 Gemini 模型交互。通过 weelinking，您可以使用兼容接口访问 Gemini 模型。

安装​

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

打开 PowerShell（管理员模式），下载并安装 nvm-windows：

# 下载 nvm-windows 安装包
# 访问 https://github.com/coreybutler/nvm-windows/releases
# 下载最新的 nvm-setup.exe 并运行安装

或使用 Chocolatey 安装：

choco install nvm

步骤 2：安装 Node.js

# 安装最新 LTS 版本
nvm install lts

# 使用该版本
nvm use lts

# 验证安装
node --version
npm --version

步骤 3：安装 Gemini CLI

npm install -g @google/gemini-cli

步骤 4：验证安装

gemini --version

快速试用（无需安装）​

npx @google/gemini-cli

配置 weelinking​

方式一：环境变量

在系统环境变量中添加：

# 临时设置（当前会话）
$env:GOOGLE_GEMINI_BASE_URL="https://api.weelinking.com"
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GEMINI_MODEL="gemini-2.5-pro"

# 永久设置（推荐）
[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.weelinking.com', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'YOUR_API_KEY', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_MODEL', 'gemini-2.5-pro', 'User')

方式二：配置文件

创建配置目录和文件：

# 创建配置目录
New-Item -Path "$env:USERPROFILE\.gemini" -ItemType Directory -Force

# 创建 .env 文件
@"
GOOGLE_GEMINI_BASE_URL=https://api.weelinking.com
GEMINI_API_KEY=YOUR_API_KEY
GEMINI_MODEL=gemini-3-pro-preview
"@ | Out-File -FilePath "$env:USERPROFILE\.gemini\.env" -Encoding UTF8

# 创建 settings.json 文件
@"
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@ | Out-File -FilePath "$env:USERPROFILE\.gemini\settings.json" -Encoding UTF8

注意：配置文件更加安全且便于管理，需要重启 Gemini CLI 才生效。

可用模型​

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

使用方法​

交互模式​

gemini

单次查询​

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

文件处理​

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

功能特色​

  • 超长上下文：支持 2M token 上下文
  • 多模态：支持图像、视频理解
  • 代码执行：支持代码生成和执行
  • 文件处理：支持多种文档格式

多模态使用​

图像分析​

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

视频理解​

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

常见问题​

命令找不到​

确保 npm 全局安装路径在系统 PATH 中：

# 查看 npm 全局路径
npm config get prefix

# 如需添加到 PATH，在系统环境变量中添加：
# %APPDATA%\npm

API 连接失败​

  1. 检查 API Base URL 配置是否正确
  2. 验证 API Key 是否有效
  3. 确认网络连接正常
# 检查环境变量
$env:GOOGLE_GEMINI_BASE_URL
$env:GEMINI_API_KEY
$env:GEMINI_MODEL

# 或检查配置文件
Get-Content "$env:USERPROFILE\.gemini\config.json"

模型不可用​

确保使用 Gemini 系列模型名称。

Node.js 版本问题​

Gemini CLI 需要 Node.js 18 或更高版本：

# 检查版本
node --version

# 如果版本过低，使用 nvm 升级
nvm install --lts
nvm use --lts