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


Windows 教程

PowerShell 临时设置(当前会话)

在 PowerShell 中运行以下命令:

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

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

PowerShell 永久设置(用户级)

在 PowerShell 中运行以下命令:

1
2
3
4
# 设置用户级环境变量(永久生效)
[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 中验证:

1
2
3
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

macOS 教程

临时设置(当前会话)

在 Terminal 中运行以下命令:

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

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

永久设置

添加到你的 shell 配置文件:

1
2
3
4
5
# 对于 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
1
2
3
4
5
# 对于 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 中验证:

1
2
3
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Linux / WSL2 教程

临时设置(当前会话)

在终端中运行以下命令:

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

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

永久设置

添加到你的 shell 配置文件:

1
2
3
4
5
# 对于 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
1
2
3
4
5
# 对于 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 环境变量

在终端中验证:

1
2
3
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL