Claude Cookbook

# Claude Cookbook 来源：https://platform.claude.com/cookbook ## 使用 Claude 的实用指南与示例 ## 全部指南 标题类别作者\(s\)日期在 Messages API 中复现 Claude 的智能搜索基准分数2026年6月• EvalsTools 构建一个 Messages API 测试框架，通过程序化工具调用、服务端压缩和任务预算，复现已发表的 DeepSearchQA 和 BrowseComp 分数。 (https://platform.claude.com/cookbook/evals-agentic-search-reproduce-agentic-search-benchmarks)EvalsTools Mengting LiMengting Li Jun 2026Claude Fable 5 的分类器回退与计费2026年6月• ResponsesSafeguardsBilling 检测 Fable 5 上的安全分类器阻塞，并通过服务端或基于 SDK 的客户端回退机制降级到 Opus 4.8，涵盖流式行为及新的计费变更。 (https://platform.claude.com/cookbook/fable-5-fallback-billing-guide)ResponsesSafeguardsBilling Alexander BrickenAlexander Bricken Mahesh MuragMahesh Murag Mikaela GraceMikaela Grace Jun 2026异步多智能体编排2026年6月• Agent Patterns 两种异步多智能体模式——通过共享枢纽进行对等消息传递的固定 N 智能体团队，以及动态生成的异步子智能体——精简到基本的消息传递和生命周期机制。 (https://platform.claude.com/cookbook/patterns-agents-async-multi-agent-orchestration)Agent Patterns Paul ChenPaul Chen Jun 2026托管你的智能体2026年5月• Claude Agent SDK 将 Notebook 00 的研究智能体通过三个运营成熟度层级（Docker、Modal、Kubernetes）部署，每个层级使用相同的容器镜像和 HTTP 接口。 (https://platform.claude.com/cookbook/claude-agent-sdk-07-hosting-the-agent)Claude Agent SDK Kevin TangKevin Tang Anav SharmaAnav Sharma May 2026多智能体：协调专家团队2026年5月• Claude Managed AgentsTools 通过多智能体协调器配置实现异构团队——一个协调器运行三个专家（网页搜索研究员、文件阅读管理员、基于规则的定价员），各具限定工具集，共同构建销售提案。涵盖多智能体字段、thread_created/thread_message_received 事件类型及按角色的工具范围限定。 (https://platform.claude.com/cookbook/managed-agents-cma-coordinate-specialist-team)Claude Managed AgentsTools Mark NowickiMark Nowicki May 2026Outcomes：自我验证的智能体2026年5月• Claude Managed AgentsEvals 通过 Outcomes 构建评分与修订循环：一个写作者起草引用研究简报，一个无状态评分器获取每个 URL 并按评分标准检查每条引用，反馈驱动修订直至通过。涵盖 user.define_outcome、span.outcome_evaluation_* 事件及如何编写评分器可执行的评分标准。 (https://platform.claude.com/cookbook/managed-agents-cma-verify-with-outcome-grader)Claude Managed AgentsEvals Mark NowickiMark Nowicki Gagan BhatGagan Bhat May 2026构建能记住用户的智能体2026年4月• Claude Managed AgentsTools 为你的 Claude Managed Agents 提供记忆存储，使其能在多次交互中学习并记住用户偏好。 (https://platform.claude.com/cookbook/managed-agents-cma-remember-user-preferences)Claude Managed AgentsTools Gagan BhatGagan Bhat Apr 2026漏洞检测智能体2026年4月• Claude Agent SDK网络安全 构建一个漏洞发现智能体，使用 Claude Agent SDK 对 C 语言目标进行威胁建模，通过内置文件工具查找内存安全漏洞，并将发现结果整理成结构化报告。 (https://platform.claude.com/cookbook/claude-agent-sdk-06-the-vulnerability-detection-agent)Claude Agent SDKCybersecurity Eugene YanEugene Yan Apr 2026使用 Claude Managed Agents 构建 SRE 事件响应智能体2026年4月• Claude Managed Agents可观测性 将 Claude 接入你的值班流程：当警报触发时，智能体读取日志和运维手册，定位根因，创建修复 PR，并在合并前等待你的批准。 (https://platform.claude.com/cookbook/managed-agents-sre-incident-responder)Claude Managed AgentsObservability Gagan BhatGagan Bhat Apr 2026使用 Claude Managed Agents 构建数据分析智能体2026年4月• Claude Managed AgentsTools 构建一个分析师，将 CSV 转换为包含交互式图表的叙事性 HTML 报告，利用沙箱环境和文件挂载功能。 (https://platform.claude.com/cookbook/managed-agents-data-analyst-agent)Claude Managed AgentsTools Charmaine LeeCharmaine Lee Jess YanJess Yan Apr 2026使用 Claude Managed Agents 构建 Slack 数据分析机器人2026年4月• Claude Managed Agents集成 在对话中提及机器人并附上 CSV，即可在线程中获得分析报告，并支持同一会话内的多轮追问。 (https://platform.claude.com/cookbook/managed-agents-slack-data-bot)Claude Managed AgentsIntegrations Charmaine LeeCharmaine Lee Apr 2026Managed Agents 教程：迭代修复失败的测试套件2026年4月• Claude Managed AgentsTools Claude Managed Agents API 入门教程。通过让智能体修复 calc.py 包中的三个预设错误，逐步演示智能体/环境/会话创建、文件挂载及流式事件循环。 (https://platform.claude.com/cookbook/managed-agents-cma-iterate-fix-failing-tests)Claude Managed AgentsTools Paul YangPaul Yang Apr 2026Managed Agents 教程：生产环境配置2026年4月• Claude Managed Agents集成 Managed Agents 的端到端生产故事——基于 Vault 的 MCP 凭据、无需长连接的 session.status_idled 人工介入 webhook 模式，以及资源生命周期 CRUD 操作。 (https://platform.claude.com/cookbook/managed-agents-cma-operate-in-production)Claude Managed AgentsIntegrations Paul YangPaul Yang Apr 2026Managed Agents 教程：提示词版本管理与回滚2026年4月• Claude Managed AgentsEvals 服务端提示词版本管理——创建 v1，基于标注测试集评估，发布 v2，检测回归，通过将会话锁定到版本 1 实现回滚。涵盖 agents.update、sessions.create 的版本锁定，以及提示词非代码化时的审查关卡移动。 (https://platform.claude.com/cookbook/managed-agents-cma-prompt-versioning-and-rollback)Claude Managed AgentsEvals Mark NowickiMark Nowicki Apr 2026威胁情报富化智能体2026年4月• ToolsAgent Patterns网络安全 构建一个能自主调查 IOC 的智能体，通过查询多个威胁情报源、交叉引用发现、映射到 MITRE ATT&CK，并生成适用于 SIEM 和 SOAR 集成的结构化报告。 (https://platform.claude.com/cookbook/tool-use-threat-intel-enrichment-agent)ToolsAgent PatternsCybersecurity Jannet ParkJannet Park Apr 2026构建会话浏览器2026年3月• Claude Agent SDKAgent Patterns 列出、读取、重命名、标记和分叉磁盘上的 Agent SDK 会话，无需编写转写解析器即可构建对话历史侧边栏。 (https://platform.claude.com/cookbook/claude-agent-sdk-05-building-a-session-browser)Claude Agent SDKAgent Patterns Qing WangQing Wang Mar 2026使用 Claude 构建知识图谱2026年3月• RAG & RetrievalTools 利用 Claude 进行实体提取、关系挖掘、去重和多跳图查询，从非结构化文本中构建知识图谱。 (https://platform.claude.com/cookbook/capabilities-knowledge-graph-guide)RAG & RetrievalTools AnthropicAnthropic Mar 2026上下文工程：记忆、压缩与工具清理2026年3月• ToolsAgent Patterns 比较长期运行智能体的上下文工程策略，了解每种策略的适用场景、成本及组合方式。 (https://platform.claude.com/cookbook/tool-use-context-engineering-context-engineering-tools)ToolsAgent Patterns Isabella HeIsabella He Mar 2026从 OpenAI Agents SDK 迁移2026年3月• Claude Agent SDKAgent Patterns 将 OpenAI Agents SDK 应用移植到 Claude Agent SDK，通过一个费用审批智能体示例映射每个原语（工具、护栏、会话、交接）。 (https://platform.claude.com/cookbook/claude-agent-sdk-04-migrating-from-openai-agents-sdk)Claude Agent SDKAgent Patterns Preston TugglePreston Tuggle Mar 2026站点可靠性智能体2026年2月• Claude Agent SDKAgent Patterns 构建一个事件响应智能体，使用具备读写能力的 MCP 工具实现自主诊断、修复及事后文档编写。 (https://platform.claude.com/cookbook/claude-agent-sdk-03-the-site-reliability-agent)Claude Agent SDKAgent Patterns Ben LehrburgerBen Lehrburger Isabella HeIsabella He Feb 2026会话记忆压缩2026年1月• Agent PatternsResponses 通过后台线程和提示缓存，对长期运行的 Claude 对话进行即时会话记忆压缩。 (https://platform.claude.com/cookbook/misc-session-memory-compaction)Agent PatternsResponses Joe ShamonJoe Shamon Jan 2026程序化工具调用（PTC）2025年11月• Tools 通过让 Claude 在代码执行环境中编写调用工具的代码，降低延迟和令牌消耗。 (https://platform.claude.com/cookbook/tool-use-programmatic-tool-calling-ptc)Tools Pedram NavidPedram Navid Nov 2025基于嵌入的工具搜索2025年11月• ToolsRAG & Retrieval 使用语义嵌入实现动态工具发现，将 Claude 应用扩展到数千个工具。 (https://platform.claude.com/cookbook/tool-use-tool-search-with-embeddings)ToolsRAG & Retrieval Henry KeetayHenry Keetay Nov 2025自动上下文压缩2025年11月• ToolsAgent Patterns 通过自动压缩对话历史记录，管理长期运行的智能体工作流中的上下文限制。 (https://platform.claude.com/cookbook/tool-use-automatic-context-compaction)ToolsAgent Patterns Pedram NavidPedram Navid Nov 2025与 ElevenLabs 集成的低延迟语音助手2025年11月• 集成 使用 ElevenLabs 实现语音转文字和文字转语音，结合 Claude 构建低延迟语音助手。 (https://platform.claude.com/cookbook/third-party-elevenlabs-low-latency-stt-claude-tts)Integrations Adriaan EngelbrechtAdriaan Engelbrecht Nov 2025为 Claude 添加裁剪工具以改进图像分析2025年11月• MultimodalTools 为 Claude 提供裁剪工具，使其能够放大图像区域，对图表、文档和示意图进行详细分析。 (https://platform.claude.com/cookbook/multimodal-crop-tool)MultimodalTools Nadine YasserNadine Yasser Nov 2025前端美学的提示词设计2025年10月• ResponsesSkills 指导如何为 Claude 编写提示词，生成独特、精致的前端设计，避免千篇一律的美学风格。 (https://platform.claude.com/cookbook/coding-prompting-for-frontend-aesthetics)ResponsesSkills Prithvi RajasekaranPrithvi Rajasekaran Oct 2025金融应用的 Claude 技能2025年10月• Skills 利用 Claude 的 Excel、PowerPoint、PDF 技能构建金融仪表盘和投资组合分析。 (https://platform.claude.com/cookbook/skills-notebooks-02-skills-financial-applications)Skills Alex NotovAlex Notov Oct 2025为 Claude 构建自定义技能2025年10月• Skills 创建、部署和管理自定义技能，通过专业组织工作流扩展 Claude 功能。 (https://platform.claude.com/cookbook/skills-notebooks-03-skills-custom-development)Skills Alex NotovAlex Notov Oct 2025Claude 技能入门2025年10月• Skills 使用 Claude 的 Excel、PowerPoint、PDF 技能创建文档、分析数据、自动化工作流。 (https://platform.claude.com/cookbook/skills-notebooks-01-skills-introduction)Skills Alex NotovAlex Notov Oct 2025一行指令研究智能体2025年9月• Claude Agent SDKAgent Patterns 使用 Claude Code SDK 和 WebSearch 构建一个研究智能体，实现自主研究。 (https://platform.claude.com/cookbook/claude-agent-sdk-00-the-one-liner-research-agent)Claude Agent SDKAgent Patterns Rodrigo OlivaresRodrigo Olivares Jiri De JongheJiri De Jonghe Sep 2025幕僚长智能体2025年9月• Claude Agent SDKAgent Patterns 构建多智能体系统，支持子智能体、钩子、输出样式和计划模式等功能。 (https://platform.claude.com/cookbook/claude-agent-sdk-01-the-chief-of-staff-agent)Claude Agent SDKAgent Patterns Rodrigo OlivaresRodrigo Olivares Jiri De JongheJiri De Jonghe Sep 2025可观测性智能体2025年9月• Claude Agent SDKAgent Patterns 通过 MCP 服务器将智能体连接到外部系统，实现 GitHub 监控和 CI 工作流。 (https://platform.claude.com/cookbook/claude-agent-sdk-02-the-observability-agent)Claude Agent SDKAgent Patterns Rodrigo OlivaresRodrigo Olivares Jiri De JongheJiri De Jonghe Sep 2025工具评估2025年9月• Evals 独立于评估任务文件，并行运行工具相关的智能体评估。 (https://platform.claude.com/cookbook/tool-evaluation-tool-evaluation)Evals AnthropicAnthropic Sep 2025用量与费用管理 Admin API 指南2025年8月• 可观测性 通过 Admin API 以编程方式访问和分析你的 Claude API 使用量和费用数据。 (https://platform.claude.com/cookbook/observability-usage-cost-api)Observability AnthropicAnthropic Aug 2025与 Claude Sonnet 4.6 的记忆与上下文管理2025年5月• ToolsAgent Patterns 利用 Claude 的记忆工具和上下文编辑功能，构建具有持久记忆的 AI 智能体。 (https://platform.claude.com/cookbook/tool-use-memory-cookbook)ToolsAgent Patterns Alex NotovAlex Notov May 2025投机性提示缓存2025年5月• Responses 在用户构思查询时通过投机性预热缓存，缩短首次令牌生成时间。 (https://platform.claude.com/cookbook/misc-speculative-prompt-caching)Responses AnthropicAnthropic May 2025在 Claude 3.7 Sonnet 上的并行工具调用2025年3月• Tools 通过在 Claude 3.7 Sonnet 上使用批量工具元模式变通方法，实现并行工具调用。 (https://platform.claude.com/cookbook/tool-use-parallel-tools)Tools AnthropicAnthropic Mar 2025扩展思考2025年2月• Thinking 利用 Claude 的扩展思考功能，结合预算管理实现透明的逐步推理。 (https://platform.claude.com/cookbook/extended-thinking-extended-thinking)Thinking Alex AlbertAlex Albert Feb 2025结合工具使用的扩展思考2025年2月• ThinkingTools 将扩展思考与工具结合，在多步骤工作流中实现透明的推理过程。 (https://platform.claude.com/cookbook/extended-thinking-extended-thinking-with-tool-use)ThinkingTools Alex AlbertAlex Albert Feb 2025基础工作流2024年12月• Agent Patterns 三种简单的多 LLM 工作流模式，通过权衡成本或延迟来提升性能。 (https://platform.claude.com/cookbook/patterns-agents-basic-workflows)Agent Patterns AnthropicAnthropic Dec 2024评估者-优化器2024年12月• Agent PatternsEvals 一种工作流模式，使用一个 LLM 进行生成，另一个 LLM 进行评估反馈循环。 (https://platform.claude.com/cookbook/patterns-agents-evaluator-optimizer)Agent PatternsEvals AnthropicAnthropic Dec 2024编排器-工作者2024年12月• Agent Patterns 中央 LLM 动态地将任务委派给工作者 LLM，并综合它们的合并结果。 (https://platform.claude.com/cookbook/patterns-agents-orchestrator-workers)Agent Patterns AnthropicAnthropic Dec 2024使用 Message Batches API 进行批处理2024年10月• Responses 通过批量处理以 50% 的成本降低异步处理大量 Claude 请求。 (https://platform.claude.com/cookbook/misc-batch-processing)Responses Alex AlbertAlex Albert Oct 2024使用 Claude 实现文本到 SQL2024年9月• RAG & Retrieval 利用 RAG、思维链和自改进技术，将自然语言查询转换为 SQL。 (https://platform.claude.com/cookbook/capabilities-text-to-sql-guide)RAG & Retrieval Mahesh MuragMahesh Murag Sep 2024通过上下文检索增强 RAG2024年9月• RAG & Retrieval 在嵌入前为文本块添加上下文，结合提示缓存提升 RAG 准确性。 (https://platform.claude.com/cookbook/capabilities-contextual-embeddings-guide)RAG & Retrieval AnthropicAnthropic Sep 2024在 Bedrock 上微调 Claude 3 Haiku2024年8月• Fine-Tun