本页可直接阅读、选中文本复制或打印。文中的复制按钮、判断练习和成果保存,请使用互动版。

中文教程 · 独立阅读版

Gemini CLI:启动终端会话,写项目说明

理解工作目录、项目上下文和命令执行,完成一次可检查的终端任务。

内容整理:2026-09-07 · 资料核对:2026年9月14日

进入互动版,练习并保存成果

开始前准备

准备测试项目,并按 Gemini CLI 官方文档完成安装与一种认证方式。该流程不适用于 Qwen Code。

1. 运行 gemini,核对项目上下文

官方快速开始使用 npm install -g @google/gemini-cli 安装。安装后在练习项目的终端运行 gemini,首次启动可选择 Sign in with Google;部分账号需要另外配置 Google Cloud 项目,按官方认证说明处理。先核对当前文件夹,再开始提问。

让工具读取已有的 GEMINI.md 和 README。如果准备新增 GEMINI.md,先让它起草项目用途、运行命令和修改规则,经你检查后再保存;不要把推测的运行命令写成已确认事实。

Gemini CLI 启动
pwd
gemini

2. 确认目录、工具与认证

CLI 是在终端中使用的程序。进入项目目录后,再按当前工具文档启动。工作目录决定了工具首先看到哪些文件。

确认你使用的是哪个工具、哪个模型服务和哪种认证方式。开源客户端并不等于所有模型调用免费。

3. 从只读任务开始

先让工具理解项目结构和运行方式,不修改文件。检查返回的路径、命令是否在项目里有依据。

任务提示词
请阅读当前目录中的项目说明与构建配置,不修改文件。
列出:项目用途、启动方式、测试方式、需要的环境。
每一项说明对应的文件依据。
缺少的信息写“尚未确认”,不要猜测运行命令。

4. 再执行一项有限任务

选择一个范围小的动作,例如补充已有脚本的输入检查。先看计划和命令用途,再执行并检查结果。

保留修改差异、命令退出状态和相关输出。遇到权限或网络错误,先定位原因,不要直接关闭校验或扩大权限。

练习与核对

按实际操作自查,完成标记与成果草稿请在互动版保存。

打开练习与核对

带走这一点

终端协作的关键是清楚自己在哪个目录、让工具执行什么、如何判断完成。

资料与核对记录

关键步骤有官方依据

已确认终端启动、Google 认证与 GEMINI.md 项目说明机制。

本次核对公开官方资料,未登录产品账号、运行练习或发起付费调用。

步骤对不上?在互动版生成问题记录