Gemini CLI上手指南：从注册到实战，开启你的AI编程之旅

你是否曾想过，如果你的命令行能听懂人话，帮你写代码、改Bug、甚至自动化部署，那该有多酷？Gemini CLI 正是为此而生。它是一个强大的AI代理，能直接在你的终端里与你协作。

这篇教程将手把手带你走完从注册、安装到实际使用的全过程，让你能快速上手，体验下一代开发工作流的魅力。

准备工作：你需要什么？

在开始之前，请确保你已准备好：

  1. 一个Google账户：用于授权和访问Gemini服务。
  2. 一个主流操作系统：macOS, Linux, 或 Windows (建议使用WSL 2)。
  3. 基本的命令行知识：了解如何打开终端并执行基本命令。

第一步：获取访问权限与API密钥

由于Gemini CLI可能仍处于早期或预览阶段，获取访问权限通常需要通过Google AI或Google Cloud平台。

  1. 访问 Google AI Studio：
    • 打开浏览器，前往 Google AI Studio。
    • 使用你的Google账户登录。
  2. 获取API密钥：
    • 在AI Studio中，寻找并点击“Get API key”（获取API密钥）选项。
    • 创建一个新的API密钥。请立即复制并妥善保管这个密钥，它只会出现一次。这个密钥是你从命令行向Google发出请求的身份凭证。

(注意：具体步骤可能会随产品迭代而变化，但核心总是在Google Cloud或AI Studio中获取一个用于认证的API Key。)

第二步：安装与配置Gemini CLI

安装过程通常和其他CLI工具类似，通过包管理器或安装脚本完成。

1. 安装 (以npm为例的假设性命令)

打开你的终端，运行以下（假设的）安装命令：

1
2
# 假设通过npm全局安装
npm install -g @google/gemini-cli

（请根据官方文档替换为实际的安装命令，例如使用 pip, brew 或 curl 脚本）。

2. 配置认证

安装完成后，你需要将CLI与你的API密钥关联起来。

运行配置命令：

1
gemini-cli auth

程序会提示你输入之前获取的API密钥。将密钥粘贴进去并回车。

1
2
Please enter your Gemini API Key: ***************************
Authentication successful! You're ready to go.

看到成功提示，意味着你的Gemini CLI已经配置完毕，可以随时听候调遣。

第三步：开始你的第一次对话

现在，激动人心的时刻到了！启动Gemini CLI，开始你的第一次AI辅助编程。

在终端输入：

1
gemini-cli

你会看到一个欢迎信息和等待你输入的提示符，这表示AI代理已激活。

Gemini CLI is active. I’m ready to help you with your software engineering tasks.
What would you like to do?
>

现在，让我们给它一个简单的任务。

第四步：核心功能实战

让我们通过几个真实场景，看看Gemini CLI如何工作。

场景1：创建和运行一个新文件

你输入: 创建一个名为 "app.py" 的Python文件，让它打印 "Hello from Gemini CLI!"

Gemini CLI会理解你的意图，并使用它的工具来执行：

Gemini CLI (思考过程): Okay, I need to create a file named app.py with specific content. I will use the write_file tool.

Gemini CLI (执行):

1
2
# 伪代码，展示工具调用
print(default_api.write_file(content='print("Hello from Gemini CLI!")', file_path='app.py'))

Gemini CLI (响应): I have created the file app.py.

现在，让我们让它运行这个文件。

你输入: 运行 app.py

Gemini CLI (思考过程): The user wants to execute a python script. The run_shell_command tool is perfect for this.

Gemini CLI (执行):

1
2
# 伪代码，展示工具调用
print(default_api.run_shell_command(command='python app.py'))

Gemini CLI (响应):

1
2
Command output:
Hello from Gemini CLI!

场景2：读取和修改文件

你输入: 把 app.py 文件里的 "Hello" 改成 "Greetings"

Gemini CLI (思考过程): I need to modify an existing file. First, I’ll read the file to get the exact content, then I’ll use the replace tool to perform the change.

Gemini CLI (执行):

1
2
3
4
5
# 伪代码，展示工具调用
# 1. 读取文件
print(default_api.read_file(absolute_path='app.py'))
# 2. 替换内容
print(default_api.replace(file_path='app.py', old_string='print("Hello from Gemini CLI!")', new_string='print("Greetings from Gemini CLI!")'))

Gemini CLI (响应): I have modified app.py.

总结

你已经成功完成了从注册到实战的整个流程！Gemini CLI不仅仅是一个命令工具，它是一个能够理解上下文、使用工具并与你进行智能对话的开发伙伴。

现在，尝试给你自己的任务吧！无论是重构旧代码、学习新框架，还是自动化日常任务，Gemini CLI都将为你提供前所未有的强大助力。欢迎来到命令行开发的未来！