在 Ubuntu 上安装和使用 Gemini CLI 的完整指南

  • Gemini CLI 允许您从 Ubuntu 和 Linux 终端与高级 AI 进行交互。
  • 它提供大型代码库、任务自动化和多模式原型的分析。
  • 它的安装需要 Node.js、npm 和 Google 帐户，以及自定义配置
Pablinux

8分钟

双子座 Cli

Gemini 命令行界面 已经彻底改变了开发人员和高级用户从 Ubuntu 终端与人工智能交互的方式。. 越来越多的人工智能工具被集成到编程工作流程中，但并非所有工具都能提供 Gemini CLI 所提供的强大功能、灵活性和直接访问。

Linux 世界中人工智能的兴起为自动化、代码分析和创意内容生成开辟了新的可能性。. 然而，安装和配置某些实用程序并不总是那么简单，尤其是对于那些希望在舒适的终端上充分利用 Gemini AI 潜力的人来说。如果您听说过 Gemini CLI，或者需要一个 Shell 中的智能伴侣， 这里有你需要知道的所有信息 在 Ubuntu 上安装、配置并充分利用它。

什么是 Gemini CLI 以及为什么它在 Ubuntu 上脱颖而出？

Gemini CLI 是由 Google Gemini 团队开发的命令行工具，主要面向开发人员、系统管理员以及任何想要在终端上利用 AI 的人。 它不仅允许您分析和编辑大型代码库，还可以自动执行 DevOps 任务、使用多模式输入制作应用程序原型，并提供与其他生成服务和模型的集成。 此外，它是一个根据 Apache 2.0 许可证获得许可的开源项目，确保透明度并与社区持续发展。

Gemini CLI 的主要功能和优势

  • 支持大型代码库：它能够处理上下文中的超过一百万个标记，让您能够分析大型项目而不会降低效率。
  • 多模式应用程序原型设计：允许您利用 Gemini 的多模式功能从 PDF 文档、图像或草图创建原型。
  • 高级 DevOps 和 Git 任务自动化：查询和操作拉取请求、计划迁移、解决复杂的重新基准等，所有这些都可以通过终端完成。
  • 轻松与多媒体模型集成：您可以通过 MCP 服务器连接到 Imagen、Veo 和 Lyria 等服务，直接生成多媒体内容。
  • 整合式网页搜寻：它有一个基于谷歌的搜索工具，可以实时获得最新、可靠的答案。

终端内的工作环境是高度可定制的。这得益于 MCP、GEMINI.md 文件等新兴标准，以及个人和团队配置选项。该项目在设计时充分考虑了可扩展性，因此能够不断发展，并融入国际开发者社区提出的新功能。

在 Ubuntu 上安装 Gemini CLI 的先决条件

在开始安装之前，请确保满足以下基本要求：

  • Ubuntu（或基于 Ubuntu 的发行版）正在运行。
  • Sudo 权限用于安装软件和对系统进行更改。
  • Google 帐户：第一次运行 Gemini CLI 时您需要登录。
  • Node.js 版本 20 或更高版本（最好是最新版本）。
  • npm（Node.js 包管理器）。

要检查您安装了哪个版本的 Node.js，您可以在终端中运行以下命令：

节点-v

如果少于要求或未安装，请按照以下步骤操作。

如何在 Ubuntu 上安装 Node.js 和 npm

安装 Node.js 和 npm 最快的方法是从 Ubuntu 自己的仓库安装。打开终端并运行：

sudo apt-get 更新 sudo apt-get 安装 nodejs -y sudo apt-get 安装 npm -y

如果你需要更高版本的 Node.js （例如 20 或更新版本），可以参考 Nodesource 官方仓库：

curl -fsSL https://deb.nodesource.com/setup_23.x -o nodesource_setup.sh sudo -E bash nodesource_setup.sh sudo apt-get install nodejs -y sudo apt-get install npm -y

TIP： 如果您已经安装了 Node.js 并且遇到冲突，请在升级 Node.js 后再次运行 npm install。

在 Ubuntu 上逐步安装 Gemini CLI

有几种方法可以安装 Gemini CLI，但在 Ubuntu 上最方便和推荐的选项是通过 npm，使用以下命令：

sudo npm install -g @google/gemini-cli

这样，该工具将作为系统上的全局命令使用，您可以从任何目录启动它。

如果您不想进行全局安装，也可以使用 npx 一次性运行它，但对于日常使用，建议进行全局安装。

安装后的第一步：配置和身份验证

首次使用以下命令运行 Gemini CLI：

双子座

将出现一个交互式向导，用于初始设置。 这些是通常的步骤：

1. 视觉主题选择

Gemini CLI 允许您选择不同的颜色和样式，以根据自己的喜好自定义环境。使用箭头键并按 Enter 确认。

2.登录方式

