选择合适的工作方式

同一个任务可以有不同的完成方式。Qoder CLI 提供多种工作方式，覆盖从即时对话到长时间自动化的不同场景。选对方式，能让你在"掌控每一步"和"放手让 Qoder 自主完成"之间找到合适的平衡。 这篇文档帮助你根据任务特点快速选择。每种方式都有独立的详细文档，可点击进入。

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

交互模式是最常用的默认方式。在项目根目录运行 qodercli 进入交互式（TUI）会话，用自然语言对话，随时查看 Qoder 的动作、确认权限、纠正方向。 适合探索代码、逐步实现功能、调试问题等需要人机紧密配合的任务。详见 使用 CLI。 当任务较复杂、影响面较大，或你希望在动手前先看清方案时，使用 Plan。进入 Plan 后，Qoder 只读地探索代码并输出方案，不会直接修改代码；确认方案后再退出 Plan 开始执行。 通过 /plan 命令进入或退出。详见 先规划再执行（Plan）。 当你有一个明确的完成条件，希望 Qoder 持续自主工作直到达成时，使用 Goal。通过 /goal set <目标> 进入，Qoder 会自动切换到自动化执行状态，减少中途打扰。 适合"把测试全部修绿""完成某个重构直到构建通过"这类有清晰终点的任务。详见 持续完成目标（Goal）。 当任务需要在未来某个时间点运行一次，或按日历计划重复运行时，使用定时任务。适合定时巡检、周期性报告、按计划触发的自动化。 详见 定时执行任务。 当你需要按固定时间间隔反复运行同一个任务时，使用 /loop。适合轮询状态、持续检查、周期性重复动作。 详见 重复执行任务（/loop）。 当任务复杂到需要多个 Agent 分工协作时，可以编排工作流，把任务拆解给不同的 Subagent 分别处理。适合大型任务的分解与并行推进。 Subagent 的创建与编排见 Subagent，多 Agent 编排见 动态工作流，并行协作见 并行处理多个任务。 当你需要把 Qoder CLI 嵌入脚本、自动化流程或 CI/CD 流水线时，使用 Headless（非交互）模式。通过 qodercli --print 运行，可以输出 Text、JSON 或 Stream JSON 结构化结果。 由于没有人在旁边确认，Headless 模式下需要预先配置好权限。详见 在脚本中运行 Qoder CLI。 这些工作方式并非互斥，可以组合。例如：

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

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