claude-cookbooks 是什么?

Claude Cookbooks 是 Anthropic 官方的『食谱』集合:用 Jupyter Notebook 提供一批可直接复制、即拿即用的代码与指南,教开发者怎么用 Claude API 做实事。它覆盖从基础能力(分类、RAG、摘要、text-to-SQL)、工具调用、多模态视觉,到进阶技巧(扩展思考、prompt 缓存、JSON 模式、自动化评测、内容审核),再到 Claude Agent SDK 的成体系示例(研究/幕僚长/可观测/SRE/漏洞检测 agent,以及从 OpenAI Agents SDK 迁移)。代码主要是 Python,但概念可迁移到任意语言。MIT,前身是 anthropic-cookbook,是用 Claude 构建应用的官方参考库。

⭐ 41,161 Stars 🍴 4,556 Forks Jupyter Notebook MIT 作者: anthropics 商业引流:低
来源:官方 README 与文档入口 查看 GitHub 仓库 →

为什么值得关注

约 4.35 万星、自 2023 年就是 Claude 开发者的标配参考。热度来自『官方 + 即拿即用』:想用 Claude 做 RAG、工具调用、视觉、agent,最快的路径就是抄它的 notebook。随着 Claude Agent SDK、扩展思考、Skills 等新能力推出,cookbook 持续补上对应的成体系示例(如幕僚长/SRE/漏洞检测 agent),始终是跟进 Claude 最新用法的第一手资料。

来源:官方 README 与文档入口

核心功能

核心能力食谱

分类、检索增强生成(RAG)、摘要、text-to-SQL、知识图谱、上下文嵌入等,给出可复制的实现范式,帮你把 Claude 接进具体任务。

来源:官方 README 与文档入口
工具调用与第三方集成

工具调用(客服 agent、计算器、SQL 查询等)示例,以及与向量库 Pinecone、Wikipedia、网页、Voyage AI 嵌入等第三方的集成配方。

来源:官方 README 与文档入口
多模态与进阶技巧

视觉入门与最佳实践、读图表/表单内容、配 Stable Diffusion 生图;进阶含 sub-agent(Haiku 作 Opus 子代理)、PDF 上传、自动化评测、JSON 模式、内容审核过滤器、prompt 缓存等。

来源:官方 README 与文档入口
Claude Agent SDK 成体系示例

claude_agent_sdk/ 下有一系列可运行 agent 案例:一行研究 agent、幕僚长 agent、可观测 agent、站点可靠性 agent、漏洞检测 agent、会话浏览器,以及从 OpenAI Agents SDK 迁移的指南。

来源:官方仓库
官方权威 + 可贡献

由 Anthropic 维护、随 Claude 新能力持续更新,并欢迎社区贡献新 recipe;配 registry/authors 元数据、CI(lychee 链接检查/pre-commit/tox)保证质量。

来源:官方 README 与文档入口

技术架构

一个以 Jupyter Notebook 为主的教学/参考仓库,按主题分目录组织:capabilities(分类/RAG/摘要/text-to-SQL/知识图谱/嵌入)、tool_use、multimodal、patterns、skills、coding、extended_thinking、managed_agents、observability、tool_evaluation、finetuning、third_party(各集成)、misc,以及最成体系的 claude_agent_sdk(多个端到端 agent 子项目 + notebook)。每个 recipe 是自包含的 notebook 或带子项目的目录,强调可复制片段直接用于自己的项目。仓库用 uv/pyproject 管依赖,registry.yaml/authors.yaml 做食谱与作者索引,lychee 检查链接、pre-commit/tox/tests 保证可运行与一致性。它没有运行时产品,价值在于这套由官方维护、随 Claude 能力演进的高质量、可执行示例库。

