玩转Gemini CLI：新手入门指南

想象一下，直接在你电脑的命令行界面中，指挥一位智能助手来撰写代码、分析数据，甚至自动化冗长的任务。这不是科幻小说，而是借助强大的 Gemini CLI（命令行界面）你可以轻松实现的事情。如果你从未接触过命令行，别担心，这就是为你准备的终极指南。

什么是 Gemini CLI？

Gemini CLI 是一个命令行工具，让你通过文本指令向人工智能 Gemini 发出请求。通过简洁高效的命令输入，可以完成令人惊叹的各种操作。无论是编程、数据处理还是文件管理，Gemini CLI 都能为你提供强大的支持。

你与命令行的第一步

当你进入命令行界面（CLI），你会看到如同“小黑窗”的界面，这里没有华丽的图形，只有纯文本与命令的世界。虽然这个环境初看起来可能有些冷冰冰，但它蕴藏着极大的效率与实力。

安装与配置：一步到位

准备好了吗？让我们开始安装吧！只需三个简单步骤，你就能唤醒你的 AI 助手。

1. 安装前提：Node.js

首先，你需要安装 Node.js，这使得 Gemini CLI 能够在你的设备上顺利运行。
检查是否已安装：打开终端，输入以下命令并回车：

node -v

如果系统显示 v18.0.0 或更高版本，恭喜你！如果没有，访问 Node.js 官网上下载 LTS(长期支持版本)。

2. 安装 Gemini CLI

你有两种方式来使用 Gemini CLI，推荐第二种以便长期使用。

快速体验 (npx)

如果你仅想尝试，可以使用此命令，它将临时运行 Gemini CLI：

npx https://github.com/google-gemini/gemini-cli

推荐长期使用 (npm)

在终端中输入以下命令将 Gemini CLI 全局安装到你的系统中：

npm install -g @google/gemini-cli

3. 首次运行与授权

安装完成后，在终端输入 gemini 并按回车，首次运行时你将经历几个简单的设置：

• 选择颜色主题：为你的终端界面挑选一个喜欢的配色方案。
• 登录 Google 账号：系统会引导你在浏览器中登录你的 Google 账号，以授权 Gemini CLI 使用其功能。这个过程安全无忧。

登录后，你就可以开始与 Gemini CLI 互动了。免费用户每天可发出高达 1000 次请求，足以满足你的日常需求！

Google Cloud & AI Studio 用户必看

如果你是 Google Cloud 或 AI Studio 的用户，可能会在登录授权时遭遇不同项目配置引发的问题。别担心！在这篇文章中，我们将为你提供简洁明了的步骤，从而顺利克服困扰，加快你的操作效率。让我们深入了解吧！

遇到什么问题？

在登录授权时，你可能会因为项目配置冲突而无法顺利完成。这种情况下，了解如何正确设置和授权尤为关键。
以下是解决方案的具体步骤：

1. 访问 Google Cloud 控制台
   • 首先，前往 Google Cloud 控制台。
2. 复制你的项目 ID
   • 在控制台的左上角，找到并复制你的项目 ID。这是后续操作中必不可少的信息。
3. 设置环境变量
   • 打开终端输入以下命令，替换 "你的项目ID" 为你刚才复制的项目 ID：
     export GOOGLE_CLOUD_PROJECT="你的项目ID"
4. 启动 Gemini CLI
   • 在终端中输入 gemini 启动 Gemini 命令行工具，然后输入 /auth 来发起授权流程。
5. 选择正确的 Google 帐号
   • 在浏览器中，点击“More”，确保用与该项目关联的同一个 Google 账号登录，以保证权限正确。

第一次与 AI 的互动

启动 Gemini CLI 后，你会看到 > 符号，系统准备好接收你的指令了。试试问它一个问题，例如：

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

Gemini 会立刻生成代码并提供解释。若你需要进一步修改，可以随时追问，比如：

很好，现在给这段代码加上详细的注释。

Gemini 能够持续理解上下文，灵活调整响应。

探索更多实用功能

Gemini CLI 的核心实力在于它能够理解项目中的文件，助你轻松进行许多复杂的操作：

• 探索代码库：询问系统：> 描述一下这个系统的主要架构。
• 辅助编程：请求：> 为 GitHub issue #123 实现一个初步的解决方案。
• 代码迁移：咨询：> 帮我把这个项目迁移到最新版本的 Java，先给我一个计划。
• 文件处理：指令：> 把这个目录里所有的 jpg 图片转换成 png 格式。

进阶配置（可选）

若你需要提升请求额度或使用特定 AI 模型，可以设置 API 密钥。首先，从 Google AI Studio 获取你的 API 密钥，然后在终端中设置环境变量，将 YOUR_API_KEY 替换成你自己的密钥。

在 Mac/Linux 上：

export GEMINI_API_KEY="YOUR_API_KEY"

在 Windows 上：

$env:GEMINI_API_KEY="YOUR_API_KEY"

完成后，Gemini CLI 将使用该密钥进行认证。

遇到问题怎么办？

探索过程中遇到困扰？别担心！官方提供了详细文档和指南，助你轻松解决问题。

• 官方 GitHub 仓库中有故障排查指南和命令列表。

网络连接错误（设置代理）

若你处于有网络代理环境下，Gemini CLI 可能容易遭遇连接错误。你可以通过设置环境变量来配置代理服务器。例如：
在 Windows 中：

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

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

在 Mac/Linux 中：

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

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

实用快捷键，提升效率！

• Ctrl+A：移动到行首
• Ctrl+E：移动到行尾
• Ctrl+K：删除光标到行尾
• Ctrl+U：删除光标到行首
• Ctrl+P / Up：上一条历史
• Ctrl+N / Down：下一条历史

开始你的 Gemini CLI 冒险吧！相信这位 AI 助手会让你的编程和工作变得简单而高效。