Qoder Cloud Agents 接入 HarnessRouter：首个“云端运行时”Harness 落地

HarnessRouter：Coding Agent 界的 OpenRouter

如果你用过 OpenRouter，应该熟悉它解决的问题：一个 API 接入几十家模型，使用者不用为每家单独写代码，哪个便宜、哪个好用就切哪个。

HarnessRouter 做的是同一件事，只不过对象换成了 Coding Agent。Claude Code、Codex、Gemini CLI、goose、OpenHands……每一个都是一套完整的 Agent 运行时，但启动任务、跟踪进度、续轮对话、取消、取回文件的方式各不相同。应用要想支持多个 Agent，就得把这些差异逐个重做一遍。

HarnessRouter 把它们统一成一套 OpenAI Responses 兼容的 API（Unified Harness Protocol，简称UHP），只需对接一次即可。好处是实打实的：

• 不被单一 Agent 绑定：今天用 Claude Code，明天换 Codex，后天上 Qoder，应用代码一行不改。
• 按任务选工具、按成本选工具：简单任务走便宜的，复杂任务走强的；某家涨价或限流了，切走即可。
• 公平比较：同一个任务跑在不同 Agent 上，输出、耗时、成本放在一起看，谁好谁差一目了然。

这个项目今年 8 月开源，两个月时间已经在 GitHub 上拿到 3,100+ Star、300 多个 Fork，接入了近二十种 Harness。

这次接入有什么不一样

在此之前，HarnessRouter 支持的每一个 Harness 都是本地 CLI——在沙箱里拉起子进程、解析输出。取消靠杀进程，产物靠工作区的 git diff，凭证隔离靠本机的回环代理，三件事都建立在“本地有个进程”之上。

Qoder Cloud Agents 不是本地 CLI。它是一个托管的 Agent 运行时：Agent 循环在 Qoder 云端执行，对外通过 REST + SSE 的 Managed API 暴露——创建 Session、发送消息、订阅事件流、交付产物。

因此这次接入做的不只是“再加一个 Harness”，而是让 HarnessRouter 第一次有了“远端运行时（remote runtime）”这个类别，并把它需要的能力补齐：

• 优雅下线：本地进程退出前先通知 Qoder 取消远端任务，避免“地停了、云端还在跑还在计费”。
• 凭证安全：Qoder 的访问令牌始终留在 HarnessRouter 侧，运行 Agent 的进程只拿到占位符，与其他 Harness 一致。
• 产物交付：Qoder 侧通过工具交付的文件，会被完整校验后落到用户的工作区；文件名作为不可信输入严格处理。
• 工具权限跨轮生效：对话中途禁用某个工具，下一轮立即在 Qoder 的 Agent 配置层面被真正移除，而不只是“写一句提示让模型别用”。
• 删除不冗余：删除一个会话时，它在 Qoder 侧创建的 Session、文件、Agent、Skill、凭证会一并清理。
• 成本透明：Qoder 以 credits 计费，这次为 UHP 引入了独立的参数如实呈现，不与 token 统计混算。

这些设计已经写进 HarnessRouter 的 Harness 接入规范，成为后续任何云端 Harness 的参照模板。

对开发者意味着什么

• HarnessRouter 用户：在原有本地 Harness 之外，多了一个无需安装任何二进制、开箱即用的云端选项；Qoder 租户内的全部模型（Qwen、DeepSeek、Kimi、GLM、MiniMax 等十余款）都能通过它使用。
• Qoder 用户：可以把 Qoder Cloud Agents 放进任何支持 UHP 的应用和编排系统里，与其他 Agent 并列对比、组合使用。

两个项目都相信同一件事：Agent 的能力正在快速趋同，让它们可互换、可组合、可被公平度量，比再造一个封闭的 Agent 更有价值。这次合作是朝这个方向迈出的一步。

这是一种构建方式：Agents API

把这次合作放回更大的图景里看，它只是一步。

今天做一个 Agent 产品，大多数团队仍然要从头搭 agent loop、沙箱、编排和 tracing，然后才轮到真正的业务逻辑。我们认为这不该是常态。Qoder Cloud Agents 把 Agent 做成了一个云端 API：创建 Session、发任务、订阅事件流、取回成品，应用方只需对接接口，基础设施那一层由我们承担。我们把这种构建方式叫 Agents API。

一种构建方式要成为事实标准，靠的不是自己定义，而是被足够多的生态采用。所以我们选择通过开源合作来推进：接入 HarnessRouter，意味着所有 UHP 应用天然多了一个云端 Agent 选项；更多生态项目的合作也在推进中。每多一个生态把 Qoder Cloud Agents 作为标准后端，Agents API 这条路就更扎实一些。

Agent 的能力正在快速趋同，让它们可互换、可组合、可被公平度量，比再造一个封闭的 Agent 更有价值。这次合作是朝这个方向迈出的一步。