🚀 零基础教程：在 Mac 终端丝滑使用 Google Gemini CLI (完美解决网络与认证卡顿)
想要在终端（Terminal）里直接和 Google Gemini 对话，不仅看起来很酷，还能极大地提升开发效率。
但是在国内网络环境下，很多 Mac 用户卡在了 “认证 Loading” 或者 “网络连接失败” 这两步。这通常是因为终端不走系统代理，导致无法连接 Google 服务器。
本教程将手把手教你如何 安装、配置网络代理、获取永久 API Key，实现打开终端就能用的丝滑体验。
✅ 准备工作
- 开启VPN：全程保持你的代理软件开启。
- 确认代理端口：打开你的代理软件设置，查看 HTTP/Socks5 端口号（本教程默认以 7890 为例，如果你的端口是 1080 或其他，请替换对应数字）。
第一步：检查 Node.js 环境
Gemini CLI 依赖 Node.js 运行环境，且建议版本在 v20 及以上。
-
打开终端，输入以下命令检查版本：
node -v -
如果显示的版本低于 v20（例如 v16, v18）或者提示 command not found，请前往 Node.js 官网 下载安装最新的 LTS 版本。
第二步：安装 Gemini CLI
我们将安装 Google 官方支持的最新版 CLI 工具。在终端执行以下命令：
npm install -g @google/gemini-cli@latest
提示：如果出现 ACCEES 权限错误，请在命令前加上 sudo，即 sudo npm install ...，然后输入电脑密码即可。
第三步：核心配置（代理 & API Key）
这是最关键的一步。
为什么你会卡在认证 Loading
因为浏览器（Chrome/Safari）虽然可以访问 Google，但 终端（Terminal）默认不走系统代理。这导致 CLI 工具发出的请求被墙拦截，无法完成 OAuth 握手。
为什么需要 API Key？
使用网页跳转认证（OAuth）容易因为网络波动导致 Token 失效，需要反复登录。使用 API Key 可以跳过浏览器交互，实现“永久在线”。
1. 获取 API Key
- 浏览器访问 Google AI Studio。
- 点击 "Create API key"。
- 复制生成的以 AIza 开头的长串字符。
2. 一键配置脚本 (推荐)
为了避免每次打开终端都要手动输入代理命令，我们将配置写入 Mac 的系统配置文件 (.zshrc) 中。
复制下面的代码（注意替换你的 API Key），粘贴到终端并回车：
# ⚠️ 注意：请先将下面的 "你的_API_KEY_粘贴在这里" 替换为你刚才复制的 Key
# 如果你的代理端口不是 7890，也请修改对应的数字
# 1. 为了安全，先备份一下你现有的配置
cp ~/.zshrc ~/.zshrc_backup_$(date +%Y%m%d)
# 2. 将配置追加写入到 .zshrc 文件底部
# 使用 cat << EOF 这种方式可以避免手动 echo 多次的麻烦
cat << 'EOF' >> ~/.zshrc
# 3. Google Gemini CLI 配置
# 3.1 网络代理设置 (端口 7890)
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890
# 3.2 API Key 设置 (避免反复弹窗登录)
# 设置两个变量名以兼容不同的工具版本
export GEMINI_API_KEY="你的_API_KEY_粘贴在这里"
export GOOGLE_API_KEY="你的_API_KEY_粘贴在这里"
# --- 配置结束 ---
EOF
# 4. 让配置立即生效
source ~/.zshrc
稳妥点的同学可以手动进入.zshrc文件，然后吧第三步手动粘贴到底部，手动保存。
3. 示例
第四步：验证使用
现在，你的环境已经配置完毕。直接在终端输入：
gemini
预期效果：
终端不会弹出浏览器，也不会卡 Loading，而是直接出现 > 提示符，等待你输入问题。
成功的界面
恭喜你！你已经成功解锁了终端 AI 助手。🎉
