前置条件
- 1已安装 Node.js 18+（npm 安装方式）
- 2已注册 Google 账号，或在 Google AI Studio 获取 Gemini API Key
- 3支持 macOS / Linux / Windows（推荐 WSL2）
腾讯智能体开发平台 ADP
新客首月专属价，最高直降 880 元，构建/分发/治理企业级 Agent
常见问题
QGemini CLI 和 Gemini 网页版有什么区别？
Gemini CLI 是运行在终端的开源 AI Agent，可读写文件、执行 Shell、调用 MCP 工具；网页版只能对话。两者可共用同一个 Google 账号。
Q免费额度是多少？
用个人 Google 账号 OAuth 登录，免费层为 60 次/分钟、1000 次/天，并支持 Gemini 2.5 系列模型与 1M token 上下文。
Q不想用 OAuth，能用 API Key 吗？
可以。在 Google AI Studio 获取 API Key 后，设置环境变量 `GEMINI_API_KEY` 即可，适合无头服务器和 CI/CD。
Q企业 / 学校账号要额外配置吗？
Google Workspace、企业、学校账号需要先关联一个 Google Cloud 项目；个人账号通常无需配置项目即可直接使用。
Q如何切换到 Vertex AI 后端？
在 `~/.gemini/settings.json` 中将 `selectedType` 设为 `vertex-ai`，并设置 `GOOGLE_CLOUD_PROJECT`、`GOOGLE_CLOUD_LOCATION`、`GOOGLE_GENAI_USE_VERTEXAI=true` 等环境变量。
Q如何给项目定制行为？
在项目根目录放置 `GEMINI.md`，写入技术栈、编码规范、上下文说明，Gemini CLI 会自动加载作为每次对话的系统上下文。