Google Gemini CLI 速查表

⌨️ 键盘与输入

基础与会话

Enter 确认选择 / 提交提示

Esc 关闭对话框；连按两次可清空输入或浏览历史交互

CtrlC 取消请求；输入为空时可退出

CtrlD 输入为空时退出 CLI

光标与编辑

CtrlA / CtrlE 行首 / 行尾（或 Home / End）

CtrlK / CtrlU 删至行尾 / 删至行首

CtrlZ 撤销输入；CtrlShiftZ 重做

历史与补全

CtrlP / CtrlN 上一条 / 下一条历史

CtrlR 反向搜索历史；Tab 接受匹配

Tab 接受内联建议；列表中上下导航

提交与多行

CtrlEnter 换行不提交（另：ShiftEnter、AltEnter、CtrlJ）

\ + Enter 单行模式下在行尾插入换行

CtrlX 在外部编辑器打开当前提示（计划展示时亦可编辑计划）

界面与审批

CtrlL 清屏并重绘 UI（与 /clear 类似）

CtrlY 切换 YOLO（工具自动批准）

ShiftTab 循环审批模式：默认 → auto_edit → plan（忙时跳过 plan）

CtrlO 展开/折叠内容块或粘贴占位符

AltM 切换 Markdown 渲染

? 空提示时打开快捷键面板（再按关闭或插入 ?）

TabTab 无补全时切换极简 / 完整 UI（会记忆）

Shell 与后台

! 单独输入切换 Shell 模式；!cmd 执行单行 shell 后返回

CtrlB 后台 shell 显示切换

CtrlK 终止当前后台 shell（与编辑删至行尾上下文不同）

自定义键位

~/.gemini/keybindings.json 覆盖默认快捷键（类 VS Code schema）

🔌 MCP

配置位置

~/.gemini/settings.json 用户级 MCP 与通用设置

项目内 .gemini/ 可与信任文件夹策略配合使用

会话内

/mcp desc | nodesc 工具说明；schema 参数 JSON Schema

@别名文档示例：在提示中用 @github 等调用已连接 MCP

扩展

/extensions 列出当前会话激活的扩展

文档 MCP 集成指南

⚡ 斜杠命令

会话与检查点

/chat save 保存对话检查点（默认在 ~/.gemini/tmp/）

/chat resume <tag> 恢复

/chat list 列出可恢复标签

/chat delete 删除已保存检查点

/chat share 导出为 .md 或 .json

/clear 清屏与可见历史（CtrlL）

/compress 用摘要替换整段上下文以省 Token

/restore 恢复工具执行前的文件（需 --checkpointing 或设置开启）

工作区与文件

/directory add 向工作区添加目录（沙箱限制时可用启动参数 --include-directories）

/directory show 列出已添加目录

记忆与说明

/memory add 追加文本到 AI 记忆

/memory show 查看已加载分层记忆全文

/memory refresh 从所有 GEMINI.md 重新加载

/memory list 列出参与记忆的 GEMINI.md 路径

/init 分析当前目录生成 GEMINI.md 脚手架

工具与 MCP 显示

/tools desc 显示内置工具完整说明

/mcp desc MCP 服务器与工具说明

界面与账户

/settings 设置编辑器（等价校验后的 settings.json）

/theme 主题选择

/auth 切换认证方式

/editor 选择外部编辑器

/vim Vim 式编辑模式（偏好写入 settings）

/stats Token、缓存命中、会话时长

/copy 复制到剪贴板（Linux 需 xclip/xsel）

其它

/help / /? 帮助

/about 版本信息（提 issue 时请附上）

/privacy 隐私说明与改进数据收集同意

/bug 提交 CLI 问题（可用 advanced.bugCommand 自定义）

/quit / /exit 退出

自定义命令见 Custom Commands

📁 GEMINI.md 与 @ 引用

分层记忆

GEMINI.md 全局、祖先目录与子目录合并为层次化说明上下文

/memory list 查看实际参与文件路径

@ 路径

@path 将文件或目录内容并入提示（内部 read_many_files）

路径含空格用反斜杠转义，如 @My\ Documents/a.txt

Git 过滤默认排除 gitignore 项；可调 context.fileFiltering

单独 @

@ 仅输入 @ 时将查询原样交给模型（讨论符号本身时）

🧠 工作流

无头与脚本

gemini -p "…" 非交互单行回答

--output-format json 结构化输出便于解析

--output-format stream-json NDJSON 事件流

工作区

--include-directories 启动时包含多个目录（逗号分隔）

-m / --model 指定模型（如 gemini-2.5-flash）

检查点与撤销

--checkpointing 启用文件修改前自动检查点 → /restore

接地与搜索

Google Search 内置检索接地（见 Gemini API Grounding 文档）

CI 与 GitHub

GitHub Action run-gemini-cli：PR 审查、Issue 分流等

信任与安全

Trusted Folders 按文件夹控制执行策略（见官方 Trusted Folders 文档）

Sandbox 安全执行环境说明见 docs/cli/sandbox.md

⚙️ 配置与环境

配置文件

.gemini/settings.json 项目或用户目录下设置（分层合并）

~/.gemini/settings.json 用户主配置

~/.gemini/keybindings.json 快捷键覆盖

认证环境变量（节选）

GEMINI_API_KEY Gemini API Key（AI Studio）

GOOGLE_CLOUD_PROJECT 组织 Code Assist / 云端项目

GOOGLE_API_KEY Vertex AI 等场景

GOOGLE_GENAI_USE_VERTEXAI 设为 true 走 Vertex

认证方式摘要

Google 账号 OAuth 登录；个人免费档配额见官网说明

API Key 适合脚本与模型细选

Vertex AI 企业生产与合规场景

🔧 工具与扩展

内置工具（节选）

文件系统读/写/搜索（见 Tools 文档）

Shell 执行终端命令（受沙箱与审批约束）

Web 抓取与检索

/tools desc 会话内查看完整工具说明

扩展

Extensions 自定义扩展与命令

/extensions 当前会话已加载扩展列表

发行渠道

npm @latest 稳定、@preview 周预览、@nightly 日构建

brew / port / conda 见安装文档

🖥️ CLI 入口

常用启动

gemini 当前目录交互会话

npx @google/gemini-cli 免全局安装运行

gemini -p "…" 打印应答后退出

gemini -m <model> 覆盖默认模型

gemini --include-directories a,b 多目录上下文

输出与调试

--output-format text | json | stream-json

F12 调试台：详细错误与按键日志