Gemini CLI 接入指南

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

安装​

• Windows
• macOS
• Linux

步骤 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

快速试用（无需安装）​

• Windows
• macOS
• Linux

npx @google/gemini-cli

配置 weelinking​

• Windows
• macOS
• Linux

方式一：环境变量​

在系统环境变量中添加：

# 临时设置（当前会话）
$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-preview	LMArena 第一	1M
gemini-2.5-pro	正式版	2M
gemini-2.5-flash	快速响应	1M

使用方法​

交互模式​

gemini

单次查询​

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

文件处理​

• Windows
• macOS
• Linux

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

功能特色​

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

多模态使用​

图像分析​

• Windows
• macOS
• Linux

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

视频理解​

• Windows
• macOS
• Linux

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

常见问题​

命令找不到​

• Windows
• macOS
• Linux

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

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

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

API 连接失败​

1. 检查 API Base URL 配置是否正确
2. 验证 API Key 是否有效
3. 确认网络连接正常

• Windows
• macOS
• Linux

# 检查环境变量
$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

链接如下 api.weelinking.com/register?af... 其实很简单的！ 安装文档 docs.weelinking.com/docs/scenar... 通过使用我们的中转API，以及附带的安装配置流程，可以轻松完美使用gemini-cli！