Gemini CLI 使用指南

本文介绍如何安装 Gemini CLI，并在本地 ~/.gemini（Windows 为 %USERPROFILE%\\.gemini）目录下配置 .env 接入 Let AI Run。

1. 安装 Gemini CLI

安装方式请以官方文档为准：

• https://github.com/google-gemini/gemini-cli

2. 配置 .env

在对应系统目录创建 .env 文件并写入以下内容：

GOOGLE_GEMINI_BASE_URL="https://api.letai.run"
GEMINI_API_KEY=你的key
GEMINI_MODEL=gemini-3-pro-preview

3. macOS 目录

打开 Gemini 配置目录：

open "$HOME/.gemini"

如果目录不存在，可先创建：

mkdir -p "$HOME/.gemini"
open "$HOME/.gemini"

4. Windows 目录

打开 Gemini 配置目录：

start "" "%USERPROFILE%\.gemini"

如果目录不存在，可先创建：

mkdir "%USERPROFILE%\.gemini"
start "" "%USERPROFILE%\.gemini"

5. 使用

安装并配置完成后，在终端运行：

gemini

6. 常见排查

1. 启动后没有读取到配置：
   • 确认 .env 文件路径正确。
   • 确认文件名是 .env，不是 .env.txt。
2. 鉴权失败：
   • 检查 GEMINI_API_KEY 是否为真实可用 Key。
3. 未走 Let AI Run：
   • 检查 GOOGLE_GEMINI_BASE_URL 是否为 https://api.letai.run。