Gemini CLI 部署教程【全网最细】

一、前言 🙋‍♂️

Gemini CLI 是 Google 推出的终端 AI 工具，依托 Google Cloud 的算力与模型能力，可在本地终端快速调用 AI 服务。由于国内网络对 Google 服务访问有时不太稳定，强烈建议配合 ClashX Pro 的 Tun（增强）模式使用，以保证登录与数据传输的稳定性～🔒🌐

---

二、环境准备 🛠️

1. 系统要求

   • macOS 10.15 及以上 🍎

   • 已安装 Homebrew 🍺

   • node 18.x

   • 可以开启Tun模式（增强模式的🪜） 应掘金要求省略一万字

三、安装 Gemini CLI 🤖

github地址
github.com/google-gemi…

1. 安装方式

• Homebrew（推荐）：
  bash npx https://github.com/google-gemini/gemini-cli

• npm（可选）：
  bash npm install -g @google/gemini-cli

2. 环境变量设置 亲测不用配置也可以 确保 GOOGLE_CLOUD_PROJECT指向你的 Project ID（如smooth-c-u7`）： echo 'export GOOGLE_CLOUD_PROJECT="your-project-id"' >> ~/.zshrc source ~/.zshrc

3. 配置权限 亲测不用配置也可以
   给账号加上：

   • roles/cloudaicompanion.user

   • roles/serviceusage.serviceUsageConsumer

   gcloud 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"
   

---

五、登录与使用 🚪➡️💬

1. 登录

   gemini
   

   选择 “Login with Google”，完成浏览器 OAuth 授权。🔑
   2. 测试调用

   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 了～🤩 祝使用顺利！