Vercel 开源 durable-harness：让 Claude Code、Codex、OpenCode、Pi 等编码 Agent 在云端崩溃后从日志续跑

核心背景与行业痛点

Claude Code、Codex、OpenCode、Pi 这类编码 Agent harness 原本是为本地长进程设计的：会话留在内存里，工作区和历史在同一块磁盘上，中断了只要再发一句提示就能接着做。但越来越多团队把它们搬到云上做全天候 Agent，一轮任务常跑几分钟到几小时。Vercel 在官方博客里指出，云上即便用 VM 加持久存储，也不会自动记录哪些模型和工具调用已经完成；函数超时、网络断开或进程崩溃，这一轮的工作就丢了，重跑还会重复消耗 token。

架构亮点与底层机制

durable-harness 是一组适配器和工具，不改 harness 本身，而是让会话存进 Workflow SDK 的 World（Vercel 这套持久化后端）。每一轮的每一步都写入持久日志：调用前记 intent，结束后记 outcome；整轮由一条队列消息兜底，函数挂了就由队列交给新函数读日志续跑。恢复时，已完成的调用直接读结果，标记 replay: 'safe' 的工具会重跑，其余工具以“可能已执行”的状态交还模型判断。Claude Code 的 transcript、Codex 的 rollout、OpenCode 的事件存储都会被镜像到日志里，新函数或 Sandbox 可据此重建。World 接口把日志、队列和流合为一体，所以同一个 Agent 可以在 Vercel、本地文件、Postgres、MongoDB、Redis、Turso 之间迁移而不改代码。

权威 Benchmark 与实测跑分对比

官方未公布性能或可靠性跑分，也没有给出恢复延迟、额外开销等数字。官方口径的可验证事实是：GitHub 仓库 vercel-labs/durable-harness 采用 Apache 2.0 许可，npm 最新版本为 0.0.1-beta.6，README 明确写着“实验性，0.0.x 阶段 API 可能变化”。“已完成的模型调用不会被重复计费”是 Vercel 博客的设计说明，而非第三方测试结果。

开发者实战落地与开箱指南

README 的快速上手以 Pi 为例：在 Next.js 应用中安装 durable-harness 和 @earendil-works/pi-durable，用 chatRoute 暴露聊天路由，再在 next.config 里包一层 withDurableHarness。其他 harness 各有入口，如 durable-harness/opencode，具体配置见 Vercel 文档的 Agent Harnesses 章节。自建部署只需设置 WORKFLOW_TARGET_WORLD="@workflow/world-postgres" 和 WORKFLOW_POSTGRES_URL 两个变量。部署在 Vercel 上的会话可以在 Agent Runs 面板里看到每次模型和工具调用的 trace，包括崩溃后续跑的位置。由于仍是 beta，建议先用于内部长任务 Agent，并给有副作用的工具认真设置 replay 策略。