Gemini CLI 新手安装与使用指南
Gemini CLI 是一个可以通过命令行与 Google Gemini 模型进行交互的强大工具。本教程将从零开始,一步步带你完成安装、配置和基本使用,即使你没有任何编程基础,也能轻松上手。
准备工作
在开始之前,请确保你拥有:
-
一台电脑 (macOS, Linux, 或 Windows)。
-
可以连接到互联网。
-
一个可以访问 Google 服务的网络环境(可能需要代理工具)。
第一步:安装 nvm (Node.js 版本管理器)
nvm
是一个非常方便的工具,可以让你轻松地安装和切换不同版本的 Node.js
。我们先来安装它。
1. 为什么要用 nvm?
不同的项目可能需要不同版本的 Node.js
。nvm
可以帮助我们管理这些版本,避免冲突,让你的开发环境更干净、更灵活。
2. 安装 nvm
打开你的终端(Terminal),复制并粘贴以下命令,然后按回车执行:
bash
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
)。
bash
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
的启动脚本添加到你的 shell 配置文件中。对于zsh
用户(macOS 默认),请运行:
```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. 验证安装
关闭并重新打开你的终端,然后输入以下命令:
bash
command -v nvm
如果你看到输出 nvm
,那就说明安装成功了!如果提示 "command not found",请检查上一步的配置是否正确写入了对应的文件。
第二步:安装 Node.js
Node.js
是一个 JavaScript 运行环境,Gemini CLI 需要它才能工作。我们将使用 nvm
来安装它。
1. 安装指定版本的 Node.js
在终端中输入以下命令:
bash
nvm install v22.16.0
- 命令解释 :这个命令会告诉
nvm
下载并安装22.16.0
版本的Node.js
。nvm
会自动处理所有细节。你可能会看到一些下载和编译的日志,请耐心等待其完成。
2. 设为默认版本
安装完成后,使用以下命令将这个版本设置为默认版本,这样每次打开终端都会使用它:
bash
nvm alias default v22.16.0
3. 验证安装
输入以下命令来检查 Node.js
和 npm
(Node.js 的包管理器) 是否安装成功:
bash
node -v
npm -v
如果你分别看到了 v22.16.0
和一个版本号(例如 10.8.1
),那么恭喜你,Node.js
已成功安装!
第三步:安装 Gemini CLI
现在我们有了 Node.js
和 npm
,可以正式安装 Gemini CLI 了。
1. 安装命令
在终端中运行以下命令:
bash
npm install -g @google/gemini-cli
- 命令解释:
* npm install
: 这是 npm
的安装命令。
* -g
: 这是一个标志,意思是"全局安装"。这样你就可以在电脑的任何位置运行 gemini
命令。
* @google/gemini-cli
: 这是我们要安装的包的名称。
2. 验证安装
安装完成后,输入:
bash
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
打开终端,输入以下命令:
bash
gemini init
-
程序会提示你
Enter your Google AI API key:
。 -
将你在第四步中保存的 API Key 粘贴 进去 (在终端中粘贴通常使用
Cmd+V
或Ctrl+Shift+V
),然后按回车。
2. 开始聊天
初始化成功后,你就可以开始和 Gemini 聊天了!输入:
bash
gemini chat
现在,你可以在终端里输入任何问题,然后按两次** **Enter**
**键发送。Gemini 就会回答你了!
- 退出聊天 :输入
exit
或按Ctrl + C
。
总结
恭喜你!你已经成功安装并配置了 Gemini CLI。现在你可以开始探索它的强大功能了。祝你玩得开心!