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 密钥：

1. 从 Google AI Studio 生成一个密钥。
2. 在你的终端中将其设置为环境变量。 将 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 的强大功能直接带入你的终端。