谷歌 Gemini CLI 工具入门教程

本教程概述 Gemini CLI 的主要命令，这是一个由谷歌开发的强大命令行界面工具，用于与 Gemini 服务交互。无论您是开发者还是技术爱好者，本教程将帮助您理解并有效使用 Gemini CLI。以下内容将介绍主要命令、用法和实际示例，助您快速上手。

Gemini CLI 简介

Gemini CLI 是一个多功能工具，旨在简化与谷歌 Gemini 服务的交互。它允许用户通过终端直接执行命令，非常适合自动化任务、管理配置和高效访问 Gemini 功能。本指南基于官方文档，为初学者和中级用户提供简化的命令说明。

前提条件

在使用 Gemini CLI 之前，请确保您已准备好：

• 安装 Gemini CLI：按照官方 Gemini CLI GitHub 仓库 的安装说明进行操作。
• API 密钥：从您的 Gemini 账户获取有效的 API 密钥以进行身份验证。
• 终端访问：在您的操作系统上使用命令行界面（如 Bash、PowerShell 或终端）。

主要命令

以下是 Gemini CLI 的主要命令，以及其描述和示例。

gemini init

描述：初始化 Gemini CLI 配置，设置必要的环境变量和身份验证凭据。

用法：

gemini init

示例：

$ gemini init
请输入您的 Gemini API 密钥：[您的 API 密钥]
配置已保存至 ~/.gemini/config.yaml

此命令会提示您输入 API 密钥，并创建一个配置文件以安全存储您的凭据。

gemini version

描述：显示系统中安装的 Gemini CLI 的当前版本。

用法：

gemini version

示例：

$ gemini version
Gemini CLI 版本 1.2.3

使用此命令验证您是否在使用最新版本的 CLI。

gemini auth

描述：管理身份验证设置，允许您更新或刷新 API 密钥。

用法：

gemini auth [选项]

选项：

• --update：更新现有的 API 密钥。
• --clear：清除当前的身份验证设置。

示例：

$ gemini auth --update
请输入新的 API 密钥：[新 API 密钥]
身份验证更新成功。

当您的 API 密钥过期或需要更改时，此命令非常有用。

gemini query

描述：向 Gemini 服务发送查询并获取响应。

用法：

gemini query [查询字符串]

示例：

$ gemini query "法国的首都是哪里？"
响应：法国的首都是巴黎。

这是与 Gemini 查询处理功能交互最常用的命令之一。

gemini config

描述：查看或修改 Gemini CLI 的配置设置。

用法：

gemini config [选项]

选项：

• --view：显示当前配置。
• --set：设置特定的配置参数（例如，端点 URL）。

示例：

$ gemini config --view
API 密钥：[您的 API 密钥]
端点：https://api.gemini.google.com/v1

使用此命令检查或更新您的配置设置。

gemini help

描述：显示 Gemini CLI 的帮助信息，包括可用命令及其描述。

用法：

gemini help

示例：

$ gemini help
可用命令：
  init    初始化 Gemini CLI 配置
  version 显示 CLI 版本
  auth    管理身份验证
  query   向 Gemini 发送查询
  config  管理配置设置
  help    显示此帮助信息

此命令是探索 CLI 功能的绝佳起点。

使用 Gemini CLI 的最佳实践

• 保护您的 API 密钥：切勿公开分享您的 API 密钥或将其存储在不安全的位置。
• 检查更新：定期运行 gemini version 以确保使用最新版本的 CLI。
• 使用帮助命令：如有疑问，使用 gemini help 探索可用命令和选项。
• 测试查询：从简单的 gemini query 命令开始，熟悉工具的响应。

常见问题排查

• 身份验证错误：如果遇到身份验证问题，运行 gemini auth --update 刷新您的 API 密钥。
• 配置问题：使用 gemini config --view 验证您的设置，确保配置了正确的端点。
• 命令未找到：确保 Gemini CLI 已正确安装并添加到系统 PATH。

结论

Gemini CLI 是一个强大的工具，可通过命令行与谷歌 Gemini 服务交互。通过掌握上述命令，您可以高效地管理配置、进行身份验证并查询 Gemini 服务。欲了解更多详细信息，请参阅官方 Gemini CLI 文档。