青蛙小白
博客 / 2026/06

Claude Code Artifacts:把 Agent 的工作过程变成活文档

2026/06/21 · — 字 · 阅读约 — 分钟 ·
目录

Claude Code 现在支持 Artifacts —— 一句话版:你让 Claude Code 干活时,它可以把过程和结果生成一个可交互的网页,分享给团队看,而且会随着 Claude Code 继续工作自动更新。

Artifact 是什么

以前 Claude Code 的工作成果散在终端输出和对话里。查完 bug、读完代码、推理出根因之后,要把这些东西传递给其他人,只能截图、复制粘贴、或者口头转述。Claude Code 的 Artifacts 把这些工作打包成一个可访问的网页。

它不是让你手动填数据的表单,也不是让你把结论写进去的模板。Claude Code 会用当前会话里的上下文来生成页面,包括代码库、连接器数据(监控、日志、PR、issue 等)、你和 Claude 的对话、以及 Claude 已经做过的分析过程。说白了:不是你写报告,是 Claude Code 把它刚干的活自动包装成报告。

适用场景很具体:

场景Artifact 呈现的内容
PR reviewdiff、改动原因、测试结果、风险点
线上事故排查时间线、错误率图、可疑 commit、根因分析
架构理解服务依赖图、数据流图、模块关系
安全审计依赖许可证列表、风险项、对应代码位置
发布管理checklist、已完成项、阻塞项

三个关键设计

第一,基于 session 上下文生成,而不是空白起步。 这是和"让 Claude 帮我生成一个网页"的本质区别。Artifact 里的内容来自 Claude Code 这一轮已经做过的分析,不需要你重新描述场景、贴上下文。Claude Code 查到的东西直接进入 Artifact。

第二,页面会随调查进展更新。 Artifact 不是一次性静态输出。Claude Code 后续继续查东西、发现新线索时,可以重新 publish,同一个链接会更新。配合版本历史,可以看到调查思路的演进,也可以恢复到某个旧状态。对团队协作来说,这意味着不用每隔十分钟在群里发进度更新,丢一个链接,大家看同一个实时页面。

第三,默认私有,只面向组织内部。 Artifact 不是 CodePen 或 Vercel 那种公开展示页。默认只有作者可见,可以分享给团队或组织成员,但只有经过认证的组织成员能访问,不能生成公网公开链接。管理员可以配置权限和保留策略,合规 API 可以审计组织范围内的 artifact 情况。更像公司内部的"活文档",而不是对外展示用的页面。

它解决的根本问题

Agent 做了很多工作,但人类很难快速理解它到底干了啥、现在进展到哪、依据是什么。

这个问题在 Agent 能力越来越强之后反而更突出。以前 Claude Code 只能改几个文件,工作结果直接看代码就行。现在它能跑完整的事故排查、做多文件重构、读完整个代码库的安全状况,这些工作的过程和推理链在终端里是线性的、难以导航的。Artifacts 把这些东西重新组织成适合团队阅读的格式。

尤其适合几种交接场景:给 reviewer 看 PR、给 PM 看进度、给事故响应团队看当前排查状态、给安全合规团队看证据链、给新人看系统结构。这些场景的共同点是:信息消费者不在 Claude Code 的对话里,没有完整上下文,需要一个独立可读的快照。

怎么用

直接自然语言要求:

Make an artifact walking through this PR — the diff, the reasoning, and what I tested.
Turn this incident into an artifact — timeline, suspect commits, error spike from our monitoring — and republish as I work through it.

不需要学新语法,Claude Code 理解"做一个 artifact"这个意图。

本质上是什么

Artifacts 把 coding agent 的工作过程产品化成一个可分享、可更新、可审计的网页。重点不在于"生成了一个网页",而在于它的内容来自 agent 掌握的完整上下文、能随着工作继续演进、面向团队协作、有权限和版本管理。

某种意义上,它是"让 AI 的工作结果变得可交接"这个问题的一个具体解法。如果你平时用 Claude Code 做复杂的多步骤任务,这个会有用;如果只是让它改几个小文件,意义不大。

目前以 beta 形式向 Claude Team 和 Enterprise 组织开放,通过 Claude Code CLI 和桌面应用使用。

参考

评论