简介

本指南将帮助您在 Windows 和 macOS 系统上使用 Node.js环境安装和配置 Gemini CLI 。教程中有些步骤需要在VPN环境下才可完成，如果没有VPN的小伙伴可前往IT部申请开通，当然如果您觉得需要安装VPN太麻烦，我们也有不需要VPN的方案可供选择，其次我会尽可能的简化步骤，让初学者更容易上手。

为什么我需要？

你有没有因为电脑文件太多太乱，不想花时间整理又找不到东西而心烦意乱？

你有没有一些看起来简单但做起来就是很繁琐的工作影响心情？

如果有一个简单的工具通过对话就能解决这些问题，你会感兴趣吗？

安装前我们先了解一下什么是Gemini CLI

一，安装nodejs环境

1.前往 Node.js 官网 （可以直接点击链接）根据自身系统选择下载并安装

2.也可点击下方安装包直接下载安装

WIN系统：node-v24.5.0-x64.msi MAC系统：node-v24.5.0.pkg

3.下载完成后双击打开安装包一直点击“下一步”直到安装完成。

二，安装Gemini cli

1.MAC电脑安装方法：

1️⃣打开终端：

方法1：Command (⌘) + 空格键-打开 Spotlight 聚焦搜索，输入 终端 或 Terminal，按回车即可启动

方法2：点击 Dock 中的 火箭图标（Launchpad） → 进入“其他”文件夹 → 点击“终端”

方法3：打开 Finder → 左侧选择“应用程序” → 进入“实用工具”文件夹 → 双击“终端”

2️⃣安装Gemini cli（复制下面的代码粘贴到“终端” 内，点击回车键）

npm i -g @google/gemini-cli --force --registry=https://registry.npmmirror.com

3️⃣获取 API 密钥

方法1：注册Google账号（点击链接进入注册教程）访问 Google AI Studio登录并获取API（此方法需要有一定的动手能力并且全程需要VPN环境）

方法2：点击领取(API由Google官方AIStudio渠道获取，每个API有5000000Tokens额度，没有时间限制用完自动作废，适合需求不高的用户使用)

4️⃣配置系统变量与API（复制下面的代码粘贴到“终端” 内，回车键确认）

export GOOGLE_GEMINI_BASE_URL=https://llmxapi.com

export GEMINI_API_KEY=sk-xxx

gemini

出现以下界面安装完成

2.WIN电脑安装方法：

1️⃣打开“命令提示板”：

方法1：键盘WIN+R键一起按，输入CMD回车

2️⃣安装Gemini cli（复制下面的代码粘贴到“命令提示板” 内，回车键确认）

npm i -g @google/gemini-cli --force --registry=https://registry.npmmirror.com

3️⃣获取 API 密钥

方法1：注册Google账号（点击链接进入注册教程）访问 Google AI Studio登录并获取API（此方法需要有一定的动手能力并且全程需要VPN环境）

方法2：点击领取(API由Google官方AIStudio渠道获取，每个API有5000000Tokens额度，没有时间限制用完自动作废，适合需求不高的用户使用)

4️⃣配置系统变量与API（复制下面的代码粘贴到“终端” 内，回车键确认）

set GOOGLE_GEMINI_BASE_URL=https://llmxapi.com

set GEMINI_API_KEY=sk-xxx

setx "GOOGLE_GEMINI_BASE_URL" "https://llmxapi.com"

setx "GEMINI_API_KEY" "sk-xxxx"

gemini

出现以下界面安装完成

3.免翻版无需VPN环境（备用）

如果上述不行安装此版本

# 全局安装（首次执行）
npm install -g @google-dev/gemini-cli --force --registry=https://registry.npmmirror.com 

# 设置变量 sk-xxx 替换成你的key
export GEMINI_API_KEY="sk-xxx"

# 启动
gemini