安装 Gemini CLI2025 完整指南

几分钟内开始使用 Google 官方开源 AI 代理。Gemini CLI 将强大的代码库分析、工作流自动化和多模态 AI 功能直接带到您的终端。

✅ 免费:每天 1000 次 API 调用(无需信用卡)

系统要求

在安装 Gemini CLI 之前,请确保您的系统满足这些要求。

Node.js

必需

18.0.0 或更高版本

NPM 安装所需的 JavaScript 运行时

NPM

必需

8.0.0 或更高版本

包管理器(随 Node.js 一起提供)

Git

最新版本

版本控制系统(可选,用于源码构建)

Google 账户

必需

活跃

API 身份验证所需

安装方法

选择最适合您设置的安装方法。

📦

NPM 安装(推荐)

使用 Node 包管理器全局安装

简单
npm install -g @google/gemini-cli

支持的平台:

WindowsmacOSLinux
在 NPM 上查看
⬇️

直接下载

为您的平台下载预构建的二进制文件

简单
从 GitHub 发布页面下载

支持的平台:

WindowsmacOSLinux
下载发布版本
🔧

从源码构建

为高级用户从源代码编译

高级
git clone && npm run build

支持的平台:

WindowsmacOSLinux
查看构建指南

分步安装

按照这些详细步骤使用 NPM(推荐方法)安装 Gemini CLI。

1

Install Node.js and NPM

Download and install Node.js from the official website. NPM comes bundled with Node.js.

# Check if Node.js is installed
node --version
npm --version
2

Install Gemini CLI

Use NPM to install Gemini CLI globally on your system.

npm install -g @google/gemini-cli
3

Verify Installation

Check that Gemini CLI is installed correctly and accessible from your terminal.

gemini --version
gemini --help
4

Authenticate with Google

Run Gemini CLI and follow the authentication prompts, or set up your API key.

gemini
Or set API key:
export GEMINI_API_KEY="YOUR_API_KEY"

Test Your Installation

Run your first Gemini CLI command to ensure everything is working.

gemini
# Then in the interactive session:
> Hello, world!

Troubleshooting Common Issues

Having trouble with installation? Here are solutions to the most common problems.

⚠️

权限被拒绝错误

在 macOS/Linux 上使用 sudo 运行或在 Windows 上以管理员身份运行

sudo npm install -g @google/gemini-cli
⚠️

安装后找不到命令

将 NPM 全局 bin 目录添加到您的 PATH

echo $PATH | grep npm
⚠️

身份验证失败

通过运行 Gemini CLI 或设置您的 API 密钥来设置身份验证

export GEMINI_API_KEY="YOUR_API_KEY"
⚠️

安装期间网络超时

使用不同的 NPM 注册表或检查防火墙设置

npm config set registry https://registry.npmjs.org/

安装完成!接下来做什么?

现在您已经安装了 Gemini CLI,探索这些后续步骤以充分利用您的设置。

标题

事实核查
[1]🏛️官方文档已验证

Gemini CLI - Official GitHub Repository

作者: Google Gemini Team
组织: Google
发布时间: 2024年1月1日
访问时间: 2025年8月14日
查看来源
事实核查
[2]🏛️官方文档已验证

Node.js Installation Guide

组织: Node.js Foundation
发布时间: 2024年1月1日
访问时间: 2025年8月14日
查看来源
事实核查

引用免责声明

商标声明

Google™, Gemini™ Google 和 Gemini 是 Google LLC 的商标。

NPM® npm 是 npm, Inc. 的商标。

Node.js® Node.js 是 OpenJS Foundation 的商标。

GitHub® GitHub 是 GitHub, Inc. 的商标。

所有商标均为其各自所有者的财产。