Gemini CLI 中文使用指南#
基本介绍#
Gemini CLI 是谷歌提供的开源命令行 AI 工具,将 Gemini 的强大功能直接带入您的终端。它提供轻量级的 Gemini 访问方式,为您提供从提示到模型的最直接路径。通过设置中转代理,您可以在网络受限的情况下正常使用 Gemini CLI 服务。🚀 为什么选择 Gemini CLI?#
🧠 强大的 Gemini 2.5 Pro:访问 100 万 token 上下文窗口
🔧 内置工具:Google 搜索基础功能、文件操作、Shell 命令、网页抓取
🔌 可扩展:支持 MCP(模型上下文协议)进行自定义集成
📦 安装方式#
快速安装#
使用 npx 即时运行(无需安装)#
使用 npm 全局安装#
使用 Homebrew 安装(macOS/Linux)#
系统要求#
配置使用#
1. 设置环境变量#
注意:您也可以将这些环境变量添加到 .bashrc、.zshrc 或其他 shell 配置文件中,这样每次启动终端时都会自动设置这些变量。
🚀 快速开始#
基本使用#
在当前目录启动#
包含多个目录#
使用特定模型#
脚本非交互模式#
快速示例#
启动新项目#
分析现有代码#
📋 主要功能#
代码理解与生成#
自动化与集成#
自动化操作任务,如查询拉取请求或处理复杂的变基操作
高级功能#
自定义上下文文件(GEMINI.md)为您的项目定制行为
常用命令和功能示例#
探索代码库#
> 描述这个系统架构的主要组成部分
> 有哪些安全机制?
> 为新开发者提供一份分步骤的入门文档
处理现有代码#
> 为 GitHub issue #123 实现一个初稿
> 帮我将这个代码库迁移到最新版本的 Java。先制定一个计划
自动化工作流程#
> 制作一个幻灯片,展示过去 7 天的 git 历史,按功能和团队成员分组
> 制作一个全屏 Web 应用用于墙上显示,展示我们互动最多的 GitHub issues
系统交互#
> 将此目录中的所有图像转 换为 png,并使用 exif 数据中的日期重命名它们
> 按支出月份整理我的 PDF 发票
GitHub 集成#
使用 Gemini CLI GitHub Action 将 Gemini CLI 直接集成到您的 GitHub 工作流中:Issue 分类:基于内容分析自动标记和优先级排序 GitHub issues
按需帮助:在 issues 和拉取请求中提及 @gemini-cli 获取调试、解释或任务委派的帮助
自定义工作流:构建适 合您团队需求的自动化、定时和按需工作流
故障排除#
3.
查看是否有错误信息输出,这些信息通常会指示问题所在
4.
如果使用 SOCKS 代理,确保代理格式正确,例如 socks5://<user>:<pass>@<proxy>:<port>
发布版本说明#
预览版(Preview)#
每周二 UTC 23:59 发布新的预览版本。使用 preview 标签安装:稳定版(Stable)#
每周二 UTC 20:00 发布新的稳定版本。使用 latest 标签安装:每夜版(Nightly)#
每天 UTC 00:00 发布每夜版本。使用 nightly 标签安装:MCP 服务器使用#
在 ~/.gemini/settings.json 中配置 MCP 服务器以扩展 Gemini CLI 的自定义工具:> @github 列出我的开放拉取请求
> @slack 向 #dev 频道发送今天提交的摘要
> @database 运行查询查找不活跃用户
📚 相关资源#
GitHub Issues:报告 bug 或请求功能
如果您需要卸载 Gemini CLI,请参考官方的卸载指南。Modified at 2025-12-11 01:21:36