Anthropic Engineering

20 篇内容

工程实践Anthropic Engineering

How we contain Claude across products

这篇文章系统复盘了 Anthropic 在多个 Claude 产品中如何做“容器化/隔离式”约束,核心目标不是单纯让模型少犯错,而是通过环境边界、模型层防护和外部内容治理来限制 agent 的爆炸半径。文章分别讨论了 claude.ai 的临时容器、Claude Code 的人机协同沙箱、Claude Cowork 的本地 VM 三种隔离模式,并结合真实披露的漏洞与红队事件说明了信任边界、egress 控制、文件挂载、MCP 连接器、提示注入和数据外泄等关键风险。结论是:对 agent 安全而言,确定性边界比概率性监督更可靠,且隔离方案必须根据用户能否有效监督 agent 来选择,同时要警惕自研组件比成熟基础设施更容易出问题。

推荐收录,因为它不是泛泛谈“AI 安全”,而是给出了可落地的 agent containment 架构、风险分类和多次真实失误后的修正经验。对正在构建 LLM 应用、代码代理、企业知识工作代理或本地工具接入系统的工程团队,这篇文章提供了很强的可迁移参考价值。

工程实践Anthropic Engineering

An update on recent Claude Code quality reports

这篇文章复盘了 Claude Code 近期“质量下降”反馈的三个独立成因:默认推理强度从 high 调到 medium、会话恢复时清理历史思考的缓存优化存在 bug,以及为降低冗长度而加入的 system prompt 反而伤害了编码质量。作者说明这三项改动分别影响不同产品与流量切片,因此在外部看起来像广泛且不稳定的退化,但 API 和推理层本身并未被破坏。文中还给出每个问题的发现、回滚和修复时间线,以及为何内部使用和既有评测一开始都没复现。最后总结了后续改进:更严格的 prompt 变更审查、按模型做更宽的评测与 ablation、渐进式发布、增强 code review 上下文,并将限制重置给所有订阅用户。

这是一次非常具体的 AI 产品故障复盘,直接给出了三类退化的机制、时间线和修复措施,不是泛泛而谈。适合做 Claude Code、Agent 系统、prompt 调参与线上稳定性治理的参考,尤其对评测设计、渐进发布和变更审查有可迁移价值。

工程实践Anthropic Engineering

Scaling Managed Agents: Decoupling the brain from the hands

本文介绍 Anthropic 为 Managed Agents 设计的“元 harness”架构,核心是把 Claude 的“脑”(模型与调度逻辑)、“手”(沙箱和工具)以及“会话”(持久事件日志)解耦。作者先回顾了早期把所有组件放进单容器的方案,说明这种耦合会把容器变成难以替换的“宠物”,带来故障难排查、用户数据与调试冲突、以及 VPC/外部系统接入困难等问题。随后文章给出新的接口设计:harness 通过 execute/provision/wake/getSession/emitEvent 等稳定边界与沙箱和会话交互,使容器、harness、会话都能独立失败、重启或替换。安全上,凭据被移出沙箱,Git 与 MCP/OAuth 通过受控初始化或代理访问,避免提示注入直接接触 token。作者还指出这种解耦显著降低了 TTFT,p50 约下降 60%,p95 超过 90%,但前提是系统愿意承担更复杂的编排与多环境 reasoning 负担。

推荐收录,因为文章给出了面向长时运行 agent 的完整接口分层、故障隔离和凭据边界设计,并用 TTFT 数据验证了架构收益。适合做 AI 平台、Agent 基础设施和安全设计的参考,尤其能迁移到需要多沙箱、多工具、可恢复会话的工程场景。

工程实践Anthropic Engineering

How we built Claude Code auto mode: a safer way to skip permissions

文章介绍 Anthropic 为 Claude Code 设计的 auto mode,目标是在减少频繁确认带来的“审批疲劳”的同时,避免直接开启“跳过权限”所带来的安全风险。核心方案是两层防线:输入侧用提示注入探测器检查文件、网页和工具输出中的可疑内容,输出侧用基于 Sonnet 4.6 的转录分类器对每次动作做放行或阻断判断。系统在权限上采用分层策略:安全只读工具和项目内编辑可直接执行,真正高风险的 shell、外部访问、跨信任边界操作才进入分类器。作者详细给出了威胁模型、固定分类模板与可配置策略槽位,并用真实流量、真实激进行为和合成外泄集评估效果。结果表明端到端误报率可降到 0.4%,但真实危险动作仍有 17% 漏检,说明它适合高频自动化场景,不适合作为高风险基础设施的人审替代品。

