Gemini CLI 常见问题

提示命令未找到

安装完成后需要打开一个新的终端窗口再运行 gemini。使用 npm 安装的，确认 npm 全局目录已加入 PATH：

npm config get prefix
# 把输出目录下的 bin 加入 PATH，例如：
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

如何更新 Gemini CLI

Homebrew：brew upgrade gemini-cli
npm：npm install -g @google/gemini-cli@latest --registry=https://registry.npmmirror.com

安装失败

配置问题

配置文件在哪里

需要 .env 和 settings.json 两个文件。

请求地址要不要加 /v1

不要。Gemini CLI 会自动补全路径，请求地址填：

GOOGLE_GEMINI_BASE_URL=https://www.jiji.cc

.env 文件格式

每行一个配置，值两边不要加引号，等号两边不要有空格：

GOOGLE_GEMINI_BASE_URL=https://www.jiji.cc
GEMINI_API_KEY=your-api-key-here

Windows 下用记事本新建时，注意文件名是 .env，不要变成 .env.txt。

启动时要求登录 Google 账号

确认 ~/.gemini/settings.json 中已设置 "selectedType": "gemini-api-key"，参考配置。也可以在启动后输入 /auth，选择 Use Gemini API Key。

如何切换模型

可用的模型 ID 以模型广场为准。

错误排查

API Key 无效

API 连接失败

安装与更新