> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 先规划再执行（Plan）

# 概述

Plan（规划）让 Qoder 在动手改代码之前，先只读地探索代码、分析问题并给出方案。等你确认方案后，再退出 Plan 开始实际修改。它适合影响面较大、涉及多个文件、或你希望在改动前先看清整体思路的任务。

Plan 是一个独立的**工作状态**，而不是权限策略——它可以和任意权限模式共存。进入 Plan 后，Qoder 的写入被限制，主要产出是一份方案。

# 进入与退出

用 `/plan` 命令进入或退出 Plan（切换式）：

```shell theme={null}
/plan
```

* 进入后，Qoder 只读探索代码并输出方案，不会直接修改你的代码。
* 再次执行 `/plan` 退出。

也可以在启动时进入 Plan 工作状态：

```shell theme={null}
qodercli --permission-mode plan
```

> `--permission-mode plan` 为兼容旧用法保留。由于 Plan 是一种工作状态、并非权限模式，该取值会被映射为「默认权限模式 + 进入 Plan 状态」。

# 工作方式

在 Plan 状态下：

* Qoder 会读取相关文件、搜索代码、分析现状，弄清楚要做什么、怎么做。
* 它的写入受到限制，产出集中在一份可供你评审的方案上。
* 你可以对方案提出修改意见，让 Qoder 调整，直到方案符合预期。

这套"先看清、再动手"的方式，能在复杂任务上减少返工——先把方向定对，再让 Qoder 执行。

# 配合 Goal 执行

Plan 常和 Goal 搭配使用：先在 Plan 中确认方案，退出 Plan 后用 `/goal set` 进入 Goal，让 Qoder 按既定方案持续自主执行到完成。这样既保证了方向正确，又能放手让 Qoder 完成后续的实现工作。

Goal 的详细说明见 [持续完成目标（Goal）](https://docs.qoder.com/zh/cli/03-使用QoderCLI/02-任务自动化/goal.md)。如果 Goal 执行前 Plan 处于激活状态，Qoder 在跨进程恢复目标时会一并恢复 Plan 状态。

# 何时使用

* **影响面大的改动**：跨多个文件、涉及公共接口或核心逻辑的修改。
* **方向不确定**：存在多种实现方案，需要先比较再决定。
* **希望先评审**：你想在改动前先看清 Qoder 打算怎么做。

对于简单、明确的小改动，直接在交互模式下让 Qoder 动手通常更快，不必进入 Plan。

# 相关

* Plan 与权限模式的关系，见 [权限](https://docs.qoder.com/zh/cli/06-配置与安全/permissions.md)。
* 如何在不同工作方式间做选择，见 [选择合适的工作方式](https://docs.qoder.com/zh/cli/02-核心概念/work-modes.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.