Gemini CLI 配置指南

Gemini CLI 是 Google 提供的命令行 AI 工具，可以在终端里直接调用 Gemini 模型。
本文介绍如何安装 Gemini CLI，并通过 MaoMaoToken API 配置可用的 Gemini 模型。

TIP

本文所有网关地址统一填写 https://api.maomaotoken.com。
API Key 请使用 MaoMaoToken 中 Gemini/Vertex 分组的令牌。

准备工作

在配置 Gemini CLI 前，需要先准备好下面几项：

项目	说明
Node.js	用于通过 npm 安装 Gemini CLI
Git	部分开发环境和依赖安装会用到
Gemini CLI	Google 官方命令行工具
MaoMaoToken API Key	使用 Gemini/Vertex 分组的令牌
默认模型	选择你账号中可用的 Gemini 模型

安装步骤

1. 安装 Node.js

访问 Node.js 官网，建议下载左侧的 LTS 版本。LTS 是长期支持版，更适合日常稳定使用。

安装完成后，打开命令行验证：

node -v
npm -v

2. 安装 Git

访问 Git 官网，页面会自动推荐适合你操作系统的版本，点击下载并按默认选项安装即可。

安装完成后验证：

git --version

3. 安装 Gemini CLI

打开 cmd、PowerShell 或终端，通过 npm 安装 Gemini CLI：

npm install -g @google/gemini-cli

验证安装：

gemini --version

INFO

如果你在亚太地区下载依赖较慢，可以先参考 亚太地区加速访问教程 配置 npm 镜像。

WARNING

请只安装官方包名 @google/gemini-cli。不要安装来源不明的 Gemini CLI、提前体验版或名称相似的 npm 包。

快速配置

Gemini CLI 可以读取 .gemini/.env 中的配置。推荐把配置放在用户目录下，方便所有项目共用。

系统	配置文件位置
Windows	%USERPROFILE%\.gemini\.env
macOS	~/.gemini/.env
Linux	~/.gemini/.env

配置内容如下，请把 API Key 替换成自己的真实令牌：

GOOGLE_GEMINI_BASE_URL=https://api.maomaotoken.com
GEMINI_API_KEY=你的 MaoMaoToken API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1

DANGER

必须把 你的 MaoMaoToken API Key 替换为自己的真实 API Key。不要把 API Key 发给他人，也不要把它写进公开仓库。

Windows 配置

1. 创建配置目录

打开 PowerShell，运行：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.gemini"

2. 写入环境变量配置

创建 .env 文件，请替换 API Key：

@"
GOOGLE_GEMINI_BASE_URL=https://api.maomaotoken.com
GEMINI_API_KEY=你的 MaoMaoToken API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"

3. 写入认证配置

可选：如果启动后仍提示选择认证方式，可以写入下面的配置，让 Gemini CLI 使用 API Key 模式：

@"
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\settings.json"

配置目录通常位于：

C:\Users\你的用户名\.gemini\

macOS 配置

1. 创建配置目录

打开终端，运行：

mkdir -p ~/.gemini

2. 写入环境变量配置

创建 .env 文件，请替换 API Key：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.maomaotoken.com
GEMINI_API_KEY=你的 MaoMaoToken API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

3. 写入认证配置

可选：如果启动后仍提示选择认证方式，可以写入下面的配置：

cat > ~/.gemini/settings.json <<'EOF'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

配置目录位于：

/Users/你的用户名/.gemini/

Linux 配置

1. 创建配置目录

mkdir -p ~/.gemini

2. 写入环境变量配置

创建 .env 文件，请替换 API Key：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.maomaotoken.com
GEMINI_API_KEY=你的 MaoMaoToken API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

3. 写入认证配置

可选：如果启动后仍提示选择认证方式，可以写入下面的配置：

cat > ~/.gemini/settings.json <<'EOF'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

启动 Gemini CLI

配置完成后，直接运行：

gemini

如果能正常进入 Gemini CLI 并开始对话，说明配置已经生效。

后续需要替换的图片

TODO：替换为终端运行 gemini 后成功进入 Gemini CLI 的截图，注意隐藏 API Key 和用户路径中的敏感信息。

配置项说明

配置项	说明
GOOGLE_GEMINI_BASE_URL	MaoMaoToken Gemini 网关地址，填写 https://api.maomaotoken.com
GEMINI_API_KEY	您的 MaoMaoToken API Key
GEMINI_MODEL	默认使用的模型名称

INFO

模型名称以你账号实际可用模型为准。如果示例模型不可用，请在 MaoMaoToken 控制台查看可用模型后替换。

常见问题

npm install -g 提示权限错误

Windows 用户可以尝试以管理员身份运行 PowerShell，然后重新执行安装命令。

macOS 用户推荐通过 Homebrew 或 nvm 安装 Node.js。Homebrew 或 nvm 安装的 Node.js 通常不需要 sudo 权限。

Linux 用户推荐使用 nvm 管理 Node.js，或修改 npm 全局目录：

npm config set prefix ~/.npm-global

然后将 ~/.npm-global/bin 加入 PATH。

提示 gemini command not found

先确认 Node.js 和 npm 是否安装成功：

node -v
npm -v

然后重新安装官方包：

npm install -g @google/gemini-cli

安装后关闭终端，重新打开再试：

gemini --version

API 调用失败

可以按下面顺序检查：

1. .gemini/.env 文件是否创建在正确位置
2. GEMINI_API_KEY 是否复制完整，前后不要多空格
3. API Key 是否来自 Gemini/Vertex 分组
4. GOOGLE_GEMINI_BASE_URL 是否为 https://api.maomaotoken.com
5. GEMINI_MODEL 是否是账号可用模型

远程服务器连接问题

Linux 服务器可以先检查是否能访问 MaoMaoToken API：

curl -I https://api.maomaotoken.com

如果当前网络需要代理，可以在 .env 中追加：

HTTPS_PROXY=http://your-proxy:port