Gemini CLI 命令行工具使用指南
近一段时间，大模型没有什么大的突破，也没有什么新闻。倒是各式各样的 AI agent 卷得飞起，比如聊天机器人、代码助手（cursor, windsurf）、文件助手等，Google 也是不甘落后，推出了 Gemini CLI 工具，把 Gemini 的强大能力集成到终端工作流中。 这操作一看就是针对开发者的，谁能想到 2025 年了，还有大厂想在终端工具上发力，毕竟也只有开发者才需要经常使用命令行。
工具简介
Gemini CLI 是由 Google 开源的一款命令行 AI 工具，把 Gemini 的强大能力集成到终端工作流中。最新版本为 v0.1.10-dev.14，项目采用 Apache-2.0 许可协议，已有超过 5 万颗 GitHub Stars。
代码已经开源，GitHub 地址：https://github.com/google-gemini/gemini-cli
核心功能
- 大规模代码处理：支持处理超过 100 万 token 的代码库上下文
- 多模态应用开发：可从 PDF 或设计稿直接生成应用程序
- 任务自动化：自动化代码审查、分支管理等开发运维任务
- 工具集成：内置 Google Search 工具，支持连接 Imagen、Veo 等媒体生成服务
- 企业协作：通过 MCP（Model Context Protocol）服务器与企业协作工具集成
安装指南
基础要求
- Node.js 18 或更高版本
快速安装
npx -y https://github.com/google-gemini/gemini-cli
# 或全局安装
npm install -g @google/gemini-cli安装时会提示你选择一个主题，如果你习惯用 dark 模式的终端，建议选择 light 主题，对比度高一点。不然字体可能也是黑色的，看不清楚。
身份认证
首次运行时会提示使用 Google 账号登录，免费账户可获得：
- 每分钟 60 次请求
- 每天 1,000 次请求额度
这个额度对于一般开发者来说应该够用了，付费计划可解锁更高调用限额。
API Key 方式（推荐）
- 从 Google AI Studio 获取 API Key
- 设置环境变量：
export GEMINI_API_KEY="YOUR_API_KEY"默认使用 gemini-2.5-pro 模型，这也是当前 Gemini 模型中性能最优的模型，AI 产品竞争日益激烈，Google 在免费推广自己 AI 产品这一块是一点也不含糊。
使用
基础知识
- 添加上下文：使用
@指定文件作为上下文（例如，@src/myFile.ts），以定位特定文件或文件夹。 - Shell 模式：通过
!执行 shell 命令（例如，!npm run start），或使用自然语言（例如，启动服务器）。
支持的命令
/help- 获取 gemini-cli 的帮助信息/docs- 在浏览器中打开完整的 Gemini CLI 文档/clear- 清屏并清除对话历史/theme- 更改主题/auth- 更改认证方式/editor- 设置外部编辑器偏好/privacy- 显示隐私声明/stats- 查看会话统计。用法：/stats [model|tools]/mcp- 列出已配置的 MCP 服务器和工具/memory- 管理记忆。用法：/memory <show|refresh|add> [添加的文本]/tools- 列出可用的 Gemini CLI 工具/about- 显示版本信息/bug- 提交错误报告/chat- 管理对话历史。用法：/chat <list|save|resume> [标签]/quit- 退出命令行界面/compress- 通过替换为摘要来压缩上下文!- 执行 shell 命令，再按一次!可以取消
快捷键
- Enter - 发送消息
- Ctrl+J - 换行
- 上/下箭头 - 循环浏览输入历史
- Alt+左/右箭头 - 跳转输入中的单词
- Esc - 取消操作
- Ctrl+C - 退出应用程序
使用 gemini-cli 创建项目
mkdir my-project
cd my-project
gemini
> 创建一个基于 FAQ.md 的 Gemini Discord 问答机器人现有项目分析
git clone https://github.com/some/repo
cd repo
gemini
> 总结昨天所有的代码变更实用场景
- 代码库探索：分析系统架构和安全机制
- 代码迁移：比如制定 Java 版本升级计划，或者分析代码库，制定迁移计划
- 工作流自动化：生成 git 历史报告幻灯片
- 文件处理：批量转换图片格式并重命名
日常对话示例
从上面示例也可以看到，对话历史会自动保存（~/gemini-cli/ 目录下），中断后可以继续对话，这一点实现的还是挺扎实的。
进阶资源
小结
笔者之前也自己造过类似轮子，主要功能是在终端下调用 AI 模型进行对话，功能比较单一，远不如 Gemini CLI 来得强大。 Gemini CLI 这个工具做得还是很扎实的，让开发者可以更方便地使用 Gemini 的强大能力，提升日常开发效率和自动化水平。
而且模型还是免费的，如果是终端用户，还是强烈推荐体验一下。有 Google 背书，后续开发迭代、问题反馈都有保障。