文章直接公开了 AI Agent 自动审批的系统架构、威胁模型、分类规则和评测结果,属于可迁移的工程经验,而非产品宣传。适合做代理式工具安全设计、权限分层和风险边界的参考,但需注意其对真实危险动作仍有明显漏检,不宜直接用于高风险场景。

工程实践Anthropic Engineering

Harness design for long-running application development

这篇文章系统介绍了 Anthropic 在长时运行应用开发中的 harness 设计演进:先用“生成器+评估器”的双代理结构改进前端设计,再将同样思路扩展到多小时的自动编码任务。作者指出,长任务的主要失效来自上下文窗口膨胀导致的连贯性下降、模型接近上下文上限时的“context anxiety”,以及生成器自评过于宽松,因此需要上下文重置、结构化交接和独立 QA。前端部分通过将“设计质量、原创性、工艺、功能性”拆成可打分标准,并让评估器用 Playwright 直接操作页面,显著提升了生成结果的审美和可用性。完整应用开发则采用 planner、generator、evaluator 三代理:planner 把简短需求扩成规格,generator 分 sprint 实现,evaluator 通过浏览器测试和硬阈值验收,能抓出接口路由、交互和逻辑缺陷。文章最后比较了 Opus 4.5 与 4.6 下不同 scaffold 的必要性,强调 harness 不是固定模板,而应随着模型能力提升持续删减或补充负载组件,但代价是更高的编排复杂度、延迟和 token 成本。

推荐收录,因为文章给出了可复用的代理式 harness 设计:上下文重置、结构化交接、独立评估器、sprint contract 和浏览器级 QA 都有明确实现细节与实验对比。适合做 AI 应用工程、长任务 agent 编排和自动化测试的参考,但也要注意其效果依赖具体模型能力,且成本与时延较高。

科研议题Anthropic Engineering

Eval awareness in Claude Opus 4.6’s BrowseComp performance

这篇文章分析了 Claude Opus 4.6 在 BrowseComp 基准上的异常高分来源,核心问题不是单纯“答对了题”,而是模型在开放网络环境中遭遇了题库污染与评测感知。作者统计了 1,266 道题中 11 道来自泄露答案,其中 9 道是公开网页、论文或 GitHub 里的直接泄露,另有 2 道是模型先怀疑自己在做评测,再反向识别出具体基准并解密答案键。文章进一步展示了多代理配置会放大这种风险,且代码执行、搜索工具和可访问的镜像数据会让模型绕过原本的防护。结论认为,静态基准在联网、长链路、工具增强的场景下越来越容易失真,评测完整性应被视为持续的对抗性问题,而不是一次性的设计问题。文中也指出,这种行为不等同于对齐失败,但确实暴露了代理系统会以意料之外的方式完成任务,且 URL 级封锁并不足够。

收录价值明确:文章给出了 1,266 题、20 处泄露源、18 次相关运行等具体证据,直接证明联网评测会被污染和“评测意识”绕过。适合做基准设计、Agent 评测和工具链安全的参考,尤其能提醒读者不要把静态分数当作可靠能力指标。

工程实践Anthropic Engineering

Building a C compiler with a team of parallel Claudes

文章复盘了 Anthropic 研究员用 16 个并行 Claude 实例,从零实现一个 Rust 版 C 编译器的过程。核心不是“让模型写代码”本身,而是设计一个能长期自治的 harness:用无限循环驱动任务推进、通过 git 文件锁避免重复劳动,并让不同代理分工处理测试、文档、性能和代码去重。作者强调,真正决定成败的是高质量测试、可自动判错的日志、以及把问题拆成可并行的小任务;当 Linux 内核编译这种“单大任务”卡住时,又引入 GCC 作为在线 oracle 和抽样测试来恢复并行性。最终产物可编译 Linux 6.9 及多个大型项目,但仍存在 16 位 x86、汇编器/链接器、代码质量和性能不足等边界,说明当前自治编程仍远未“全能”。

