Gemini CLI 配置指南

最近更新：2026 年 10 月 17 日（Asia/Shanghai）
关联：帮助中心 · 大模型 API · 图像生成

适用：在终端使用 Google Gemini CLI，经词源探索调用 Gemini 系列模型。

配置要点

项	值
Node.js	≥ 18
Base URL	`https://ai.afp.net`（不要加 `/v1`）
推荐模型	`gemini-3.1-pro`；要快可用 `gemini-3.5-flash` / `gemini-3.7-flash`

1. 环境与令牌

bash

node --version

控制台「令牌管理」创建令牌（如 gemini-cli），复制 sk- 密钥。

bash

npm install -g @google/gemini-cli
gemini --version

配置目录：

bash

mkdir -p ~/.gemini

env

GOOGLE_GEMINI_BASE_URL=https://ai.afp.net
GEMINI_API_KEY=sk-xxxxxxxx
GEMINI_MODEL=gemini-3.1-pro

也有环境会读取项目或用户目录下的 ~/.env；以当前 Gemini CLI 版本行为为准。优先保证 ~/.gemini/.env 正确。

json

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

bash

gemini
# 或非交互（视版本子命令而定）
gemini -p "用三句话介绍词源探索"

切换模型示例：gemini-3.5-flash、gemini-3.1-pro-preview、gemini-2.5-pro。生图模型（gemini-3-pro-image 等）更适合走图像生成 API 或 SDK，CLI 是否暴露生图能力取决于版本。

现象	处理
404	Base URL 是否误加了 `/v1` 或 `/v1beta`
认证失败	`GEMINI_API_KEY` 是否完整；`settings.json` 是否选了 api-key 模式
模型不存在	对照 `/v1/models` 与令牌分组
权限错误	配置用户级 npm 全局目录，避免混乱的 sudo 安装
额度不足	控制台查看余额与令牌额度