📚 系列导航：上一篇 DeepSeek Harness 是什么教程 已经解释 Harness 与模型的关系；本篇拆解 DeepSeek Harness、Claude Code 和 Pi 的架构区别；下一篇 DeepSeek Harness 快速上手教程 会从启动 Web UI 开始跑通第一个任务。
DeepSeek Harness 与 Claude Code、Pi 的核心区别是：Claude Code 提供一套完整 Coding Agent 产品，Pi 提供可以直接使用和深度改造的极简终端工作台，DeepSeek Harness 则把模型、工具、会话、安全和界面拆成插件，让开发者重新组装 Agent。 这不是模型能力排名，而是三种产品责任和扩展边界的区别。
DeepSeek Harness、Claude Code 和 Pi 的产品定位
先看三者“交付给用户的东西”是什么。Claude Code 交付已经组织好的工作循环，Pi 交付一个保持小核心的可编程终端 Agent，DeepSeek Harness 交付用于搭建 Agent 的插件化运行框架。
| 核心维度 | Claude Code | Pi | DeepSeek Harness |
|---|---|---|---|
| 产品形态 | 完整 Coding Agent 产品 | 极简、可改造的终端工作台 | 插件化 Agent 搭建平台 |
| 默认能力 | 官方组织好模型、工具、会话和交互 | 默认提供 read、write、edit、bash | 由 Profile、Agent Preset 和插件组合 |
| 主要使用者 | 想直接完成开发任务的用户 | 想定制个人终端工作流的用户 | 想实验或搭建 Agent 系统的开发者 |
| 扩展方向 | 在统一产品上增加能力 | 从小核心向外扩展 | 替换和重组组成部分 |
Claude Code 是完整 Coding Agent 产品
Claude Code 把理解项目、使用工具、修改文件、执行命令、管理会话和控制权限组织成统一体验。用户可以增加 CLAUDE.md、Skills、MCP、Hooks、子 Agent 和插件，但通常不需要先理解内部组件怎样挂载，具体机制可查看 Claude Code 官方工作原理。
Pi 是极简可编程终端 Agent
Pi 安装后可以直接工作，默认只给模型四个基础工具，再通过 Skills、提示模板、TypeScript Extensions 和 Pi Packages 增加能力。它的重点不是预装最多功能，而是让个人用户能从简单核心出发，具体工具和扩展范围见 Pi Coding Agent 官方 README。
DeepSeek Harness 是插件化 Agent 平台
DeepSeek Harness 随发行版提供 Web 和 Headless Profile，但两者仍由同一套插件能力组合。官方架构明确说明不存在需要扩展者打补丁的特权内核，模型适配器、工具、会话日志和 Agent Loop 都可以进入组合树，详见 DeepSeek Harness 官方架构说明。
三种 Agent 架构由谁决定默认工作方式
Claude Code 由产品方预先确定主要工作循环和交互方式；Pi 刻意少做决定，把不少高级能力留给扩展；DeepSeek Harness 则让搭建者在配置与插件层决定整个运行组合。
这会直接改变使用成本。Claude Code 的默认方案最多，你主要学习怎样使用和配置；Pi 要决定安装哪些扩展、怎样组织个人工作台；DeepSeek Harness 还要决定模型提供方、会话、工具呈现、安全组件和 UI 怎样组合。
因此，“可配置项更多”不自动等于日常任务更省事。决定权越深，越需要测试、版本管理和回滚方案；如果目标只是打开终端修复 Bug，没必要先把整个 Agent 架构重新设计一遍。
Claude Code、Pi 和 DeepSeek Harness 能扩展到多深
三者都支持扩展，但扩展发生在不同层级。Claude Code 重点是在统一 Agent Loop 上增加项目规则、外部服务和自动化；Pi 允许 Extensions 替换工具、界面、模型提供方、上下文整理和任务流程；DeepSeek Harness 则把通常被视为核心的能力本身也做成 Cordis 插件。
| 改造层级 | Claude Code | Pi | DeepSeek Harness |
|---|---|---|---|
| 项目规则和知识 | CLAUDE.md、Skills | AGENTS.md、Skills、提示模板 | Skills、提示词插件、上下文插件 |
| 外部工具与服务 | MCP、插件、Hooks | Extensions、Pi Packages | 工具插件、MCP 与能力提供方 |
| 界面和任务流程 | 在官方扩展边界内组合 | Extensions 可增加或替换终端 UI | Web UI 也属于插件树的一部分 |
| 会话、执行和 Agent Loop | 核心产品保持统一 | 可从轻量核心深度改造 | 对应能力本身可以替换或重组 |
这里最容易混淆的是“插件”这个词。Claude Code 插件主要打包 Skills、Hooks、子 Agent 和 MCP 等扩展；Pi Extension 可以直接注册工具、事件和 UI；DeepSeek Harness 插件还承担服务定义、提供方、消费者和生命周期组合。名称相同，不代表改造深度相同。
三种 Coding Agent 的安全责任如何划分
安全差异不能只看“有没有权限按钮”，还要看谁负责执行边界。Claude Code 把权限模式和文件检查点作为产品能力；Pi 明确不内置沙箱；DeepSeek Harness 提供沙箱与审批组件，但最终保护程度取决于实际组合和宿主后端。
Claude Code 权限与检查点
Claude Code 会根据权限模式决定哪些文件修改或命令可以直接运行、哪些需要询问，并在编辑前建立文件检查点。检查点只覆盖文件变化，无法撤销数据库、部署或外部 API 副作用；详细边界应以 Claude Code 权限文档 为准。
Pi 为什么没有内置沙箱
Pi 的内置工具和 Extensions 使用启动 Pi 的本机用户权限。项目 Trust 只控制是否加载项目设置与扩展，不会把不可信代码变安全；官方建议对不可信项目和无人值守任务使用容器、虚拟机或系统级沙箱，详见 Pi 官方安全说明。
DeepSeek Harness 沙箱和审批边界
DeepSeek Harness 提供 read-only、workspace-write 和 danger-full-access 文件效果模式，以及一次性用户审批。沙箱只定义文件系统效果，网络和进程可见性不属于这三个模式；平台后端还可能报告 partial 强制状态，所以部署方必须核对实际边界，而不是只看模式名称。
日常使用界面和协作方式有什么区别
Claude Code 提供终端、IDE、桌面、Web、远程和自动化入口，并尽量保持相同 Agent 工作循环。Pi 以终端交互为中心，同时提供打印、JSON 事件、RPC 和 SDK 等程序化入口。DeepSeek Harness 当前随附 Web 与 Headless Profile，前者适合查看工作区、会话和审批，后者适合一次性任务。
如果你关心“每天打开就写代码”，应重点比较交互节奏、会话恢复、工具可见性和权限提示。如果你关心“怎样做一个不同形态的 Agent 产品”，DeepSeek Harness 的 Profile、Preset 和 UI 插件树才是关键。
这也解释了为什么不能只用功能数量打分。Pi 没把计划模式、子 Agent 或权限弹窗固定在核心里，是它的架构选择；DeepSeek Harness 把同类能力拆成插件，也不等于所有自定义组合都会自动拥有官方 Web Profile 的完整体验。
模型与供应商选择方式有什么区别
Claude Code 围绕 Claude 模型设计，产品和模型之间的提示、工具与交互更统一。Pi 把多模型切换作为日常功能，内置多家提供方和本地模型入口；DeepSeek Harness 同样支持 DeepSeek、目录提供方和自定义兼容端点，但把模型路由放进可替换的 LLM 能力层。
DeepSeek Harness 的通用多提供方适配器使用 @earendil-works/pi-ai，但这不代表 DSH 就是 Pi 的 Web 版本。它只复用模型连接层；会话、工具执行、沙箱、审批、Agent Preset 和 UI 仍属于 DeepSeek Harness 自己的组合，具体实现可查看 DSH 的 llm-pi-ai 包。
支持同一个模型也不代表得到同样结果。系统提示词、工具 Schema、上下文投影、权限和执行策略都会改变模型实际看到的任务环境；跨 Harness 对比时，应固定模型、工作区、任务和验收标准。
如何判断是否需要 DeepSeek Harness
判断标准不是“哪个工具更强”，而是你要控制到哪一层。想直接完成真实项目，优先评估成熟产品的默认工作流；想打造个人终端工作台，关注轻量核心和扩展维护；想替换 Agent 组成、实验运行机制或构建团队平台，再考虑 DeepSeek Harness 的深层组合能力。
可以按下面三步做决定：
- 写下目标是“完成编码任务”“定制个人工作台”还是“搭建 Agent 平台”。
- 列出必须控制的层级：模型、工具、会话、安全、Agent Loop、界面和部署入口。
- 估算谁负责升级、兼容测试、安全评估和故障回滚。
如果你只需要少配置地处理日常代码，DeepSeek Harness 的维护成本未必能转化为收益。如果团队要做内部 Agent、替换工具执行环境、研究新的会话机制或开发插件化界面，这些额外治理成本才可能是必要投入。
常见问题
DeepSeek Harness 是 DeepSeek 版 Claude Code 吗？
不是简单复刻。两者都能让模型读写文件和运行命令，但 Claude Code 首先是统一产品，DeepSeek Harness 首先是可重新组合的 Agent 运行框架。
DeepSeek Harness 和 Pi 是什么关系？
DeepSeek Harness 的通用模型适配器使用 Pi 项目的 pi-ai 库，但 DSH 还有独立的 Cordis 插件树、会话、工具、安全和 Web 运行组合。复用连接库不等于两个产品采用相同架构。
Pi 的 Project Trust 等于沙箱吗？
不等于。Project Trust 控制项目设置和扩展是否加载；Pi 官方明确说明它不会限制内置工具和命令的本机权限。
三者可以同时使用吗？
可以。它们可以分别承担成熟日常工作、个人工作流实验和 Agent 平台开发；关键是不要让多个工具在同一目录无协调地同时修改文件。
理解产品边界后，下一步跟着 DeepSeek Harness 安装与启动教程 跑通默认 Web Profile，再决定是否值得继续学习 Preset、Code Mode 与插件开发。