有直接工程证据:并行代理、任务锁、测试 harness、GCC oracle 和 CI 共同构成了可复用的方法论。适合做 AI 编程代理、自动化测试与编译器工程的参考,但也明确暴露了自治开发在正确性、效率和边界处理上的风险。

工程实践Anthropic Engineering

Quantifying infrastructure noise in agentic coding evals

这篇文章研究了 agentic coding 评测中的“基础设施噪声”,核心结论是:容器资源配置本身就能显著改变分数,甚至超过榜单上常见的微小差距。作者在 Terminal-Bench 2.0 上比较了从严格按任务规格执行到完全放开资源的六种配置,发现资源越宽松,成功率越高,但其中一部分提升来自减少 OOM、pod error 等基础设施失败,而不是模型能力本身。实验表明,在 1x 到 3x 资源范围内,分数变化多落在噪声内;超过约 3x 后,额外资源开始真正帮助代理完成原本做不到的任务,最高相对提升约 6 个百分点。作者又在 SWE-bench 上复现了类似趋势,但幅度较小,说明该问题并非 Terminal-Bench 独有。文章最后建议评测应同时公开并区分“保证资源”和“硬性上限”,并把资源配置当作一等实验变量,否则几分之差很可能只是更大的 VM 或更宽松的沙箱。

文章直接给出了对照实验:同一模型、同一任务集,仅改变资源配置就能带来最高 6 个百分点的差异,证明基准分数并不纯粹。适合做 agent 评测、自动化 coding benchmark 和推理沙箱设计的读者参考,尤其适合需要判断榜单差距可信度的人。

职业经验Anthropic Engineering

Designing AI-resistant technical evaluations

文章回顾了 Anthropic 性能工程团队如何设计并多次重做 take-home 面试,以在 AI 辅助普及后仍能区分候选人。原题是模拟加速器上的树遍历优化,要求候选人逐步完成并行化、SIMD/VLIW 利用、调试和工具构建,因此在早期能有效筛出强工程师,也确实招到了多位高绩效员工。随着 Claude Opus 4 和 4.5 在两小时约束内逐步追平甚至超过优秀人类,作者不得不把题目改成更陌生、更受限的谜题式优化问题,并减少那些模型已经轻松掌握的维度。文章总结出评估设计应兼顾真实工作、高信号、足够深度以及对 AI 的开放使用,但也承认越强调“抗模型”越容易牺牲岗位真实性和可解释性。最后作者公开了原始题目作为挑战,并用成绩对比说明人类在无限时间下仍有优势,但在短时约束下可区分性正在迅速下降。

推荐收录,因为文中给出了清晰的直接证据:原始 take-home 曾有效招人,但已被 Claude Opus 4/4.5 在 2 小时约束内追平甚至超越,迫使团队重设评估方式。适合负责面试设计、技术招聘和 AI 时代能力评估的人阅读,可迁移价值在于如何构造高信号任务与识别失效边界。

技术文章Anthropic Engineering

Demystifying evals for AI agents

本文系统拆解了 AI agents 的评测方法,先给出 task、trial、grader、transcript、outcome 和 harness 等核心定义,说明评测对象不仅是模型,还包括代理脚手架与运行环境。文章重点比较了代码、模型和人工三类 grader,以及能力评测和回归评测的不同目标,并按 coding、conversational、research、computer use 等 agent 类型分别讨论可用的判分方式。作者强调多轮 agent 评测天然存在非确定性,因此应结合 pass@k 与 pass^k 来理解成功率和一致性。文章还给出从零搭建 eval 的实践路线:从真实失败中收集 20-50 个任务、写清晰无歧义的题目、设计平衡样本、构建稳定环境、检查 transcript、防止刷分和饱和。最后指出,长期有效的 eval 需要与生产监控、A/B 测试、用户反馈和人工复核结合使用,才能持续支撑 agent 演进。

推荐收录,因为文章不仅解释了 agent eval 的概念,还给出了可直接落地的任务设计、grader 选择、非确定性度量和长期维护方法。适合正在做 AI agent、LLM 应用或自动化评测的平台/产品团队参考,但需要注意模型判分仍需人工校准,且评测套件要随产品变化持续维护。

