Google Gemini CLI 免费安装与配置指南
Google推出的Gemini CLI是一款强大的命令行工具，它允许开发者直接在终端中与Gemini模型进行交互。本文将为你提供一份清晰的安装与配置指南，帮助你快速上手，免费使用强大的Gemini 2.5 Pro模型。
Gemini CLI 核心能力
| 功能模块 | 核心能力 | 应用场景 |
|---|---|---|
| 大规模代码分析 | 支持超长上下文（100万+ Token） | 复杂项目理解、代码库重构、大型系统维护 |
| 多模态应用生成 | 基于PDF、草图等媒介快速构建原型 | 概念验证、敏捷开发、创意实现 |
| 自动化运维 | 自动执行Git、PR查询、代码迁移 | 提升DevOps效率、减少重复性劳动、简化工作流 |
| 外部工具集成 | 连接Imagen, Veo等第三方媒体模型 | 多媒体内容创作、扩展应用功能 |
| 联网搜索支持 | 内置Google Search | 事实核查、获取最新API文档、追踪技术趋势 |
步骤一：环境准备
在安装之前，请确保你的电脑已经安装了 Node.js (版本 20 或更高)。
你可以在终端中输入以下命令来检查当前版本：
<span class="code-line"><span class="token function">node</span> <span class="token variable parameter">--version</span>
</span>如果未安装或版本过低，请访问 Node.js 官网 下载并安装最新版本。为了获得最佳的命令行体验，推荐使用Windows的WSL、原生Linux或macOS环境。
步骤二：安装 Gemini CLI
Google 提供了多种安装方式，你可以根据自己的偏好选择其一。
方式一：使用 npx (推荐，无需全局安装)
这是最简单快捷的方式，可以直接运行而无需在你的系统中全局安装。
<span class="code-line"><span class="token comment"># 直接运行 Gemini CLI</span>
</span><span class="code-line">npx https://github.com/google-gemini/gemini-cli
</span>方式二：使用 npm (全局安装)
如果你希望在任何路径下都能直接使用 gemini 命令，可以选择全局安装。
<span class="code-line"><span class="token function">npm</span> <span class="token function">install</span> <span class="token variable parameter">-g</span> @google/gemini-cli
</span>方式三：使用 Homebrew (适用于 macOS 或 Linux)
如果你的系统安装了 Homebrew，也可以使用它来安装。
<span class="code-line">brew <span class="token function">install</span> gemini-cli
</span>步骤三：配置 Gemini CLI
安装完成后，你需要进行配置，将工具与你的Google账户或API密钥关联起来。
直接在命令行输入 gemini 即可启动配置向导和开始对话。
<span class="code-line">gemini
</span>强烈建议：首次运行时，花几分钟时间创建一个 GEMINI.md 配置文件。这个文件可以用来设定长期有效的上下文或“记忆”，避免每次对话都重复提供背景信息。
你有以下几种配置方式：
1. 使用 Google 账户登录 (最简单)
运行 gemini 命令后，会引导你通过浏览器登录自己的Google账户。按照提示操作即可，这是最简单的方式。
2. 使用 API 密钥 (推荐，更灵活)
这种方式更适合开发者和自动化脚本。
首先，你需要免费获取API密钥：
- 访问 Google AI Studio。
- 登录后，点击 “Get API key” -> “Create API key”。
- 复制生成好的密钥。
然后，在终端中设置环境变量。
临时配置 (仅当前终端窗口有效):
<span class="code-line"><span class="token comment"># 将 YOUR_API_KEY 替换成你自己的密钥</span>
</span><span class="code-line"><span class="token builtin class-name">export</span> <span class="token variable assign-left">GEMINI_API_KEY</span><span class="token operator">=</span><span class="token string">"YOUR_API_KEY"</span>
</span><span class="code-line">gemini
</span>永久配置 (推荐): 将密钥信息写入你终端的配置文件中（如 ~/.bashrc, ~/.zshrc 等）。
<span class="code-line"><span class="token comment"># 这会将密钥写入 .bashrc 文件，新开终端时会自动生效</span>
</span><span class="code-line"><span class="token builtin class-name">echo</span> <span class="token string">'export GEMINI_API_KEY="YOUR_API_KEY"'</span> <span class="token operator">>></span> ~/.bashrc
</span><span class="code-line"><span class="token comment"># 如果你使用 Zsh，请将 .bashrc 替换为 .zshrc</span>
</span>3. 使用 Vertex AI (企业级，收费)
这是面向企业用户的付费方式，需要通过 Google Cloud Console 获取密钥。
<span class="code-line"><span class="token builtin class-name">export</span> <span class="token variable assign-left">GOOGLE_API_KEY</span><span class="token operator">=</span><span class="token string">"YOUR_API_KEY"</span>
</span><span class="code-line"><span class="token builtin class-name">export</span> <span class="token variable assign-left">GOOGLE_GENAI_USE_VERTEXAI</span><span class="token operator">=</span>true
</span><span class="code-line">gemini
</span>关于第三方API：市面上有一些提供转发服务的第三方API，虽然可能在特定情况下能解决网络问题，但稳定性和安全性无法保证，请谨慎甄别。
完成以上步骤后，你的Gemini CLI就配置好了。现在，你可以在终端里尽情探索Google AI的强大能力了。
评论(0)