最简单的方法是使用您的个人 Google 帐户进行身份验证，标准免费套餐允许每分钟最多 60 个请求，每天最多 1.000 个请求。如果您需要更多容量，可以使用 API 密钥或 Vertex AI：

  • Google AI Studio API 密钥: 加入 谷歌人工智能工作室，生成密钥并将其设置为环境变量 GEMINI_API_KEY.
  • Vertex AI 的 Google Cloud API 密钥：从 Google Cloud 控制台生成密钥并导出变量 GEMINI_API_KEY y GOOGLE_GENAI_USE_VERTEXAI=true 在您的终端中。
  • 如果您在公司拥有 Google Workspace 帐号，请参阅身份验证指南了解高级方法。

3. 通过浏览器进行身份验证

选择方法后，该工具将打开一个浏览器窗口，供您安全登录。身份验证完成后，返回终端，您将看到一条确认消息。您已准备好开始使用 Gemini CLI！

安装后如何使用 Gemini CLI

Gemini CLI 使用起来简单但功能强大。您可以：

  • 在新目录中启动项目 或者使用现有的 cd 并运行 gemini.
  • 使用自然语言直接与 AI 模型交互：描述任务、请求代码生成、回答技术问题、自动执行重复任务等。
  • 使用字符将本地文件附加到对话中 @.
  • 通过键入来发现命令和可能性 / 在 CLI 本身中。
  • 集成 MCP 服务器以将 Gemini CLI 与系统或企业协作中的其他工具连接起来。

每次您进行查询时，Gemini CLI 都会在您正在处理的目录和文件的上下文中处理您的请求，从而允许进行特定于项目的操作。

故障排除和实用技巧

虽然安装通常很简单，但您可能会遇到一些问题：

  • Node.js 版本错误：请确保满足最低版本，按照前面的步骤进行更新。
  • 全局 npm 权限问题： 添加 sudo 如果收到权限错误，请转到安装命令。
  • 身份验证失败：在启动 Gemini CLI 之前，请确保您的默认浏览器已链接到正确的 Google 帐户。
  • 网络故障或模型变化：如果您的连接不稳定，Gemini 可能会自动从模型切换 gemini-2.5-pro a gemini-2.5-flash 以较低的延迟继续运行。

无论如何，您都可以查阅官方文档、常见问题解答指南或社区和开发人员发布解决方案和更新的 GitHub 存储库。

在 Ubuntu 上充分利用 Gemini CLI 的高级用法和技巧

除了通过传统终端进行交互外，Gemini CLI 还可以在 Visual Studio Code 等编辑器的集成终端中运行，从而在日常开发流程中受益于 AI。只需在 VSCode 中打开终端并运行 gemini 开始

另一个高级功能是文件管理：如果您在对话过程中需要查阅、编辑或分析特定文件，请使用 @ 在您的查询中选择并明确引用它。Gemini 会根据上下文进行处理。

对于那些希望扩展 CLI 功能或将其与企业系统集成的人来说， MCP 服务器允许您与组织的工具建立桥梁或添加新功能由于它是开源和可扩展的软件，您可以开发自己的附加组件或贡献社区本身会欣赏的改进。

身份验证选项、计划和限制

Gemini CLI 提供了几种不同的身份验证和使用方式：

  • 使用个人 Google 帐户免费访问：每天最多 1.000 个请求，每分钟最多 60 个请求。
  • Google AI Studio API 密钥：每天 100 个免费请求，可在密钥页面上付费升级。
  • Vertex AI API（Google Cloud）：通过快速模式对 Gemini 2.5 Pro 进行基本访问，但可以通过链接计费帐户来提高限制。

对于专业项目或密集使用案例，最好审查限制并考虑可用的付款计划，并尊重隐私政策和服务条款。

社区、支持和开源理念

Gemini CLI 是开源的，欢迎大家积极参与。 您可以报告错误、建议新功能、改进安全性，或直接向官方 GitHub 代码库贡献代码。Google 和全球社区共同打造了一个协作空间，让个人用户和团队都能根据自身需求调整工具。

Gemini CLI 采用的新兴标准（例如 MCP、可自定义配置以及 GEMINI.md 文件中的集中式系统提示符）使其成为一个独特且功能丰富的环境。这允许高度高级的配置，无论是个人使用还是商业和协作环境。

推荐补充工具：Apidog

除了 Gemini CLI 之外，值得一提的是以下实用程序 蜜蜂狗Apidog 是一个全面的 API 文档、测试和自动化环境。Apidog 兼容 Postman 和 Swagger 等格式，方便现有项目的迁移和导入。其直观的界面使其成为经验丰富的开发人员和 API 新手的理想之选，并且是 Gemini CLI 提升生产力的绝佳助手。

AI 集成到 Linux 终端现在已成为现实，任何愿意尝试的人都可以实现。 Gemini CLI 以其强大的功能、灵活性和可定制性而著称，能够帮助程序员、DevOps 团队和高级用户轻松完成日常和复杂的任务。该工具安装相对简单，提供丰富的身份验证选项、活跃的社区支持和持续更新，是您在控制台中运用 AI 的必备工具。