快速入门

了解如何安装、配置并高效使用 Gemini CLI

快速入门

Gemini CLI 是一款开源 AI 终端代理，基于 ReAct 推理-行动循环，为开发者提供在本地或远程 MCP 服务器上调用 Gemini 系列模型的能力。您可以借助它完成从代码生成、调试到自动化运维的全流程任务。

先决条件

  • 操作系统：macOS、Linux 或 Windows
  • 运行环境：已安装 Node.js ≥ 18（建议使用 LTS 版本）
  • 网络访问：能够访问 Google AI 相关服务（若位于受限网络，可提前配置代理或镜像）

安装

使用 npm

npm install -g @google/gemini-cli

使用 yarn

yarn global add @google/gemini-cli

临时使用

如不想全局安装，可直接执行：

npx @google/gemini-cli

验证安装

gemini --version

出现版本号即表示安装成功。

创建并初始化项目

1. 在空目录初始化

gemini

2. 生成模板项目（可选）

gemini create my-project
cd my-project

首次运行将提示选择配色方案，并要求使用 Google 个人账号或 API Key 进行身份验证。完成登录后，个人账户默认配额为 60 次/分钟、1,000 次/日。

常用命令速览

查看所有命令

gemini help

列出 CLI 支持的全部子命令

检查配置状态

gemini status

快速诊断网络与鉴权是否正常

管理工具与 MCP

/tools
/mcp

在交互模式下列出已启用的本地工具或 MCP 服务器

管理上下文记忆

/memory show

查看已加载的 GEMINI.md 及其他上下文文件

完整命令文档请参阅 CLI Commands。

下一步

🔧 配置与高级定制

了解环境变量、~/.gemini/settings.json 与 .geminiignore 等配置选项，按需调整模型、代理与文件过滤。

参考链接：Configuration Guide

🔌 扩展与插件体系

通过 Gemini CLI Extensions 将自定义工具、工作流或第三方 API 注入 CLI，扩展模型能力。

参考链接：Gemini CLI Extensions

📖 最佳实践与案例

参考 Google Cloud 官方技术博客，深入了解 GEMINI.md 上下文文件的组织方式、MCP 集成以及团队协作模式。

参考链接：Getting Started with Gemini CLI

🏠 源代码与社区

GitHub 仓库：google-gemini/gemini-cli

欢迎提交 Issue、PR 或参与社区讨论。