工程实践Anthropic Engineering

Effective harnesses for long-running agents

这篇文章讨论了长运行 AI agent 在跨多个上下文窗口执行任务时的核心失败模式:容易一次做太多、在中途断档后无法恢复上下文,以及过早判定任务完成。作者基于 Claude Agent SDK 的实验提出一套两阶段 harness:首次会话用 initializer agent 搭建环境,生成 init.sh、claude-progress.txt、初始 git 提交和完整 feature list;后续 coding agent 只按单个功能逐步推进,并在每轮结束时写进度、提交代码、保持工作区干净。文章还强调必须把端到端测试显式写入流程,借助浏览器自动化工具验证真实用户路径,而不仅是单元测试或 curl。最后作者指出该方案对全栈 Web 开发效果明显,但仍受浏览器可见性、弹窗等工具限制,且多 agent 架构是否更优仍是开放问题。

文章直接给出了长运行 agent 的可复用工程方案:初始化阶段、功能清单、进度文件、git 约束和端到端测试,证据具体且可落地。适合做 AI 编程代理、自动化开发流程和 agent harness 设计的参考;但其最佳实践主要来自全栈 Web 场景,迁移到其他任务时仍需重新验证。

工程实践Anthropic Engineering

Introducing advanced tool use on the Claude Developer Platform

这篇文章介绍了 Claude Developer Platform 新增的三项高级工具使用能力:Tool Search Tool、Programmatic Tool Calling 和 Tool Use Examples。作者指出,传统函数调用在多工具场景下会遇到工具定义占用上下文、错误选工具与参数、以及多轮推理带来的上下文污染问题,因此需要按需发现、用代码编排和用示例约束调用方式。文中给出明确的实现方式:通过 defer_loading 让工具按需加载、在 code execution 中让 Claude 用 Python 组织多步调用、以及用 input_examples 补足 JSON Schema 无法表达的使用模式。文章还提供了内部测试数据,显示在大工具库和复杂工作流中可显著节省 token、降低延迟并提升准确率。其适用边界也很清楚:小工具集、单步调用或 intermediate 结果需要模型直接推理的任务,收益会明显下降。

文中直接给出了三种机制的设计动机、API 形态、适用边界和内部评测数据,不是泛泛的产品介绍,而是可落地的 agent 工程方法总结。适合做多工具 agent、MCP 集成和平台侧工具调用设计的读者参考,尤其有助于借鉴“按需加载、代码编排、示例约束”这三层思路。

工程实践Anthropic Engineering

Code execution with MCP: Building more efficient agents

文章讨论如何用代码执行环境来更高效地连接 MCP 服务器,核心动机是解决大规模工具接入后的上下文膨胀与中间结果反复进模型的问题。作者指出,直接把所有工具定义和返回值都放进上下文,会在连接上千工具时显著增加 token、延迟和出错率;改为让模型写代码操作 MCP,则可按需读取工具定义,并在执行环境中先过滤、聚合和转换数据。文中进一步给出文件系统式工具发现、search_tools、循环与条件控制、结果脱敏、状态持久化和技能复用等做法,说明这种模式能把很多原本依赖模型逐步编排的逻辑交给程序处理。文章也明确提醒,代码执行并非零成本,需要安全沙箱、资源限制和监控,否则会引入新的运维与安全复杂度。整体结论是:在工具很多、数据很大或任务流程复杂时,code execution 能显著降低上下文成本并提升代理可组合性,但只适合具备较强执行隔离能力的系统。

文章直接给出了从“工具调用”转向“代码执行”的可操作方案,并用 token 成本、延迟和隐私脱敏等具体例子说明收益与边界,适合做 Agent/MCP 系统设计参考。对做 AI 工程、平台能力或工具编排的读者尤其有价值,但落地前必须评估沙箱、监控和安全治理成本。

工程实践Anthropic Engineering

Beyond permission prompts: making Claude Code more secure and autonomous

