DeepSeek Harness、Claude Code 与 Omnigent 怎么选?
比较 DeepSeek Harness、Claude Code 与 Omnigent 的架构、模型耦合、界面、许可证和成熟度,并说明各自在 VPS 上的运行要求。
DeepSeek Harness、Claude Code 和 Omnigent:您需要哪一个
DeepSeek Harness、Claude Code 和 Omnigent 都被称为 agent harness,但它们解决的是不同部分的问题。DeepSeek Harness 是带有 Web UI(用户界面)的插件运行时,模型由您提供。Claude Code 是 Anthropic 提供的终端程序,用于运行 Anthropic 模型。Omnigent 是 Databricks 提供的编排器,用于驱动包括 Claude Code 在内的其他 harness,而不是自行实现 agent loop。它们都不能直接替代其他产品,因此需要回答的问题是:您缺少的是哪一层。如果您不熟悉这种划分方式,请参阅agent harness 的实际含义,其中说明了这三个产品以不同方式划分的组成部分:循环、工具、权限和会话状态。
真正存在差异的维度包括架构、模型耦合方式、接口、成熟度和许可证。下面的版本和日期最初于 18 August 2026 进行核查,并于 20 October 2026 对照各项目自己的文档、发布页面和 package registry 再次核查。版本号、发布状态和运行时要求于 27 October 2026 再次核查。如果某句话给出了自己的日期,则该日期适用于该句话。三者中有两个迭代速度很快,因此在您决定采用其中一个之前,应再次进行核查。
什么是 DeepSeek Harness,插件模型带来了什么优势?
DeepSeek 于 2026 年 8 月在 github.com/deepseek-ai/deepseek-harness 发布了 DeepSeek Harness,即 dsh。仓库说明用四个词概括了整个设计:一切都是插件。模型适配器、工具注册表、会话日志、沙箱以及代理循环本身都是插件,由基于 Cordis 构建的运行时加载。该项目的采用速度异常快,仓库在发布后数日内就超过了 150,000 个 star(截至 2026 年 8 月 18 日检查)。
DeepSeek Harness 目前处于开发者预览阶段,迭代速度很快。必然会发生破坏兼容性的变更。
这是 README 自己给出的警告,也是本次比较中最重要的一句话。今天针对插件 API(应用程序编程接口)编写的任何内容,都应预期将来需要重写。
使用 npx 启动,但需要先安装 Node.js:
npx @deepseek-ai/dsh web该命令会输出 URL;在本地启动时,还会在默认浏览器中打开该 URL。默认情况下,Web UI 在 http://127.0.0.1:3080 提供服务,输出的 URL 包含一个用于让浏览器完成登录的新进程令牌,因此应打开该完整 URL,而不是输入不带令牌的地址。这个地址是有意指定的绑定地址,并非仅用于显示的默认值;当 dsh 与浏览器不在同一台机器上运行时,了解绑定到 127.0.0.1 对访问 UI 的影响 就很重要。截至 2026 年 10 月 27 日,所有已发布的构建版本都是预发布版本,属于候选发布版或 alpha 版,没有一个是稳定版(此时 npm 的 latest 标签仍指向 0.2.1-rc.2,而其 next 标签已移动到 0.2.1-rc.4)。因此,如果该命令失败,或启动了不是你预期的版本,固定确切的 dsh 版本并清除 npx 缓存 是最快的解决方法。从源代码构建则使用 pnpm:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh webdsh web 是 dsh --profile web 的简写。配置 profile 本身是 $DSH_HOME/profiles/ 下的一个目录,启动器会启动你指定的那个 profile。这一点很重要,因为还有一个无头 profile:dsh --profile headless "job" 会运行一个持久化会话,输出结果后退出,这正适合 cron 作业或构建步骤。--profile 和 --patch 等启动器标志必须放在应用程序自身参数之前,因为启动器在交接处停止解析参数。--port 这类标志属于已启动的 profile,而不是启动器,因此位置很重要。插件通过向 pnpm 转发参数进行管理,例如 dsh plugin --profile web add <package>。插件会加载到与代理相同的运行时中,并继承代理的权限,因此请在安装插件前检查插件可以访问哪些资源。
Claude Code 是什么?为什么它是终端程序?
Claude Code 是 Anthropic 自己的 CLI(命令行界面)代理。CLI 本身没有网页界面。Anthropic 还提供网页版 Claude Code、桌面应用和 IDE 扩展,但这些属于独立入口。在服务器上运行的是 CLI。它在终端中运行,并使用您希望它处理的目录,因此非常适合服务器会话。由于没有需要配置的界面,您可以通过文本而不是设置面板控制它的回答方式;输出样式会替换其系统提示词,使会话中的每条回复都采用不同格式。在 macOS、Linux 和 WSL 上,只需运行一条命令即可安装:
curl -fsSL https://claude.ai/install.sh | bash
claude --version安装成功后会输出版本和产品名称,例如 2.1.211 (Claude Code)。如果该命令失败,claude doctor 会输出只读的安装和设置诊断信息,但不会启动会话。它也提供 npm 软件包 npm install -g @anthropic-ai/claude-code,需要 Node.js 22 或更高版本。该软件包安装的是相同的原生二进制文件,因此已安装的 claude 不会在运行时使用 Node.js。Anthropic 还为 Debian、Ubuntu、Fedora、RHEL 和 Alpine 提供带签名的 apt、dnf 和 apk 软件源。如果服务器由配置管理工具管理,这些软件源是更好的选择,因为更新可以通过您现有的升级流程部署。
Anthropic 的设置文档说明,Claude Code 需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账户,或者通过受支持的云服务提供商访问:Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。免费的 Claude.ai 计划不包含访问权限。Ollama 也记录了一种方式 ollama launch claude,可通过 Ollama 兼容 Anthropic 的 API,让 Claude Code 使用本地模型,而无需在配置中提供 Anthropic 凭据;但此时运行的是其他提供方的模型,而不是 Claude。对于 Anthropic 自己的模型,选择 Claude 订阅还是 API 计费,对费用的影响远大于工具内部的任何设置。
什么是 Omnigent,元框架负责编排什么?
Databricks 于 2026 年 6 月宣布推出 Omnigent,并根据 Apache 2.0 许可证发布。它将自身称为元框架。它不实现智能体循环,而是驱动已有的智能体循环:Claude、Codex、Cursor、OpenCode、Hermes、Pi 和 OpenAI 的智能体 SDK(软件开发工具包)。到 2026 年 10 月,README 还列出了 GitHub Copilot、Antigravity、Devin、Kiro 和 Grok Build。其中一些工具在框架列表中出现了两次:一种通过供应商的 SDK 通信,另一种以原生形式封装供应商实际的终端程序。
智能体是一个 YAML 文件。YAML 是一种纯文本配置格式:
name: my_agent
prompt: You are a helpful data analyst.
executor:
harness: claude-sdk
tools:
word_count:
type: function
callable: mypackage.mymodule.word_count
docs:
type: mcp
url: https://example.com/mcp
researcher:
type: agent
prompt: Search for relevant information.executor.harness 行体现了整个项目的核心。将 claude-sdk 改为 codex,相同的提示和相同的工具就会在另一家供应商的模型上运行。工具可以是 Python 函数、MCP(模型上下文协议)服务器或另一个智能体。最后一种情况用于表示多智能体工作:子智能体就是一个工具。如果您还没有确定技能、MCP 服务器和规则文件分别应放在哪里,建议先阅读智能体技能、MCP 与规则文件的区别,因为 Omnigent 会继承底层框架所支持的相应机制。
随附的示例具体展示了这一理念。Polly 是一个代码编排器,本身不编写代码。它先制定计划,再通过并行的 git worktree 将工作分派给编码子智能体,最后将每个差异交给运行在另一家供应商模型上的审查器。
使用已发布的脚本安装:
curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh也可以手动安装,但需要 Python 3.12 或更高版本:
uv tool install omnigent
omnigent setup
omnigent startpip install "omnigent" 同样可用,附加组件通常通过 uv tool install "omnigent[databricks,modal]" 选择。omnigent setup 用于收集凭据和设置默认值。omnigent start 启动本地服务器,将当前机器注册为主机,并输出要打开的 URL。omnigent server status 和 omnigent stop 是日常使用的另外两个命令。单独执行 omnigent 不会启动智能体。omnigent 和 omni 都调用同一个入口点:在交互式终端中,单独执行该命令会在后台启动本地服务器和主机,然后返回;在没有 TTY 时,它会输出帮助信息。使用 omni claude、omni polly 或 omni run agent.yaml 启动智能体。
依赖项比单行安装器暗示的更多:Python 3.12 或更高版本、uv、git、Node.js 22 LTS(长期支持版)或更高版本,以及 npm 和 pnpm;原生终端封装器需要 tmux,Linux 沙箱需要 bubblewrap(bwrap)。这直接源于其设计。Omnigent 负责监管供应商 CLI,并会自动安装其中一些工具;其他工具则需要单独安装。因此,它是一个 Python 软件,但其职责包括运行 Node.js 软件。
模型由谁提供,费用由谁承担?
这是实际影响最大的维度,三个答案确实不同。
DeepSeek Harness 采用自带供应商的方式。已安装的供应商目录包含 Anthropic、OpenAI、Kimi(moonshotai)和 GLM(zai)等供应商,旁边还有 DeepSeek 自有 API 的配置卡片。目录还列出 openai-codex 等不使用原生密钥认证的供应商;除非配置文件明确指定凭据引用,否则这些供应商不会显示密钥字段(检查于 20 October 2026)。自定义供应商条目需要小写的供应商 ID、显示名称、基础 URL、API 协议、凭据以及至少一个模型。这样即可将其指向公司网关或自托管服务器。密钥写入 $DSH_HOME/.credentials.yaml,配置文件中的供应商设置(位于 cordis.patch.yml,适用于 dsh web、$DSH_HOME/profiles/web/cordis.patch.yml)只保留对这些密钥的引用,因此可以安全共享设置文件,但不能共享凭据文件。网关条目也可以改为指定环境变量,例如 apiKeyEnv: GATEWAY_API_KEY。尽管项目名称如此,其中没有任何设置会强制使用 DeepSeek 自有模型。如果您希望查看真实密钥的配置方式,或查看如何将其指向本地 Ollama 端点,请参阅配置 dsh 密钥、模型和端点,其中介绍了每种模式,以及各模式下哪些内容会离开您的计算机。
Claude Code 围绕单一供应商的模型构建。您可以使用付费账户登录,也可以设置 ANTHROPIC_API_KEY;此时 Claude Code 会提示您一次以批准该密钥,而不会打开浏览器。第二种方式适用于无头服务器。已经在其他平台购买容量的组织,可以通过 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 路由请求。官方文档建议使用 Ollama 的 Anthropic 兼容 API,将其指向本地模型;代价是无法使用 Claude 本身。
Omnigent 需要底层 harness 所需的全部内容,并由 omnigent setup 收集。它支持 API 密钥、现有 CLI 订阅、兼容 OpenAI 或兼容 Anthropic 的网关,以及 Databricks 工作区。这就是使用元 harness 的实际成本:一台计算机会保存每个供应商的凭据。在让这台计算机接入公网之前,请阅读如何防止 AI 代理接触机密信息。
截至 2026 年 8 月,每个项目的成熟度如何?
Claude Code 自 2025 年起已正式可用。2026 年 10 月 29 日,最新的变更日志条目为 2.1.312,它仍处于 2.1.x 系列。它会在后台自动更新,提供 latest 和 stable 发布渠道,发布经过 GPG 签名的版本清单,并记录了适用于需要设定最低版本组织的 minimumVersion。这表明该产品已经有人在生产环境中运行。
Omnigent 自 2026 年 6 月起对外发布,目前仍处于 0.x 系列。2026 年 10 月 29 日,PyPI 上的最新版本为 0.20.0,于 10 月 28 日上传。PyPI 将这些编号版本(从 0.1.0 起)列为普通版本,而不是预发布版本;候选版本则单独发布。尽管如此,README 仍将该项目标记为 alpha。预计 harness 列表和 YAML schema 仍会持续变化。它已经可以使用,但尚未稳定。
DeepSeek Harness 的发布时间明显最晚。它于 2026 年 8 月发布,比本比较的第一个版本早几天。其 README 明确承诺会进行破坏兼容性的变更。截至 2026 年 10 月 27 日,发布到 npm 的每个构建版本仍然是预发布版本。非常高的 star 数量只能说明很多人正在关注它,无法说明 plugin API 是否已经稳定。
各工具采用何种许可证?
DeepSeek Harness 采用 MIT 许可证,第三方许可证已在 THIRD_PARTY_NOTICES.md 中披露。Omnigent 采用 Apache 2.0 许可证。Claude Code 并非开源软件:它是 Anthropic 的商业产品,使用该工具调用 Anthropic 模型需要付费计划、计费 API 访问权限或受支持的云服务商。如果您的需求是能够阅读并修补每一行代码,那么在进行任何功能对比前,Claude Code 均不符合要求。如果您的需求是该工具在未来无需人工干预即可持续运行,那么该需求则指向了另一个方向。
在 VPS 上运行每个工具需要什么条件?
Claude Code 是三者中最简单的工具。安装并登录后,在 tmux 中运行它,使会话在 SSH(安全 Shell)连接中断后仍能继续。Anthropic 要求使用 4 GB 或更多 RAM(随机存取内存),以及 x64 或 ARM64 处理器;操作系统需为 Ubuntu 20.04 或更高版本、Debian 10 或更高版本,或 Alpine 3.19 或更高版本。在 Alpine 上,还必须先安装 bash 和 curl,否则安装命令会因 not found 错误而失败。在 VPS 的 tmux 中运行 Claude Code详细介绍了会话管理。
DeepSeek Harness 需要 Node.js,以及一个指向其 Web UI 的浏览器。README 要求使用 Node.js,但未指定最低版本。2026 年 10 月 27 日,仓库根目录中的 package.json 声明了 >=24.9.0;此前带标签的版本使用的是 ^22.19.0 || >=24.0.0 范围。因此,Node 22 已不再足够,稳妥的选择是 Node 24.9 或更高版本。不要公开发布端口 3080。让服务器监听 127.0.0.1,然后从笔记本电脑转发该端口:
ssh -N -L 3080:127.0.0.1:3080 you@your-vps随后在本地浏览器中打开打印出的 URL dsh,其中包括令牌。通过 SSH 运行时,它不会尝试替您打开浏览器。在 VPS 上完整安装 DeepSeek Harness介绍了配置文件布局和插件命令。
Omnigent 的资源占用最高,因为它会安装并管理其他开发者提供的 CLI。它要求在同一台主机上安装 Python 3.12、uv、git、Node.js 22、npm、pnpm、tmux 和 bubblewrap,某些供应商的 CLI 还需要单独安装。对于原生 Kiro,首先安装并登录 kiro-cli:如果 CLI 不在 PATH 中,启动器就会失败,除非将 OMNIGENT_KIRO_PATH 指向该 CLI。其 README 说明,可以通过设备的 LAN 地址从手机打开本地 UI。因此,在 VPS 上不要假设端口 6767 是私有的:在防火墙中阻止该端口,并用相同方式转发:
ssh -N -L 6767:127.0.0.1:6767 you@your-vps对于供其他人使用的服务器,受支持的方式是在 deploy/ 下使用 Docker 部署;该方式默认启用多用户账户。手动启动服务器时,设置 OMNIGENT_AUTH_ENABLED=1 也可以启用相同的行为。OIDC(OpenID Connect)登录支持 Google、GitHub、Okta 和 Microsoft。Omnigent 多代理 Harness 指南介绍了沙箱提供程序;一旦代理开始写入磁盘,这些提供程序就会变得重要。
为什么服务器的公网 IP 地址无法显示 Web UI?
将 Web 框架绑定到公网地址并开放端口是常见的做法,但这两者在此场景下的表现不同。DeepSeek Harness 现在禁止了这种高风险操作:其 --host 标志仅接受一个具体的本地地址,启动时会拒绝 0.0.0.0 这样的通配符。其生成的 URL 包含一个进程令牌,该令牌与已签名的会话 Cookie 一起验证每个 API 调用,这意味着在明文 HTTP 下,令牌会在网络中以未加密状态传输。Omnigent 的裸机本地服务器默认关闭了多用户账户,因此开放 Omnigent 端口等同于在 VPS 上开放了一个 Shell。
第二个导致故障的原因是浏览器的一项规则,这常令用户感到意外。crypto.randomUUID() 仅在安全上下文中定义,即 HTTPS(超文本传输安全协议)、localhost 或 127.0.0.1。在 2026 年 8 月撰写此对比时,通过 http://203.0.113.10:3080 等明文地址加载 DeepSeek Harness UI 会导致浏览器控制台报错:
TypeError: crypto.randomUUID is not a function页面随后仅部分渲染或完全无法显示,因为会话创建在绘图前就已失败。服务器端并未损坏,日志也显示请求正常。由于浏览器不信任该源,前端依赖的函数未被定义。SSH 隧道无需证书即可规避此问题,因为 127.0.0.1 被视为安全上下文。使用持有真实 TLS(传输层安全)证书的反向代理同样有效,且能防止 dsh 启动令牌在网络中传输;而在 Omnigent 前端,你还必须自行开启身份验证。
哪一个适合您?
如果您希望立即使用编码代理,愿意向 Anthropic 付费,并且平时就在终端中工作,请选择 Claude Code。三者中,只有它是已经完成的商业产品,而不是预览版。
如果插件模型才是重点:您希望替换模型适配器、沙箱或代理循环,并且接受所面向的接口会发生变化,请选择 DeepSeek Harness。它的提供商目录涵盖 Anthropic 和 OpenAI,因此选择它意味着押注其运行时,而不是押注 DeepSeek 的模型。
如果您已经运行多个代理 CLI,而实际问题是协调,请选择 Omnigent:包括策略、沙箱、使用第二家供应商的模型进行审查,以及供其他人查看的共享会话。它会在您的技术栈中增加一层,而不需要的层就可能成为故障点。如果您的协调需求没有那么复杂,那么在同一台机器上运行两个 Claude Code 会话即可相互发送消息,无需在中间加入编排器。
如果您仍在筛选,Mimo Code AI 编码代理与 Claude Code 同属终端代理类别;无论您选择哪一个,都值得阅读在一次性 VM 中运行编码代理,因为这三个工具都不会自行确保粗心的 rm -rf 安全。三者也都不会决定代理提出的差异有多大;这属于提示词层面的问题。因此,无论您最终采用哪种 harness,都值得叠加使用促使代理采用可行的最小改动的 skill。
FAQ
使用 Claude Code 是否需要付费的 Anthropic 计划?
对于 Anthropic 的模型,需要付费计划或受支持的云提供商。Anthropic 的设置文档说明,Claude Code 需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账户,免费的 Claude.ai 计划不包含访问权限。具备其他平台容量的组织可以改用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。在无头 VPS 上,首次运行前设置 ANTHROPIC_API_KEY:随后 Claude Code 会提示您一次以批准该密钥,而不是尝试打开浏览器。Ollama 记录了另一种方式,即使用 ollama launch claude,通过 Ollama 兼容 Anthropic 的 API,让 Claude Code 使用本地模型运行,无需 Anthropic 凭据;但此时执行任务的模型不是 Claude。
DeepSeek Harness 能运行 Claude 或 OpenAI 模型吗?
可以。已安装的提供商目录包含 Anthropic 和 OpenAI 等提供商。您可以在 Settings,然后 Models 中为每个提供商添加密钥。目录之外的提供商需要作为自定义提供商添加,并且必须包含小写的提供商 ID、基础 URL、API 协议、凭据和至少一个模型。目录还列出了不使用原生密钥身份验证的提供商,例如 openai-codex。除非配置文件明确指定凭据引用,否则这些提供商不会显示密钥字段(截至 20 October 2026 检查)。密钥存储在 $DSH_HOME/.credentials.yaml 中,而配置文件的 cordis.patch.yml 只保存引用。因此,请单独备份凭据文件,并将其排除在版本控制之外。
Omnigent 会取代 Claude Code 吗?
不会。Omnigent 运行 Claude Code。它的执行框架列表包含 Claude、Codex、Cursor、OpenCode、Hermes 和 Pi。代理在其 YAML 文件中使用一行 harness: 即可选择其中一个。您仍需为底层 CLI 完成身份验证,某些供应商的 CLI 还要求您单独安装。Omnigent 在此基础上增加编排、策略和沙箱功能。因此,只有在运行多个代理或多个供应商时,使用它才值得增加这些依赖项。
为什么 DeepSeek Harness 的 Web 界面在服务器公网 IP 地址上显示为空白?
在 August 2026,原因是普通 HTTP 来源不属于安全上下文,因此 crypto.randomUUID() 未定义,浏览器控制台报告了 TypeError: crypto.randomUUID is not a function。会话创建失败,所以页面只显示部分内容或完全无法显示,而服务器日志看起来正常。当前版本还会拒绝通配符 --host,并将进程令牌放入打印出的 URL 中,因此仅打开裸地址无法登录。使用 ssh -N -L 3080:127.0.0.1:3080 you@your-vps 通过 SSH 转发端口,然后在 http://127.0.0.1:3080 打开打印出的 URL,因为回环地址属于安全上下文。使用带有真实 TLS 证书的反向代理也可以,并且可避免启动令牌以明文形式通过网络传输。
这些执行框架需要 VPS 具备多少 RAM?
Anthropic 文档建议 Claude Code 使用 4 GB 或更多内存。对于 DeepSeek Harness 和 Omnigent,应实际测量,而不要凭经验估算。使用远程模型时,执行框架本身负责进程管理和文件操作,而不是执行推理;托管本地模型还会增加自身的内存需求。服务器规格真正取决于代理在服务器上执行的工作,例如构建和测试套件。Omnigent 的要求最高,因为 Python、Node.js、tmux 以及您启用的每个供应商 CLI 都在同一台机器上运行。