Gemini CLI 配置指南

如果你使用 Gemini CLI，需要设置以下环境变量来连接到中转服务。

---

Windows 教程

PowerShell 临时设置（当前会话）

在 PowerShell 中运行以下命令：

$env:GOOGLE_GEMINI_BASE_URL = "你的服务地址/gemini"
$env:GEMINI_API_KEY = "你的API密钥"
$env:GEMINI_MODEL = "gemini-2.5-pro"

💡 使用与 Claude Code 相同的 API 密钥即可。

PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "你的服务地址/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)

💡 设置后需要重新打开 PowerShell 窗口才能生效。

验证 Gemini CLI 环境变量

在 PowerShell 中验证：

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

---

macOS 教程

临时设置（当前会话）

在 Terminal 中运行以下命令：

export GOOGLE_GEMINI_BASE_URL="你的服务地址/gemini"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-2.5-pro"

💡 使用与 Claude Code 相同的 API 密钥即可。

永久设置

添加到你的 shell 配置文件：

# 对于 zsh (默认)
echo 'export GOOGLE_GEMINI_BASE_URL="你的服务地址/gemini"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export GOOGLE_GEMINI_BASE_URL="你的服务地址/gemini"' >> ~/.bash_profile
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.bash_profile
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.bash_profile
source ~/.bash_profile

验证 Gemini CLI 环境变量

在 Terminal 中验证：

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

---

Linux / WSL2 教程

临时设置（当前会话）

在终端中运行以下命令：

export GOOGLE_GEMINI_BASE_URL="你的服务地址/gemini"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-2.5-pro"

💡 使用与 Claude Code 相同的 API 密钥即可。

永久设置

添加到你的 shell 配置文件：

# 对于 bash (默认)
echo 'export GOOGLE_GEMINI_BASE_URL="你的服务地址/gemini"' >> ~/.bashrc
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.bashrc
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.bashrc
source ~/.bashrc

# 对于 zsh
echo 'export GOOGLE_GEMINI_BASE_URL="你的服务地址/gemini"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.zshrc
source ~/.zshrc

验证 Gemini CLI 环境变量

在终端中验证：

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL