h5i-python

Claude Code、Codex 以及其他编码 Agent 各自有不同的优势。然而，简单的多 Agent 编排（例如仅仅并行启动多个 Agent，或允许它们互相收发消息）并不能定义出一个可复现的开发流程。一个真正的工作流必须明确指定：

• 谁负责实现；

• 谁审查谁；

• Agent 在何时必须修订自己的工作；

• 哪些候选方案会被独立测试；

• 如何选出优胜者；

• 选定的更改何时被应用到原始分支。

h5i-python 是 h5i 编排引擎的 Python SDK。该 SDK 让你能够像编写普通 Python 程序一样，定义并执行跨 Claude Code、Codex 以及其他运行时的多 Agent 编码工作流。

每个 Agent 都在自己独立的沙箱化 Git worktree 中工作，因此它无法覆盖原始 checkout 或其他 Agent 的工作。Agent 的每次回合都会产出由 Git 支持的工件，这些工件可以被审查、修订、中立地验证、对比、选择，并作为一个可审计的工作流被应用。

安装pip install h5i-orchestra

快速上手在 Agent 需要修改的 Git 仓库内创建 ensemble.py。该工作流让 Claude 与 Codex 独立实现同一任务，互相审查并改进彼此的工作，然后选出更优的结果。

from h5i.orchestra import Conductor

async def main(task):

async with Conductor(repo=".", run="demo-task", launcher="resident") as c:

claude = await c.hire("claude-agent", runtime="claude")

codex = await c.hire("codex-agent", runtime="codex")

# 让两个 Agent 彼此独立、并行地实现该任务

claude_work, codex_work = await asyncio.gather(claude.work(task), codex.work(task))

await c.freeze() # 封存本回合，确保任一 Agent 此前未受彼此影响

# 让每个 Agent 审查另一个 Agent 的工作

await asyncio.gather(codex.review(claude_work), claude.review(codex_work))

# 在全新、中立的沙箱中验证每个提交

await c.verify(claude_work, ["pytest", "--quiet"])

await c.verify(codex_work, ["pytest", "--quiet"])

verdict = await c.judge() # 在通过全部测试的提交中，选择 diff 最小的一个

print("winner:", verdict.selected_submission)

asyncio.run(main("implement quicksort in python with unit test"))将其作为普通 Python 程序运行：

python ensemble.py使用默认的 launcher="resident" 时，h5i 会自动通过 tmux 启动 Agent 会话。