Gemini CLI 配置教程

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

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

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

打开终端（Windows 用户按 Win+R 输入 cmd 回车）：

如果没有显示版本号，请参考「Node.js 安装教程」进行安装。

步骤 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 → 你在平台创建的令牌

Windows（PowerShell）

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

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

永久生效（推荐）：

[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://jiniu.ai", "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：环境变量设置后不生效？
A：重新打开一个终端窗口，或执行 source ~/.bashrc。

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

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

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

Q：如何切换模型？
A：修改 GEMINI_MODEL 环境变量为你想使用的模型名称，如 gemini-2.5-flash。

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：开始使用

常见问题