---
title: "CLI 工作流"
description: "Gemini CLI 日常使用入口：CLI 参数、slash commands、快捷键、文件管理、Shell、Web、会话、任务规划、checkpoint 和 plan mode。"
verifiedAt: "2026-05-09"
---

CLI 工作流这一组回答“每天怎么用 Gemini CLI”。它不是配置参考，而是把交互式 REPL、一次性 prompt、文件引用、Shell、Web、会话恢复、计划和回滚机制串起来。

> [!NOTE]
> **学习顺序**：先掌握 `gemini`、`-p`、`@file`、`!command` 和 `/help`，再进入 session、checkpoint、plan mode。

## 学习路径

```mermaid
flowchart LR
    Start["启动与参数"] --> Commands["Slash / @ / !"]
    Commands --> Files["文件与 Shell"]
    Files --> Web["Web search / fetch"]
    Web --> Session["Session"]
    Session --> Plan["Plan / Todo"]
    Plan --> Checkpoint["Checkpoint / Rewind"]
    Checkpoint --> Config["上下文与配置"]

    style Commands fill:#dbeafe,stroke:#3b82f6
    style Plan fill:#fef3c7,stroke:#f59e0b
    style Checkpoint fill:#dcfce7,stroke:#22c55e
```

这个顺序的核心是先学会“怎么和 CLI 交互”，再学会“怎么让它安全做事”。如果直接跳到自动化或 MCP，很容易把权限、上下文和恢复机制混在一起。

## 日常最小动作

```bash
gemini
gemini -p "summarize README.md"
gemini -r "latest" "继续刚才的任务"
```

交互式会话里常用：

```text
@src/file.ts      把文件放进上下文
!npm test         直接执行 Shell 命令
/help             查看内置命令
/memory reload    重新加载 GEMINI.md 等上下文文件
/mcp list         查看 MCP server
```

## 按场景阅读

<Cards>
  <Card title="先把 CLI 用顺" description="从启动参数、一次性 prompt、slash commands 和快捷键开始。" href="/docs/gemini-cli/official/01-cli-workflow/10-cli-reference" />
  <Card title="再接文件与命令" description="学习 @ 文件引用、Shell 命令、Web search / fetch 的安全边界。" href="/docs/gemini-cli/official/01-cli-workflow/13-file-management" />
  <Card title="最后控制风险" description="进入 session、任务规划、checkpoint、rewind 和 Plan mode。" href="/docs/gemini-cli/official/01-cli-workflow/16-session-history" />
</Cards>

## 页面清单

| 页面 | 解决的问题 |
| --- | --- |
| [CLI reference](/docs/gemini-cli/official/01-cli-workflow/10-cli-reference) | `gemini` 参数、prompt、resume、sandbox、输出格式 |
| [命令系统](/docs/gemini-cli/official/01-cli-workflow/11-commands) | slash commands、`@` 文件引用、`!` Shell |
| [快捷键](/docs/gemini-cli/official/01-cli-workflow/12-keyboard-shortcuts) | 清屏、退出、输入模式、shell mode |
| [文件管理](/docs/gemini-cli/official/01-cli-workflow/13-file-management) | 文件上下文、目录、ignore、多目录 workspace |
| [Shell 命令](/docs/gemini-cli/official/01-cli-workflow/14-shell-commands) | 命令执行、输出截断、高风险边界 |
| [Web search / fetch](/docs/gemini-cli/official/01-cli-workflow/15-web-search-fetch) | 联网查资料、读取 URL、事实核验 |
| [会话与历史](/docs/gemini-cli/official/01-cli-workflow/16-session-history) | 保存、恢复、分享和清理 session |
| [任务规划](/docs/gemini-cli/official/01-cli-workflow/17-task-planning) | 计划、todo、验证命令、完成标准 |
| [Checkpoint 与 rewind](/docs/gemini-cli/official/01-cli-workflow/18-checkpointing-rewind) | 修改前恢复点、`/restore`、回退边界 |
| [Plan mode](/docs/gemini-cli/official/01-cli-workflow/19-plan-mode) | 只读规划、执行准入、风险审查 |

## 下一步

CLI 工作流读完后，进入：[上下文与配置](/docs/gemini-cli/official/02-context-config)。

## 官方来源

- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