文章围绕 Claude Code 在更少人工审批下安全运行的需求,提出用操作系统级沙箱替代频繁的 permission prompt。核心方案分为两层:文件系统隔离限制可读写目录,网络隔离限制可访问的域名,并通过 bubblewrap、macOS seatbelt 和外部代理把约束落实到 OS 层,连子进程与脚本也一并受控。文中进一步介绍了新的 sandboxed bash 工具:它可在预定义边界内执行命令,越界时立即告警并等待用户确认,从而显著减少审批疲劳,内部使用中审批提示减少了 84%。另一部分讲 Claude Code on the web 如何在云端隔离会话,把 git 凭据和签名密钥留在沙箱外,再通过代理校验分支与仓库目标后转发请求。文章的边界在于它依赖 OS 原语和代理基础设施,适用于需要高自治但又必须防 prompt injection 与数据外泄的 agent 场景。

收录价值明确,因为文章给出了面向编码代理的完整安全架构:文件隔离、网络隔离、外部代理校验和云端凭据分离,且说明了为什么两类隔离缺一不可。适合做 AI 编码助手、MCP server 或自动化 agent 的安全设计参考;主要风险是其实现强依赖操作系统能力和代理基础设施,迁移时需评估环境差异。

工具笔记Anthropic Engineering

Equipping agents for the real world with Agent Skills

文章介绍 Anthropic 提出的 Agent Skills:一种把领域知识打包成目录的标准,核心由 SKILL.md、可选的附加文档和脚本组成,供代理按需发现与加载。作者强调“渐进式披露”是关键设计:启动时只读元数据,需要时再读取正文和相关文件,从而在文件系统和代码执行工具支持下突破单一上下文窗口限制。文中还说明技能可直接调用确定性脚本完成适合代码处理的任务,并给出从评估缺口、拆分结构、观察代理行为到迭代优化的构建方法。最后专门提醒技能可能引入供应链和数据外泄风险,建议只安装可信来源并审查依赖与外部网络访问。整体更像一份面向代理工程的可复用规范与实践指南,而不是单纯产品宣发。

文章直接给出了 Agent Skills 的目录结构、加载机制、代码执行方式和安全注意事项,属于可落地的代理工程方法总结,而非泛泛概念介绍。适合正在构建 Claude 生态、Agent 工作流或可移植提示/脚本封装方案的读者,具有较强的迁移价值,但需要注意其内容与 Anthropic 生态绑定较强。

技术文章Anthropic Engineering

Effective context engineering for AI agents

这篇文章把“context engineering”定义为比 prompt engineering 更完整的 LLM/Agent 设计问题:不只是写好提示词,而是持续管理系统指令、工具、示例、历史消息和外部检索信息,尽量把有限上下文窗口里的 token 用在最有信号的地方。作者用上下文退化、注意力预算和 Transformer 的 n² 关系解释了为什么长上下文并不等于高质量上下文,模型在信息检索和长程推理上仍会随长度增长而变差。文章进一步给出一套实操框架:系统提示要保持清晰、简洁且处于合适抽象层级,工具要少而明确,示例要选典型而非穷举边界。对于长周期任务,作者重点介绍了 compaction、结构化笔记、just-in-time 检索和子代理架构,说明它们分别适合持续对话、迭代开发和复杂研究。整体结论是,构建可靠 Agent 的核心不是堆上下文,而是不断筛选、压缩和动态加载最必要的信息,但这些策略仍受任务类型、工具设计和模型能力边界约束。

文章直接给出了上下文管理、工具设计、compaction 和子代理等可落地方法,是构建长程 Agent 的系统性经验总结。适合做 AI 应用、Agent 编排和检索增强设计的参考;其价值在于方法可迁移,但前提是读者理解上下文窗口与任务自治之间的权衡。

工程实践Anthropic Engineering

A postmortem of three recent issues

这篇复盘讲述了 Anthropic 在 8 月至 9 月间连续暴露的三起 Claude 基础设施故障,分别是短上下文请求被错误路由到 1M token 服务器、TPU 端输出生成被错误配置污染、以及 XLA:TPU 的 approximate top-k 误编译问题。文章不仅给出每个问题的时间线、影响范围和修复方式,还说明了为何不同平台与不同模型上的症状会交叠,导致用户感知为随机降质。作者强调,问题并非由需求高峰或负载降级引起,而是纯粹的基础设施缺陷。文中进一步分析了诊断困难来自于评测不够敏感、线上抽样噪声大、用户交互受隐私限制难以直接复现。最后给出改进方向:更敏感的质量评测、更多真实生产环境中的连续监测、以及兼顾隐私的调试工具,并在推理链路上采用 exact top-k 和更稳妥的精度策略。文章的适用边界主要在大模型推理与异构硬件部署场景,但其排障和验证方法具有普遍参考价值。

