Gemini CLI 配置教程

获取 API Key 后，按照你的操作系统选择对应步骤完成配置。

步骤 1：验证是否安装 Node.js

Gemini Cli 基于 Node.js 运行，请先确认已安装 Node.js（建议 LTS 版本）。

打开终端
windows用户（win+R）输入 cmd 回车

分别执行
node -v
npm -v
查看是否有版本号，如果没有显示版本号的可以参考 node 安装教程进行安装

步骤 2：安装 Gemini CLI

Windows（PowerShell，无需 sudo）

npm install -g @google/gemini-cli

macOS / Linux / WSL2

如果使用 nvm 管理 Node.js，可以不加 sudo。
也可以不全局安装，直接通过 npx 运行：npx @google/gemini-cli

验证安装：

步骤 3：配置环境变量

如果使用CC Switch的可以跳转 CC Switch 配置

将下方变量中的占位符替换为你的实际信息：

YOUR_API_KEY → 你的 API Key

Windows（PowerShell）

临时生效（仅当前终端会话有效）：

$env:GOOGLE_GEMINI_BASE_URL = "https://tokenflowing.cn"
$env:GEMINI_API_KEY         = "YOUR_API_KEY"
$env:GEMINI_MODEL           = "gemini-2.5-pro"

永久生效（推荐）：

[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://tokenflowing.cn",  "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：

然后使配置立即生效：

步骤 4：验证环境变量

Windows

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

macOS / Linux / WSL2

步骤 5：开始使用

常见问题

Q：环境变量设置后不生效？
重新打开一个终端窗口，或执行 source ~/.bashrc。

Q：Windows 安装时提示权限错误？
以管理员身份运行 PowerShell 后重试。

Q：macOS / Linux 安装时提示权限错误？
命令前加 sudo，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 sudo）。

Q：提示认证失败或 API Key 无效？
检查 GEMINI_API_KEY 是否正确填写，以及 GOOGLE_GEMINI_BASE_URL 是否包含多余的斜杠或路径。

Gemini CLI 配置教程

步骤 1：验证是否安装 Node.js#

步骤 2：安装 Gemini CLI#

Windows（PowerShell，无需 sudo）#

macOS / Linux / WSL2#

步骤 3：配置环境变量#

Windows（PowerShell）#

macOS / Linux / WSL2#

步骤 4：验证环境变量#

Windows#

macOS / Linux / WSL2#

步骤 5：开始使用#

常见问题#

步骤 1：验证是否安装 Node.js

步骤 2：安装 Gemini CLI

Windows（PowerShell，无需 sudo）

macOS / Linux / WSL2

步骤 3：配置环境变量

Windows（PowerShell）

macOS / Linux / WSL2

步骤 4：验证环境变量

Windows

macOS / Linux / WSL2

步骤 5：开始使用

常见问题