打赏

Google Gemini CLI 配置教程

Google Gemini CLI 配置教程

大家好！这个教程是为新手准备的，详细解释如何配置和使用 Google 的 Gemini CLI（这是一个命令行工具，让你能在终端直接和 Gemini AI 聊天、生成代码、搜索信息等）。我会一步一步地指导你，从零开始，确保你能成功配置。即使你没有编程经验，我也会用简单的话解释每个步骤。我们用 Node.js 来安装，因为这是官方推荐的方式。整个过程大约需要 15-30 分钟。

注意： 这个 CLI 是免费的（有使用限额，使用 Google 账号认证），但需要一个 Google 账号。Gemini CLI 是 Google 的开源工具，能让你在终端里像聊天一样用 AI。

前提条件

在开始前，确保你有这些：

  1. 一个 Google 账号：如果你没有，去 accounts.google.com 注册一个。最好用个人 Gmail 账号，而不是工作账号（Google Workspace）。
  2. Node.js 安装：需要 Node.js 20 或更高版本（有些教程说 18+ 也行，但推荐最新）。如果你没有安装，去 nodejs.org 下载并安装 LTS 版本。安装后，在命令行（Windows 是 CMD 或 PowerShell，Mac/Linux 是 Terminal）输入 node -v 检查版本，应该显示像 v20.x.x 这样的。
  3. 命令行工具：你需要用命令行运行命令。别担心，我会教你怎么打开和输入。
    • Windows：按 Win + S，搜索 “CMD” 或 “PowerShell”，打开。
    • Mac：按 Cmd + Space，搜索 “Terminal”，打开。
    • Linux：直接打开 Terminal。
  4. 浏览器：最好用 Chrome，因为认证时会打开浏览器。

如果这些你都没有，先安装 Node.js，它是最重要的。

步骤 1: 安装 Gemini CLI

我们用 npm（Node.js 的包管理器）来安装。npm 随 Node.js 一起安装。

  1. 打开命令行。
  2. （可选）创建一个项目文件夹来测试：
    mkdir gemini-cli-test
cd gemini-cli-test
    这只是为了组织文件，不必纠结。
  3. 安装 Gemini CLI。有两种方式，新手推荐全局安装：
    • 全局安装（推荐，能在任何地方用）：
      npm install -g @google/gemini-cli
      如果是 Mac 或 Linux，可能需要加 sudo（输入密码）：
      sudo npm install -g @google/gemini-cli
      Windows 可能需要管理员权限，右键打开 CMD 以管理员运行。
    • 不安装，直接运行（测试用）：
      npx https://github.com/google-gemini/gemini-cli
  4. 安装完后，检查版本：
    gemini --version
    如果显示版本号（如 1.0.0），就成功了！如果命令找不到，检查 Node.js 是否在 PATH 中（重启命令行试试）。

常见问题：如果 npm 报错，检查网络或 Node.js 安装。安装可能需要几分钟。

步骤 2: 获取并设置 API Key（可选，但推荐用于更高限额）

默认用 Google 账号认证（免费，60 请求/分钟，1000 请求/天），但如果你想用 API Key（更高限额或自定义）：

  1. 打开浏览器，访问 aistudio.google.com/app/apikey。
  2. 用 Google 账号登录。
  3. 点击“Create API key”（创建 API 密钥）。
  4. 复制生成的 Key（像 AIzaSy... 开头）。
  5. 设置环境变量，让 CLI 能找到它：
    • Windows (CMD)：
      set GEMINI_API_KEY=你的API_Key
      （替换 “你的API_Key”）。永久设置：搜索“环境变量”，在用户变量中新建 GEMINI_API_KEY。
    • Windows (PowerShell)：
      $env:GEMINI_API_KEY="你的API_Key"
    • Mac 或 Linux：
      export GEMINI_API_KEY="你的API_Key"
      永久设置：编辑 ~/.bashrc 或 ~/.zshrc，添加这行，然后 source ~/.bashrc。
  6. 测试：输入 echo $GEMINI_API_KEY（Mac/Linux）或 echo %GEMINI_API_KEY%（Windows），应该显示 Key。

安全提示：Key 像密码，别分享。如果用默认认证，不需要这个步骤。

步骤 3: 首次运行和配置

现在，启动 CLI 并配置。

  1. 在命令行输入：
    gemini
  2. 首次运行，会提示配置：
    • 选择主题：选一个你喜欢的（如 Default），按 Enter。
    • 认证方式：选 “Personal Google Account” 或 “OAuth personal”（推荐免费方式）。按 Enter，它会打开浏览器。
  3. 在浏览器中：
    • 用 Google 账号登录。
    • 接受条款和权限（允许 CLI 访问 Gemini）。
    • 浏览器会显示成功消息，关掉它，回命令行。
  4. 配置完，CLI 会进入聊天界面。你看到提示符如 “>” 或类似，就成功了！

如果用 API Key，CLI 会自动检测环境变量。如果提示错误，检查 Key 是否正确。

步骤 4: 基本使用

现在，你能用了！CLI 像聊天室。

  1. 在提示符下输入问题，如：
    给我一个关于 AI 的著名引用，以及谁说的？
    按 Enter，Gemini 会回复。
  2. 常用命令（输入 / 开头）：
    • /help：显示帮助。
    • /quit：退出。
    • /tools：列出工具（如 GoogleSearch、WriteFile）。
    • /model：切换模型，如 gemini-1.5-flash（更快）。
  3. 上传文件：输入 @，选本地文件，CLI 会分析它（如 “帮我总结这个文件”）。
  4. 非交互模式（快速问答）：
    gemini -p "今天天气怎么样？"
    （-p 是提示）。
  5. 工具权限：如果用像 WriteFile 的工具，会问你允许吗？选一次允许、总是允许或拒绝。

例子：搜索并保存文件。
输入：

搜索今天金融新闻，并保存到 finance-news.txt

CLI 会用工具搜索，问权限，然后保存文件。你可以用 cat finance-news.txt 查看（Mac/Linux）或 type finance-news.txt（Windows）。

如果出错：

  • 检查网络（需要互联网）。
  • 如果认证失败，重新运行并选其他方式。
  • 更新 CLI：npm update -g @google/gemini-cli。

额外提示

  • 配置文件：设置保存在 ~/.gemini/settings.json。你可以用编辑器改主题或认证。
  • 在 VS Code 用：在 VS Code 终端运行 gemini，能直接选项目文件。
  • 模型选择：默认是 gemini-1.5-pro，闪电版是 gemini-1.5-flash（用 -m 指定）。
  • 限额：免费版够用，如果超了，用 API Key 或等。
  • 卸载：如果不想用，npm uninstall -g @google/gemini-cli。

恭喜！你现在能用 Gemini CLI 了！试试生成代码、翻译、搜索吧。如果问题，去 GitHub 仓库 github.com/google-gemini/gemini-cli 看文档。

posted @ 2025-12-26 22:31  gyc567  阅读(0)  评论(0)    收藏  举报