一个 Docker 容器，让 Claude Code 和 Codex 用同一根线接进你的产品

你有没有想过：为啥 Claude Code、Codex、Hermes、OpenCode、Cline 这些 AI 编程 Agent，明明每个都很猛，但想在自己产品里”按需切换”就头大——每家一套私有协议、一套 session 流、一套文件管理？

本周 GitHub Trending 上悄悄冒出来一个新项目，刚好戳中这个”AI 编码 Agent 集成地狱”：HarnessRouter（社区版开源，Apache-2.0，Docker 单容器）。

它做了一件什么事

它把所有主流 AI 编码 Agent（Codex、Claude Code、Hermes、PI、DeepSeek Harness、OpenCode、Qwen Code、Cline）塞进一个统一协议层——叫 UHP（Unified Harness Protocol），对外只暴露一套 API。

你的产品只需要接一次 HarnessRouter，想用 Claude Code 就把 harness_id 切到 anthropic/claude-code，想换 Codex 就切 openai/codex——不用改一行客户端代码。

为什么这事儿现在重要

LLM 是语言预测器，harness 才是把模型变成”能干活的 Agent”那一层——管文件、管工具调用、管多轮循环、管流式输出、管取消、管失败处理。现在每家 harness 都是闭源私货，集成成本按 N² 爆炸。HarnessRouter 想做的就是 LLM 时代的”USB-C”——一个端口，插所有 harness。

社区版已经拿到 UHP Full 类合规徽章，托管版用同一套协议，不会有”开源版跑通了上线还得重写”的尴尬。

三个特别香的细节

1. 真·单容器：约 700MB 镜像，一个 docker run 拉起来。API、Console、SQLite 状态、工作区文件全在你机器上，不连云，不上传 telemetry。
2. 许可证处理很干净：Claude Code 和 Hermes 不预装进镜像（无法再发行），首次启动时按你接受的条款从上游拉——你在自己机器上履行自己的合规。
3. 配套 Starter Kit 开箱即用：官方给了四个完整产品套件（Slides/Sheets/Dashboards/Videos），跑起来直接是个可演示的产品——比空仓库友好太多。

怎么上手

一行起服务：

docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter 
  -p 127.0.0.1:3000:3000 
  -v harnessrouter:/data 
  -e HR_AUTH_PASSWORD='change-me' 
  harnessrouter/harnessrouter

Console 跑在 http://localhost:3000，第一次进会自动装好三套 Agent Harness（Claude Code、Codex、Hermes）。UHP 协议规范在 unifiedharnessprotocol.org，社区版跟托管版共用同一份契约。

谁适合用它

• 想给自家产品接多个 AI 编码 Agent、但不想为每家单独维护集成层的团队
• 个人开发者想用一个统一界面切换不同模型 A/B 测试编码能力
• 对”代码上云”敏感、希望 self-host 全部状态的独立开发者和企业

一句话总结：HarnessRouter 给 AI 编码 Agent 圈画了个 USB-C 口，让 Claude Code 和 Codex 第一次能用同一根线接进你的产品。

仓库地址：HarnessRouter/harnessrouter

GitHub: https://github.com/HarnessRouter/harnessrouter