教程
Claude Cookbooks
Anthropic 的 Claude 示例笔记本,演示具体能力而不是产品介绍。
anthropics/claude-cookbooks 是 MIT 许可的笔记本集合,用来演示 Claude 的一些具体用法,例如工具、长上下文或分类这一类可以照着改的食谱。它比营销页更接近可以运行的代码。
选一个和你的功能接近的笔记本,把模型名换成你账户里实际可用的型号,再用你自己的一小段数据跑通。不要把食谱里的示例数据当成基准。
本页是导读,不是原文。
解决什么问题
anthropics/claude-cookbooks 是 Anthropic 维护的官方示例笔记本集合,用来演示调用 Claude API 的具体写法,而不是产品介绍页。仓库用 MIT 许可发布,并未归档。配套的网页目录在 platform.claude.com/cookbook,适合先浏览再回到仓库里打开对应笔记本。
核验日期为 2026-11-16(Asia/Shanghai)。仓库最近一次推送是 2026-11-04 19:23 UTC,换算为 2026-11-05 03:23(Asia/Shanghai)。需要注意两处容易过时的信息。第一,仓库曾用名 anthropics/anthropic-cookbook,当前 README 里仍有一部分链接写成旧名;GitHub 一般会跳转到现仓库,但请以 anthropics/claude-cookbooks 为准。第二,根目录 README 的食谱表明显窄于仓库实际目录和官方网页目录:仓库里还有 skills、managed_agents、claude_agent_sdk、extended_thinking、evals 等目录,网页上也能看到 2026 年 11 月的较新条目。选例子时不要只盯着 README 那张表。
适合谁
适合已经准备使用 Claude API、希望对着可运行示例改自己功能的开发者。示例以 Python 为主。你需要自己的 API 密钥,密钥申请入口见 console.anthropic.com。
若你只用 claude.ai 聊天、并不调用 API,这个仓库帮不上太大忙。也不要把食谱里的示例数据或笔记本里保存的输出,当成你自己任务的基准成绩。
怎么用
说明来自 2026-11-16 查阅的 CONTRIBUTING.md、undefined 和 pyproject.toml。官方推荐用 uv:
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks
uv sync --all-extras
cp .env.example .env然后在 .env 里填写 ANTHROPIC_API_KEY,不要把该文件提交进仓库。.env.example 把可选的默认测试模型写成 claude-haiku-5-5。也可以先只在网页目录里阅读,确认要跑哪一篇后再克隆。
关于 Python 版本,官方材料并不完全一致:CONTRIBUTING.md 写的是 “Python 3.11 or higher”;同日的 pyproject.toml 则是 requires-python = ">=3.11,<3.13"。本次没有在 3.13 上实跑,因此不能断言更高版本一定可用或一定不可用。若只是跟随官方环境安装,请以 pyproject.toml 的约束为准,或先使用 3.11 或 3.12。
模型名更容易过时。CONTRIBUTING 把当时的常用别名写成 claude-opus-5-5、claude-sonnet-5-5、claude-fable-5-1、claude-haiku-5-5,并建议不要使用带日期的旧模型 ID,低成本示例可用 claude-haiku-5-5。但 2026-11-16 查阅的官方模型总览里,当前 Fable 最新别名是 claude-fable-5-2。打开笔记本后,请把模型名换成你账户实际能调用、并与该总览页一致的型号,不要默认笔记本里写死的字符串仍然有效。
一个实际例子
下面是一个只跑单篇、控制花费的路径。本次没有执行任何笔记本,因此不编造单元格输出或分类准确率。
- 在 网页目录 或仓库目录里,选一篇和你的功能接近、范围较小的食谱。若你只是先验证环境,优先选分类、摘要或官方标注为入门的短笔记本,而不是多代理或评测长文。
- 按上一节安装依赖并写入 API 密钥。先把笔记本中的模型名对照模型总览改成你账户可用的型号;若只是打通流程,可用
.env.example建议的claude-haiku-5-5。 - 把示例数据换成你自己的一小段文本或文件,然后从上到下运行。预期效果:客户端能成功调用 API,并按该食谱演示的步骤给出结果。请自己检查返回内容,不要把仓库里保存的旧输出当成当前模型的成绩。
- 跑通后立刻检查密钥没有被写入笔记本或 git。接下来只改与你功能相关的那几段提示词或工具定义。
常见坑
- 只根据根目录 README 的食谱表判断「官方现在有哪些例子」。那张表窄于仓库目录和 platform.claude.com/cookbook,也仍含指向旧仓库名的链接。
- 直接运行几年前的笔记本,却不改模型 ID。CONTRIBUTING 与官方模型总览也不完全同步(例如 Fable 的 5.1 与 5.2)。以模型总览和你账户实际可调用的型号为准。
- 忽略 Python 版本的两种说法。若
uv sync失败,先核对本地 Python 是否落在pyproject.toml写明的>=3.11,<3.13区间。 - 把 API 密钥写进笔记本或提交
.env。官方要求从环境变量读取。 - 把食谱里的示例数据和已保存输出,当成可对外公布的评测结论。
FAQ
仓库现在叫什么?旧链接还能用吗?
当前官方仓库是 anthropics/claude-cookbooks。它此前用过 anthropics/anthropic-cookbook 这个名字。旧地址在 GitHub 上通常会跳转,但克隆、引用和提 issue 请使用现名。pyproject.toml 里的项目名仍是 anthropic-cookbook,这不影响你按现仓库路径克隆。
需要哪个 Python 版本?
CONTRIBUTING 写的是 3.11 或更高;pyproject.toml 写的是 >=3.11,<3.13。二者并不完全一致。本次没有在区间外的版本上实跑。跟随官方锁文件安装时,优先满足 pyproject.toml。
笔记本里的模型名可以直接用吗?
不一定。先对照官方模型总览和你账户里实际可用的型号。.env.example 把低成本默认值写成 claude-haiku-5-5,但这仍需你自己确认。
只看书还是必须克隆仓库?
只阅读可以先用 platform.claude.com/cookbook。要运行代码,再克隆仓库并按 CONTRIBUTING 安装依赖。网页目录和仓库文件可能会有出入,运行时以仓库里的笔记本为准。
许可证是什么?一定要有 API 密钥吗?
仓库为 MIT 许可,见 LICENSE。要真正调用 Claude API,需要你自己的密钥;申请入口见控制台的密钥页面。密钥从环境变量读取,不要写入仓库。地区或账户是否可用,只以 Anthropic 官方说明为准,本文不讨论绕过方法。
来源与许可
仓库 anthropics/claude-cookbooks 使用 MIT 许可。本文依据 2026-11-16 查阅的 README、CONTRIBUTING.md、pyproject.toml、.env.example、网页目录 和官方模型总览,用自己的话写成,供 CQBase 上下文库使用。若安装步骤或模型名有变,以仓库和官方文档为准。