一、前言 🙋♂️
Gemini CLI 是 Google 推出的终端 AI 工具，依托 Google Cloud 的算力与模型能力，可在本地终端快速调用 AI 服务。由于国内网络对 Google 服务访问有时不太稳定，强烈建议配合 ClashX Pro 的 Tun（增强）模式使用，以保证登录与数据传输的稳定性～🔒🌐
二、环境准备 🛠️
系统要求
- macOS 10.15 及以上 🍎已安装 Homebrew 🍺node 18.x
必装软件
- ClashX Pro：启动后在“配置”中开启 增强模式（Tun 模式） ，并保证规则覆盖
*.googleapis.com、*.cloud.google.com 等域名。gcloud CLI：管理 Google Cloud 账户与权限。Git（可选）：更新脚本或示例代码仓库。🐙三、ClashX Pro 配置步骤 ⚙️
下载并安装
- 前往 ClashX Pro Releases 下载最新版并安装。💾
导入配置
- 在 ClashX Pro 中导入你的订阅配置或手动添加规则，确保能代理 Google Cloud 相关域名。点击「配置文件」→「编辑」，确认
.googleapis.com、.cloud.google.com 等都在代理列表里。✅开启 Tun 模式
- 菜单栏 →「偏好设置」→「通用」。勾选 “启用增强模式 (Tun 模式)” 。点击「应用」，在 macOS 网络偏好中添加新出现的 “clashX Tun” 网络接口，让所有应用走该虚拟网卡。🚀
验证网络
ping console.cloud.google.com -c 3若能正常通、无丢包，就大功告成啦！🎯
四、安装 Gemini CLI 🤖
github地址github.com/google-gemi…
安装方式
Homebrew（推荐）：
npx https://github.com/google-gemini/gemini-clinpm（可选）：
npm install -g @google/gemini-cli环境变量设置 亲测不用配置也可以
确保 GOOGLE_CLOUD_PROJECT 指向你的 Project ID（如 smooth-copilot-464504-u7）：
echo 'export GOOGLE_CLOUD_PROJECT="your-project-id"' >> ~/.zshrcsource ~/.zshrc配置权限 亲测不用配置也可以
给账号加上：
roles/cloudaicompanion.userroles/serviceusage.serviceUsageConsumergcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \ --member="user:you@example.com" --role="roles/cloudaicompanion.user"gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \ --member="user:you@example.com" --role="roles/serviceusage.serviceUsageConsumer"五、登录与使用 🚪➡️💬
登录
gemini选择 “Login with Google”，完成浏览器 OAuth 授权。🔑
测试调用
gemini整理电脑文件
分析项目
如能正常返回 AI 回复，证明一切 OK～✨
六、常见问题 ❓
| 问题描述 | 排查要点 |
|---|---|
| 无法访问 Google 控制台 | 检查 ClashX Pro Tun 模式是否开启；确认规则覆盖了 *.google.com 等域名。 |
GOOGLE_CLOUD_PROJECT 未生效 | 确保在同一终端执行了 source ~/.zshrc；macOS 重启网络或注销后重试。 |
| 登录时提示权限不足 | 检查账号是否已添加所需 IAM 角色；可在 GCP 控制台中确认。 |
| Gemini CLI 命令找不到 | 确认安装路径在 $PATH；执行 which gemini 应返回可执行文件路径。 |
七、总结 🎉
通过以上步骤，ClashX Pro Tun 模式✅、gcloud CLI✅、Gemini CLI✅ 全部搞定！现在，你可以在终端里愉快地玩转 AI 了～🤩 祝使用顺利！
