> ## 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.

# 选择合适的工作方式

<div id="overview">
  # 概述
</div>

同一个任务可以有不同的完成方式。Qoder CLI 提供多种工作方式，覆盖从即时对话到长时间自动化的不同场景。选对方式，能让你在"掌控每一步"和"放手让 Qoder 自主完成"之间找到合适的平衡。

这篇文档帮助你根据任务特点快速选择。每种方式都有独立的详细文档，可点击进入。

<div id="quick-guide">
  # 快速选择
</div>

* 想边聊边做、随时干预 → **交互模式**
* 改动前想先看清方案、确认再动手 → **Plan**
* 有一个明确目标，希望 Qoder 一直做到完成 → **Goal**
* 需要在指定时间运行，或按日历重复 → **定时任务**
* 需要按固定时间间隔反复运行同一件事 → **/loop**
* 需要多个 Agent 协作、编排复杂流程 → **Workflow**
* 需要在脚本或 CI/CD 中自动运行 → **Headless**

<div id="interactive">
  # 边聊边做：交互模式
</div>

交互模式是最常用的默认方式。在项目根目录运行 `qodercli` 进入交互式（TUI）会话，用自然语言对话，随时查看 Qoder 的动作、确认权限、纠正方向。

适合探索代码、逐步实现功能、调试问题等需要人机紧密配合的任务。详见 [使用 CLI](/zh/cli/03-使用QoderCLI/01-开始一个任务/using-cli)。

<div id="plan">
  # 先规划再执行：Plan
</div>

当任务较复杂、影响面较大，或你希望在动手前先看清方案时，使用 Plan。进入 Plan 后，Qoder 只读地探索代码并输出方案，不会直接修改代码；确认方案后再退出 Plan 开始执行。

通过 `/plan` 命令进入或退出。详见 [先规划再执行（Plan）](/zh/cli/03-使用QoderCLI/01-开始一个任务/plan)。

<div id="goal">
  # 持续完成一个目标：Goal
</div>

当你有一个明确的完成条件，希望 Qoder 持续自主工作直到达成时，使用 Goal。通过 `/goal set <目标>` 进入，Qoder 会自动切换到自动化执行状态，减少中途打扰。

适合"把测试全部修绿""完成某个重构直到构建通过"这类有清晰终点的任务。详见 [持续完成目标（Goal）](/zh/cli/03-使用QoderCLI/02-任务自动化/goal)。

<div id="scheduled">
  # 在指定时间执行：定时任务
</div>

当任务需要在未来某个时间点运行一次，或按日历计划重复运行时，使用定时任务。适合定时巡检、周期性报告、按计划触发的自动化。

详见 [定时执行任务](/zh/cli/03-使用QoderCLI/02-任务自动化/scheduled)。

<div id="loop">
  # 按固定间隔重复执行：/loop
</div>

当你需要按固定时间间隔反复运行同一个任务时，使用 `/loop`。适合轮询状态、持续检查、周期性重复动作。

详见 [重复执行任务（/loop）](/zh/cli/03-使用QoderCLI/02-任务自动化/loop)。

<div id="workflow">
  # 多 Agent 协作：Workflow
</div>

当任务复杂到需要多个 Agent 分工协作时，可以编排工作流，把任务拆解给不同的 Subagent 分别处理。适合大型任务的分解与并行推进。

Subagent 的创建与编排见 [Subagent](/zh/cli/04-扩展QoderCLI/subagent)，多 Agent 编排见 [动态工作流](/zh/cli/03-使用QoderCLI/03-多任务与协作/workflows)，并行协作见 [并行处理多个任务](/zh/cli/03-使用QoderCLI/03-多任务与协作/parallel)。

<div id="headless">
  # 在脚本中运行：Headless
</div>

当你需要把 Qoder CLI 嵌入脚本、自动化流程或 CI/CD 流水线时，使用 Headless（非交互）模式。通过 `qodercli --print` 运行，可以输出 Text、JSON 或 Stream JSON 结构化结果。

由于没有人在旁边确认，Headless 模式下需要预先配置好权限。详见 [在脚本中运行 Qoder CLI](/zh/cli/03-使用QoderCLI/02-任务自动化/headless)。

<div id="combine">
  # 组合使用
</div>

这些工作方式并非互斥，可以组合。例如：

* 先用 **Plan** 确认方案，再进入 **Goal** 让 Qoder 自主执行到完成。
* 在 **Headless** 模式下搭配权限模式，实现无人值守但受控的自动化。
* 用 **定时任务** 或 **/loop** 触发一段固定的自动化流程。

从最贴近你需求的方式开始，随着对 Qoder 的熟悉逐步组合出适合团队的工作流。