主题
如何安装和使用 Gemini CLI
Gemini CLI 是什么?
Gemini CLI 是一款命令行工具,让你能够直接在终端中使用 Google Gemini AI 模型。通过配置 ModelGate 代理,你可以便捷地访问 Gemini 的强大功能,实现代码生成、问答对话等多种 AI 辅助开发任务。
安装教程
选择你的操作系统
Windows 安装
1. 下载 Node.js
访问 Node.js下载页,安装时全程点击下一步,不要修改路径
2. 验证安装
Win+R 打开 Windows 命令提示符(CMD)
bash
node -v
npm -v若正常显示版本,则安装成功
3. 安装 Gemini CLI
bash
npm install -g @google/gemini-cli4. 在「API Keys」界面配置一个 API KEY
访问仪表板的「API Keys」页面,创建并复制一个新的 API 密钥
5. 设置 Windows 系统环境变量
注意:CMD 本身不能直接修改"系统环境变量"(需管理员权限 + 图形界面),但可通过 setx 命令设置 用户级 或 系统级 变量(需管理员权限)。
方法一:使用 setx 命令(推荐用于用户级)
bash
setx GOOGLE_GEMINI_BASE_URL "https://mg.aid.pub/gemini-proxy"
setx GEMINI_API_KEY "填写你的Key"注意
如果您使用 modelgate 网页端，GOOGLE_GEMINI_BASE_URL 为： https://mg.aid.pub/gemini-proxy
如果您使用 modelgate 客户端，GOOGLE_GEMINI_BASE_URL 为： http://localhost:13148/gemini-proxy
重要提示：请使用与您选择的端口对应的 Key：
- 使用客户端时，请填写客户端的 Key
- 使用网页版时，请填写网页版的 Key
- 两个端的 Key 不要混用，否则可能导致认证失败
TIP
此方法仅对当前用户生效,重启后仍有效
方法二:手动设置(推荐系统级)
- Win10可在搜索框搜索 "系统属性" → "高级"→ "环境变量"
- 点击"环境变量"
- 在"系统变量"和"用户变量"区域点击"新建"
- 添加以下两项:
需要设置以下环境变量:
- 变量名:
GOOGLE_GEMINI_BASE_URL,变量值:https://mg.aid.pub/gemini-proxy - 变量名:
GEMINI_API_KEY,变量值:你的Key
注意
如果您使用 modelgate 网页端，GOOGLE_GEMINI_BASE_URL 为： https://mg.aid.pub/gemini-proxy
如果您使用 modelgate 客户端，GOOGLE_GEMINI_BASE_URL 为： http://localhost:13148/gemini-proxy
重要提示：请使用与您选择的端口对应的 Key：
- 使用客户端时，请填写客户端的 Key
- 使用网页版时，请填写网页版的 Key
- 两个端的 Key 不要混用，否则可能导致认证失败
6. 验证安装结果
重新启动 CMD,运行:
bash
gemini -vmacOS 安装
1. 安装 Gemini CLI 官方原版包
使用 npm 安装:
bash
npm install -g @google/gemini-cli或者使用 Homebrew 安装:
bash
brew install gemini-cli2. 在「API Keys」界面配置一个 API KEY
访问仪表板的「API Keys」页面,创建并复制一个新的 API 密钥
3. 编辑 ~/.zshrc 文件
使用 vim 编辑配置文件:
bash
vim ~/.zshrc在文件末尾添加以下两行:
bash
export GOOGLE_GEMINI_BASE_URL="https://mg.aid.pub/gemini-proxy"
export GEMINI_API_KEY="填写你的Key"注意
如果您使用 modelgate 网页端，GOOGLE_GEMINI_BASE_URL 为： https://mg.aid.pub/gemini-proxy
如果您使用 modelgate 客户端，GOOGLE_GEMINI_BASE_URL 为： http://localhost:13148/gemini-proxy
请将 "填写你的Key" 替换为你实际的 API Key
重要提示：请使用与您选择的端口对应的 Key：
- 使用客户端时，请填写客户端的 Key
- 使用网页版时，请填写网页版的 Key
- 两个端的 Key 不要混用，否则可能导致认证失败
4. 使配置生效
保存文件后,执行以下命令使配置生效:
bash
source ~/.zshrc开始使用
安装完成后,可前往任意项目目录开始使用 Gemini CLI
导航至目录
bash
cd your-folder启动 Gemini CLI
bash
gemini首次启动
当第一次启动 Gemini 出现选项时,选择 "Use gemini API key" 填入你的 Key
计费说明
在使用 Gemini CLI 时,每一次具体的任务交互需要调用模型完成,不同的模型调用费率如下(下列计费单位为每百万 tokens):
| 模型名称 | 输入(魔币) | 输出(魔币) |
|---|---|---|
| gemini-3-pro | 21 140 | 124 840 |
| gemini-3-pro-preview | 13 84 | 75 504 |
| gemini-3-pro-high | 11 70 | 63 420 |
| gemini-3-pro-low | 11 70 | 63 420 |
| gemini-2.5-pro | 7 43.75 | 52 350 |
| gemini-2.5-pro-nothinking | 7 43.75 | 52 350 |
| gemini-2.5-pro-thinking | 7 43.75 | 52 350 |
| gemini-2.5-flash | 1 6.3 | 8 52.5 |
| gemini-2.5-flash-nothinking | 2 10.5 | 13 87.5 |
| gemini-2.5-flash-thinking | 2 10.5 | 13 87.5 |
| gemini-2.0-flash | 2 10.5 | 6 42 |
| gemini-2.0-flash-lite | 1 1.4 | 1 1.4 |
| gemini-1.5-pro | 13 87.5 | 52 350 |
| gemini-1.5-flash | 2 10.5 | 6 42 |
说明
- 计费单位为 Mcoin(魔币)，1魔币=0.1人民币/ 0.0143美元
- 目前 Gemini CLI 内使用模型的费用约等于官方原价的 1.5折