🚀 谷歌免费 AI 神器 Gemini CLI 保姆级教程

🧐 什么是 Gemini CLI？

Google Gemini CLI 是一个免费、开源的 AI 命令行工具，它将强大的 Gemini 模型直接带入你的终端。本指南旨在让你用最少的时间掌握其核心用法，提升开发效率。

✨ 核心特性一览

🔒 安全性：你的 API 密钥通过环境变量存储，绝不会暴露在代码或命令行历史中，确保隐私与安全。
💻 跨平台：无论你使用 Windows (WSL)、macOS 还是 Linux，都可以获得一致的、完美的运行体验。
💲 完全免费：Google 为开发者提供了非常慷慨的免费额度（每分钟最多 60 模型请求次，每天最多 1000 次），对于绝大多数个人开发和学习场景来说绰绰有余。
🧠 多模型支持：轻松切换不同模型。使用速度与性价比兼备的 gemini-1.5-flash，或功能最全面的 gemini-1.5-pro 来应对复杂任务。`。
🔧 高度可定制：通过命令行参数微调 AI 行为，如设置 temperature 控制创意性、max-tokens 限制输出长度等，满足你的精细化需求。
📦 管道集成：遵循 Unix 哲学，可与任何标准命令行工具（cat, grep, git, awk）通过管道符 | 结合，构建强大的自动化工作流。
📝 智能交互对话：在交互模式下，随时输入 @ 符号引用一个或多个本地文件进行提问，AI 会自动读取并理解文件内容上下文。
📸 强大的多模态：使用 @ 符号引用图片、音频甚至视频文件，让 AI 分析视觉或听觉信息并回答你的问题。

📚 快速入门

安装

确保你的系统已安装 Node.js v20+

1
2
# 全局安装 (推荐)
npm install -g @google/gemini-cli

或者通过 npx 直接运行：

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

直接运行

1
gemini

接着，你需要注册一个 Google 账号并获取 API 密钥。在 Google AI Studio 中创建一个新的 API 密钥，并将其保存到你的环境变量中：

1
export GEMINI_API_KEY="YOUR_API_KEY"

或者选择 LOGIN 模式，然后直接使用 Google 账号登录：

1
gemini login

登录后，你就可以开始使用 Gemini CLI 了。

💡 开发者实用场景

  1. 代码生成与解释 *忘记语法细节？需要一个函数模板？
1
2
# 生成一个计算文件夹大小的 Python 函数
> gemini "写一个 python 函数，它接收一个目录路径，然后递归地计算所有文件的总大小"
  1. Git Commit Message 自动化 *这是最受欢迎的功能之一，告别手写 commit message。
1
2
# 根据代码变更自动生成 commit message
> git diff --staged | gemini "根据这些代码变更，为我生成一条清晰、简洁并遵循 conventional commits 规范的 commit message"
  1. 调试与错误分析 *面对复杂的错误堆栈不再迷茫。
1
2
# 将错误日志通过管道传给 Gemini 进行分析
> cat error.log | gemini "解释这个错误日志的根本原因是什么，并提供可能的解决方案"
  1. 学习与理解新命令 *快速掌握不熟悉的 Shell 命令。
1
2
# 解释一个复杂的 tar 命令
> gemini "解释这个 shell 命令的每个参数是什么意思: tar -czvf archive.tar.gz /path/to/dir"
  1. 分析图片中的内容 (多模态) *有一张产品 UI 设计图或系统架构图？ 直接向它提问。
1
2
# 分析截图并生成代码
> gemini "分析这张截图，它是一个登录表单。使用 tailwind css 和 react 为我生成对应的 jsx 代码" @./login-form-screenshot.png
  1. 文档与代码注释 *让 AI 为你的代码编写高质量的文档。
1
2
# 引用一个代码文件，让 AI 为其添加 JSDoc 注释
> gemini "为这个 TypeScript 文件中的每个函数添加详细的 JSDoc 注释" @./src/utils.ts

进阶用法

  1. 集成 Git Hooks 自动审查代码
    在 git commit 前自动审查代码。创建或编辑 .git/hooks/pre-commit 文件，并赋予执行权限 (chmod +x .git/hooks/pre-commit)。
1
2
3
#!/bin/sh
echo "正在使用 Gemini 审查代码..."
gemini review --staged-files --format=checklist
  1. 自定义 Gemini 行为
    使用命令行参数调整 AI 的行为，例如设置温度、最大令牌数等。
1
gemini chat --temperature 0.9 --max-tokens 1024
  1. 批量生成代码
    使用 --batch 参数批量生成代码，适合在 CI/CD 环境中使用。
1
gemini generate "生成一个简单的 CRUD 应用" --batch
  1. 自定义模型
    使用 --model 参数指定使用的 Gemini 模型，例如 Gemini 1.5 Flash 或 Gemini 1.5 Pro。
1
gemini chat --model "gemini-1.5-flash"

🔧 常见问题（FAQ）

如何获取 API 密钥？

  1. 访问 Google AI Studio。
  2. 点击 “Create API Key”。
  3. 复制生成的 API 密钥，并保存到环境变量 GEMINI_API_KEY 中。

如何设置代理？

1
2
3
# Linux/MacOS
export https_proxy=http://127.0.0.1:10809
export http_proxy=http://127.0.0.1:10809

或者使用 Windows 的环境变量设置：

1
2
set HTTPS_PROXY=http://127.0.0.1:10809
set HTTP_PROXY=http://127.0.0.1:10809

10809 替换为你实际代理的端口。

如何使用 Gemini CLI 与 Git 集成？

  1. 在 .git/hooks 目录下创建或编辑 pre-commit 文件。
  2. 添加以下内容：
1
2
3
#!/bin/sh
echo "正在使用 Gemini 审查代码..."
gemini review --staged-files --format=checklist
  1. 赋予执行权限：chmod +x .git/hooks/pre-commit

📖 更多资源

🎉 结语

通过本教程，你应该已经掌握了 Gemini CLI 的基本用法和进阶技巧。如果你有任何问题或建议，欢迎在评论区留言。希望你能充分利用这个强大的工具，提升你的开发效率。