Skip to main content

​
环境准备

Gemini CLI 需要 Node.js 18 或更高版本，请先完成 Node.js 环境配置。macOS 使用 Homebrew 安装时可跳过。

​
安装

方法一：Homebrew（推荐）
方法二：npm
安装完成后，打开一个新的终端窗口，确认安装成功：

​
创建 API Key

在 API 密钥 页面新建一个 Key，分组选择包含 Gemini 模型的分组。

​
配置

配置文件位于：
  • macOS/Linux：~/.gemini/
  • Windows：C:\Users\你的用户名\.gemini\
1

创建 .env

.env
将 your-api-key-here 替换为你的 API Key。值两边不要加引号，请求地址不要加 /v1。
2

创建 settings.json

指定使用 API Key 登录，避免启动时弹出 Google 账号登录：
settings.json
如果 settings.json 已存在，只需把 security 部分合并进去，不要覆盖整个文件。

​
验证

在终端运行 gemini，看到对话界面并能正常回复即配置完成：

​
遇到问题

Gemini CLI 常见问题

安装、配置与错误排查