Gemini CLI 安装与设置

详细的安装指南，帮助您在任何操作系统上快速安装和配置 Gemini CLI， 开始您的 AI 辅助编程之旅。

系统要求

Gemini CLI 支持主流操作系统，确保您的系统满足以下要求

Windows

  • Windows 10 或更高版本
  • PowerShell 5.1 或更高版本
  • Node.js 20+ (推荐使用 nvm-windows)

💡 建议使用 Windows Terminal 获得更好的体验

macOS

  • macOS 10.15 或更高版本
  • Terminal 或 iTerm2
  • Node.js 20+ (推荐使用 nvm)

💡 可以使用 Homebrew 安装 Node.js: brew install node

Linux

  • Ubuntu 18.04+ / CentOS 7+ / 其他主流发行版
  • Bash 4.0 或更高版本
  • Node.js 20+ (推荐使用 nvm)

💡 确保系统已安装 curl 和 git

安装步骤

按照以下步骤完成 Gemini CLI 的安装和配置

1

安装 Node.js

确保您的系统已安装 Node.js 20 或更高版本

1访问 Node.js 官网 (https://nodejs.org)
2下载并安装 LTS 版本（推荐）
3验证安装：运行 node --version
4确保版本号 ≥ 20.0.0
$ node --version
2

安装 Gemini CLI

使用 npm 全局安装或直接运行

1方式一：全局安装 npm install -g @google/generative-ai-cli
2方式二：直接运行 npx @google/generative-ai-cli
3推荐使用 npx 方式，无需全局安装
4首次运行会自动下载最新版本
$ npx @google/generative-ai-cli --version
3

配置认证

设置 Google 账户认证以使用 Gemini API

1运行 npx @google/generative-ai-cli auth
2按照提示在浏览器中登录 Google 账户
3授权 Gemini CLI 访问您的账户
4认证成功后即可开始使用
$ npx @google/generative-ai-cli auth

故障排除

遇到安装问题？这里有常见问题的解决方案

命令未找到错误

确保 Node.js 已正确安装并添加到 PATH 环境变量中

  • 检查 Node.js 安装：node --version
  • 重新启动终端或命令提示符
  • 如果使用 npx，确保网络连接正常

权限错误

在 Unix 系统上可能需要使用 sudo，或配置 npm 全局目录

  • Linux/macOS: 使用 sudo npm install -g
  • 或配置 npm 全局目录到用户目录
  • Windows: 以管理员身份运行命令提示符

网络连接问题

检查网络连接，或配置 npm 代理设置

  • 检查防火墙设置
  • 配置 npm 代理：npm config set proxy http://proxy:port
  • 尝试使用不同的 npm 镜像源

认证失败

确保 Google 账户有效，并检查浏览器设置

  • 清除浏览器缓存和 Cookie
  • 尝试使用无痕模式进行认证
  • 检查 Google 账户是否启用了两步验证

下一步

安装完成后，继续学习如何使用 Gemini CLI

查看使用指南浏览命令参考