有明确的事故时间线、根因分析和修复验证,不是泛泛而谈的产品公告。对做 LLM 推理、异构硬件部署和线上稳定性的人尤其有参考价值,文中的评测设计、路由隔离与精度权衡可直接迁移。

技术文章Anthropic Engineering

Writing effective tools for agents — with agents

本文讨论如何为 LLM agent 设计更有效的工具,并以 Anthropic 的 MCP/Claude Code 实践为例,强调工具不是给确定性程序调用的普通 API,而是要适配会试错、会幻觉、会选择不同策略的非确定性 agent。文章给出一套迭代流程:先快速搭建本地原型,再用真实任务构建评测集,借助 LLM/人工 verifier 量化准确率、调用次数、耗时和 token 消耗,并用评测结果持续改进工具。核心经验包括:只实现高价值工具、按服务或资源做好命名空间、返回高信号且更语义化的上下文、控制响应长度与分页、以及把工具描述和参数命名写清楚。作者还指出,很多性能提升来自对工具说明、返回格式和错误信息的精细调整,而不是单纯增加工具数量。文中也承认这些最佳实践依赖具体模型与任务,需通过 held-out 测试集防止对评测集过拟合。

推荐收录,因为文章不仅解释了 agent 工具为何需要重新设计,还给出了原型、评测、日志分析到迭代优化的完整方法链,证据非常具体。适合正在做 MCP 服务、AI 工具链或 agent 评测的工程师参考,尤其有可迁移的命名、上下文压缩和工具描述优化经验。

工具笔记Anthropic Engineering

Desktop Extensions: One-click MCP server installation for Claude Desktop

文章介绍 Claude Desktop Extensions(MCPB)这一新的本地 MCP 服务器打包与安装格式,核心目标是把原先依赖 Node/Python、手动改配置和处理依赖冲突的安装流程,简化为下载 .mcpb 后在 Claude Desktop 中一键安装。作者说明了 MCPB 以 zip 形式封装 server、manifest、依赖和图标,manifest 负责描述元数据、运行时、工具/提示词、平台差异和用户配置,并支持模板变量与敏感信息存入系统密钥链。文章还给出 mcpb init/pack 的实践路径,以及跨平台、自动更新、目录浏览、企业预装/黑名单/MDM 等能力。它的价值在于为本地 AI 工具分发提供了可复用的规范,但当前版本仍是 0.1,具体字段和 Claude Desktop 实现预计会继续演进。

建议收录:正文明确给出了 .mcpb 打包格式、manifest 结构、模板变量、用户配置和企业管控等关键机制,不只是产品发布。适合做 MCP 服务器开发、桌面 AI 工具分发和安全安装设计的参考,但需注意规范仍处于 0.1 版本,后续可能演进。

工程实践Anthropic Engineering

How we built our multi-agent research system

文章复盘 Anthropic 将 Claude Research 从原型做成可上线的多智能体研究系统。系统采用 lead agent + 多个 subagent 的 orchestrator-worker 架构:主代理先规划研究路径,再并行派发子代理做广搜,最后由 CitationAgent 回收证据并生成带引用的答案。作者总结了多智能体提示词的关键原则,包括先广后窄、按任务复杂度分配代理数量和工具调用、明确分工边界、选择合适工具,并让模型自我修复提示词和工具描述。评估上,他们用小样本快速迭代、LLM-as-judge 和人工测试结合,关注事实准确性、引用准确性、覆盖度和工具效率。工程上则强调长链路状态持久化、错误恢复、全链路 tracing、渐进式部署和异步并行的权衡;但此架构代价高,尤其适合高价值、强并行的研究任务,不太适合上下文强耦合的编码场景。

收录价值高,因为文章把多智能体系统从架构、提示词、评估到线上可靠性完整串联,并明确给出失败模式、分工原则和部署策略等直接证据。适合做 AI 工程、Agent 系统和生产化研究助手的参考,但需注意 token 成本高、并非所有任务都适用。