来源:官方 README 与文档入口

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) anthropic(Claude API SDK)anthropic(Cla… Claude Agent SDKClaude Agent S… 第三方集成(Pinecone/Voyage AI/Wikipedia 等)第三方集成(Pin… uv / pyproject(依赖)uv / pyproject… Jupyter 核心能力食谱 工具调用与第三方集成 多模态与进阶技巧 Claude Agent SDK 成体系示例Claude Agent SDK 成… 官方权威 + 可贡献 claude-cookbooks 项目本体 核心功能 关键依赖

技术栈

语言Jupyter Notebook / Python框架Claude API + Claude Agent SDK
anthropic(Claude API SDK)Claude Agent SDK第三方集成(Pinecone/Voyage AI/Wikipedia 等)uv / pyproject(依赖)Jupyter
本地跑 notebook;需 Claude API key;部分 recipe 接第三方服务
来源:官方 README 与文档入口

快速上手

需一个 Claude API key(官网免费注册)。clone 仓库、用 uv/pyproject 装依赖后,打开感兴趣主题目录下的 notebook 直接跑:想做 RAG 看 capabilities/retrieval_augmented_generation,做工具调用看 tool_use,做视觉看 multimodal,做 agent 看 claude_agent_sdk(从 00_The_one_liner_research_agent 起步)。代码是 Python,但思路可迁移到任意语言。新手建议先过 Anthropic API Fundamentals 课程打底,再按需抄对应 recipe 进自己项目。
来源:官方 README 与文档入口

使用场景

适合:①用 Claude API 做开发、想要官方、可复制、随版本更新的范例(RAG/工具/视觉/评测/缓存等)的工程师;②想成体系学 Claude Agent SDK、照着构建研究/运维/安全等 agent 的人;③从 OpenAI Agents SDK 迁移到 Claude 的团队;④教学/自学 Claude 用法的人。不适合:不使用 Claude 的人;以及想要现成产品/框架而非示例代码的人——它是 recipe 集合,需要你抄改进自己的项目。

来源:官方 README 与文档入口

优势与局限

优势

  • 官方权威 + 即拿即用:可复制的 notebook 覆盖 Claude 主要用法,是最可信的第一手参考
  • 覆盖广且与时俱进:从 RAG/工具/视觉到 Agent SDK、扩展思考、Skills,随 Claude 新能力持续补
  • Agent SDK 示例成体系:研究/幕僚长/SRE/漏洞检测等端到端案例 + 迁移指南,学习价值高
  • 工程质量有保障:CI 链接检查、pre-commit、tests,可运行性与一致性较好,MIT 可自由用
  • 降低上手门槛:配 API Fundamentals 课程与文档链接,新手也能按图索骥

局限

  • 是示例/教学库而非产品框架,需要自己抄改、整合进项目,不能直接当生产代码用
  • 示例以 Python 为主,其他语言需自行适配
  • recipe 质量与新鲜度不一,部分可能滞后于最新 API/模型,需对照官方文档
  • 运行需 Claude API key(及部分第三方服务),有调用成本
  • 覆盖的是『怎么用 Claude』,不解决你具体业务的架构与工程化问题
来源:官方 README 与文档入口

最新版本

仓库无正式 GitHub Release,作为官方示例库以主分支持续更新(最近 push 2026-05-22,创建于 2023-08-15),随 Claude 能力(Agent SDK、扩展思考、Skills 等)不断新增/更新 recipe;已从 anthropic-cookbook 更名为 claude-cookbooks。

来源:官方 Releases

总结评价

Claude Cookbooks 是用 Claude 做开发的『标准答案集』:Anthropic 官方维护、可复制即用的 notebook,从 RAG、工具调用、视觉到成体系的 Agent SDK 案例(含从 OpenAI Agents SDK 迁移)一应俱全,且随 Claude 新能力持续更新,4.35 万星说明它是开发者的常备参考。要清楚它的定位——是示例/教学库不是产品框架,需要你抄改进自己的项目,示例以 Python 为主、部分可能滞后于最新 API、跑起来要 API key 有成本。但凡你在用 Claude 构建应用或 agent,这里基本是最该先翻的地方,照着 recipe 起步能省下大量摸索。

来源:官方 README 与文档入口
资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-05-22 23:42.

参考材料:README、GitHub API、依赖文件