手动配置 Gemini CLI

提示

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

前置条件

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

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

1. 确认 Gemini CLI 已安装

gemini --version

如果提示命令不存在，请先安装 Gemini CLI：

npm i -g @google/gemini-cli@latest

2. 找到 Gemini 的配置文件夹

打开终端，根据系统执行下面的命令。目录不存在时先创建目录，再打开。

Windows

CMD 命令行：

if not exist "%USERPROFILE%\.gemini" mkdir "%USERPROFILE%\.gemini"
start "" "%USERPROFILE%\.gemini"

macOS

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

3. 写入 .env

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

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

在 GEMINI_API_KEY 部分填入你在后台生成的 Gemini 分组 API Key，然后保存。

提示

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

相关信息

Gemini CLI 官方支持从 .env 文件或环境变量读取 GEMINI_API_KEY 和 GEMINI_MODEL。当前 Gemini CLI 的底层请求库会读取 GOOGLE_GEMINI_BASE_URL 作为 Gemini API base URL，GoodCode 后台生成配置也使用这个变量将请求转发到 https://goodcode.store。

提示

如果 .env 修改后没有生效，先完全退出并重新打开 Gemini CLI。仍不生效时，可以临时改用下面的环境变量方式验证；某些工作区的 .env 加载顺序或信任状态会影响 ~/.gemini/.env 的读取。

4. 重启并验证

关闭当前 Gemini CLI 会话，重新打开终端后运行：

gemini

首次进入时如出现认证方式选择，选择 Use Gemini API key。发送一句简单问题，如果能正常返回内容，说明 Gemini CLI 已接入 GoodCode。

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

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 文件。