Gemini CLI 使用指南

本指南将帮助你安装和配置 Google Gemini CLI，体验 Gemini AI 驱动的命令行编程助手。

开始之前

请确保你已准备好：

重要提示：Gemini CLI 首次运行需要登录 Google 账号进行授权。

安装 Node.js

先检查是否已安装 Node.js 及版本：

node -v

如果版本低于 22 或未安装，根据你的操作系统选择安装方式（安装时一路下一步即可）：

macOS (Homebrew):

brew install node

Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Windows:

访问 nodejs.org 下载安装包。

安装 Gemini CLI

使用 npm 全局安装 Gemini CLI：

npm install -g @google/gemini-cli

配置环境变量

前往密钥管理界面获取一键导入命令，或手动配置：

Linux / macOS:

export GOOGLE_GEMINI_BASE_URL="https://yy.52ai.ai"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-3.1-pro-preview"

Windows PowerShell:

$env:GOOGLE_GEMINI_BASE_URL="https://yy.52ai.ai"
$env:GEMINI_API_KEY="你的API密钥"
$env:GEMINI_MODEL="gemini-3.1-pro-preview"

Windows CMD:

set GOOGLE_GEMINI_BASE_URL=https://yy.52ai.ai
set GEMINI_API_KEY=你的API密钥
set GEMINI_MODEL=gemini-3.1-pro-preview

请将 你的API密钥 替换为你在密钥管理界面获取的真实密钥。

如需永久生效，请将上述命令添加到 ~/.bashrc 或 ~/.zshrc 文件中。

首次运行并登录

在终端中运行：

gemini

首次运行会提示登录 Google 账号，按照提示完成授权即可开始使用。