Google Gemini CLI 完整安装与使用指南

一、 前提条件：安装 Node.js

1. 检查版本：确保您的电脑已安装 Node.js 18 或更高版本。在您的终端（Terminal、命令提示符或 PowerShell）中输入以下命令进行检查：

2. 安装 Node.js：如果未安装或版本过低，请访问 Node.js 官网 下载并安装最新的 LTS (长期支持) 版本。

二、 运行 Gemini CLI

• 方式一：直接运行 (推荐初次体验) 这种方式无需在您的系统中安装任何文件，非常适合快速测试。
注意：官方推荐的命令是 @google/gemini-cli，这比使用 GitHub 链接更标准、更安全。

• 方式二：全局安装 (推荐长期使用) 如果您计划频繁使用，全局安装后只需输入 gemini 即可启动。
1. 安装命令：
2. 运行命令：安装后，在终端的任何位置输入 gemini 即可启动。

三、 首次配置

1. 选择主题色：首次运行时，程序会提示您选择一个界面配色方案，根据个人喜好选择即可。

2. 登录认证：程序会自动打开浏览器，引导您使用 Google 账号登录授权。成功登录后，您将获得免费使用额度（通常为每分钟 60 次请求）。

四、 (可选) 配置 API 密钥以提升额度

1. 获取密钥：访问 Google AI Studio，创建并获取您的 API Key。

2. 配置环境变量：在终端中设置环境变量。
• 临时生效 (仅限当前终端窗口)：
• 永久生效：将上述命令添加到您的 Shell 配置文件中（如 ~/.zshrc, ~/.bashrc 或 ~/.bash_profile），然后重启终端或运行 source ~/.zshrc 使其生效。
请将 YOUR_API_KEY 替换为您自己的密钥。

五、 开始使用：实用命令示例

• 基础对话：直接在 gemini 命令后跟上您的问题。

• 流式输出 (打字机效果)：使用 s 或 -stream 参数，让答案逐字显示。

• 多媒体输入 (图片识别)：让 Gemini 描述一张本地图片。

• 从文件读取提示：将您的长篇问题或文章保存在一个文件中。

• 使用管道 (Pipe) 传递内容：结合其他命令，实现更强大的工作流。

• 持续性聊天：Gemini CLI 会自动记住上下文，您可以进行多轮对话。

• 查看帮助：