Claude Code(AI IDE 平台市场研究)
1. 介绍
Claude Code 是 Anthropic 于 2025 年推出的智能体编码工具,也是本组六个平台中把 Harness 工程细节披露得最完整的一个。Anthropic 不仅在产品层面提供了规则文件、技能、钩子、子智能体与沙箱,还在工程博客中系统公开了上下文工程、长时运行 Harness 设计与沙箱架构的设计理由与量化效果。这使 Claude Code 成为研究「什么是好的 Harness」的最佳样本。
Anthropic 官方对自身的定位表述是:Claude Agent SDK 是 "a powerful, general-purpose agent harness"。这一措辞的意义在于,它把「Harness」从一个社区词汇变成了厂商产品定义中的正式名词——AI IDE 的竞争焦点随之从模型能力外移到承载层设计。
1.1. 开发商与产品沿革
| 项目 | 内容 |
|---|---|
| 开发商 | Anthropic |
| 首发 | 2025-02-24,以 limited research preview 形式与 Claude 3.7 Sonnet 同日发布,被定义为 "our first agentic coding tool" |
| 转正式可用 | 2025-05-22,随 Claude 4 系列发布转为正式可用 |
| 形态演进 | 终端 CLI 起步,逐步扩展至 IDE 集成、桌面端、Web 与代码托管平台集成 |
| 官方 Harness 文献 | 上下文工程、长时运行双智能体 Harness、长时运行应用开发三智能体 Harness、沙箱架构、Agent Skills 五篇工程博客构成完整体系 |
1.2. 定位与最新版本
Claude Code 的定位是终端优先、以长时自主任务见长的编码智能体。它的能力边界被官方描述为:搜索与阅读代码、编辑文件、编写并运行测试、提交并推送到代码托管平台、使用命令行工具。与编辑器型工具的区别在于:Claude Code 的默认工作假设是「任务可能持续数十分钟到数小时」,因此在上下文压缩、状态交接与权限治理上的投入明显更高。
最新版本与版本号属高频变动信息,撰写时未取得可核验的当期版本号,记为 [待填写]。可确认的版本相关事实是:凭据保护能力需要 v2.1.187 及以上(deny 模式)与 v2.1.199 及以上(mask 模式)。
1.3. 定价体系
Claude Code 不单独定价,而是包含在 Claude 的订阅体系中,与其余 Claude 产品共享同一用量池。以下价格来自第三方对官方定价页的核对,标 :
| 档位 | 价格 | 与 Claude Code 的关系 |
|---|---|---|
| Free | $0 | 不含 Claude Code |
| Pro | $20/月(年付约 $17/月) | 含 Claude Code,用量额度面向个人开发者 |
| Max 5x | $100/月 | 约 Pro 的 5 倍额度 |
| Max 20x | $200/月 | 约 Pro 的 20 倍额度,优先访问新功能 |
| Team 标准席 | 约 $25/席/月(年付约 $20) | 席位能力视档位而定,部分口径称标准席不含完整 Claude Code |
| Team 高级席 | 约 $100—$125/席/月 | 含完整 Claude Code 能力 |
| Enterprise | 定制 | 含全部能力与企业级合规选项 |
按 API 直接计价时的单价同样来自第三方核对(Opus 档约 $5/MTok 输入、$25/MTok 输出;Sonnet 档约 $3 / $15;Haiku 档约 $1 / $5),标 。
计费结构的工程含义:订阅制让长任务的成本可预测——一个跑飞的智能体循环不会带来意外账单,而在按 token 计费的模式下这是真实风险。这是团队在「长时任务」场景下应优先考虑订阅制而非纯 API 计费的直接理由。
2. 名词解释
| 术语 | 英文 / 缩写 | 释义 |
|---|---|---|
| 项目记忆文件 | CLAUDE.md | 存放项目约定的 Markdown 文件,作为持久上下文在会话启动时加载;支持按目录层级就近生效 |
| 就近加载 | Proximity Loading | 规则文件沿目录树向上搜集、向下覆盖的机制,子目录的 CLAUDE.md 会覆盖父目录同名约定,使上下文与当前工作对象对齐 |
| 技能 | Skills | 含 SKILL.md 的可复用能力包,采用三层渐进式披露:启动只加载名称与描述,命中时加载正文,按需加载附带脚本与参考文件 |
| 渐进式披露 | Progressive Disclosure | 能力不在启动时全量进入上下文,而是按需要逐层载入,使可捆绑的知识量实际上不受限 |
| 钩子 | Hooks | 在工具调用生命周期事件(如执行前、编辑后、会话开始/结束、压缩前)触发的外部脚本,可拦截、修改或记录行为 |
| 子智能体 | Subagents | 拥有独立上下文窗口、独立系统提示与工具白名单的下级智能体,只向主会话回传约 1,000—2,000 tokens 的浓缩摘要 |
| 斜杠命令 | Slash Commands | 以 /名称 显式调用的可复用工作流定义 |
| 计划模式 | Plan Mode | 先产出实现方案、经人工确认后再执行,用于在动手前锁定策略 |
| 权限规则 | Permissions | 以允许 / 拒绝 / 询问三类规则构成的策略集,可按工具与参数模式匹配 |
| 沙箱 | Sandbox | 操作系统级进程隔离,限制可写路径与网络访问;macOS 用 Seatbelt,Linux / WSL2 用 bubblewrap + socat |
| 沙箱运行时 | Sandbox Runtime | 把整个 Claude Code 进程(含内置工具、MCP 服务器与钩子)包进同一层隔离的流程级沙箱 |
| 自动允许模式 | Auto-allow | 沙箱化命令自动批准,不再逐条提示的权限模式 |
| 严格沙箱模式 | Strict Sandbox Mode | 关闭「以关闭沙箱方式重试」逃生舱的模式,通过 allowUnsandboxedCommands: false 配置 |
| 凭据保护 | Credentials Protection | 通过 sandbox.credentials 拒绝或掩码指定文件(如 ~/.aws/credentials)与环境变量(如 GITHUB_TOKEN) |
| 上下文压缩 | Compaction | 接近窗口上限时把历史摘要化,保留关键约束与决策 |
| 上下文重置 | Context Reset | 直接清空上下文重开白板,代价是需要完整的交接产物 |
| 交接产物 | Handoff Artifacts | 跨会话传递状态的载体,如进度文件、git 历史与功能清单 |
| 自评偏差 | Self-Evaluation Bias | 智能体评估自身产出时倾向于自信称赞、即便质量明显平庸的现象 |
3. 功能说明
3.1. 会话与工作流能力
| 能力 | 说明 | Harness 层位 |
|---|---|---|
| 代码库检索与阅读 | 搜索、阅读、理解整个仓库 | L1 |
| 多文件编辑 | 协调修改跨文件的实现 | L2 + L3 |
| 测试编写与运行 | 写测试、跑测试、根据失败迭代 | L5(机械判据) |
| 版本控制操作 | 提交、推送、创建 PR | L2 + L6 |
| 计划模式 | 先产出方案再执行 | L3 |
| 上下文压缩 | 手动或自动摘要化历史 | L1 |
| 会话恢复与继续 | 从历史会话恢复上下文 | L4 |
3.2. 扩展机制
Claude Code 提供五个互补的扩展点,这是其作为 Harness 的核心可塑性来源:
| 扩展点 | 作用 | 层位 |
|---|---|---|
CLAUDE.md 与规则 | 注入项目约定,按目录层级就近生效 | L1 |
技能 /skills | 可复用、可打包、可携带独立工具权限集的工作流,按需加载 | L1 + L2 |
子智能体 /agents | 专职化的独立智能体,拥有自己的系统提示、工具白名单与记忆 | L3 |
| 钩子 | 生命周期事件上触发外部脚本,用于自动格式化、强制门禁、审计留痕 | L6 + L5 |
| MCP | 接入外部系统与数据源,本地走 stdio、远程走 Streamable HTTP | L2 |
技能的渐进式披露机制尤其值得注意:官方表述为「可捆绑进一个技能的上下文量实际上是无限的」,因为启动时只把名称与描述载入系统提示。这解决了 L1 层最典型的矛盾——既要让智能体知道团队有哪些能力,又不能让这些能力的全文常驻窗口。
3.3. 执行环境
| 环境 | 代码运行位置 | 适用 |
|---|---|---|
| 本地 | 本机,完整访问文件与工具 | 默认;配合沙箱使用 |
| 云端 | Anthropic 托管环境 | 长时任务、无需本地克隆的仓库、并行作业 |
| 远程控制 | 本机执行,浏览器或 Web 界面驱动 | 需要 Web 界面但要求执行留在本地 |
4. 平台架构
4.1. 总体架构
图 4-1|Claude Code 五层总体架构(上下文装配 → 状态层)
数据来源:基于本文分析绘制的示意图。
| 组件 | 职责 |
|---|---|
| 上下文装配层 | 搜集 CLAUDE.md 层级、技能索引、当前文件内容与对话历史,装配每次请求 |
| 工具执行层 | 文件读写、命令执行、搜索、网络、MCP 调用,均在权限与沙箱双重约束下执行 |
| 权限与沙箱运行时 | 决定「能不能做」(权限规则)与「做到哪里为止」(沙箱边界) |
| 编排层 | 计划模式、待办列表、子智能体派发与结果回收 |
| 状态层 | 会话记录、记忆文件、检查点与 git 历史 |
这五层与本项目的 Harness 六层模型几乎一一对应,是本组六个平台中对应关系最清晰的一个。
4.2. 上下文装配与就近加载
CLAUDE.md 的就近加载机制是本平台的标志性设计。其行为可概括为三条:
- 沿目录树向上搜集:从当前工作目录向上,依次收集各级
CLAUDE.md与用户级记忆文件。 - 就近覆盖:子目录的规则覆盖父目录的同名约定,使上下文与当前编辑对象对齐。
- 引用式扩展:规则文件可引用更深层文档,只在需要时载入。
工程含义是:上下文的层级与代码库的层级同构。开发者在哪个目录工作,就自动获得哪一层级的约定——这比把所有约定平铺进一个文件更节省窗口,也更符合「上下文是稀缺资源」这一前提。
Anthropic 官方给出的上下文管理四策略与本平台的对应关系:
| 官方策略 | 在本平台的落点 |
|---|---|
| 压缩(Compaction) | 手动压缩与自动压缩;最安全轻量的一档是清理工具回显 |
| 结构化笔记(Structured Note-taking) | 会话内待办列表、进度文件、记忆文件 |
| 记忆工具(Memory Tool) | 随模型版本在开发者平台提供( 当前状态) |
| 子智能体架构(Sub-agent) | 子智能体可用数万 token 深入探索,只回传 1,000—2,000 tokens 摘要 |
官方同时给出调优顺序:先最大化召回,再提升精度。顺序反了会丢掉后续还要用的关键约束——这是压缩功能最常见的误用。
4.3. 沙箱与权限运行时
这是 Claude Code 披露最完整、也最值得作为行业基准的部分。
| 维度 | 实现 |
|---|---|
| 文件系统隔离 | macOS 用 Seatbelt;Linux / WSL2 用 bubblewrap + socat,可选 seccomp 过滤器;WSL1 不支持;不支持原生 Windows |
| 默认写入范围 | 沙箱内命令只能写当前工作目录与会话临时目录($TMPDIR 被设为该目录);读取默认全机可读,被拒目录除外 |
| 网络隔离 | 只能经 unix domain socket 连接沙箱外运行的代理服务器;新域名首次请求时提示批准 |
| 权限模式 | 自动允许(沙箱化命令自动批准)/ 常规权限(仍逐条提示) |
| 自动允许下的保留拦截 | deny 规则、针对 / 或主目录的 rm -rf 类命令、内容范围的 ask 规则仍然生效 |
| 逃生舱 | dangerouslyDisableSandbox 重试;可用 allowUnsandboxedCommands: false 关闭,即严格沙箱模式 |
| 凭据保护 | sandbox.credentials 可 deny 或 mask 指定文件与环境变量;deny 需 v2.1.187+,mask 需 v2.1.199+ |
| 流程级沙箱 | @anthropic-ai/sandbox-runtime 把整个进程(含内置工具、MCP 服务器、钩子)包进同一层隔离;默认拒绝写 .git/hooks、.git/config、.mcp.json、.claude/commands、.claude/agents 与 shell 启动文件 |
| 配置路径 | .claude/settings.local.json(项目级)、~/.claude/settings.json(用户级)、托管配置(组织级) |
| 硬失败开关 | sandbox.failIfUnavailable 可设为沙箱不可用时直接失败而非降级 |
两条官方论断值得单独引用:
- 文件系统隔离与网络隔离缺一不可:只有网络隔离,被攻陷的智能体可以外传 SSH 密钥;只有文件系统隔离,被攻陷的智能体可以轻易逃逸并获取网络访问。
- 默认拒绝写
.claude/commands、.claude/agents与 shell 启动文件:这三条针对的是「智能体改写自己的指令」与「注入持久化后门」两类攻击路径,是同类产品中少见的防御深度。
5. Harness 设计
5.1. L1 上下文工程层
| 机制 | 说明 |
|---|---|
| 就近加载的规则层级 | 上下文与代码库层级同构 |
| 技能的渐进式披露 | 名称与描述常驻,正文命中才载入,附带文件按需读取 |
| 子智能体上下文隔离 | 子智能体消耗独立窗口,主会话只接收 1,000—2,000 tokens 摘要 |
| 上下文压缩 | 手动与自动双通道,支持先召回后精度的调优顺序 |
| 技能内可执行代码 | 代码不进入上下文即可运行,用确定性换取 token 与可复现性 |
官方对上下文腐烂的界定是「性能梯度,而非硬性悬崖」——这意味着上下文问题不会以「报错」的形式出现,而是以「智能体慢慢变笨」的形式出现,因此必须主动治理。
实践要点:把 CLAUDE.md 写成「地图」而非「百科全书」。Anthropic 在长时运行实践中给出的对照是:把指令文件从百科全书改为目录,约 100 行注入上下文,真正的知识放在结构化的 docs/ 中——给智能体一张地图,而不是一本一千页的说明书。
5.2. L2 工具与执行层
| 工具 | 隔离与确认机制 |
|---|---|
| 文件读写 | 受沙箱写入范围约束;关键路径(.git/hooks 等)默认拒写 |
| 命令执行 | 沙箱内执行;网络经代理且新域名需批准 |
| MCP 服务器 | 与内置工具、钩子一同被包进流程级沙箱 |
| 凭据与环境变量 | 可被显式 deny 或 mask |
| 网络访问 | 经沙箱外代理,逐域名批准 |
设计原则的官方表述:工具应「自包含、对错误健壮、用途极其明确」,避免功能过载与决策点含糊。另有公开的旁证显示,削减工具数量可同时提升准确率与降低消耗——工具界面本身就是 Harness 设计的一部分,不是中性的。
5.3. L3 编排与控制层
| 机制 | 说明 |
|---|---|
| 计划模式 | 先产出方案再执行,锁定策略 |
| 待办列表 | 会话内显式维护任务状态 |
| 子智能体派发 | 专职子智能体在干净窗口内深度工作,只回传摘要 |
| 钩子拦截 | 可在退出尝试时拦截并重新注入目标,迫使智能体继续工作 |
| 会话恢复 | 从历史会话恢复上下文继续任务 |
| 中断与人工接管 | 随时中断并接管,权限提示构成天然的人机交接点 |
Anthropic 官方对长时运行任务给出的两条经验值得照搬:
- 每次会话开场三步走:确认当前目录 → 读取进度文件与提交历史 → 从功能清单中挑选最高优先级的未完成项。
- 在动手实现新功能前先跑一遍端到端测试确认环境健康:模型倾向于在没有充分测试的情况下就宣布功能完成,对策是给它浏览器自动化工具,让它像真人一样验证。
5.4. L4 记忆与状态层
| 组件 | 持久化范围 | 用途 |
|---|---|---|
| 记忆文件与规则 | 随仓库版本化 | 项目约定跨会话保留 |
| 待办列表 | 会话内 | 里程碑与进度显式化 |
| 检查点 | 会话内 | 可回滚到此前状态 |
| git 历史 | 仓库级 | 最可靠的状态交接载体 |
| 进度文件 | 仓库内文件 | 跨会话交接(长时运行实践中的标准产物) |
Anthropic 对跨窗口交接难题的表述是:把它想象成「由工程师轮班工作的软件项目,每位新工程师上班时对前一班发生的事情毫无记忆」。解法不是让智能体记住一切,而是把状态外化到文件与版本历史中——这与 L1 的「外化状态」策略是同一条原则在 L4 上的延续。
官方同时坦承了一个开放问题:单个通用编码代理是否总是最优,还是拆成测试、QA、清理等专职代理的多代理架构更好——目前尚不清楚。
5.5. L5 评估与观测层
| 机制 | 说明 |
|---|---|
| 测试作为机械判据 | 写代码后运行测试,失败则迭代;这是编码场景天然的二值判据 |
| 浏览器自动化验证 | 给智能体浏览器工具,让它像真人一样验证前端行为 |
| 评估者与被评估者分离 | 独立评估者远容易调教成怀疑者,而让生成器自我批判很难 |
| 轨迹与用量观测 | 记录调用与消耗,用于成本归因( 具体产品形态) |
最重要的 L5 设计原则是评估者与被评估者分离。官方观察到:让智能体评估自己的作品时,它会「自信地称赞」——即便人类观察者眼中质量明显平庸;这在缺乏二值判据的主观任务上尤其突出。分离之后,「把一个独立的评估者调教得怀疑,远比让生成器自我批判容易得多」。这一设计被官方类比为生成对抗网络。
评分维度建议采用硬阈值制:产品深度、功能性、视觉设计、代码质量各设阈值,任一项低于阈值即判该轮失败,并把详细失败原因回传给生成器。
5.6. L6 治理与安全层
| 治理维度 | 实现 |
|---|---|
| 权限模型 | 允许 / 拒绝 / 询问三类规则,可按工具与参数模式匹配,三级配置(项目 / 用户 / 组织托管) |
| 进程隔离 | 文件系统 + 网络双重隔离,流程级沙箱覆盖内置工具、MCP 与钩子 |
| 凭据保护 | 文件与环境变量可 deny 或 mask |
| 自主度调节 | 自动允许 / 常规权限两档;严格沙箱模式可关闭逃生舱 |
| 组织级策略 | 托管配置由组织下发,个人不可覆盖 |
| 关键路径保护 | 默认拒写 .git/hooks、.git/config、.mcp.json、.claude/commands、.claude/agents 与 shell 启动文件 |
| 硬失败 | sandbox.failIfUnavailable 防止沙箱不可用时静默降级 |
量化效果:Anthropic 内部使用发现,沙箱化安全地将权限提示减少了 84%。这是本组全部文档中用于论证「治理与自主性是正和」的最强一条证据——约束并没有换来更多打断,反而换来了更少的打断。
5.7. 六层能力小结
| 层 | 评级 | 一句话判断 |
|---|---|---|
| L1 上下文工程 | ★★★ | 就近加载 + 技能渐进披露 + 子智能体隔离 + 压缩,机制最完整 |
| L2 工具与执行 | ★★★ | 沙箱披露最完整,隔离深度与凭据保护领先 |
| L3 编排与控制 | ★★★ | 计划模式、子智能体、钩子拦截、会话恢复齐备 |
| L4 记忆与状态 | ★★★ | 状态外化到文件与 git 的设计最成熟 |
| L5 评估与观测 | ★★ | 原则(评估者分离)最强,但产品内建观测形态需确认 |
| L6 治理与安全 | ★★★ | 权限三级配置 + 沙箱 + 凭据保护 + 硬失败开关,行业基准 |
6. 实际案例
说明:本节案例取自 Anthropic 官方工程博客公开披露的实践与量化结果;凡官方未给出量化数字者,仅描述机制,不补写效果。
6.1. 案例一:沙箱化把权限提示减少 84%
背景:智能体编码工具的经典矛盾是——逐条确认太打断,全部放开太危险。
方案:以操作系统级沙箱替代逐条确认。文件系统隔离限定可写范围到当前工作目录与会话临时目录,网络隔离限定只能经沙箱外代理访问且新域名需批准,两者缺一不可。在沙箱成立的前提下,切换到自动允许模式,让沙箱化命令免于逐条提示。
效果:Anthropic 内部使用中,权限提示减少 84%,同时安全性提升。
可迁移性:这是本组认为最值得被所有 AI IDE 采纳的一条设计。它证明了「用边界替代询问」优于「用询问替代边界」。
6.2. 案例二:长时运行任务的跨会话交接
背景:单一上下文窗口装不下数小时乃至数天的任务,跨窗口交接是长时运行智能体的核心难题。
方案:初始化阶段产出启动脚本、进度文件、初始提交与带完成标记的 JSON 功能清单;每轮会话开场执行三步——确认目录、读取进度文件与提交历史、挑选最高优先级未完成项;结束前必须把环境留在可合并的干净状态。硬规矩是不可移除或修改测试。
效果机制:把「记忆」问题转换为「文件与版本历史」问题,使交接不再依赖模型记忆的连续性。
已知代价:官方同时指出,上下文重置给的是干净白板,但要求交接产物足够完整;压缩则保留连续性但「上下文焦虑」仍在。两者不是替代关系,应按任务形态选择。
6.3. 案例三:以钩子把工程纪律机械强制
背景:写在文档里的工程约定会腐烂,写在提示词里的约定会被稀释。
方案:把约定下沉为钩子——编辑后自动格式化、提交前强制 lint、危险命令直接拦截、工具调用全量留痕。钩子在生命周期事件上触发,不消耗上下文 token。
效果机制:纪律从「要求智能体记住」变成「机械强制」,且不占用上下文预算。这与另一家厂商的实践高度同构:把 linter 的错误消息写成向智能体上下文注入的修复指令,让约束在被违反的瞬间就完成教学。
6.4. 案例四:评估者与被评估者分离
背景:让智能体自评,它会自信地称赞自己的产出,即便质量明显平庸。
方案:把生成与评估拆成两个角色,评估者按产品深度、功能性、视觉设计、代码质量四个维度打分,每项设硬阈值,任一项不达标即判该轮失败,并把详细失败原因回传给生成器。编码前双方就「完成」的定义达成一致。
效果机制:把主观质量判断转换为带阈值的机械判定,并把失败原因结构化回传,使迭代可被收敛。
7. 总结
7.1. 优势
- Harness 工程披露最完整:五篇官方工程博客构成从上下文工程到沙箱架构的完整体系,可作为行业基准。
- 沙箱深度领先:文件系统 + 网络双重隔离、凭据 deny/mask、流程级沙箱、关键路径默认拒写,防御深度在同类中最深。
- 治理与自主性正和有量化证据:权限提示减少 84% 且更安全。
- 上下文工程机制最全:就近加载、渐进披露、子智能体隔离、压缩四件套齐备。
- 长时运行实践成熟:以文件与 git 作为状态交接载体的方法论可直接复用。
- 评估者分离原则:提供了 L5 层最可操作的设计原则。
7.2. 局限
- 模型绑定单一:仅支持 Anthropic 自有模型,无法接入第三方模型做成本或能力对比。
- 订阅制在高峰期易撞限:长任务可能因额度窗口而中断,重度使用者需升级到高倍档位,成本显著上升。
- 不支持原生 Windows:Windows 用户需经 WSL2,且 WSL1 不支持。
- L5 产品内建观测形态未确认:原则强,但平台侧是否提供轨迹分析、回归集与成本看板,公开材料不足以判断。
- 用户规模数据缺失:本平台的用户量与采用率未获权威披露,标 ,不应引用任何未经核实的数字。
7.3. 自评与实测的背离(必读)
METR 于 2025-07-10 发布的随机对照试验给出了本平台乃至整个 AI 编码赛道最重要的一条反直觉证据:资深开源开发者在使用 AI 工具后,实际完成任务的速度慢了 19%,而这些开发者自评认为快了约 20%。
这一落差对使用本平台的团队有三条直接启示:
- 不接受主观自评作为验收标准。任何效率结论必须有对照测量。
- 把验证成本计入收益模型。生成快不等于交付快,走查与返工是真实成本。
- 优先在高置信场景使用:陌生仓库理解、机械性重构、测试补全这类「验证成本低」的任务收益最稳;在需要深度隐性知识的资深领域,收益最不确定。
同一时期的其他调研也指向同一结论:84% 的开发者在使用或计划使用 AI 工具,但 46% 不信任其准确性,66% 认为「AI 方案几乎对但不完全对」;企业侧 95% 已使用 AI、80% 感到个体生产力提升,但交付稳定性反而下降。采用已饱和,信任未跟上——这个缺口正是 Harness 的价值空间。
7.4. 适用边界
| 场景 | 是否适用 | 理由 |
|---|---|---|
| 数小时级的长时自主任务 | 适用 | 压缩、交接、会话恢复机制最成熟 |
| 需要深度隔离的高风险环境 | 适用 | 沙箱与凭据保护最深 |
| 需要多模型对比与成本优化 | 不适用 | 仅支持自有模型 |
| Windows 原生工作流 | 不适用 | 需 WSL2 |
| 需要完全开源可审计 | 不适用 | 闭源产品 |
| 组织级策略下发 | 适用 | 三级配置 + 组织托管 |
7.5. 选型建议
选 Claude Code 的判断标准是:任务以长时、自主、需要隔离保障为特征,且团队已接受 Anthropic 模型体系。若你的主要工作流在编辑器内且需要逐处审阅,Cursor 或 Windsurf 更顺手;若你需要开源可审计的执行栈,应选 Codex CLI;若你的组织已深度绑定 GitHub 且需要平台级合规,应选 GitHub Copilot。
无论选哪家,本组建议照搬本平台的两条实践:先把沙箱打开,再用自动允许模式;先建测试与机械判据,再谈自主度。这两步的先后顺序,决定了团队最终拿到的是效率还是事故。
信息缺口声明
- Claude Code 用户量与采用率:未获权威披露,全部相关数字标 ,本文不引用任何具体数字。
- 当前版本号与发布说明:撰写时未取得可核验的当期版本号,标
[待填写]。 - 定价与额度:订阅价格来自第三方对官方页面的核对,标 ;Team 标准席是否包含完整 Claude Code 存在口径冲突,标 。
- 记忆工具的当前可用状态(是否仍在公测、是否已正式可用):标 。
- 产品内建的轨迹分析与回归集能力:官方材料未明确,标 。
- 子智能体嵌套深度、动态工作流等进阶编排能力的准确参数:来自第三方转述,标 。
- 企业落地效果数据:本组未检索到可支撑的一手来源,本文未采用任何未经核实的企业案例与效果数字。
8. 参考资料
- Claude 3.7 Sonnet and Claude Code — Anthropic,2025-02-24。https://www.anthropic.com/news/claude-3-7-sonnet
- Sandboxing: a safer and more autonomous approach — Anthropic,2025。https://www.anthropic.com/engineering/claude-code-sandboxing
- Claude Code 官方文档 · Sandboxing — Anthropic,2026。https://code.claude.com/docs/en/sandbox-environments
- Claude Code 官方文档 · Sandboxing(中文)— Anthropic,2026。https://code.claude.com/docs/zh-TW/sandboxing
- Effective context engineering for AI agents — Anthropic,2025。https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents
- Effective harnesses for long-running agents — Anthropic,2025。https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
- Harness design for long-running application development — Anthropic,2026。https://www.anthropic.com/engineering/harness-design-long-running-apps
- Equipping agents for the real world with Agent Skills — Anthropic,2025-10-16。https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
- Introducing Agent Skills — Anthropic,2025-10-16(2025-12-18 转为开放标准)。https://www.anthropic.com/news/skills
- Claude 官方定价页 — Anthropic,2026。https://claude.com/pricing
- Model Context Protocol 官方站 — MCP / AAIF,2024—2026。https://modelcontextprotocol.io/
- 2025 Stack Overflow Developer Survey — Stack Overflow,2025-07-30。https://survey.stackoverflow.co/2025/
- DORA 2025 State of AI-assisted Software Development — Google Cloud / DORA,2025。https://dora.dev/
- Harness engineering: leveraging Codex in an agent-first world — OpenAI,2026-02-11。https://openai.com/index/harness-engineering/
Claude Code (AI IDE Platform Market Research)
1. Introduction
Claude Code is Anthropic's agentic coding tool launched in 2025, and among the six platforms in this group it is the one that discloses Harness engineering details most completely. Beyond offering rule files, skills, hooks, subagents, and a sandbox at the product level, Anthropic has also systematically published the design rationale and quantified results of context engineering, long-running Harness design, and sandbox architecture in its engineering blog. This makes Claude Code the best specimen for studying "what makes a good Harness."
Anthropic's own positioning statement is: Claude Agent SDK is "a powerful, general-purpose agent harness". The significance of this phrasing is that it turns "Harness" from a community vocabulary term into a formal noun in a vendor's product definition — the competitive focus of AI IDEs thereby shifts outward from model capability to the design of the carrier layer.
1.1. Developer and Product Evolution
| Item | Content |
|---|---|
| Developer | Anthropic |
| Initial release | 2025-02-24, released the same day as Claude 3.7 Sonnet in the form of a limited research preview, defined as "our first agentic coding tool" |
| Generally available | 2025-05-22, became generally available with the release of the Claude 4 series () |
| Form evolution | Started as a terminal CLI, progressively expanding to IDE integration, desktop, Web, and code-hosting platform integration |
| Official Harness literature | Five engineering blog posts — context engineering, the two-agent long-running Harness, the three-agent long-running application development Harness, the sandbox architecture, and Agent Skills — form a complete system |
1.2. Positioning and Latest Version
Claude Code's positioning is a terminal-first coding agent that excels at long-running autonomous tasks. Its capability boundary is officially described as: searching and reading code, editing files, writing and running tests, committing and pushing to code-hosting platforms, and using command-line tools. The difference from editor-type tools is: Claude Code's default working assumption is "a task may last from tens of minutes to several hours," so it invests noticeably more in context compaction, state handoff, and permission governance.
The latest version and version number are fast-changing information; no verifiable current version number was obtained at the time of writing, so it is recorded as [To be filled]. The verifiable version-related facts are: credentials protection requires v2.1.187 or above (deny mode) and v2.1.199 or above (mask mode).
1.3. Pricing System
Claude Code is not priced separately; it is included in the Claude subscription system and shares the same usage pool with the rest of the Claude products. The following prices come from third-party cross-checks against the official pricing page, marked [To be verified]:
| Plan | Price | Relationship with Claude Code |
|---|---|---|
| Free | $0 | Does not include Claude Code |
| Pro | $20/month (annually ~$17/month) | Includes Claude Code, usage quota aimed at individual developers |
| Max 5x | $100/month | Roughly 5x the Pro quota |
| Max 20x | $200/month | Roughly 20x the Pro quota, priority access to new features |
| Team standard seat | ~$25/seat/month (annually ~$20) | Seat capabilities depend on the plan; some accounts say the standard seat does not include full Claude Code () |
| Team premium seat | ~$100—$125/seat/month | Includes full Claude Code capabilities |
| Enterprise | Custom | Includes all capabilities and enterprise-grade compliance options |
Unit prices when billed directly via the API likewise come from third-party cross-checks (Opus tier ~$5/MTok input, $25/MTok output; Sonnet tier ~$3 / $15; Haiku tier ~$1 / $5), marked [To be verified].
Engineering implications of the billing structure: subscription pricing makes the cost of long tasks predictable — a runaway agent loop will not produce an unexpected bill, whereas under a per-token billing model that is a real risk. This is the direct reason teams should prefer subscription pricing over pure API billing in "long-running task" scenarios.
2. Glossary
| Term | English / Abbreviation | Definition |
|---|---|---|
| Project memory file | CLAUDE.md | A Markdown file storing project conventions, loaded as persistent context at session start; supports proximity-based application by directory level |
| Proximity loading | Proximity Loading | The mechanism by which rule files are collected upward along the directory tree and override downward; a child directory's CLAUDE.md overrides the same-named convention of the parent directory, aligning context with the current working object |
| Skill | Skills | A reusable capability package containing SKILL.md, using three-tier progressive disclosure: only the name and description are loaded at startup, the body is loaded on match, and accompanying scripts and reference files are loaded on demand |
| Progressive disclosure | Progressive Disclosure | Capabilities do not fully enter context at startup, but are loaded layer by layer as needed, so the bundleable amount of knowledge is effectively unbounded |
| Hooks | Hooks | External scripts triggered on tool-call lifecycle events (e.g. before execution, after edit, session start/end, before compaction) that can intercept, modify, or record behavior |
| Subagent | Subagents | Lower-level agents with their own context window, system prompt, and tool whitelist, returning only a condensed summary of roughly 1,000—2,000 tokens to the main session |
| Slash command | Slash Commands | Reusable workflow definitions invoked explicitly with /name |
| Plan mode | Plan Mode | First produce an implementation plan, execute after human confirmation, used to lock down strategy before acting |
| Permission rules | Permissions | A policy set made of allow / deny / ask three rule types, matchable by tool and parameter patterns |
| Sandbox | Sandbox | Operating-system-level process isolation limiting writable paths and network access; macOS uses Seatbelt, Linux / WSL2 use bubblewrap + socat |
| Sandbox runtime | Sandbox Runtime | A process-level sandbox that wraps the entire Claude Code process (including built-in tools, MCP servers, and hooks) in the same isolation layer |
| Auto-allow mode | Auto-allow | A permission mode in which sandboxed commands are automatically approved without per-command prompts |
| Strict sandbox mode | Strict Sandbox Mode | A mode that disables the "retry without sandbox" escape hatch, configured via allowUnsandboxedCommands: false |
| Credentials protection | Credentials Protection | Denying or masking specified files (e.g. ~/.aws/credentials) and environment variables (e.g. GITHUB_TOKEN) via sandbox.credentials |
| Context compaction | Compaction | Summarizing history as the window limit is approached, preserving key constraints and decisions |
| Context reset | Context Reset | Directly clearing context and reopening a blank slate, at the cost of requiring complete handoff artifacts |
| Handoff artifact | Handoff Artifacts | Carriers that pass state across sessions, such as progress files, git history, and feature lists |
| Self-evaluation bias | Self-Evaluation Bias | The phenomenon of an agent confidently praising its own output when evaluating it, even when quality is clearly mediocre |
3. Feature Description
3.1. Session and Workflow Capabilities
| Capability | Description | Harness Layer |
|---|---|---|
| Codebase search and reading | Search, read, and understand the entire repository | L1 |
| Multi-file editing | Coordinate modifications across files to implement changes | L2 + L3 |
| Test writing and running | Write tests, run them, and iterate based on failures | L5 (mechanical criteria) |
| Version-control operations | Commit, push, create PRs | L2 + L6 |
| Plan mode | Produce a plan first, then execute | L3 |
| Context compaction | Summarize history manually or automatically | L1 |
| Session resume and continue | Restore context from a previous session | L4 |
3.2. Extension Mechanisms
Claude Code offers five complementary extension points, which are the core source of its plasticity as a Harness:
| Extension point | Role | Layer |
|---|---|---|
CLAUDE.md and rules | Inject project conventions, applied by proximity according to directory level | L1 |
Skills /skills | Reusable, packageable workflows carrying independent tool permission sets, loaded on demand | L1 + L2 |
Subagents /agents | Specialized standalone agents with their own system prompt, tool whitelist, and memory | L3 |
| Hooks | Trigger external scripts on lifecycle events, for auto-formatting, enforced gates, and audit trails | L6 + L5 |
| MCP | Connect external systems and data sources, locally over stdio and remotely over Streamable HTTP | L2 |
The progressive-disclosure mechanism of skills is especially noteworthy: the official statement is that "the amount of context that can be bundled into a single skill is effectively unlimited," because at startup only the name and description are loaded into the system prompt. This resolves the most typical contradiction at the L1 layer — letting the agent know what capabilities the team has without keeping the full text of those capabilities resident in the window.
3.3. Execution Environments
| Environment | Where code runs | Applicable to |
|---|---|---|
| Local | This machine, full access to files and tools | Default; used together with the sandbox |
| Cloud | Anthropic-hosted environment | Long-running tasks, repositories that do not need a local clone, parallel jobs |
| Remote control | Executed locally, driven by a browser or Web interface | When a Web interface is needed but execution must stay local |
4. Platform Architecture
4.1. Overall Architecture
图 4-1|Claude Code 五层总体架构(上下文装配 → 状态层)
数据来源:基于本文分析绘制的示意图。
| Component | Responsibility |
|---|---|
| Context assembly layer | Collect the CLAUDE.md hierarchy, skill index, current file content, and conversation history to assemble each request |
| Tool execution layer | File read/write, command execution, search, network, MCP calls, all executed under the dual constraints of permissions and sandbox |
| Permission and sandbox runtime | Determines "whether it may be done" (permission rules) and "how far it may go" (sandbox boundaries) |
| Orchestration layer | Plan mode, todo list, subagent dispatch and result collection |
| State layer | Session records, memory files, checkpoints, and git history |
These five layers map almost one-to-one onto this project's six-layer Harness model, and among the six platforms in this group it has the clearest correspondence.
4.2. Context Assembly and Proximity Loading
The proximity-loading mechanism of CLAUDE.md is this platform's signature design. Its behavior can be summarized in three points:
- Collected upward along the directory tree: from the current working directory upward, collecting
CLAUDE.mdfiles and user-level memory files at each level in turn. - Proximity override: a child directory's rules override the same-named conventions of the parent directory, aligning context with the current editing object.
- Reference-style extension: rule files can reference deeper documents, loading them only when needed.
The engineering implication is: the hierarchy of context is isomorphic to the hierarchy of the codebase. Whatever directory a developer works in, they automatically get the conventions of that level — which saves more window than flattening all conventions into one file and better matches the premise that "context is a scarce resource."
The correspondence between the four context-management strategies officially given by Anthropic and this platform:
| Official strategy | Where it lands on this platform |
|---|---|
| Compaction | Manual and automatic compaction; the safest and lightest option is clearing tool echo |
| Structured note-taking | In-session todo lists, progress files, memory files |
| Memory tool | Provided on the developer platform with the model version ( current status) |
| Sub-agent architecture | Subagents can explore deeply with tens of thousands of tokens, returning only a 1,000—2,000 token summary |
Officially it also gives a tuning order: first maximize recall, then improve precision. Reversing the order loses key constraints still needed later — this is the most common misuse of the compaction feature.
4.3. Sandbox and Permission Runtime
This is the part Claude Code discloses most completely and which is most worth taking as an industry benchmark.
| Dimension | Implementation |
|---|---|
| Filesystem isolation | macOS uses Seatbelt; Linux / WSL2 use bubblewrap + socat, with optional seccomp filters; WSL1 is not supported; native Windows is not supported |
| Default write scope | Commands inside the sandbox can only write to the current working directory and the session temp directory ($TMPDIR is set to that directory); reads are machine-readable by default except for denied directories |
| Network isolation | Can only connect via a unix domain socket to a proxy server running outside the sandbox; new domains prompt for approval on first request |
| Permission modes | Auto-allow (sandboxed commands automatically approved) / normal permissions (still prompts per item) |
| Interception retained under auto-allow | deny rules, rm -rf-like commands targeting / or the home directory, and content-scoped ask rules still take effect |
| Escape hatch | dangerouslyDisableSandbox retry; can be disabled with allowUnsandboxedCommands: false, i.e. strict sandbox mode |
| Credentials protection | sandbox.credentials can deny or mask specified files and environment variables; deny requires v2.1.187+, mask requires v2.1.199+ |
| Process-level sandbox | @anthropic-ai/sandbox-runtime wraps the entire process (including built-in tools, MCP servers, hooks) in the same isolation layer; by default denies writing .git/hooks, .git/config, .mcp.json, .claude/commands, .claude/agents and shell startup files |
| Config paths | .claude/settings.local.json (project-level), ~/.claude/settings.json (user-level), managed configuration (organization-level) |
| Hard-fail switch | sandbox.failIfUnavailable can be set to fail directly when the sandbox is unavailable rather than degrade |
Two official assertions deserve separate citation:
- Filesystem isolation and network isolation are each indispensable: with only network isolation, a compromised agent can exfiltrate SSH keys; with only filesystem isolation, a compromised agent can easily escape and gain network access.
- By default deny writing
.claude/commands,.claude/agentsand shell startup files: these three target the two attack paths of "an agent rewriting its own instructions" and "injecting a persistent backdoor," a defense depth rarely seen among comparable products.
5. Harness Design
5.1. L1 Context Engineering Layer
| Mechanism | Description |
|---|---|
| Proximity-loading rule hierarchy | Context is isomorphic to the codebase hierarchy |
| Progressive disclosure of skills | Name and description stay resident, body loaded only on match, accompanying files read on demand |
| Subagent context isolation | Subagents consume their own window; the main session only receives a 1,000—2,000 token summary |
| Context compaction | Both manual and automatic channels, supporting the recall-first, precision-later tuning order |
| Executable code within skills | Code runs without entering the context, trading determinism for tokens and reproducibility |
The official definition of context rot is "a performance gradient, not a hard cliff" — this means context problems do not appear in the form of "errors" but in the form of the "agent slowly getting dumber," and therefore must be actively governed.
Practical takeaways: write CLAUDE.md as a "map" rather than an "encyclopedia". The contrast Anthropic gives in its long-running practice: change the instruction file from an encyclopedia to a directory, with roughly 100 lines injected into context, and put the real knowledge in a structured docs/ — give the agent a map, not a thousand-page manual.
5.2. L2 Tools and Execution Layer
| Tool | Isolation and confirmation mechanism |
|---|---|
| File read/write | Constrained by the sandbox write scope; critical paths (.git/hooks etc.) denied by default |
| Command execution | Executed inside the sandbox; network goes through a proxy and new domains require approval |
| MCP servers | Wrapped together with built-in tools and hooks in the process-level sandbox |
| Credentials and environment variables | Can be explicitly denied or masked |
| Network access | Through an outside-sandbox proxy, approved per domain |
The official statement of the design principle: tools should be "self-contained, robust to errors, and extremely clear in purpose," avoiding feature overload and ambiguous decision points. There is also published corroborating evidence that reducing the number of tools improves both accuracy and consumption — the tool interface is itself part of Harness design and is not neutral.
5.3. L3 Orchestration and Control Layer
| Mechanism | Description |
|---|---|
| Plan mode | Produce a plan first, then execute, locking down strategy |
| Todo list | Explicitly maintain task state within the session |
| Subagent dispatch | Specialized subagents work deeply in a clean window, returning only a summary |
| Hook interception | Can intercept an exit attempt and re-inject the goal, forcing the agent to keep working |
| Session resume | Restore context from a previous session and continue the task |
| Interruption and human takeover | Interrupt and take over at any time; permission prompts form a natural human-machine handoff point |
The two pieces of experience Anthropic officially gives for long-running tasks are worth copying directly:
- Three steps at the start of every session: confirm the current directory → read the progress file and commit history → pick the highest-priority incomplete item from the feature list.
- Run an end-to-end test to confirm the environment is healthy before implementing a new feature: models tend to declare a feature done without adequate testing; the countermeasure is to give it browser-automation tools so it can verify like a real person.
5.4. L4 Memory and State Layer
| Component | Persistence scope | Purpose |
|---|---|---|
| Memory files and rules | Versioned with the repository | Project conventions persist across sessions |
| Todo list | In-session | Make milestones and progress explicit |
| Checkpoints | In-session | Can roll back to a previous state |
| git history | Repository-level | The most reliable carrier of state handoff |
| Progress files | Files in the repository | Cross-session handoff (the standard artifact in long-running practice) |
Anthropic's account of the cross-window handoff problem: imagine it as "a software project worked on by engineers in shifts, where each new engineer arrives with no memory of what happened in his predecessor's shift." The solution is not to have the agent remember everything, but to externalize state to files and version history — this is the same "externalize state" principle from L1 continued at the L4 layer.
Officially it also acknowledges an open question: whether a single general-purpose coding agent is always optimal, or whether a multi-agent architecture split into dedicated agents for testing, QA, cleanup, etc. is better — it is currently unclear.
5.5. L5 Evaluation and Observability Layer
| Mechanism | Description |
|---|---|
| Tests as mechanical criteria | Run tests after writing code, iterate on failure; this is the natural binary criterion in coding scenarios |
| Browser automation verification | Give the agent browser tools so it verifies front-end behavior like a real person |
| Evaluator separated from the evaluated | An independent evaluator is far easier to train into a skeptic, while making a generator self-criticize is hard |
| Trace and usage observability | Record calls and consumption for cost attribution ( concrete product form) |
The most important L5 design principle is separating the evaluator from the evaluated. Officially it was observed that when an agent evaluates its own work, it will "confidently praise" — even when quality is clearly mediocre in the eyes of a human observer; this is especially prominent on subjective tasks lacking binary criteria. After separation, "training an independent evaluator to be skeptical is far easier than making the generator self-criticize." This design is officially analogized to a generative adversarial network.
Scoring dimensions are recommended to use a hard-threshold system: product depth, functionality, visual design, and code quality each get a threshold; any one below its threshold means the round is judged a failure, and the detailed failure reasons are fed back to the generator.
5.6. L6 Governance and Security Layer
| Governance dimension | Implementation |
|---|---|
| Permission model | Three rule types — allow / deny / ask — matchable by tool and parameter pattern, with three-level configuration (project / user / organization-managed) |
| Process isolation | Dual isolation of filesystem + network; process-level sandbox covers built-in tools, MCP, and hooks |
| Credentials protection | Files and environment variables can be denied or masked |
| Autonomy adjustment | Two levels of auto-allow / normal permissions; strict sandbox mode can disable the escape hatch |
| Organization-level policy | Managed configuration is handed down by the organization and cannot be overridden by individuals |
| Critical-path protection | By default denies writing .git/hooks, .git/config, .mcp.json, .claude/commands, .claude/agents and shell startup files |
| Hard failure | sandbox.failIfUnavailable prevents silent degradation when the sandbox is unavailable |
Quantified results: Anthropic's internal usage found that sandboxing safely reduced permission prompts by 84%. This is the strongest single piece of evidence across all documents in this group for arguing that "governance and autonomy are a positive sum" — constraints did not buy more interruptions, but fewer.
5.7. Six-Layer Capability Summary
| Layer | Rating | One-line assessment |
|---|---|---|
| L1 Context engineering | ★★★ | Proximity loading + progressive skill disclosure + subagent isolation + compaction, most complete mechanism |
| L2 Tools and execution | ★★★ | Most complete sandbox disclosure, leading isolation depth and credentials protection |
| L3 Orchestration and control | ★★★ | Plan mode, subagents, hook interception, session resume all in place |
| L4 Memory and state | ★★★ | Most mature design of externalizing state to files and git |
| L5 Evaluation and observability | ★★ | Strongest on principle (evaluator separation), but the built-in product observability form needs confirmation |
| L6 Governance and security | ★★★ | Three-level permission configuration + sandbox + credentials protection + hard-fail switch, industry benchmark |
6. Case Studies
Note: the cases in this section are drawn from practices and quantified results publicly disclosed by Anthropic's official engineering blog; where the official source gives no quantified figures, only the mechanism is described, without supplementing effects.
6.1. Case 1: Sandboxing reduced permission prompts by 84%
Background: the classic contradiction of agentic coding tools is — confirming each item one by one is too disruptive, while giving full freedom is too dangerous.
Approach: replace per-item confirmation with an operating-system-level sandbox. Filesystem isolation limits the writable scope to the current working directory and the session temp directory; network isolation limits access to the out-of-sandbox proxy with new domains requiring approval; both are indispensable. With the sandbox in place, switch to auto-allow mode so sandboxed commands are exempt from per-item prompts.
Effect: In Anthropic's internal usage, permission prompts dropped by 84% while security improved.
Transferability: this is the design this group believes is most worth adopting across all AI IDEs. It demonstrates that "substituting boundaries for questioning" is superior to "substituting questioning for boundaries."
6.2. Case 2: Cross-session handoff for long-running tasks
Background: a single context window cannot hold tasks lasting hours or even days, and cross-window handoff is the core challenge of long-running agents.
Approach: the initialization phase produces a startup script, progress file, initial commit, and a JSON feature list with completion markers; every session opens with three steps — confirm the directory, read the progress file and commit history, pick the highest-priority incomplete item; before ending, the environment must be left in a clean, mergeable state. A hard rule is that tests must not be removed or modified.
Effect mechanism: convert the "memory" problem into a "files and version history" problem, so handoff no longer depends on the continuity of the model's memory.
Known cost: officially it also notes that a context reset gives a clean slate but requires the handoff artifacts to be complete enough; compaction preserves continuity but "context anxiety" remains. The two are not substitutes; they should be chosen according to the task shape.
6.3. Case 3: Mechanically enforcing engineering discipline with hooks
Background: engineering conventions written in documents rot, and conventions written in prompts get diluted.
Approach: push conventions down into hooks — auto-format after editing, force lint before commit, directly intercept dangerous commands, and retain complete traces of tool calls. Hooks trigger on lifecycle events and do not consume context tokens.
Effect mechanism: discipline changes from "asking the agent to remember" to "mechanical enforcement," without drawing on the context budget. This is highly isomorphic to another vendor's practice: writing a linter's error messages as repair instructions injected into the agent's context, so the constraint teaches the lesson the moment it is violated.
6.4. Case 4: Separating the evaluator from the evaluated
Background: when an agent evaluates itself, it confidently praises its own output even when quality is clearly mediocre.
Approach: split generation and evaluation into two roles; the evaluator scores across four dimensions — product depth, functionality, visual design, and code quality — each with a hard threshold; any dimension failing means the round is judged a failure, and the detailed failure reasons are fed back to the generator. Before coding, both sides agree on the definition of "done."
Effect mechanism: convert subjective quality judgment into a threshold-based mechanical determination and feed failure reasons back in a structured way, so iteration can converge.
7. Summary
7.1. Strengths
- Most complete Harness engineering disclosure: five official engineering blog posts form a complete system from context engineering to sandbox architecture, which can serve as an industry benchmark.
- Leading sandbox depth: filesystem + network dual isolation, credential deny/mask, process-level sandbox, default denial of writing critical paths — the deepest defense among comparable products.
- Quantified evidence that governance and autonomy are a positive sum: permission prompts dropped by 84% and it is safer.
- Most complete context engineering mechanisms: proximity loading, progressive disclosure, subagent isolation, and compaction — all four pieces in place.
- Mature long-running practice: the methodology of using files and git as state-handoff carriers can be reused directly.
- Evaluator-separation principle: provides the most actionable design principle at the L5 layer.
7.2. Limitations
- Single model binding: only supports Anthropic's own models, and third-party models cannot be integrated for cost or capability comparison.
- Subscription plan is prone to hitting limits at peak times: long tasks may be interrupted by the quota window; heavy users must upgrade to a higher-multiplier tier, with significantly higher cost.
- No native Windows support: Windows users must go through WSL2, and WSL1 is not supported.
- The built-in L5 product observability form is unconfirmed: the principle is strong, but whether the platform side provides trace analysis, regression suites, and cost dashboards cannot be judged from public materials.
- Missing user-scale data: this platform's user count and adoption rate have not been authoritatively disclosed, marked
[To be verified]; no unverified figures should be cited.
7.3. The Discrepancy Between Self-Assessment and Measured Reality (Must Read)
The randomized controlled trial published by METR on 2025-07-10 provides the most important counterintuitive evidence for this platform and the entire AI coding field: senior open-source developers were actually 19% slower at completing tasks after using AI tools, while these developers self-assessed themselves as about 20% faster.
This gap has three direct implications for teams using this platform:
- Do not accept subjective self-assessment as an acceptance criterion. Any efficiency conclusion must have a controlled measurement.
- Include verification cost in the benefit model. Fast generation does not equal fast delivery; walkthroughs and rework are real costs.
- Prefer using it in high-confidence scenarios: tasks with low "verification cost" such as unfamiliar-repository understanding, mechanical refactoring, and test completion have the most stable returns; in expert domains requiring deep tacit knowledge, returns are the most uncertain.
Other surveys from the same period point to the same conclusion: 84% of developers use or plan to use AI tools, but 46% do not trust their accuracy, and 66% believe "AI solutions are almost right but not quite right"; on the enterprise side, 95% already use AI and 80% feel individual productivity improved, yet delivery stability actually declined. Adoption has saturated, but trust has not caught up — this gap is precisely the value space for Harness.
7.4. Applicability Boundaries
| Scenario | Applicable? | Reason |
|---|---|---|
| Long-running autonomous tasks lasting hours | Applicable | Compaction, handoff, and session-resume mechanisms are the most mature |
| High-risk environments requiring deep isolation | Applicable | Deepest sandbox and credentials protection |
| Multi-model comparison and cost optimization | Not applicable | Only supports its own models |
| Native Windows workflows | Not applicable | Requires WSL2 |
| Needs fully open-source auditable stack | Not applicable | Closed-source product |
| Organization-level policy rollout | Applicable | Three-level configuration + organization-managed |
7.5. Selection Recommendations
The criterion for choosing Claude Code is: tasks characterized by long-running, autonomy, and a need for isolation guarantees, with the team already accepting the Anthropic model system. If your primary workflow lives in an editor and needs point-by-point review, Cursor or Windsurf is more convenient; if you need an open-source auditable execution stack, choose Codex CLI; if your organization is deeply tied to GitHub and needs platform-level compliance, choose GitHub Copilot.
Whichever you choose, this group recommends copying two practices from this platform: turn on the sandbox first, then use auto-allow mode; build tests and mechanical criteria first, then talk about autonomy. The order of these two steps determines whether the team ultimately gets efficiency or an incident.
Information Gap Declaration
- Claude Code user count and adoption rate: not authoritatively disclosed; all related figures are marked
[To be verified], and this document cites no specific numbers. - Current version number and release notes: no verifiable current version number was obtained at the time of writing, marked
[To be filled]. - Pricing and quotas: subscription prices come from third-party cross-checks against the official page, marked
[To be verified]; whether the Team standard seat includes full Claude Code has conflicting accounts, marked[To be verified]. - Current availability status of the memory tool (whether still in public beta or already generally available): marked
[To be verified]. - Product-built-in trace analysis and regression-suite capabilities: not made clear by official materials, marked
[To be verified]. - Accurate parameters of advanced orchestration capabilities such as subagent nesting depth and dynamic workflows: from third-party accounts, marked
[To be verified]. - Enterprise deployment effect data: this group found no primary source to support it; this document does not use any unverified enterprise cases or effect figures.
8. References
- Claude 3.7 Sonnet and Claude Code — Anthropic, 2025-02-24. https://www.anthropic.com/news/claude-3-7-sonnet
- Sandboxing: a safer and more autonomous approach — Anthropic, 2025. https://www.anthropic.com/engineering/claude-code-sandboxing
- Claude Code official docs · Sandboxing — Anthropic, 2026. https://code.claude.com/docs/en/sandbox-environments
- Claude Code official docs · Sandboxing (Chinese) — Anthropic, 2026. https://code.claude.com/docs/zh-TW/sandboxing
- Effective context engineering for AI agents — Anthropic, 2025. https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents
- Effective harnesses for long-running agents — Anthropic, 2025. https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
- Harness design for long-running application development — Anthropic, 2026. https://www.anthropic.com/engineering/harness-design-long-running-apps
- Equipping agents for the real world with Agent Skills — Anthropic, 2025-10-16. https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
- Introducing Agent Skills — Anthropic, 2025-10-16 (became an open standard on 2025-12-18). https://www.anthropic.com/news/skills
- Claude official pricing page — Anthropic, 2026. https://claude.com/pricing
- Model Context Protocol official site — MCP / AAIF, 2024—2026. https://modelcontextprotocol.io/
- 2025 Stack Overflow Developer Survey — Stack Overflow, 2025-07-30. https://survey.stackoverflow.co/2025/
- DORA 2025 State of AI-assisted Software Development — Google Cloud / DORA, 2025. https://dora.dev/
- Harness engineering: leveraging Codex in an agent-first world — OpenAI, 2026-02-11. https://openai.com/index/harness-engineering/