Anthropic 官方脚手架：claude-quickstarts 该抄哪一份
Anthropic 的 claude-quickstarts：客服、Computer Use、浏览器自动化与自主编码的可运行示例，附前提与缺口。
第一次用 Claude API 做应用，卡点很少在「调通接口」，而在接口之外的那一圈：会话状态存哪里、工具怎么声明、Agent 跑到一半崩了怎么续、提示缓存和批量工具调用怎么落到代码里。Anthropic 自己的 claude-quickstarts 就是为这一圈准备的：十几个能直接跑起来的完整项目，每个带独立 README 和配置说明，仓库以 MIT 许可开放，截至 2026-10-18 有 18,602 颗星，主要语言 TypeScript。
要点
- 仓库的真实形态是 15 个左右可独立运行的项目，覆盖客服、财务分析、Computer Use、浏览器自动化、自主编码和 Managed Agents 六类场景。
- 最适合先跑的是 Customer Support Agent 与 Financial Data Analyst：依赖少、跑通快，能先把「会话 + 工具 + 流式输出」的基本骨架看懂。
- Computer Use 与 Browser Use 示例会真实操作桌面或浏览器，官方明确建议在虚拟机里跑；Managed Agents 系列则要先有 Anthropic 的 Managed Agents 权限。
- 官方示例的价值在「Anthropic 自己怎么写提示词、怎么声明工具、怎么处理长会话」，但这些示例不构成生产模板：鉴权、多租户、限流和成本控制大多要自己补。
它到底装了什么
打开仓库根目录的 README，会看到一条按场景分组的清单。最基础的一组是 Customer Support Agent（带知识库的客服机器人）和 Financial Data Analyst（上传财务数据后，用自然语言生成交互式图表）。这两个项目都把会话、工具调用和前端界面串在一起，是理解 Claude 应用骨架最短的路径。
第二组是 Computer Use：Computer Use Demo 用容器跑一个能让 Claude 控制桌面的环境，Computer Use Best Practices 则是一个原生 macOS 参考实现，README 建议放在虚拟机里运行。后者把提示缓存、服务端压缩、批量工具调用、沙盒化 Shell 和轨迹记录这些实践写进了代码，比文档里抽象的描述更容易对照。
第三组是浏览器自动化。Browser Use Demo 基于 Playwright，演示 Claude 如何导航、读取 DOM、点击和填表；同一目录下还有 Browser Toolset 与 Computer Toolset 两个更小的示例，用来单独验证工具声明。
第四组是 Autonomous Coding Agent：基于 Claude Agent SDK 的双 Agent 模式，一个负责初始化、一个负责编码，进度用 git 和一份功能清单持久化，因此可以跨多个会话继续写一个完整应用。这也是站内已经单独写过的 ai-job-search 那类工作流的官方原型。
第五组是 Managed Agents 系列，也是仓库里数量最多的一类：Slack 机器人、Linear 集成、每日简报、知识库 Wiki、Sentry 错误分诊、路途规划器，以及一个把 Managed Agents Sessions API 封装成九个工具的 MCP Server（支持 stdio 与 Streamable HTTP）。这些示例的共性是「不常驻进程」：靠 webhook 或定时任务触发一次会话，跑完就结束。
每个入口的前提
| 示例 | 最适合谁 | 跑之前要准备什么 |
|---|---|---|
| Customer Support Agent | 想做客服/知识库问答的团队 | Claude API Key、向量库或检索服务 |
| Financial Data Analyst | 要做数据问答与图表的产品 | Claude API Key、可运行的前端环境 |
| Computer Use Demo | 想验证桌面操作 Agent | 容器环境，且只给它必要的权限 |
| Computer Use Best Practices | 要研究工具设计细节的开发者 | macOS，最好在虚拟机里跑 |
| Browser Use Demo | 要做网页自动化的团队 | Playwright 与浏览器依赖 |
| Autonomous Coding Agent | 想做长任务编码 Agent | Claude Agent SDK、可写的代码仓库 |
| Managed Agents 系列 | 已有 Managed Agents 权限的团队 | Anthropic 账号权限、对应平台（Slack/Linear 等）的凭据 |
| MCP Server 示例 | 想把自己 Agent 接进 Claude 桌面端的人 | 一个运行中的 Managed Agents 工作区 |
怎么读这些代码
官方示例最值得抄的是几处实现细节，目录结构反而次要。第一是工具声明：每个示例都把工具的参数、边界和返回格式写得很克制，能看出 Anthropic 更倾向「少而明确」的工具集。第二是长会话处理：Autonomous Coding Agent 把进度写进 git 与功能清单，Managed Agents 示例把状态放进 session metadata，两种做法都在避免「把全部上下文塞进一次请求」。第三是失败处理：每日简报示例专门记录了「某个来源读不到时，报告为 unreadable，而不是当作今天没有更新」，这类失败语义在文档里通常一笔带过。
也要看清它不是什么。这些项目大多以「演示一条完整路径」为目标，鉴权、多租户隔离、限流、审计和成本上限都需要自己补；Computer Use 与 Browser Use 会真实操作用户环境，官方自己建议放进虚拟机；Managed Agents 系列依赖 Anthropic 的托管能力，换供应商或自建会话服务时这部分要重写。仓库的 MIT 许可允许商用，但第三方依赖和模型调用仍按各自条款。
快速上手
最短路径是只跑一个示例，而不是克隆整个仓库后逐个试：
git clone https://github.com/anthropics/claude-quickstarts.git
cd claude-quickstarts/customer-support-agent
# 按该目录 README 安装依赖
export ANTHROPIC_API_KEY=your_key
每个子目录都有自己的 README，安装命令和所需服务以它为准。想先看机制而不部署，可以直接读 computer-use-best-practices 与 autonomous-coding 两个目录的代码，它们把工具声明、上下文管理和失败恢复写得最完整。
和其他路线的关系
如果你要的是「现成的应用框架」，Everything Claude Code 这类工程配置合集更直接；如果你要的是「一个能跑的业务示例」，claude-quickstarts 的性价比更高，因为它是官方维护、和 API 更新同步。两者可以叠加：先用 quickstarts 跑通一条业务路径，再把工程规范搬进来。
值不值得抄
值得，但要带着判断抄。它解决的是「从零到能跑」这一段，且由 Anthropic 自己维护，API 变更时通常最先更新；代价是示例为了演示而简化了生产环境的复杂度。比较务实的用法是挑一个最接近你产品的示例跑通，再对照 computer-use-best-practices 和 autonomous-coding 补齐工具设计、上下文与失败处理三块，最后再决定哪些部分换成自己的实现。仓库截至 2026-10-18 有 18,602 颗星，最近一次推送是 2026-10-08。