CodeWhale三种模式Plan/Work/Operate:终端编码代理新手如何选才对的完整指南 CodeWhale三种模式Plan/Work/Operate终端编码代理新手如何选才对的完整指南【免费下载链接】CodeWhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodeWhaleCodeWhale 是一个用 Rust 编写的开源终端编码代理Coding Agent内置Plan、Work、Operate三种模式。很多新手第一次打开它就会纠结到底该用哪个选错了要么 AI 动不了手要么大任务全挤在一条线里干。本文用一张对比表和 3 个关键问题帮你在 1 分钟内选对模式。三种模式一句话定位模式一句话定位能否改文件 / 跑命令Plan先设计、后动手的只读模式❌ 运行时直接拒绝Work日常多步执行的主力模式✅ 受审批策略管控Operate多任务指挥模式默认并行✅ 同 Work调度不同 一个容易混淆的点模式Plan/Work/Operate只决定可见的工具和调度方式并不改变你的权限档位。权限是另一套独立系统后文会讲。 Plan 模式只读设计零风险Plan 是「设计优先」模式。它的底层会主动拒绝一切文件修改和 Shell 执行——即使 AI 看到了write、edit、bash这些工具名调用也会被拦截。适合场景刚接手陌生项目想先让 AI 读代码、摸清结构评估一个重构方案、排坑思路先「纸上谈兵」对改动没把握时用 Plan 逼 AI 把方案讲清楚再动手好处很直接无论 AI 多「积极」你的仓库一个字节都不会变。 Work 模式日常主力多步执行Work内部代号agent/mode act是它的兼容别名是最常用的模式。它提供第一梯队工具read、write、edit、bash、agent、todo_write能读、能改、能跑命令。每个工具调用依然要过审批、沙箱和策略检查——能不能执行取决于你的权限档位而不是模式本身。日常「改个 bug、跑个测试、补个文档」待在 Work 就对了。 Operate 模式大任务的「指挥家」Operate 的执行权限和 Work 完全相同差别在调度哲学父会话变成一个「操作员」独立、可并行的工作默认派发给后台 worker。它的决策逻辑很简单小事、单文件、聊聊天 → 父会话直接干等价于 Work真正的多线任务 → 派发后台 worker每条线各自实现并带回验证证据VERDICT PASS/FAIL需要顺序、阶段、门禁的大编排 → 交给 Workflow 层记住它强调的一条原则派发不等于完成Dispatch is not completion有写权限的子任务必须带着真实验证结果回来。一键切换Tab 键与 /mode 命令三种模式之间的切换非常轻记住两组按键就够了按键作用Tab输入框为空时循环切换模式Plan → Work → Operate → PlanShiftTab循环切换权限档位Ask → Auto-Review → Full AccessAltA/AltP/AltY快捷跳档也可以直接用命令精确跳转/mode plan、/mode work、/mode operate或用/mode打开模式选择器。 两个新手常踩的坑切换是持久化的选择会写入~/.codewhale/settings.toml的default_mode下次启动自动生效不会重启就丢。回合进行中不能切AI 正在工作时切模式/模型都会被拒绝先按Esc中断再切。3 个问题帮你 1 分钟选对模式不用背概念问自己三个问题按顺序来Q1我现在允许它动手改仓库吗不确定 → 用Plan。只读模式让你安全地「先听方案」想改时再切出去。明确允许 → 进入 Q2。Q2这是不是一条线的常规任务改 bug、写代码、跑测试这种单线多步工作 → 用Work。感觉任务能拆成几件互不干扰的事 → 进入 Q3。Q3任务能并行、需要多条线同时推进吗调研多个模块、批量处理多个文件、跑多个独立验证 → 用Operate让后台 worker 分头跑父会话负责汇总验证证据。还涉及固定阶段、门禁检查的大编排 → Operate Workflow 起步器。 一个实用的心法拿不准就从 Plan 开始它零风险确认方向后Tab两下切到 Work/Operate成本几乎为零。模式 ≠ 权限别让两套概念打架新手最容易把「模式」和「权限档位」混为一谈它们是两个正交维度模式Plan/Work/Operate决定你「能看到哪些工具、如何调度」。权限档位Ask / Auto-Review / Full Access决定「工具执行前问不问你」。举例Work 模式 Ask 档位 每步都向你确认Operate 模式 Full Access 后台 worker 基本不弹窗自动跑。Plan 模式则特殊——它是模式级的硬边界无论权限档位多高Shell 和写操作一律拒绝。完整策略栈可以查阅文档目录下的docs/MODES.md那里还有沙箱、Repo-law、审计日志的详细说明。新手常见问题速答Q/mode act是什么AWork 的兼容别名等价于/mode work老配置里也常见。QWork 和 Operate 都能执行命令选哪个A看是否「可并行」。单线任务用 Work任务能拆成几条独立线时Operate 的后台派发会明显更快而且每条线都要求带回验证证据。Q切换模式会丢失当前对话吗A不会。模式只影响下一轮对话的工具与调度会话内容保留但正在进行的回合必须先Esc中断才能切。Q怎么让 AI 少弹审批框A用ShiftTab切到 Auto-Review自动评审模型自行裁决低风险操作或 Full Access普通调用免弹窗注意后两者都会放大风险建议配合只读调研类任务使用。写在最后三选一其实很简单Plan 管安全Work 管日常Operate 管并行。先按 Q1–Q3 的套路选一次之后你的肌肉记忆就会替你做决定。模式随时Tab切换、自动持久化试错成本几乎为零——大胆试选对的那个自然就浮现了。【免费下载链接】CodeWhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodeWhale创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考