Gemini CLI 使用教程
摘要： 本文详细介绍了 Gemini CLI，一个由 Google 开发的命令行 AI 工作流工具。Gemini CLI 旨在通过连接各种工具、理解代码和加速工作流程来提高开发效率。本教程涵盖了 Gemini CLI 的安装、配置、基本用法、高级功能以及常见问题的解决方案。目标读者是希望利用 AI 提升开发效率的开发者、运维工程师和技术爱好者。通过学习本教程，读者可以掌握 Gemini CLI 的核心功能，并将其应用到实际项目中，例如代码编辑、应用生成、自动化任务等。本教程还提供了丰富的示例和故障排除指南，帮助读者快速上手并解决使用过程中遇到的问题。
什么是 Gemini CLI？
Gemini CLI 是一个命令行 AI 工作流工具，它可以：
- 查询和编辑大型代码库，超越 Gemini 的 100 万 token 上下文窗口限制。
- 使用 Gemini 的多模态能力，从 PDF 或草图生成新的应用程序。
- 自动化操作任务，例如查询 pull request 或处理复杂的 rebase。
- 使用工具和 MCP 服务器连接新功能，包括使用 Imagen、Veo 或 Lyria 生成媒体。
- 使用内置于 Gemini 的 Google Search 工具来支持你的查询。
快速开始
前提条件
确保你已经安装了 Node.js 18 或更高版本。
安装和运行 Gemini CLI
方法一：使用 npx 运行
在你的终端中执行以下命令：
npx https://github.com/google-gemini/gemini-cli方法二：全局安装并运行
使用 npm 全局安装：
npm install -g @google/gemini-cli安装完成后，运行：
gemini身份验证
当提示时，使用你的个人 Google 帐户登录。 这将授予你每分钟最多 60 个模型请求和每天 1,000 个模型请求的使用 Gemini 的权限。
现在你就可以使用 Gemini CLI 了！
高级用法和更高的请求限制
如果你需要使用特定的模型或需要更高的请求容量，你可以使用 API 密钥：
- 从 Google AI Studio 生成一个密钥。
- 在你的终端中将其设置为环境变量。 将
YOUR_API_KEY替换为你生成的密钥。
export GEMINI_API_KEY="YOUR_API_KEY"有关其他身份验证方法，包括 Google Workspace 帐户，请参阅身份验证指南。 (此链接需要替换为实际的身份验证指南链接)
使用示例
在新项目中启动
cd new-project/
gemini
> Write me a Gemini Discord bot that answers questions using a FAQ.md file I will provide
在现有项目中使用
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday
下一步
- 了解如何 贡献或从源代码构建。(此链接需要替换为实际的贡献指南链接)
- 浏览可用的 CLI 命令。(此链接需要替换为实际的 CLI 命令文档链接)
- 如果你遇到任何问题，请查看故障排除指南。(此链接需要替换为实际的故障排除指南链接)
- 有关更全面的文档，请参阅完整文档。(此链接需要替换为实际的完整文档链接)
- 查看一些 热门任务 以获取更多灵感。(此链接需要替换为实际的热门任务示例链接)
故障排除
如果你遇到问题，请前往故障排除指南。(此链接需要替换为实际的故障排除指南链接)
热门任务
探索新的代码库
首先 cd 进入现有的或新克隆的存储库，然后运行 gemini。
> Describe the main pieces of this system's architecture.
> What security mechanisms are in place?使用现有代码
> Implement a first draft for GitHub issue #123.
> Help me migrate this codebase to the latest version of Java. Start with a plan.自动化你的工作流程
使用 MCP 服务器将你的本地系统工具与你的企业协作套件集成。
> Make me a slide deck showing the git history from the last 7 days, grouped by feature and team member.
> Make a full-screen web app for a wall display to show our most interacted-with GitHub issues.与你的系统交互
> Convert all the images in this directory to png, and rename them to use dates from the exif data.
> Organise my PDF invoices by month of expenditure.服务条款和隐私声明
有关适用于你使用 Gemini CLI 的服务条款和隐私声明的详细信息，请参阅服务条款和隐私声明。(这两个链接需要替换为实际的链接)
关于
一个开源 AI 代理，可将 Gemini 的强大功能直接带入你的终端。
数据统计
相关导航
