最近更新：2026年3月6日 07:13

Gemini CLI 配置指南

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

配置要点:

Node.js 版本: ≥18

Base URL: https://www.nextai-code.com (无需 /v1 后缀)

推荐模型: gemini-3-pro-preview (下一代预览版)

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

1. 环境准备

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

推荐使用命令行工具安装 Node.js，以便于版本管理：

使用 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: 推荐使用 nvm-windows 或 winget:
```
winget install OpenJS.NodeJS.LTS
```

如果以上方式均无法使用，可前往 Node.js 官网下载安装包。

访问 NextAI Code 控制台 - 令牌管理页面。
点击 添加令牌，参照下图进行配置：
- 名称: 随意填写 (例如 gemini)
- 令牌分组: 选择 Gemini 分组 (或其他 Gemini 相关分组)
- 过期时间: 建议选择 永不过期
- 新建数量: 1
额度与限制设置:
- 额度: 建议开启 无限额度
- 访问限制: 留空 (不建议启用模型限制)
- IP白名单: 留空 (不建议填写)
提交后，复制生成的 sk- 开头的令牌。

npm install -g @google/gemini-cli

2.1 创建 .gemini 文件夹

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

2.2 创建 .env 文件

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

GOOGLE_GEMINI_BASE_URL=https://www.nextai-code.com
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.1 创建 .gemini 文件夹

配置位置: ~/.gemini/

mkdir ~/.gemini

3.2 创建 .env 文件

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

GOOGLE_GEMINI_BASE_URL=https://www.nextai-code.com
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"
    }
  }
}

安装完成后，立即测试配置是否成功：

gemini --version

如果显示版本号，说明安装成功。然后测试 API 连接：

gemini chat "你好"

如果收到 Gemini 的回复，说明配置成功！

Gemini CLI 支持指定模型。NextAI Code 支持最新的 Gemini 模型：

gemini chat --model gemini-2.5-pro

Node.js 版本过低?

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

权限错误 (Permission Denied)?

macOS/Linux: