手动配置 Gemini CLI

提示

推荐直接在后台密钥列表点击 使用密钥，复制自动生成的配置，无需手写！

前置条件

请先创建一个 Gemini 分组 的 API Key，见 API 密钥管理。

方式一：.env 配置文件（推荐）

1. 找到 Gemini 的配置文件夹

首先打开你的终端程序，不管你是 Windows 还是 macOS 系统
然后根据系统，运行下面的命令，打开 Gemini 的配置文件夹

Windows

CMD 命令行：

start "" "%USERPROFILE%\.gemini"

macOS

open "$HOME/.gemini"

Gemini 配置文件夹

2. 手动创建 .env 文件，写入如下内容

GOOGLE_GEMINI_BASE_URL=https://goodcode.store
GEMINI_API_KEY=sk-你的ApiKey
GEMINI_MODEL=gemini-2.5-pro

3. 在 GEMINI_API_KEY 部分填入你在后台生成的 Gemini 分组的 ApiKey，然后保存

提示

如果你的分组有 Gemini 3 权限，GEMINI_MODEL 可以填 gemini-3-pro-preview。

4. 在终端运行 gemini，对话查看是否配置成功

Gemini 测试

方式二：环境变量（临时会话）

macOS / Linux

export GOOGLE_GEMINI_BASE_URL="https://goodcode.store"
export GEMINI_API_KEY="sk-你的ApiKey"
export GEMINI_MODEL="gemini-2.5-pro"
gemini

Windows CMD

set GOOGLE_GEMINI_BASE_URL=https://goodcode.store
set GEMINI_API_KEY=sk-你的ApiKey
set GEMINI_MODEL=gemini-2.5-pro
gemini

PowerShell

$env:GOOGLE_GEMINI_BASE_URL="https://goodcode.store"
$env:GEMINI_API_KEY="sk-你的ApiKey"
$env:GEMINI_MODEL="gemini-2.5-pro"
gemini

相关信息

环境变量只在当前终端会话中生效。如需永久配置，请将其添加到 ~/.bashrc、~/.zshrc 或使用方式一的 .env 文件。