GEMINI CLI · 环境变量 · 约 6 分钟

Gemini CLI 配置教程

安装 Gemini CLI,设置可可AI 的 Base URL 与 API Key,然后在终端运行 gemini。

  1. 01
    创建密钥准备 Key 与 Base URL
  2. 02
    安装 CLI通过 npm 安装官方工具
  3. 03
    设置变量配置地址、密钥与模型
  4. 04
    启动验证运行 gemini 并检查用量

创建 API Key

API Key控制台 → API 密钥 → 创建或复制
Base URLhttps://kekeshop.top
环境变量GOOGLE_GEMINI_BASE_URL 与 GEMINI_API_KEY
模型GEMINI_MODEL 可选;不确定时先不设置,进入 CLI 后再选择当前可用模型
密钥安全 只使用自己控制台中的完整 Key,不要将密钥写入公开仓库或分享给他人。

安装 Gemini CLI

需要本机已安装 Node.js 与 npm。

Terminal / PowerShell
npm install -g @google/gemini-cli
gemini --version
找不到 gemini 命令? 重新打开终端并检查 npm 全局目录是否在 PATH 中;也可先用 npx @google/gemini-cli 测试。

设置环境变量

下面的变量只对当前终端会话生效,重新打开终端后需要再次设置。

zsh / bash

Terminal
export GOOGLE_GEMINI_BASE_URL="https://kekeshop.top"
export GEMINI_API_KEY="你的_API_Key"

# 可选:设置默认模型
# export GEMINI_MODEL="控制台中的模型名"

gemini
长期保存环境变量

macOS / Linux 可将 export 命令写入 ~/.zshrc 或 ~/.bashrc。Windows 可通过“编辑系统环境变量”写入用户变量。保存后重新打开终端。

运行 Gemini

01

启动 CLI

运行 gemini 进入交互模式。

02

发送测试消息

先发送一条简单消息,确认能正常返回。

03

检查控制台

查看是否出现 Gemini 用量,确认请求已走可可AI。

快速测试
gemini "用一句话介绍你自己"

常见问题

命令找不到 gemini

检查 npm 全局 bin 是否在 PATH 中,重新打开终端,或使用 npx @google/gemini-cli。

401 / API key invalid

重新复制完整 API Key,并确认变量在当前终端中已设置。

连接超时

确认 GOOGLE_GEMINI_BASE_URL 为 https://kekeshop.top,不要添加多余路径。

model not found

移除 GEMINI_MODEL 后重试,或改为控制台当前分组支持的模型。

新终端中配置失效

临时环境变量不会自动保留。重新设置,或按“长期保存环境变量”写入用户配置。

控制台没有新增用量

检查 Base URL 是否在当前终端生效;成功但无记录通常表示请求未走可可AI。