# Claude Cookbooks

Canonical: https://cqbase.net/zh/entry/claude-cookbooks
Chinese: https://cqbase.net/zh/entry/claude-cookbooks
English: https://cqbase.net/en/entry/claude-cookbooks

> Anthropic 的 Claude 示例笔记本，演示具体能力而不是产品介绍。

anthropics/claude-cookbooks 是 MIT 许可的笔记本集合，用来演示 Claude 的一些具体用法，例如工具、长上下文或分类这一类可以照着改的食谱。它比营销页更接近可以运行的代码。

选一个和你的功能接近的笔记本，把模型名换成你账户里实际可用的型号，再用你自己的一小段数据跑通。不要把食谱里的示例数据当成基准。

## 解决什么问题

[anthropics/claude-cookbooks](https://github.com/anthropics/claude-cookbooks) 是 Anthropic 维护的官方示例笔记本集合，用来演示调用 Claude API 的具体写法，而不是产品介绍页。仓库用 MIT 许可发布，并未归档。配套的网页目录在 [platform.claude.com/cookbook](https://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](https://console.anthropic.com/settings/keys)。

若你只用 claude.ai 聊天、并不调用 API，这个仓库帮不上太大忙。也不要把食谱里的示例数据或笔记本里保存的输出，当成你自己任务的基准成绩。

## 怎么用

说明来自 2026-11-16 查阅的 [CONTRIBUTING.md](https://github.com/anthropics/claude-cookbooks/blob/main/CONTRIBUTING.md)、[`.env.example`](https://github.com/anthropics/claude-cookbooks/blob/main/.env.example) 和 [pyproject.toml](https://github.com/anthropics/claude-cookbooks/blob/main/pyproject.toml)。官方推荐用 [uv](https://docs.astral.sh/uv/)：

```bash
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](https://github.com/anthropics/claude-cookbooks/blob/main/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 查阅的官方[模型总览](https://platform.claude.com/docs/en/about-claude/models/overview)里，当前 Fable 最新别名是 `claude-fable-5-2`。打开笔记本后，请把模型名换成你账户实际能调用、并与该总览页一致的型号，不要默认笔记本里写死的字符串仍然有效。

## 一个实际例子

下面是一个只跑单篇、控制花费的路径。本次没有执行任何笔记本，因此不编造单元格输出或分类准确率。

1. 在 [网页目录](https://platform.claude.com/cookbook) 或仓库目录里，选一篇和你的功能接近、范围较小的食谱。若你只是先验证环境，优先选分类、摘要或官方标注为入门的短笔记本，而不是多代理或评测长文。
2. 按上一节安装依赖并写入 API 密钥。先把笔记本中的模型名对照[模型总览](https://platform.claude.com/docs/en/about-claude/models/overview)改成你账户可用的型号；若只是打通流程，可用 `.env.example` 建议的 `claude-haiku-5-5`。
3. 把示例数据换成你自己的一小段文本或文件，然后从上到下运行。预期效果：客户端能成功调用 API，并按该食谱演示的步骤给出结果。请自己检查返回内容，不要把仓库里保存的旧输出当成当前模型的成绩。
4. 跑通后立刻检查密钥没有被写入笔记本或 git。接下来只改与你功能相关的那几段提示词或工具定义。

## 常见坑

- 只根据根目录 README 的食谱表判断「官方现在有哪些例子」。那张表窄于仓库目录和 [platform.claude.com/cookbook](https://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](https://github.com/anthropics/claude-cookbooks)。它此前用过 `anthropics/anthropic-cookbook` 这个名字。旧地址在 GitHub 上通常会跳转，但克隆、引用和提 issue 请使用现名。`pyproject.toml` 里的项目名仍是 `anthropic-cookbook`，这不影响你按现仓库路径克隆。

### 需要哪个 Python 版本？

CONTRIBUTING 写的是 3.11 或更高；`pyproject.toml` 写的是 `>=3.11,<3.13`。二者并不完全一致。本次没有在区间外的版本上实跑。跟随官方锁文件安装时，优先满足 `pyproject.toml`。

### 笔记本里的模型名可以直接用吗？

不一定。先对照官方[模型总览](https://platform.claude.com/docs/en/about-claude/models/overview)和你账户里实际可用的型号。`.env.example` 把低成本默认值写成 `claude-haiku-5-5`，但这仍需你自己确认。

### 只看书还是必须克隆仓库？

只阅读可以先用 [platform.claude.com/cookbook](https://platform.claude.com/cookbook)。要运行代码，再克隆仓库并按 CONTRIBUTING 安装依赖。网页目录和仓库文件可能会有出入，运行时以仓库里的笔记本为准。

### 许可证是什么？一定要有 API 密钥吗？

仓库为 MIT 许可，见 [LICENSE](https://github.com/anthropics/claude-cookbooks/blob/main/LICENSE)。要真正调用 Claude API，需要你自己的密钥；申请入口见控制台的[密钥页面](https://console.anthropic.com/settings/keys)。密钥从环境变量读取，不要写入仓库。地区或账户是否可用，只以 Anthropic 官方说明为准，本文不讨论绕过方法。

## 来源与许可

仓库 [anthropics/claude-cookbooks](https://github.com/anthropics/claude-cookbooks) 使用 MIT 许可。本文依据 2026-11-16 查阅的 README、[CONTRIBUTING.md](https://github.com/anthropics/claude-cookbooks/blob/main/CONTRIBUTING.md)、`pyproject.toml`、`.env.example`、[网页目录](https://platform.claude.com/cookbook) 和官方[模型总览](https://platform.claude.com/docs/en/about-claude/models/overview)，用自己的话写成，供 CQBase 上下文库使用。若安装步骤或模型名有变，以仓库和官方文档为准。

## 收录信息

- 作者: anthropics
- 许可证: MIT
- 来源: https://github.com/anthropics/claude-cookbooks
- 收录: 2026-11-15
- GitHub 星标: 54688（采集 2026-11-15）

