中文教程 · 独立阅读版
Gemini CLI:启动终端会话,写项目说明
理解工作目录、项目上下文和命令执行,完成一次可检查的终端任务。
进入互动版,练习并保存成果本篇目录
开始前准备 · 设备、账号与费用
准备测试项目,并按 Gemini CLI 官方文档完成安装与一种认证方式。该流程不适用于 Qwen Code。
1. 运行 gemini,核对项目上下文
已安装可以跳过第一步。启动前先进入练习项目文件夹。
- 安装 CLI
在终端执行,完成后核对是否可启动
npm install -g @google/gemini-cli - 确认目录
路径应是本次练习项目
pwd - 启动会话
首次启动按提示选择 Google 登录或其他认证
gemini
认证与项目说明
部分账号还需配置 Google Cloud 项目,按官方认证文档处理。读取已有 GEMINI.md 和 README;要新增 GEMINI.md 时先审查草稿,不把推测命令写成事实。
2. 确认目录、工具与认证
检查会话对应的路径确实是练习项目;按启动提示完成认证,再继续读取文件。
- 目录
当前路径是练习项目
- 工具
当前会话是 Gemini CLI
- 认证
没有尚未处理的登录提示
3. 从只读任务开始
发送下方只读任务,核对用途、运行入口、测试方式和环境要求。每条命令都要有文件依据。
请阅读当前目录中的项目说明与构建配置,不修改文件。
列出:项目用途、启动方式、测试方式、需要的环境。
每一项说明对应的文件依据。
缺少的信息写“尚未确认”,不要猜测运行命令。4. 再执行一项有限任务
选一个有限修改,例如为已有脚本补输入检查。先看计划与命令用途,再执行并检查结果。
- 文件差异
改动是否限于约定范围
- 命令退出状态
成功或失败如实记录
- 实际输出
与输入和预期对应
遇到权限或网络错误
先定位失败原因,不直接关闭校验或扩大权限。
练习与核对
- 按所选工具官方文档完成启动
- 获得带文件依据的项目说明
- 完成一项有限修改并记录验证结果
按实际操作自查,完成标记与成果草稿请在互动版保存。
打开练习与核对带走这一点
终端协作的关键是清楚自己在哪个目录、让工具执行什么、如何判断完成。
资料与核对记录
关键步骤有官方依据已确认终端启动、Google 认证与 GEMINI.md 项目说明机制。
本次核对公开官方资料,未登录产品账号、运行练习或发起付费调用。
查看来源与日期
- Gemini CLI 快速开始
已核对资料 · 获取:2026年9月14日 · 来源更新:未披露
启动、Google 登录及终端工作流
- Gemini CLI 项目说明
已核对资料 · 获取:2026年9月14日 · 来源更新:未披露
GEMINI.md 的层级与 /memory show