Gemini CLI 新手入门指南

一个为初学者准备的详细教程，带你轻松玩转强大的命令行 AI 助手。

help_center什么是 Gemini CLI？

想象一下，你可以直接在电脑的“小黑窗”（也就是终端或命令行界面）里，用打字的方式和强大的人工智能 Gemini 对话，让它帮你写代码、分析文件、甚至自动化处理繁琐任务。Gemini CLI (Command-Line Interface) 就是实现这一切的官方工具。

如果你对“命令行”感到陌生，别担心！这篇教程就是为你准备的。

computer命令行界面 (CLI)

这是一个纯文本的操作环境。你通过输入命令来告诉电脑做什么。它非常高效、强大，是程序员和技术爱好者的必备工具。

mouse图形用户界面 (GUI)

这是你平时最熟悉的界面，比如 Windows 或 macOS 桌面，有图标、窗口和按钮。你通过点击鼠标来操作电脑。

build_circle安装与配置 (一步一步来)

让我们开始动手吧！只需三个简单步骤，你就可以启动你的 AI 助手。

  1. 1

    looks_one第一步：安装前提 (Node.js)

    Gemini CLI 需要一个名为 Node.js 的环境来运行。你可以把它理解为让 Gemini CLI 能够在你电脑上跑起来的基础软件。

    检查是否已安装：打开你的终端（在 Windows 上是 PowerShell 或命令提示符，在 Mac 上是 Terminal），输入以下命令并按回车：

    node -v

    如果显示出 v18.0.0 或更高的版本号，恭喜你，可以跳到第二步！如果没有，或者提示“命令未找到”，请前往 Node.js 官网 下载并安装 LTS (长期支持) 版本。

  2. 2

    looks_two第二步：安装 Gemini CLI

    你有两种方式来运行 Gemini CLI，我们强烈推荐第二种以便长期使用。

    flight_takeoff快速体验 (npx)

    这个命令会直接运行 Gemini CLI，但不会在你的电脑上永久安装它。适合想尝鲜的用户。

    npx https://github.com/google-gemini/gemini-cli
    star推荐：长期使用 (npm)

    这个命令会将 Gemini CLI 全局安装到你的系统中。之后，你只需输入 gemini 即可随时启动它。

    npm install -g @google/gemini-cli
  3. 3

    looks_3第三步：首次运行与授权

    安装完成后，在终端里输入 gemini 并回车。首次运行时，它会引导你完成几个设置：

    • palette选择颜色主题：根据你的喜好为终端界面选择一个配色方案。
    • key登录谷歌账号：它会提示你在浏览器中登录你的个人 Google 账号。这是为了授权 Gemini CLI 使用 Gemini 1.5 Pro 模型。放心，这个过程是安全的。

    完成这些后，你就正式进入了 Gemini CLI 的交互世界！免费用户每天可以发出高达 1000 次请求，完全足够日常使用。

    warningGoogle Cloud / AI Studio 用户特别注意

    如果您是 Google Cloud 或 AI Studio 的现有用户，在进行上述登录授权时，可能会因为项目配置冲突而遇到问题。请参考以下视频和文字指南解决。

    smart_display视频操作教程

    文字步骤说明：

    1. 访问 Google Cloud 控制台。
    2. 在左上角找到并复制您的项目 ID。
    3. 在终端中设置环境变量：export GOOGLE_CLOUD_PROJECT="你的项目ID"
    4. 启动 Gemini CLI (输入 gemini)，然后手动输入 /auth 发起授权。
    5. 在浏览器中，选择 "More"，并使用拥有该项目的同一个 Google 账号登录。

Youtube你的第一个 AI 互动

启动 Gemini CLI 后，你会看到一个 > 符号，这表示它正在等待你的指令。现在，试着向它提问吧！例如，让它帮你写一个 Python 函数来生成九九乘法表：

> 帮我写一个 Python 函数，可以打印出九九乘法表

Gemini 会立刻生成代码，并可能附带解释。你还可以继续追问，比如 > 很好，现在给这段代码加上详细的注释。它会记住上下文，并根据你的新要求修改代码。

explore探索更多实用功能

Gemini CLI 的强大之处在于它能理解你项目中的文件。你可以用它做很多酷炫的事情：

architecture探索代码库

进入任何一个项目文件夹后，向它提问：> 描述一下这个系统的主要架构。

code辅助编程

让它帮你完成具体任务：> 为 GitHub issue #123 实现一个初步的解决方案。

upgrade代码迁移

处理复杂的重构任务：> 帮我把这个项目迁移到最新版本的 Java，先给我一个计划。

transform文件处理

与你的文件系统交互：> 把这个目录里所有的 jpg 图片转换成 png 格式。

settings_applications进阶配置 (可选)

如果你需要更高的请求额度或使用特定的 AI 模型，可以通过设置 API 密钥来实现。首先，你需要从 Google AI Studio 获取你的 API 密钥。然后，在终端中设置一个环境变量。将 YOUR_API_KEY 替换成你自己的密钥。

# 在 Mac/Linux 上
export GEMINI_API_KEY="YOUR_API_KEY"

# 在 Windows (PowerShell) 上
$env:GEMINI_API_KEY="YOUR_API_KEY"

设置完成后，Gemini CLI 将会自动使用这个密钥进行认证。

live_help遇到问题怎么办？

如果在探索过程中遇到任何困难，别担心！官方提供了详细的文档和指南来帮助你。

link官方资源

可以前往 Gemini CLI 官方 GitHub 仓库，你可以找到 Troubleshooting guide (故障排查指南) 和完整的 CLI Commands (命令列表)。

settings_ethernet解决网络连接错误 (设置代理)

如果您处在有网络代理的环境下（例如公司内网），可能会遇到连接错误。您可以通过设置环境变量来为 Gemini CLI 配置代理服务器。

# --- Windows (PowerShell) ---

# 设置 HTTP 和 HTTPS 代理
$env:HTTP_PROXY="http://代理地址:端口"
$env:HTTPS_PROXY="http://代理地址:端口"

# 如果代理需要认证
$env:HTTP_PROXY="http://用户名:密码@代理地址:端口"
$env:HTTPS_PROXY="http://用户名:密码@代理地址:端口"


# --- Mac/Linux (Bash/Zsh) ---

# 设置 HTTP 和 HTTPS 代理
export HTTP_PROXY="http://代理地址:端口"
export HTTPS_PROXY="http://代理地址:端口"

# 如果代理需要认证
export HTTP_PROXY="http://用户名:密码@代理地址:端口"
export HTTPS_PROXY="http://用户名:密码@代理地址:端口"

keyboard实用快捷键