Gemini CLI配置
Gemini CLI 配置教程
目录
前提条件
验证 Node.js
安装 Gemini CLI
Windows（PowerShell，无需 sudo）
npm install -g @google/gemini-climacOS / Linux / WSL2
如果使用 nvm 管理 Node.js，可以不加 sudo。
npx 运行：配置环境变量
YOUR_API_KEY → 你的 CERouter API KeyWindows（PowerShell）
$env:GOOGLE_GEMINI_BASE_URL = "https://cerouter.com"
$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GEMINI_MODEL = "gemini-2.5-pro"[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://cerouter.com", "User")
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "YOUR_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", "User")macOS / Linux / WSL2
~/.bashrc 或 ~/.zshrc：验证配置
验证环境变量
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL开始使用
常见问题
| 问题 | 解决方案 |
|---|---|
| 环境变量设置后不生效 | 重新打开一个终端窗口，或执行 source ~/.bashrc |
| Windows 安装时提示权限错误 | 以管理员身份运行 PowerShell 后重试 |
| macOS / Linux 安装时提示权限错误 | 命令前加 sudo，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 sudo） |
| 提示认证失败或 API Key 无效 | 检查 GEMINI_API_KEY 是否正确填写，以及 GOOGLE_GEMINI_BASE_URL 是否包含多余的斜杠或路径 |
修改于 2026-08-07 06:34:10