Gemini CLI 新手 · 自定义配置完整教程

一、Gemini CLI 是什么（一句话版）

Gemini CLI =
👉 在终端里直接用 Google Gemini 大模型写代码 / 查问题 / 改代码

适合你这种情况：

后端 / 小程序 / PHP / JS 经常在命令行操作

不想一直切 VS Code / 浏览器

想要 “像用 git 一样用 AI”

二、安装前准备（必须）
✅ 1️⃣ Node.js（>=18）

终端执行：

node -v
如果没有或太低：

👉 https://nodejs.org

安装 LTS 版本

三、安装 Gemini CLI（官方）
① 全局安装

npm install -g @google/gemini-cli

安装完成后验证：

gemini --version
能看到版本号 = 成功
如图所示：

四、获取 Gemini API Key（关键）

① 打开 Google AI Studio

👉 https://api.apiqik.online/console/token

然后创建复制密钥，查看令牌分组使用教程文档
⚠️ 这个 Key 很重要，不要泄露
五、配置 Gemini CLI（核心）
方法一（最推荐）：环境变量方式 ✅
macOS / Linux（zsh / bash）
export GOOGLE_GEMINI_BASE_URL="https://api.apiqik.online"
export GEMINI_API_KEY="你的API_KEY"
让它永久生效（推荐）：
echo 'export GEMINI_API_KEY="你的API_KEY"' >> ~/.zshrc
source ~/.zshrc
Windows（PowerShell）
setx GEMINI_API_KEY "你的API_KEY"
setx GOOGLE_GEMINI_BASE_URL "https://api.apiqik.online"
验证是否配置成功
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY

gemini -m gpt-4.1 "用一句话解释什么是 RESTful API"
参数-m 后面跟着自己切换的模型，参考令牌分组使用教程文档

令牌分组（Token Group）使用教程

如果模型能正常回复：

🎉 恭喜你，已经全部配置成功！