第37章 编码代理：用一条命令运行 Claude Code、Codex 等 AI 编程工具
Coding Agents
通过 Omnigent，只需一条命令即可运行 Claude Code 或 Codex。无需编写 YAML 配置。
这让你能在现有的编码代理之上，直接使用完整的平台功能，包括 Web UI、持久化会话、团队协作、移动端访问以及上下文策略。
omni claude # Claude Code
omni codex # Codex
omni goose # Goose
omni hermes # Hermes
omni copilot # GitHub Copilot（SDK harness）
omni devin # Devin
每条命令都会启动一个内置代理，无需注册步骤。Goose、Hermes 和 Devin 会在一个窗格中启动它们原生的终端 UI，并被 Omnigent 的 Web UI、协作层和策略层包裹。
omni copilot 是 omni run --harness copilot 的简写形式，需要 Copilot SDK（copilot 扩展）；关于启动和认证细节，请参见 GitHub Copilot。要查看完整的编码代理列表及其 harness 标识，请参见 Harnesses。
在底层，每个编码代理都作为一个 harness 运行，即执行代理循环的运行时。Omnigent 为它包裹了一个通用接口，并添加了单个 harness 自身无法提供的一切。
遵循 Coding Agent 教程，不到一分钟即可上手。
导入现有聊天
已经有本地的 Claude Code 或 Codex 历史记录？使用 omnigent import 将其作为普通会话引入 Omnigent。源转录会被转换为普通的 Omnigent 条目并存储为常规会话，从而获得 Web UI、持久化、协作等所有功能。除非传入 --force 以替换之前的导入，否则给定的源会话只能导入一次。
通过其 harness 原生的会话 ID 导入单个聊天：
omnigent import --harness claude --session <session-id>
omnigent import --harness codex --session <session-id>
或者使用 --last N 批量导入最近 N 个会话。这会导入最近修改的 N 个父会话（按时间从旧到新排序，最多 100 个）：
omnigent import --harness claude --last 10
请提供 --session 或 --last 中的且仅其中一个，二者互斥。
若要一次性从所有支持的 harness 中拉取最近的聊天，请同时传入 --harness all 和 --last N。这将把所有 harness 合并到一个全局的最近性排序中，并总共导入最近的 N 个会话（注意：不是每个 harness N 个），每个会话都会标记其来源：
omnigent import --harness all --last 25
--harness all 必须与 --last 搭配使用，因为一个 --session ID 只属于恰好一个 harness，将 all 与 --session 结合使用属于用法错误。
默认情况下，重新导入已导入的源会话会被拒绝。传入 --force 可替换之前的导入——Omnigent 会删除旧的对话并原地重新导入转录，保持相同的会话 ID：
omnigent import --harness claude --session <session-id> --force
在批量导入时，已导入的会话会被跳过，且某个会话导入失败不会阻止其余会话的导入。Omnigent 会打印一份摘要，显示已导入、已存在以及失败的会话数量，并在有任何失败时以非零状态码退出。
从 Web UI 导入
你也可以在 Web UI 中完成导入，无需操作终端。打开“设置 › 导入会话”，选择你的某台在线机器。导入选择器提供两种模式：
最近的会话 —— 选择一个 harness（或所有 harness）以及要拉取的最近会话数量（25、50 或 100）。
通过 ID 导入会话 —— 选择一个特定的 harness，并输入一个 harness 原生的会话 ID 来仅导入该转录，而无需列出本地历史。在此模式下，“所有 harness”不可用，因为一个会话 ID 只属于恰好一个 harness。
然后点击“导入”。转录文件位于你的机器上，因此读取操作是通过其隧道在连接的那台机器上发生的——服务器永远不会看到你的本地文件。已导入的会话会被跳过，每个新导入的会话都会在结果中建立链接，方便你直接跳转进入。
对于尚无会话的全新账户，空首页也会提供一个“导入你最近的 25 个会话”的一键按钮（从你的在线机器跨所有 harness 导入），以及一个“选择要导入的内容”链接，指向设置中的选择器。从 Web UI 导入需要一台在线机器——如果当前没有连接，请在终端运行 omnigent host 启动一台。
