Gemini CLI 配置指南

适用场景: 专为 Google Gemini 模型优化的多模态命令行工具，适合需要在终端使用 Gemini 的开发者。

配置要点:

• Node.js 版本: ≥18
• Base URL: https://www.lxai.pro (无需 /v1 后缀)
• 推荐模型: gemini-3-pro-preview (下一代预览版)

与其他 CLI 的区别: Gemini 使用 Google 原生协议，Base URL 无需 /v1 后缀。

1. 环境准备

Node.js 环境 (需要 Node.js 18+)

• macOS (使用 Homebrew):

brew install node

• 使用 nvm (推荐跨平台):

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 安装并使用最新 LTS 版本
nvm install --lts
nvm use --lts

• Windows:

winget install OpenJS.NodeJS.LTS

2. 获取 API Key

1. 访问 lxai 控制台 - 令牌管理 页面。

2. 点击 添加令牌，参照下图进行配置：

   • 名称: 随意填写 (例如 gemini)
   • 令牌分组: 选择 Gemini 分组
   • 过期时间: 建议选择 永不过期
   • 新建数量: 1

   

3. 额度与限制设置:

   • 额度: 建议开启 无限额度
   • 访问限制: 留空
   • IP白名单: 留空

   

4. 提交后，复制生成的 sk- 开头的令牌。

3. 安装与配置

1. 使用 npm 安装 Gemini CLI

npm install -g @google/gemini-cli

2. Windows 配置

2.1 创建 .gemini 文件夹

配置位置: C:\Users\{用户名}\.gemini\

2.2 创建 .env 文件

在 .gemini 文件夹中创建 .env 文件：

GOOGLE_GEMINI_BASE_URL=https://www.lxai.pro
GEMINI_API_KEY=你的API密钥
GEMINI_MODEL=gemini-3-pro-preview

2.3 创建 settings.json 文件

在 .gemini 文件夹中创建 settings.json 文件：

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

3. macOS / Linux 配置

3.1 创建 .gemini 文件夹

mkdir ~/.gemini

3.2 创建 .env 文件

在 ~/.gemini/ 文件夹中创建 .env 文件：

GOOGLE_GEMINI_BASE_URL=https://www.lxai.pro
GEMINI_API_KEY=你的API密钥
GEMINI_MODEL=gemini-3-pro-preview

3.3 创建 settings.json 文件

在 ~/.gemini/ 文件夹中创建 settings.json 文件：

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

4. 验证配置

gemini --version

然后测试 API 连接：

gemini chat "你好"

5. 常见命令与功能

模型选择

• gemini-3-pro-preview (下一代预览版，性能最强)
• gemini-2.5-pro (当前旗舰，综合能力最佳)
• gemini-2.5-flash (极速响应，高性价比)

gemini chat --model gemini-2.5-pro

6. 故障排查

Node.js 版本过低?

1. 运行 node --version 查看当前版本
2. 如果版本低于 18，使用 nvm 升级：nvm install --lts && nvm use --lts
3. 重新安装 Gemini CLI

权限错误 (Permission Denied)?

macOS/Linux:

• 使用 sudo npm install -g @google/gemini-cli
• 或配置 npm 全局安装目录到用户目录

额度不足

登录 lxai 控制台 检查余额，必要时充值。