Gemini CLI 使用指南如何在终端里跑一个能动手的 AI 编程助手【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cliGemini CLI 是谷歌开源的终端 AI 编程助手把 Gemini 模型直接搬进你的命令行。它能读项目、改代码、跑 shell 命令还会按你的规矩办事。适合天天泡在终端、想让 AI 直接下场干活的开发者。 它解决什么问题写代码最烦的是什么来回切窗口。你正在编辑器里改逻辑突然发现这个报错的根因在哪这段重构有没有遗漏的调用于是切到浏览器问 AI把代码复制过去等回答再复制回来。来回几趟思路早就断了还得重新理一遍上下文。Gemini CLI 把 AI 直接放进你的终端。它和你站在同一个项目目录里看得见你看到的文件。一句话让它读代码、定位问题、给出方案不用复制粘贴不用切窗口思路不断线。还有个常见痛点是规范失传。团队有缩进要求、命名约定、错误处理套路但你每次找 AI 帮忙都得重新交代一遍说了十遍它还按自己的习惯写。这个工具用一套自动加载的上下文文件解决了它后面细说。⏱️ 3分钟上手装它很快一行命令的事。确保 Node.js 版本在 20 以上然后npm install -g google/gemini-cli装完进入你的项目目录敲下第一条命令试试gemini 帮我看看这个项目在做什么它会扫一遍当前目录给你一份结构化的解读。到这里你就已经进入状态了剩下的能力按需打开就行。 核心能力拆解技能系统给 AI 一本岗位 SOP你可以把技能理解成一份岗位标准作业流程。比如你写一份代码审查技能列清楚要查什么SQL 注入、输入清洗、错误处理、日志覆盖。下次让 AI 审查代码它就自动按这份 SOP 走不会漏项也不用你每次手动叮嘱。技能就是一个 Markdown 文件放在项目的.gemini/skills/目录下。它还能跨项目共享团队用同一份口径就一致了。上下文文件一份永远在线的员工手册GEMINI.md 文件相当于你团队的员工手册。你写进规范用什么框架、怎么命名、错误怎么处理。Gemini CLI 每次启动都会自动读它相当于 AI 永远带着你的规矩上岗不用你临时口头交代。它支持分层加载全局偏好放你个人目录项目规范放项目根目录某个模块的特殊约定放对应子目录。越靠近代码的约定越具体就像大手册配部门细则。执行引擎持证上岗先方案后动手光会说还不够Gemini CLI 能真正动手读文件、改文件、跑 shell 命令、抓网页。但默认它很克制。你可以开 Plan Mode计划模式它先把改动方案列出来等你点头才执行。像一位持证工程师——有权限但大动作前先递审批。这样它既能干活又不会在你不知情的情况下乱改。 跟做一次完整任务拿一个真实场景走一遍你想给登录接口补上输入校验但不放心 AI 直接上手。目标审查src/auth/login.ts的校验逻辑补全缺失项全程可控。执行先进 Plan Mode让它只出方案、不动手gemini --approval-modeplan 审查登录接口的输入校验先给方案别改代码它读完相关代码列出发现邮箱没做格式校验、密码长度没设上限、异常分支吞了错误。你逐条确认批准它执行。它改完代码你再让它补三个测试用例覆盖这三处。结果三处校验补齐测试全绿。你从头到尾只做了两件事——看方案、点批准改动范围完全在预期内没有意外改动。 进阶技巧场景做法收益团队统一规范项目根目录放.gemini/GEMINI.md新会话都自动按规矩来CI/CD 集成加--output-format json跑无头模式输出结构化脚本好解析多目录大项目--include-directories指定多个目录扩大可读上下文范围网络不稳定配置本地模型路由弱网、离线也能出活编辑器协作装配套 VS Code 扩展选中代码直接丢给 AI️ 避坑与答疑怕 AI 直接改坏代码默认偏只读开 Plan Mode 让它先出方案你批准后才动手改动始终在你视野里。大仓库吃不满上下文它支持 1M token 窗口再用--include-directories圈定要读的目录别让它满仓库瞎跑。每次都要重说规范一次性写进 GEMINI.md之后每次自动加载省得反复叮嘱。断网了还能干活吗配好本地模型路由弱网和离线场景下也能正常输出。写在最后Gemini CLI 把问 AI变成了派 AI 去干活关键是它守规矩、可批准、范围可控敢在真实项目里放手用。技能怎么写docs/cli/skills.md上下文文件规范docs/cli/gemini-md.md安装与版本说明docs/get-started/installation.mdx【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考