---
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="/zh-Hant/docs/gemini-cli/official/01-cli-workflow/10-cli-reference" />
  <Card title="再接檔案與命令" description="學習 @ 檔案引用、Shell 命令、Web search / fetch 的安全邊界。" href="/zh-Hant/docs/gemini-cli/official/01-cli-workflow/13-file-management" />
  <Card title="最後控制風險" description="進入 session、任務規劃、checkpoint、rewind 和 Plan mode。" href="/zh-Hant/docs/gemini-cli/official/01-cli-workflow/16-session-history" />
</Cards>

## 頁面清單

| 頁面 | 解決的問題 |
| --- | --- |
| [CLI reference](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/10-cli-reference) | `gemini` 引數、prompt、resume、sandbox、輸出格式 |
| [命令系統](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/11-commands) | slash commands、`@` 檔案引用、`!` Shell |
| [快捷鍵](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/12-keyboard-shortcuts) | 清屏、退出、輸入模式、shell mode |
| [檔案管理](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/13-file-management) | 檔案上下文、目錄、ignore、多目錄 workspace |
| [Shell 命令](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/14-shell-commands) | 命令執行、輸出截斷、高風險邊界 |
| [Web search / fetch](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/15-web-search-fetch) | 聯網查資料、讀取 URL、事實核驗 |
| [會話與歷史](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/16-session-history) | 儲存、恢復、分享和清理 session |
| [任務規劃](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/17-task-planning) | 計劃、todo、驗證命令、完成標準 |
| [Checkpoint 與 rewind](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/18-checkpointing-rewind) | 修改前恢復點、`/restore`、回退邊界 |
| [Plan mode](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/19-plan-mode) | 只讀規劃、執行准入、風險審查 |

## 下一步

CLI 工作流讀完後，進入：[上下文與配置](/zh-Hant/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)
