很多人卡在同一步：已经装了补全插件或 AI 编辑器，却想让它自己改多文件、跑测试、修报错，结果发现它只会给建议，剩下还得自己动手。反过来也有人拿 Agent 去做一行自动补全，白烧时间和额度。这篇不推荐具体工具，只帮你分清楚两类东西各自能管到哪，给你一张对照表和一个判断顺序，看完就能定下这次任务该用哪一类。
很多人卡在同一步：已经装了补全插件或 AI 编辑器，却想让它自己改多文件、跑测试、修报错，结果发现它只会给建议，剩下还得自己动手。反过来也有人拿 Agent 去做一行自动补全，白烧时间和额度。问题往往不在工具选得差，而在把两类东西的定位搞混了。
这篇不推荐具体工具，只帮你分清楚 AI 编程工具和 Agent 各自能管到哪，给一张对照表和一个判断顺序。看完你能定下这次任务该用哪一类，以及什么时候该收手。
先分清两类东西：从“谁动手”看
别按界面来分。同一个产品，你只让它补全，它就是编程工具；你给它执行权限和循环权限，它才开始像 Agent。核心判断线是控制权在谁手里：每一步动作要不要你点确认，失败之后是谁决定下一步。
- AI 编程工具：人在环里，补全、选区内改、对话问答，输出是建议或一段 diff，落盘和执行由你确认
- Agent：自己转圈，拿到目标后自己决定调哪个工具、读哪个文件、跑哪条命令，直到它自己判断完成
- 关键不在名字，在权限：能不能跑命令、能不能改多文件、有没有循环和步数上限
- 两个极端都不划算：用工具做长链路自动化会反复人工介入，用 Agent 做单行补全会明显更慢更贵
能力对照表：五个维度比一遍
下面这张表用来做快速对照。注意它描述的是典型形态，不排除某些产品两边都能干；实际差别要看你这边的权限配置和任务类型，任务越模糊、动作半径越大，两类的差距越明显。
| 维度 | AI 编程工具 | Agent |
|---|---|---|
| 上下文范围 | 当前文件加少量显式引用 | 自己搜、自己读、自己拼，范围大但可能读偏 |
| 动作半径 | 生成文本和 diff | 改多文件、跑测试、看日志、调接口，出错回滚成本更高 |
| 任务时长 | 分钟级交互，随时打断 | 适合跑十几分钟以上的任务，需要步数和时间上限兜底 |
| 可预测性 | 扫一眼就知道对不对 | 中途决策多，得留日志才能复盘 |
| 成本结构 | 稀疏调用，按次算 | 连续多轮加工具返回，同样任务消耗可能差一个量级 |
成本这块最容易被低估。想按自己的场景估一遍，别拍脑袋，到 /tools/model-cost-calculator 填入调用轮数和上下文规模看当时的估算；具体各家的计费口径差异，去 /price-watch 核对当时的数字。
什么情况下别上 Agent
Agent 不是升级版，是另一种东西。下面这些情况硬上 Agent，通常不是省钱而是多花钱，还多出一堆要排查的中间状态。
- 任务没有可自动校验的完成标准，比如「把这个模块重构得更优雅」，它说做完了你很难验收
- 权限给不开：没有测试环境、不能跑命令、不能读数据库，Agent 只能退化成聊天工具，不如直接用编程工具
- 改动半径大又不可逆：生产配置、数据迁移脚本，先让编程工具出方案，人工审完再执行
- 额度紧张或调用频次受限：多轮消耗更容易撞限流，先确认当前套餐口径，见 /coding-plans 核对当时的说明
反过来，如果任务步骤多但每步都能校验、环境隔离做得干净、失败重来成本低，那这类活交给 Agent 反而合适，人只用在关键节点抽查。
一次任务的决策清单
选工具之前先问三句：这活有没有明确的验收标准；能不能让我安全地跑命令和改文件；出错重来的代价大不大。前两句都为「是」、第三句为「代价小」，才轮到 Agent 上场。任何一句不满足，先用编程工具。
- 先用编程工具走一遍让它出方案和第一版 diff，你审完之后再决定要不要交给 Agent 去批量落地，这一步几乎不会白做
- 上 Agent 前定三件事允许调用的工具白名单、最大步数、预算上限；写清楚这三样再开跑，中途留好日志
- 跑完抽一条轨迹复盘看它多读了哪些无关文件、哪一步绕了弯路，据此收紧下一轮的工具范围
- 定期复核用量把实际消耗和当时的估算对一遍，偏差大就调上下文或步数配置，别让默认值一直跑
拿不准两类工具的实际形态差别时，到 /ai-nav/category/ai-coding 和 /ai-nav/category/ai-agent 各翻一遍目录，按「谁动手」对号入座，比看宣传语准。
下一步把你手上这个任务的验收标准、可执行权限、出错代价三样写下来，再对照目录找对应形态的工具；具体的模型价格和套餐口径，到站内价格页面核对当时的数字。→常见问题
AI 编程工具能不能自动改多个文件？那它算 Agent 吗？
能改多文件不等于就是 Agent。判断关键看它是否自己决定下一步做什么：你圈定范围、它一次给出改动，这仍是工具；它自己去找文件、改完自己跑测试再回头修，才算 Agent 行为。同一个产品两种模式都有，取决于你开的是哪种。
用 Agent 一定比用编程工具效果好吗？
不一定。Agent 的优势在长链路和重复动作，代价是多轮调用、更难预测、要额外做护栏。任务短、验收标准模糊、权限给不开的时候，编程工具加人工判断往往更快更稳。先按验收标准、执行权限、回滚成本三条过一遍再决定。
团队里两类工具都买，怎么分工不打架？
按任务类型分而不是按人分：单点修改、解释代码、写单测这类短任务统一用编程工具；批量改名、跨文件迁移、跑测试修到绿这类长任务交 Agent，并规定必须留轨迹、有限步数。每人手上都装两类，但流程上写清楚哪类任务走哪条路。
