安装指南
在您的系统上安装和配置 Gemini CLI
系统要求
确保您的系统满足这些要求
Windows
- Windows 10 或更高版本
- Node.js 18.0.0 或更高版本
- PowerShell 5.1 或 PowerShell Core 7+
- Windows Terminal（推荐）
macOS
- macOS 10.15 (Catalina) 或更高版本
- Node.js 18.0.0 或更高版本
- Xcode 命令行工具
- Terminal 或 iTerm2
Linux
- Ubuntu 18.04+ / CentOS 8+ / Debian 10+
- Node.js 18.0.0 或更高版本
- curl 或 wget
- bash 或 zsh shell
安装方法
选择最适合您需求的安装方法
NPM 安装
大多数用户推荐的方法
步骤 1: 通过 npm 全局安装
这将在您的系统上全局安装 Gemini CLI
npm install -g @google/generative-ai-cli步骤 2: 验证安装
检查安装是否成功
gemini --version步骤 3: 设置 API 密钥
配置您的 Google AI API 密钥
gemini config set api-key YOUR_API_KEYDocker 安装
用于一致部署的容器化环境
步骤 1: 拉取 Docker 镜像
下载官方 Docker 镜像
docker pull google/gemini-cli:latest步骤 2: 使用 API 密钥运行
使用您的 API 密钥启动容器
docker run -e GEMINI_API_KEY=your_key google/gemini-cli:latest步骤 3: 交互模式
启动交互式聊天会话
docker run -it -e GEMINI_API_KEY=your_key google/gemini-cli:latest chat从源码安装
用于开发的从源代码构建
步骤 1: 克隆仓库
从 GitHub 获取源代码
git clone https://github.com/google-gemini/gemini-cli.git步骤 2: 安装依赖
安装所有必需的依赖项
cd gemini-cli && npm install步骤 3: 构建和链接
构建项目并创建全局符号链接
npm run build && npm linkAPI 密钥配置
设置您的 Google AI API 密钥以开始使用 Gemini CLI
获取您的 API 密钥
- 1访问 Google AI Studio
- 2使用您的 Google 账户登录
- 3点击"创建 API 密钥"并复制密钥
配置密钥
使用 CLI 命令:
gemini config set api-key YOUR_API_KEY使用环境变量:
export GEMINI_API_KEY=YOUR_API_KEY验证安装
测试您的安装以确保一切正常工作
检查版本
gemini --version应显示已安装的版本号
测试 API 连接
gemini ask "你好，你能听到我吗？"应返回来自 Gemini 的响应
检查配置
gemini config list应显示您当前的配置设置
常见问题
常见安装问题的解决方案
找不到命令
如果安装后出现"找不到命令"错误，您的 PATH 可能不包含 npm 的全局 bin 目录。
npm config get prefix将 bin 目录添加到您的 shell 配置文件（.bashrc、.zshrc 等）中的 PATH
权限被拒绝
在 macOS/Linux 上，您可能需要使用 sudo 或配置 npm 使用不同的目录。
npm config set prefix ~/.npm-global然后将 ~/.npm-global/bin 添加到您的 PATH