最近更新：2025年12月15日 12:15

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 官网下载安装包。

cc-switch 是一个可视化的配置管理工具,用于管理 AI CLI 工具的环境变量配置。

支持的 CLI 工具:

主要作用:

访问 GitHub Releases 下载对应版本:

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

打开 cc-switch,选择 Gemini,点击 + 按钮。
填写配置:
- 选择 自定义配置
- API Key: 你的 NextAI Code 令牌 (sk-...)
- 请求地址: https://www.nextai-code.com (无需 /v1)
- 模型: 建议不写,用默认即可
保存并确保状态为 已启用。

如果不使用 cc-switch,也可以手动配置环境变量:

export GEMINI_API_KEY="sk-..." # 你的 NextAI Code 令牌
export GOOGLE_GEMINI_BASE_URL="https://www.nextai-code.com"

npm install -g @google/gemini-cli

安装完成后,立即测试配置是否成功:

gemini --version

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

gemini chat "你好"

如果收到 Gemini 的回复,说明配置成功!

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

gemini chat --model gemini-2.5-pro

cc-switch 配置后 Gemini 无法连接?

Node.js 版本过低?

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

权限错误 (Permission Denied)?

macOS/Linux: