研究想法

编码代理运行控制

日 · 2026-07-05 · Software Intelligence

编码代理上线现在需要在失败成本高的地方设置小型运行控制:混乱的代码库、shell 访问和人工审查。近期最清楚的工作可以被测量:在真实任务上跟踪代理的 token 使用量和文件重复访问次数,把命令执行与长期运行的代理进程隔离,并限制每位审查者同时处理的代理生成 pull request 数量。

3 个想法

面向高变更代码库区域的代理成本回归测试

使用 Claude Code 或类似编码代理的团队,可以在现有代码质量工作旁边加一项小型代理成本检查。选出高变更目录中的几个重复维护任务,按固定计划用同一套代理配置运行,并记录 token 使用量、文件重复访问次数、耗时和测试结果。用这些结果判断一次清理 PR 是否降低了代理辅助工作的运行成本。

实际目标是控制预算。Claude Code 的受控研究发现,在匹配的代码库中,更干净的代码没有提高通过率,但 token 使用量减少了 7% 到 8%,文件重复访问次数减少了 34%。对于已经为代理运行付费并审查代理 diff 的团队,这足以支持一次轻量的前后对比测试。一个有用的试点可以比较两三个针对静态分析违规或认知复杂度的重构,然后检查代理在同一组任务上是否查看了更少文件、消耗了更少 token。

用于编码代理命令的可丢弃 shell 沙箱

多用户编码代理应在可丢弃的执行环境中运行有风险的 shell 命令,同时把代理循环及其记忆保留在单独的持久主机上。第一个版本可以很窄:每个用户会话一个沙箱,首次访问文件系统时上传源码,在破坏性命令前创建检查点,并且只把凭据注入到需要它的单个命令中。

Fly.io 的 Sprites 示例给出了这种模式的具体做法。一个用户会话获得自己的 Sprite,后续命令复用这个隔离环境,空闲会话可以降温,出问题的命令可以从检查点回滚。在凭据示例中,用户的 Fly token 只在一次 flyctl 调用期间放入命令环境,并在命令返回后移除。Terminai 展示了同一安全需求在本地终端中的版本:代理可以读取上下文,写入操作则通过 MCP server 由用户批准。

代理生成 pull request 的工单模板和并发限制

团队在扩大并行编码工作之前,需要为代理生成的 pull request 制定接收规则。一个可行起点是为每个代理任务准备简短的工单模板:目标、相关文件或系统、约束、预期测试、审查标准和指定负责人。同时设置审查者上限,例如在团队测量审查时间之前,每个人最多同时负责两三个活跃的代理分支。

压力来自审查,而不只是代码生成速度。一位 Claude Code 用户报告说,几个串联的 pull request 在 20 到 30 分钟内出现,但因为需求不清,结果没有匹配预期设计。同一篇经验文章发现,三个并发的代理辅助任务已经是实际上限,因为审查和恢复上下文会变难。相关文章指出了同一种运行成本:提示词需要写得像工单,生成的代码仍然带来审查、维护、安全、部署和所有权成本。