AI 智能体

概念解析——Agent 模式

Agent 运行模式,就是给 Coding Agent 的手套上三档缰绳。控制本地 Coding Agent 自主权的三档:Plan 只看不动,Default 边做边问,Auto 自己跑。敲一句「帮我重构这个模块」,几秒后十几个文件已被改了——兴奋也后怕。

本地 Agent 能直接读写你的项目文件、在终端跑命令,跟 ChatGPT 这类纯聊天 AI 不一样。它有手。模式就是给这只手套的缰绳。常见三家:Claude Code、Codex CLI、OpenCode,档位思路一致。


1. 一个核心矛盾:自主性 vs 安全性

所有模式设计都在回答同一个问题:Agent 替你跑得多快,你愿意冒多大险?往两头走都会崩。

一头是大撒把——Agent 自己删了 .env、把 WIP 分支强推到 main、执行了从网上下载的脚本。出事时你一无所知,回滚也来不及。

另一头是每步都问——读一个文件弹一次,列个目录也弹一次。二十多分钟点了八十个确认,你已经累了。让 AI 帮忙,变成帮 AI 点确认。

所有模式设计都在回答同一个问题:Agent 替你跑得多快,你愿意冒多大险?没有永远最好的档,看任务换 Plan、Default 还是 Auto。

2. 三档速览

三档的核心差别全在「能不能动」这件事上。读永远不卡,真正会卡的是写文件和跑命令。

档位一

Plan 模式(只读)

Agent 不能改任何东西。只能遍历代码、读文件、搜符号。输出是一份 Markdown 计划,列出要改哪些文件、分几步、按什么顺序。复杂重构、不熟的代码库、多人协作时最有用。

档位二

Default 模式(边做边审)

多数 Agent 的出厂设置。读不卡,写和跑命令会暂停等你点。Agent 提一步,你看 diff 点一下确认,它才能继续。日常开发、bug 修复、主分支干活推荐用这档。

档位三

Auto 模式(自动 + 护栏)

Agent 自己一路改文件、跑命令;危险操作会被一个独立的分类器拦下问你,干完你看结果。长任务、批量改、隔离环境或实验分支里推荐。

权限对照:读文件三档都放行(Agent 总得能看到代码)。写文件:Plan 禁止,Default 弹 diff 审批,Auto 自动写。跑 shell 命令:Plan 禁止,Default 弹审批,Auto 自动跑但危险命令拦。发网络请求:Auto 模式默认仍需审批,防数据外泄。

值得注意的是:各家命名不同。Claude Code 的「Auto」是自动加分类器。Codex CLI 里叫「Auto」的那档其实是每步问你。别被名字骗了。


3. Plan 模式四阶段

Plan 模式的核心是让 Agent 先理解再动手。以 Claude Code 为例,走四步:

阶段一

理解需求

Agent 先读代码,再问问题——搞清楚到底要什么。它读相关源文件,然后发问:这次的改动范围是多大?现有调用方有多少?要保留兼容期吗?

阶段二

设计方案

Agent 分头查代码,整理实现思路。它会搜索引用位置、评估影响范围,然后输出分阶段的方案——比如先抽公共层、再切换调用方、最后删旧实现,每阶段拆成独立 PR,便于回滚。

阶段三

方案审查

Agent 交叉检验方案和你的原始需求是否对齐——每个需求点在方案中都有对应,超范围的改动被标注出来。如果发现潜在冲突,它会主动预警。

阶段四

输出计划

最终方案写进 plan.md,等你确认才动手。你确认后可以切到 Default 或 Auto 模式执行。技术上就是一段预设 Prompt 加工具白名单,但「计划确认,一键切到执行」这套 UI 是纯 Prompt 做不到的。


4. Default 模式:你来当审批员

Default 是最好的日常主力模式。Agent 提案,你看,你点,Agent 继续。出 bug 也只是白点一次。这种人在环中(Human-in-the-loop)的节奏让大多数人安心。OpenCode 还能按命令粒度配置——git * 自动放行,rm * 直接拒。

典型会话:你下指令「帮我重构 session 模块」。Agent 先读相关文件(自动放行),然后提案「新增 sessionProvider.ts」,附带 diff 给你看。你看完点击同意,它接着执行。遇到危险操作如 rm -rf src/legacy/,它停住等你确认。每一轮的审批日志清晰可查。

5. Auto 模式:不等于无脑放行

Claude Code 的 Auto 背后有一个独立的 AI 分类器:每个操作执行前先评一次风险。安全的直通,可疑的弹审批,红线直接拦。就像后台站了个安全员,只在它也吃不准时才打断你。

拿具体操作看:改一个普通源文件,分类器判定为低风险,直接写。读 .env 或 .git/config——即使你说全放开,也需审批。curl | bash 从外网拉脚本执行——供应链高风险,默认拦截。git push --force 到主分支——主分支受保护加强制推送双重红线,拦截。

还有一层兜底保护:如果分类器连续拦截三次(或累计二十次),Auto 模式自动退回 Default 手动审批,等你确认风险后再切回来。

Auto 放开手脚,最好配一道围栏。Codex CLI 的 Full Access 模式更激进——它只在一次性沙箱、Docker 容器、实验分支里用。沙箱站讲的就是「就算每步都点了允许,Agent 还能碰哪些文件、连哪些网」。

6. 三家命名对照

看清这张对照表,换 Agent 就不会再被命名搞迷糊。

Agent Plan 档 Default 档 Auto 档 特色
Claude Code Plan(Shift+Tab) Default Auto(AI 分类器) 分类器兜底,受保护路径,对话边界约束
Codex CLI Read Only Auto(默认) Full Access 沙箱隔离,配置文件管理
OpenCode Plan(禁用写工具) Build(默认) 全局 allow 按工具粒度配权限,Markdown 自定义模式

7. 工作流组合:像开车换挡

一个成熟工作流不是一直挂 Auto,也不是全程 Default。先 Plan 出方案,把握大的部分用 Auto 推,敏感模块换回 Default 逐步审,最后用 git diff 整体 review。

推荐的五段换挡工作流:

  • 摸底代码库 → Plan:Agent 第一次进项目,对结构没把握,Plan 最合适。
  • 出重构方案 → Plan:方案没定就动手,回滚成本巨大。
  • 批量改 → Auto:重复性高、风险低,三十个相似文件每个都点一次太累。
  • 改敏感模块 → Default:鉴权、支付、数据迁移类,安全可控。
  • 收尾整体 review → Default:跑测试、lint 都要你点放行,正合适。
五条实用建议:新手先 Default 感受 Agent 行为。大改生产代码前先出 Plan。长任务用 Auto 但放沙箱。遇到不确定操作立刻退回保守档。花十分钟配权限规则——安全命令 allow,危险命令 deny。

一条硬规则:主分支、.env、没看过 diff 的目录——永远不要交给 Auto。分类器只是兜底,不是保险。你的 git 历史和密钥才是最后一道防线。


8. 相邻概念

Agent 模式不是一个孤立话题。顺着这些概念可以深入:

  • Agent:能感知环境、自主规划、调用工具的 AI 系统,模式是给它的行为上缰绳。
  • Agent 循环:感知→思考→行动→观察的主循环,模式挂在这个循环上。
  • 子代理:主 Agent 派出的分身,模式对分身同样适用。
  • 沙箱:隔离执行环境,模式管每步要不要点头,沙管控能不能越界。
概念解析 · 人工智能ABC