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 点确认。
2. 三档速览
三档的核心差别全在「能不能动」这件事上。读永远不卡,真正会卡的是写文件和跑命令。
Plan 模式(只读)
Agent 不能改任何东西。只能遍历代码、读文件、搜符号。输出是一份 Markdown 计划,列出要改哪些文件、分几步、按什么顺序。复杂重构、不熟的代码库、多人协作时最有用。
Default 模式(边做边审)
多数 Agent 的出厂设置。读不卡,写和跑命令会暂停等你点。Agent 提一步,你看 diff 点一下确认,它才能继续。日常开发、bug 修复、主分支干活推荐用这档。
Auto 模式(自动 + 护栏)
Agent 自己一路改文件、跑命令;危险操作会被一个独立的分类器拦下问你,干完你看结果。长任务、批量改、隔离环境或实验分支里推荐。
值得注意的是:各家命名不同。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 * 直接拒。
rm -rf src/legacy/,它停住等你确认。每一轮的审批日志清晰可查。
5. Auto 模式:不等于无脑放行
Claude Code 的 Auto 背后有一个独立的 AI 分类器:每个操作执行前先评一次风险。安全的直通,可疑的弹审批,红线直接拦。就像后台站了个安全员,只在它也吃不准时才打断你。
拿具体操作看:改一个普通源文件,分类器判定为低风险,直接写。读 .env 或 .git/config——即使你说全放开,也需审批。curl | bash 从外网拉脚本执行——供应链高风险,默认拦截。git push --force 到主分支——主分支受保护加强制推送双重红线,拦截。
还有一层兜底保护:如果分类器连续拦截三次(或累计二十次),Auto 模式自动退回 Default 手动审批,等你确认风险后再切回来。
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 都要你点放行,正合适。
一条硬规则:主分支、.env、没看过 diff 的目录——永远不要交给 Auto。分类器只是兜底,不是保险。你的 git 历史和密钥才是最后一道防线。
8. 相邻概念
Agent 模式不是一个孤立话题。顺着这些概念可以深入:
- Agent:能感知环境、自主规划、调用工具的 AI 系统,模式是给它的行为上缰绳。
- Agent 循环:感知→思考→行动→观察的主循环,模式挂在这个循环上。
- 子代理:主 Agent 派出的分身,模式对分身同样适用。
- 沙箱:隔离执行环境,模式管每步要不要点头,沙管控能不能越界。