Gemini CLI API Key 配置问题解决方案

问题描述

在使用 Gemini CLI (版本 v0.19.1) 时，尽管已在全局配置文件 ~/.gemini/.env 中设置了 API Key，但每次在项目中启动 Gemini 时仍被提示输入 API Key。全局配置未按预期生效。

报了这个错: When using Gemini API, you must specify the GEMINI_API_KEY environment variable.
Update your environment and try again (no reload needed if using .env)!

环境信息：

• 操作系统: Windows 11
• CLI 工具: Gemini CLI v0.19.1 (通过 CC-Switch 安装配置)

问题原因

经过排查，发现这是 Gemini CLI 的一个 bug：程序优先读取项目目录下的 .env 文件，而非全局配置文件 ~/.gemini/.env。由于项目目录中有 .env 文件，系统无法找到 API Key 配置。

解决方案

在项目根目录下创建 .env 文件，并添加以下配置：

GOOGLE_GEMINI_BASE_URL=
GEMINI_API_KEY=your_api_key_here

将 your_api_key_here 替换为您的实际 Gemini API Key。

验证方法

配置完成后，在项目目录中重新启动 Gemini CLI，应该不再提示输入 API Key，而是直接使用项目 .env 文件中的配置。

注意事项

1. 此问题特定于 Gemini CLI v0.19.1 版本，建议关注官方更新以获取修复版本
2. .env 文件包含敏感信息，应确保其不被提交到版本控制系统（如 .gitignore）
3. 在生产环境中，建议考虑更安全的 API Key 管理方式