Gemini CLI 配置

Gemini CLI ↗ 是 Google 推出的开源 AI 编程命令行工具。通过 LAYSO AI 的 Gemini 原生兼容接口，一个 API Key 即可调用平台模型。

一个 Key，访问全平台模型

模型按照 LAYSO AI 模型与价格 页面显示的当前价格计费。每个成功请求都有独立扣费明细，失败任务不会产生扣费。

配置步骤

第 1 步：安装 Gemini CLI

需要 Node.js 20 或更高版本。macOS、Windows 和 Linux / WSL 使用相同的 npm 安装命令：

npm install -g @google/gemini-cli
gemini --version

看到 npm 输出已新增或更新软件包，表示安装命令执行成功；随后运行 gemini --version，能够正常显示版本号即表示 Gemini CLI 已可用。

第 2 步：获取 API Key 和模型 ID

1. 前往 LAYSO AI API Key 页面 ↗ 创建并复制 API Key。
2. 打开 LAYSO AI 模型与价格 ↗，选择模型并复制页面显示的完整模型 ID。

不要猜测模型别名，也不要把真实 API Key 写入项目文件或提交到 Git 仓库。

第 3 步：配置 LAYSO AI

Gemini CLI 会自动读取当前用户目录中的 .gemini/.env。三个系统使用相同的配置内容：

GEMINI_API_KEY=sk-...
GOOGLE_GEMINI_BASE_URL=https://api.layso.ai
GEMINI_MODEL=<MODEL_ID>

把 sk-... 替换为完整的 LAYSO AI API Key，把 <MODEL_ID> 替换为模型价格页上的完整模型 ID。Base URL 只填写根地址 https://api.layso.ai，不要追加 /v1、/v1beta 或 /gemini。

macOS

配置文件位置：/Users/<用户名>/.gemini/.env（也就是 ~/.gemini/.env）。

mkdir -p ~/.gemini
nano ~/.gemini/.env
chmod 600 ~/.gemini/.env

Windows

配置文件位置：C:\Users\<用户名>\.gemini\.env（PowerShell 中为 $HOME\.gemini\.env）。

New-Item -ItemType Directory -Force "$HOME\.gemini"
notepad "$HOME\.gemini\.env"

保存时确认文件名是 .env，不是 .env.txt。

Linux / WSL

配置文件位置：/home/<用户名>/.gemini/.env（也就是 ~/.gemini/.env）。

mkdir -p ~/.gemini
nano ~/.gemini/.env
chmod 600 ~/.gemini/.env

WSL 使用 Linux 用户目录，不要写入 Windows 用户目录。项目中如果也存在 .env，可能会覆盖用户级配置；遇到异常时先检查当前项目目录。

第 4 步：启动并验证

关闭旧的 Gemini CLI 会话，然后重新启动：

gemini

第一次启动如果出现认证方式选择，请选择 Use Gemini API key。进入交互界面后，顶部应显示通过 gemini-api-key 完成认证，然后发送：

你好，请用一句话介绍自己，并告诉我当前模型名称。

也可以直接执行一次非交互请求：

gemini -p "你好，请用一句话介绍自己"

请求成功后，到 LAYSO AI 任务明细检查模型、Token 与扣费记录是否一致。

配置值说明

配置项	作用	LAYSO AI 填写值
GEMINI_API_KEY	Gemini CLI 请求认证	从 API Key 页面 获取
GOOGLE_GEMINI_BASE_URL	覆盖 Gemini API 根地址并启用 Gateway 模式	https://api.layso.ai
GEMINI_MODEL	默认模型	从 模型价格页 复制完整模型 ID

Gemini CLI 当前会在设置了 GOOGLE_GEMINI_BASE_URL 时使用自定义 Gateway。无需在 settings.json 中写入非标准的 apiKey 或 baseUrl 字段。

更换模型

从 LAYSO AI 模型与价格 ↗ 复制新的完整模型 ID，修改 .gemini/.env：

GEMINI_MODEL=<NEW_MODEL_ID>

保存后完全退出并重新启动 Gemini CLI。

可用模型

一个 LAYSO AI API Key 可以访问平台模型。模型名称、能力、上下文长度与当前价格以 LAYSO AI 模型与价格 为准。

使用场景

• 代码生成与审查：阅读项目、修改文件、执行命令并解释代码。
• 长文件分析：分析大型代码库、日志和长文档。
• 多模态任务：在所选模型支持时分析图片或文档。
• 自动化任务：使用非交互模式执行脚本化提示词。

认证与排查

现象	处理方式
401 / 403	检查 .gemini/.env 中的 GEMINI_API_KEY 是否完整、无空格和换行
404	确认 GOOGLE_GEMINI_BASE_URL=https://api.layso.ai，不要追加协议路径
模型不存在	从 模型价格页 重新复制完整模型 ID
仍然连接 Google 官方服务	检查 GOOGLE_GEMINI_BASE_URL 拼写，并完全退出后重新启动 Gemini CLI
配置未生效	检查项目目录中是否存在优先级更高的 .env 或 .gemini/settings.json
没有扣费记录	先确认任务是否成功；失败任务不会产生扣费

安全建议

• 不要在截图、日志、聊天消息或 Git 仓库中暴露完整 API Key。
• 用户级 .gemini/.env 不应复制到项目目录。
• 第一次验证使用短提示词，确认模型和计费明细后再执行长任务。