前面几篇把骨架立起来了:循环、工具、记忆、检索、分工、协议。从这一篇起,镜头拉近到成品——看真实世界里有人天天在用的 Agent,是怎么把这套骨架装进一个壳里的。
第一个标本选了 Claude Code。它没有网页、没有图形界面,住在一个很多人以为“过时”的地方:终端。但用过的人常有一个共同感受——顺手。这份顺手不是玄学,拆开看,每一步都有出处。
它住在终端里
编码这件事的现场,本来就在终端。代码、版本库、测试、构建、部署,全在这一个地方排队站好。
一个 Agent 要动手,最省力的做法不是给它盖一座新世界,而是让它住进现场:用你现成的环境、现成的习惯、现成的工具链。你不需要为它学一套新东西,反过来,它来学你的。
这也是它看起来“权限很大”却不容易闯祸的原因:它做的每件事都发生在你天天待的地方——好检查、好回退、好接管。
全部本领,一只手数得过来
拆开它的工具清单,会发现少得出奇,概括起来不过几类:
- 读文件:把某个文件的内容取出来
- 改文件:在指定位置做一次精确修改
- 跑命令:执行命令行操作,拿回输出
- 搜索:按名字找文件,按内容找行
- 联网:抓一个网页的内容回来
关键词是粒度。一个工具只干一件事,名字就是动词。看起来笨,实际上聪明:
- 工具小,动作就小:模型一次只做一个小动作,做错了,损失也有限
- 每一步都可检查:改的是哪个文件、第几行、什么内容,全都摆在明面上
- 每一步都可拒绝:请求摆在面前,你随时可以喊停
反面的做法是“全能工具”:一个工具包罗万象、参数几十个,模型理解错一次,错的就是一大片。工具越粗,越容易手滑。
还有个常被忽略的细节:每个工具背后都带着一段说明——什么时候用它、参数是什么、什么情况下别用。模型挑工具唯一能依靠的,就是这段说明。说明写得清楚,工具就好用;写得含糊,再聪明的模型也会拿错。
权限:最后那道闸门在你手里
一个能跑命令的 Agent,等于你把机器的方向盘递了出去。产品要回答的因此不是“要不要权限”,而是“闸门放在哪一层”。
常见的分法是把动作分档:
- 只读动作(读文件、搜索):通常直接放行,不打断节奏
- 有副作用的动作(改文件、跑命令):先把请求摆到你面前,等你点头
- 危险区(删数据、碰系统配置):单独拦一道,哪怕你刚批准过十次安分的命令
除了逐次点批准,还有两条省心的路:一条是预先给白名单——比如某类只读命令,以后不必再问;另一条是切换档位——有的产品提供“只看不动”的模式,让它先把代码读透、给出方案,你满意了再放它动手。

这不是安全功能,是信任设计。信任是一格一格给的,每给出一格,都要看得见。用户敢把事情越交越多,靠的不是产品保证“我不会错”,而是每一步都留着他喊停的空间。
大仓库里怎么不迷路
模型读不了几十万行代码。面对一个大项目,如果它的第一反应是“从头读到尾”,成本先崩,注意力也跟着崩。
真实的做法正好相反,靠的是纪律:
- 按需检索:先用搜索定位到少数几个相关文件,再读这些文件里的片段,而不是整个仓库
- 项目记忆:仓库里放一份写给 Agent 的说明——怎么构建、怎么测试、哪些约定不能破
- 上下文压缩:对话拖长之后,把早期过程总结成结论,丢掉细节、留下要点
- 一次性侦察:把“翻找资料”这种重活外包给一个短命的子任务,只把结论带回主线

打个比方,它更像刚进大项目组的老工程师:先把交接文档读一遍,再带着问题定点敲开几个文件。没人靠把整个仓库背下来干活。
循环:模型做决定,外壳管流程
它的工作方式一句话能说完:模型想一步,外壳替它走一步,把结果拿回来,再想下一步。
拆开是四拍:
- 模型读当前全部上下文,决定下一步做什么
- 决定以一次结构化的“工具调用”发出——调哪个工具、传什么参数,都是明确的
- 外壳负责执行:检查权限、运行工具、把输出整理成规整的结果
- 结果回到上下文里,模型看到真实世界的反馈,继续下一步

循环什么时候停?两种情况:模型认为任务已完成、不再请求工具;或者你按下中断,接管方向。
这套循环听起来朴素,却是整件事的底盘:工具再顺手、权限再合理,循环不稳,模型今天做得到的事,明天就未必。
模型没有手——它读不了文件、跑不了命令,只会“说”。外壳是那双手,也是那根缰绳。好用与不好用的分水岭,常常就藏在这个循环的细节里:错误信息写得够不够清楚,工具的返回够不够规整,模型卡住时外壳给不给它台阶下。很多“它怎么这么笨”的时刻,根子在外壳交给模型的信息质量上。
好用感从哪来
把零件对起来,“好用”两个字就有了出处:
- 工具粒度小:一步一个小动作,错了改一步,不用推倒重来
- 闸门清楚:知道它在干什么,才敢让它干更多
- 上下文有纪律:按需读、会总结,长会话不散架
- 循环不废话:流程清楚、错误可读,大部分问题它自己就能救回来
还有一条软的:说话方式。不寒暄、不铺垫,输出直指“下一步做什么”。干活的场合里,啰嗦就是成本。
好用的本质不是功能多,而是每一步都让你知道:它在干什么、为什么、以及怎么拦。
拆完之后
去掉神秘感,它不过是:一个稳定的循环、一只手数得过来的工具、一道分层的权限闸门、一套严格的上下文纪律。每样都不神奇,难的是分寸——工具细到什么程度、闸门放在哪一层、什么时候该总结、什么时候该打断。
结构可以复制,手感复制不了。还有一点值得记住:这套设计没有一处依赖“模型特别聪明”的假设——工具、权限、上下文与循环,每一步都在替模型兜底,也在替你把关。
下一站换一个视角:不是所有 Agent 都住在你的终端里。有一类产品把任务送上了天——云端沙箱、任务队列、无人值守。那就是 Codex 类的世界。
