本教程概述 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 文档。