Gemini CLI 新手安装与使用指南

Gemini CLI 是一个可以通过命令行与 Google Gemini 模型进行交互的强大工具。本教程将从零开始，一步步带你完成安装、配置和基本使用，即使你没有任何编程基础，也能轻松上手。

准备工作

在开始之前，请确保你拥有：

1. 一台电脑 (macOS, Linux, 或 Windows)。

2. 可以连接到互联网。

3. 一个可以访问 Google 服务的网络环境（可能需要代理工具）。

第一步：安装 nvm (Node.js 版本管理器)

nvm 是一个非常方便的工具，可以让你轻松地安装和切换不同版本的 Node.js。我们先来安装它。

1. 为什么要用 nvm？

不同的项目可能需要不同版本的 Node.js。nvm 可以帮助我们管理这些版本，避免冲突，让你的开发环境更干净、更灵活。

2. 安装 nvm

打开你的终端（Terminal），复制并粘贴以下命令，然后按回车执行：

export NVM_DIR="$HOME/.nvm" && (  git clone https://github.com/nvm-sh/nvm.git "$NVM_DIR"  cd "$NVM_DIR"  git checkout `git describe --abbrev=0 --tags --match "v[0-9]*" $(git rev-list --tags --max-count=1)`) && \. "$NVM_DIR/nvm.sh"

命令解释：这个命令会从 GitHub 上下载 nvm 的源代码，并将其放置在你的用户目录下的一个名为 .nvm 的隐藏文件夹中，并自动切换到最新的稳定版本。

3. 配置 nvm

为了确保每次打开新的终端窗口时 nvm 都能自动运行，我们需要将配置信息添加到你的终端配置文件中。复制并运行以下命令，它会自动检测你的 shell (bash 或 zsh) 并将配置写入对应的文件 (~/.bashrc 或 ~/.zshrc)。

export NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

重要提示

nvm

zsh

```bash

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc

echo '[ -s " $NVM_DIR/nvm.sh" ] && \. "$ NVM_DIR/nvm.sh"' >> ~/.zshrc

```

bash

```bash

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc

echo '[ -s " $NVM_DIR/nvm.sh" ] && \. "$ NVM_DIR/nvm.sh"' >> ~/.bashrc

```

4. 验证安装

关闭并重新打开你的终端，然后输入以下命令：

command -v nvm

如果你看到输出 nvm，那就说明安装成功了！如果提示 "command not found"，请检查上一步的配置是否正确写入了对应的文件。

第二步：安装 Node.js

Node.js 是一个 JavaScript 运行环境，Gemini CLI 需要它才能工作。我们将使用 nvm 来安装它。

1. 安装指定版本的 Node.js

在终端中输入以下命令：

nvm install v22.16.0

命令解释：这个命令会告诉 nvm 下载并安装 22.16.0 版本的 Node.js。nvm 会自动处理所有细节。你可能会看到一些下载和编译的日志，请耐心等待其完成。

2. 设为默认版本

安装完成后，使用以下命令将这个版本设置为默认版本，这样每次打开终端都会使用它：

nvm alias default v22.16.0

3. 验证安装

输入以下命令来检查 Node.js 和 npm (Node.js 的包管理器) 是否安装成功：

node -vnpm -v

如果你分别看到了 v22.16.0 和一个版本号（例如 10.8.1），那么恭喜你，Node.js 已成功安装！

第三步：安装 Gemini CLI

现在我们有了 Node.js 和 npm，可以正式安装 Gemini CLI 了。

1. 安装命令

在终端中运行以下命令：

npm install -g @google/gemini-cli

命令解释

* npm install: 这是 npm 的安装命令。

* -g: 这是一个标志，意思是“全局安装”。这样你就可以在电脑的任何位置运行 gemini 命令。

* @google/gemini-cli: 这是我们要安装的包的名称。

2. 验证安装

安装完成后，输入：

gemini --version

如果你看到了 Gemini CLI 的版本号，说明安装成功！

第四步：获取 Gemini API Key

API Key 就像是你的专属通行证，让 Gemini 服务知道是你正在请求访问。

1. 访问 Google AI Studio

打开浏览器，访问 Google AI Studio。

2. 登录账号

使用你的 Google 账号登录。

3. 创建 API Key

登录后，点击页面上的 “Create API key” (创建 API 密钥) 按钮。

系统可能会提示你选择一个项目，你可以创建一个新项目。

创建成功后，你会看到一长串由字母和数字组成的字符串。这就是你的 API Key。

4. 复制并保存

非常重要：立即复制这个 Key，并将它保存在一个安全的地方（例如密码管理器或一个私密的记事本里）。这个 Key 只会完整显示这一次，关闭后就无法再次查看。

第五步：配置网络代理

为了让 Gemini CLI 能够顺利连接到 Google 的服务器，你可能需要一个网络代理。

1. 为什么需要代理？

在某些地区，直接访问 Google 的服务可能会很慢或被阻断。代理可以帮助你建立一个稳定的连接。

2. 如何配置？

你需要使用支持全局代理或终端代理的工具。请确保你的代理工具已经开启，并且其设置能够覆盖到命令行的网络请求。具体设置方法请参考你所使用的代理工具的说明文档。这是确保后续步骤成功的关键。

第六步：初始化并开始使用 Gemini！

万事俱备！让我们来启动 Gemini CLI。

1. 初始化 Gemini

打开终端，输入以下命令：

gemini init

程序会提示你 Enter your Google AI API key:。

将你在第四步中保存的 API Key 粘贴进去 (在终端中粘贴通常使用 Cmd+V 或 Ctrl+Shift+V)，然后按回车。

2. 开始聊天

初始化成功后，你就可以开始和 Gemini 聊天了！输入：

gemini chat

现在，你可以在终端里输入任何问题，然后按两次** **Enter** **键发送。Gemini 就会回答你了！

退出聊天：输入 exit 或按 Ctrl + C。

总结

恭喜你！你已经成功安装并配置了 Gemini CLI。现在你可以开始探索它的强大功能了。祝你玩得开心！