GEMINI CLI · 环境变量 · 约 6 分钟
Gemini CLI 配置教程
安装 Gemini CLI,设置可可AI 的 Base URL 与 API Key,然后在终端运行 gemini。
- 01创建密钥准备 Key 与 Base URL
- 02安装 CLI通过 npm 安装官方工具
- 03设置变量配置地址、密钥与模型
- 04启动验证运行 gemini 并检查用量
创建 API Key
API Key控制台 → API 密钥 → 创建或复制
Base URL
https://kekeshop.top环境变量
GOOGLE_GEMINI_BASE_URL 与 GEMINI_API_KEY模型
GEMINI_MODEL 可选;不确定时先不设置,进入 CLI 后再选择当前可用模型密钥安全 只使用自己控制台中的完整 Key,不要将密钥写入公开仓库或分享给他人。
安装 Gemini CLI
需要本机已安装 Node.js 与 npm。
npm install -g @google/gemini-cli
gemini --version找不到 gemini 命令? 重新打开终端并检查 npm 全局目录是否在 PATH 中;也可先用
npx @google/gemini-cli 测试。设置环境变量
下面的变量只对当前终端会话生效,重新打开终端后需要再次设置。
zsh / bash
export GOOGLE_GEMINI_BASE_URL="https://kekeshop.top"
export GEMINI_API_KEY="你的_API_Key"
# 可选:设置默认模型
# export GEMINI_MODEL="控制台中的模型名"
geminiPowerShell
$env:GOOGLE_GEMINI_BASE_URL="https://kekeshop.top"
$env:GEMINI_API_KEY="你的_API_Key"
# 可选:设置默认模型
# $env: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。