Mindket

Claude Cookbooks 示例合集

新上架第 2 版 · 更新于
星标54.3k

概览

Anthropic 的 Jupyter 笔记本和 Python 示例,教你用 Claude API 做开发。文件夹涵盖工具调用、检索、Skills、Claude Agent SDK 和 Managed Agents。安装说明涵盖 uv、pip、根目录、skills、Agent SDK 和 Managed Agents 文件夹要用的密钥、Claude Code 命令,以及在线阅读示例。

Claude Cookbooks 示例合集 是一款 GitHub 上的开源项目,属于开发类,由 Mindket 上架。可免费获取。当前为第 2 版,最近更新于 。按它的 README 从 GitHub 安装。Mindket 的设置说明可在你的 Mindket 账户获取,以 zip 压缩包下载。

速览

用在
  • 在你自己的电脑上用 uv:仓库根目录,Python 3.11 或 3.12
  • 在你自己的电脑上用 pip:skills 文件夹,在虚拟环境里
  • 用 uv 做出来的 Jupyter 内核:claude_agent_sdk 文件夹
  • Claude Managed Agents,Anthropic 托管的运行环境:managed_agents 里的笔记本用你的密钥去调用它
先运行
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks
uv sync --all-extras

平台

ClaudeAI 对话
Claude Code编程智能体
Docker容器

关于

它是什么

Claude Cookbooks 是 Anthropic 的一个仓库,里面是用 Claude API 做开发的 Jupyter 笔记本和 Python 示例,采用 MIT 许可证。README 说这些指南提供可以直接复制的代码片段,你可以放进自己的项目。示例以 Python 为主,README 说这些思路可以用在任何能调用 Claude API 的语言上。文件夹涵盖工具调用、检索、分类、摘要、视觉、Skills、Claude Agent SDK、Claude Managed Agents,以及成本和延迟,每个文件夹都有可以用你自己的密钥运行的笔记本。

  1. 克隆仓库并安装依赖
  2. 把 .env.example 复制成 .env,填上你的 API 密钥
  3. 选一个示例文件夹,比如 tool_use 或 capabilities
  4. 打开里面的笔记本,从上到下运行单元格
  5. 把你需要的部分复制进自己的项目

适合谁

会一点 Python、想在自己动手之前先看一个能跑通的 Claude API 功能示例的开发者。如果你刚接触这个 API,README 建议先学 Claude API Fundamentals 课程。这些是教学示例,每一个演示一种技巧,而不是一个成品。

谁在用,怎么用
行业谁在用怎么用例子
软件团队要把 Claude 加进产品的开发者把一个工具调用或检索示例当作功能的起点一位后端开发者在写客服机器人之前,先读了客服智能体的笔记本。
数据和分析会写 Python 的分析师跟着分类和 text to SQL 指南走,两份指南也讲了怎么评估结果一位分析师跟着 text to SQL 指南走,读它怎么测试语法、数据正确性和行数。
平台和运维团队要盯着花费和延迟的工程师跟着成本和延迟的笔记本走,它们在一个智能体上逐项测量每个设置一位工程师对照成本笔记本里的通过率和每个任务的成本,选出一种配置。
智能体开发者使用 Claude Agent SDK 或 Claude Managed Agents 的开发者从编号的 SDK 示例或 Managed Agents 教程入手一位开发者先做示例 00 的一句话研究智能体,再做示例 01。

如果你想要一个现成的应用直接安装,就不必看它。Managed Agents 的 README 把它的完整应用放在另一个仓库 claude-quickstarts 里。

用在哪里

这些示例是 Jupyter 笔记本和 Python 文件,所以这些东西能跑的地方它们都能跑,另外需要一个 Claude API 密钥。作者的页面描述了这几种用法:

  • 在你自己的电脑上用 uv:仓库根目录,Python 3.11 或 3.12
  • 在你自己的电脑上用 pip:skills 文件夹,在虚拟环境里
  • 用 uv 做出来的 Jupyter 内核:claude_agent_sdk 文件夹
  • Claude Managed Agents,Anthropic 托管的运行环境:managed_agents 里的笔记本用你的密钥去调用它
  • 在克隆下来的仓库里用 Claude Code:仓库自带的审查命令和审计技能
  • 在浏览器里:在 GitHub 或 Claude Cookbook 网站上读示例,不用安装
每个文件夹要什么
文件夹环境密钥
仓库根目录uv sync,Python 3.11 或 3.12ANTHROPIC_API_KEY
skillspip 和一个虚拟环境ANTHROPIC_API_KEY 和 ANTHROPIC_MODEL(示例设为 claude-sonnet-5-5,注释说 Skills 需要 Claude 4.5 Sonnet 或更新的模型)
claude_agent_sdkuv sync 和一个 Jupyter 内核,示例 02 还要 DockerANTHROPIC_API_KEY,示例 02 用 GITHUB_TOKEN,示例 04 用 OPENAI_API_KEY
managed_agentsJupyter,每个笔记本自己安装依赖ANTHROPIC_API_KEY,点名需要的笔记本另需 GITHUB_TOKEN 或 MONGO_URI

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹,里面有仓库根目录、skills、claude_agent_sdk、managed_agents 文件夹、Claude Code 命令和在线阅读各一页步骤。先从 uv 和克隆仓库开始。

先准备好这些
需要说明
Claude API 密钥README 链接了 anthropic.com 用来注册。示例环境文件指向 console.anthropic.com/settings/keys 去拿密钥
Python根目录和 claude_agent_sdk 文件夹要 3.11 或 3.12。skills README 说 3.8 或更高
uvCONTRIBUTING.md 称它是推荐的包管理器。这些页面给了一行 shell 命令和一行 Homebrew 命令,没有 Windows 的命令
Git用来克隆仓库
Jupyter列在根目录的 pyproject.toml 里。skills 这条路线用 pip 安装它
DockerAgent SDK 的 README 要求示例 02 运行时有它,示例 07 也把智能体托管在上面
  1. 安装 uv。用 CONTRIBUTING.md 里的 shell 命令或 Homebrew 命令。
  2. 克隆仓库并进入它。
  3. 安装依赖。运行 uv sync --all-extras。
  4. 把 .env.example 复制成 .env。再把你的密钥填进去。
  5. 在 Jupyter 里打开一个示例的笔记本。从上到下运行它的单元格。
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks
uv sync --all-extras
cp .env.example .env

skills 文件夹的 README 用的是 pip 和虚拟环境,不是 uv:

git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks/skills
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env

如何使用

按你想做的东西选一个文件夹,打开其中一个笔记本,按顺序运行它的单元格。笔记本会显示它的结果,因为仓库特意保留了保存的输出。

从哪里开始
文件夹先打开
capabilitiesclassification、retrieval_augmented_generation、summarization 或 text_to_sql 里的 guide.ipynb
tool_usecustomer_service_agent.ipynb 或 calculator_tool.ipynb,根目录 README 点名的这两个
skillsnotebooks/01_skills_introduction.ipynb,它的 README 说从这个开始
claude_agent_sdk00_The_one_liner_research_agent.ipynb,它的 README 里的第一个示例
managed_agents先用 data_analyst_agent.ipynb 上手,或者用入门教程 CMA_iterate_fix_failing_tests.ipynb
multimodalgetting_started_with_vision.ipynb

CLAUDE.md 说笔记本应该能从上到下无错误地运行。skills 的 README 在 pip 安装之后用这一行启动 Jupyter:

jupyter notebook

这些页面没有给出 uv 路线的启动命令,所以用你习惯的方式打开笔记本就行。在 Agent SDK 文件夹里,这一行把它的环境注册成一个内核:

uv run python -m ipykernel install --user --name="cc-sdk-tutorial" --display-name "Python (cc-sdk-tutorial)"

示例

你想看看 Claude 怎么在调用很多工具的同时,不让工具的结果塞满它的上下文。你克隆仓库,把密钥填进 .env,打开 tool_use/programmatic_tool_calling_ptc.ipynb。它在 Claude Cookbook 网站上的页面标题是“Programmatic tool calling (PTC)”,页面说这个技术让 Claude 写出代码,在代码执行环境里调用工具。笔记本用一个模拟的团队报销 API。它的提问以下面这句开头,接着说明标准季度差旅预算是 5,000 美元,并让 Claude 查看超支的人有没有自定义预算例外:

Which engineering team members exceeded their Q3 travel budget?

它先用普通的工具调用回答,再用程序化工具调用回答。最后它打印一张表,比较两种做法的 API 调用次数、总 token 数和耗时。笔记本从 .env 里读取你的密钥,所以文件里不会有密钥。

新手与专家

新手:Claude API 让你的代码给 Claude 发一条消息,并读取它的回复。笔记本把说明文字和代码单元格混在一起,你一次运行一个单元格,调用 Claude 的单元格需要你 Anthropic 账号里的 API 密钥。README 建议先学 Anthropic 的 Claude API Fundamentals 课程。你也可以只读笔记本。它保存的输出会显示每个单元格打印了什么。

专家:Agent SDK 文件夹里的示例 08 会触发动态工作流。Claude 写一份 JavaScript 编排脚本,运行时在后台把它分派给并行的子智能体。示例 07 把一个智能体托管在 Docker、Modal 和 Kubernetes 上,三处用同一个 HTTP 接口。

  • Managed Agents 笔记本讲了带版本的提示词、记忆存储、会话预算、Outcomes 评分器和 advisor 名册条目。CONTRIBUTING.md 要求每次 agents.create 调用都带上 anthropic_cookbook 元数据标签
  • CLAUDE.md 说要用不带日期的模型别名。Bedrock 的 ID 不同:用基础 ID,比如 anthropic.claude-opus-5-5,全局端点在前面加 global.,CLAUDE.md 推荐这样做:global.anthropic.claude-opus-5-5。只通过 InvokeModel 走的集成用带日期的形式
  • Makefile 里有 make test-notebooks(快速的结构测试)和 make test-notebooks-exec(会运行笔记本,需要 API 密钥)
  • 审计技能说,这些示例不是生产级代码。它们展示的是用例和能力,不是生产模式

注意事项

代码和笔记本放在你的电脑上。调用 Claude 的单元格会带着你的密钥把提示词发给 Claude API。Skills 笔记本生成的文件会临时存放在 Anthropic 的服务器上,Managed Agents 在 Anthropic 托管的沙盒环境里运行你的智能体和你挂载的文件,Agent SDK 文件夹的示例 04 还会用你的 OPENAI_API_KEY 调用 OpenAI。CONTRIBUTING.md 要求 Managed Agents 笔记本给每个智能体加上 anthropic_cookbook 标签,好让 Anthropic 看到大家在运行哪些示例。

  • 费用和密钥:每个调用 API 的单元格都会花你自己 Anthropic 账号里的 token,这些页面没有给出价格。把密钥放在 .env 里,千万别提交,CLAUDE.md 也是这么说的。示例环境文件建议在 CLAUDE_MODEL 里用更便宜的模型,以节省费用
  • 其他服务:third_party 文件夹有 Deepgram、ElevenLabs、LlamaIndex、MongoDB、Pinecone、Voyage AI 和 Wolfram Alpha 的示例。Managed Agents 的 MongoDB 笔记本 CMA_with_mongodb_atlas.ipynb 要你自己的 MONGO_URI,另有三个 Managed Agents 笔记本要 GITHUB_TOKEN
  • 保存的输出可能落后于代码:程序化工具调用页面的代码里设的是 claude-sonnet-5-5,打印出来的输出显示的却是 claude-sonnet-4-6。有些示例还用了 beta 请求头,所以要看一下笔记本发送了什么
  • 日期:网站和 registry.yaml 给每个示例标了日期。复制较早的代码之前先看一眼
  • 页面不一致:工具包的 README 逐条列了。一处是 Python 版本,skills README 写 3.8 或更高,pyproject.toml 写 3.11 或 3.12。另一处是根目录 README 里有一个链接指向文件树里没有的文件
  • 卸载:这些页面没有给出卸载步骤。删除克隆下来的文件夹就删掉了代码。Agent SDK 这条路线还会为你的用户账号注册一个叫 cc-sdk-tutorial 的内核,这些页面没有说怎么移除它
  • 许可证:MIT。LICENSE 文件写的是“Copyright (c) 2023 Anthropic”

README 和文件

README

Claude Cookbooks:安装说明

这个工具包里只有安装说明,由 Mindket 编写。笔记本、代码和示例数据都在 Anthropic 的仓库里:https://github.com/anthropics/claude-cookbooks

这些说明不是 Anthropic 写的,也没有得到 Anthropic 的认可。仓库的 README 说:“The Claude Cookbooks provide code and guides designed to help developers build with Claude, offering copy-able code snippets that you can easily integrate into your own projects.”意思是:Claude Cookbooks 提供代码和指南,帮助开发者用 Claude 做开发,给出可以直接复制、方便放进自己项目的代码片段。这些说明依据 README、各文件夹的 README、CONTRIBUTING.md、CLAUDE.md、.claude 下的文件和 Claude Cookbook 网站写成,全部在 2026 年 11 月 3 日读取。

许可证:MIT。LICENSE 文件(https://github.com/anthropics/claude-cookbooks/blob/main/LICENSE)写的是“Copyright (c) 2023 Anthropic”。

这个仓库是什么

CLAUDE.md 把它称为“A collection of Jupyter notebooks and Python examples for building with the Claude API.”,也就是用 Claude API 做开发的 Jupyter 笔记本和 Python 示例合集。README 说示例以 Python 为主,这些思路可以用在任何能调用 Claude API 的语言上。你需要一个 Claude API 密钥。想先了解这个 API 的话,README 指向 Claude API Fundamentals 课程:https://github.com/anthropics/courses/tree/master/anthropic_api_fundamentals

来源:https://github.com/anthropics/claude-cookbooks/blob/main/README.md 和 https://github.com/anthropics/claude-cookbooks/blob/main/CLAUDE.md

示例都在哪里

文件夹名取自仓库的文件树(https://api.github.com/repos/anthropics/claude-cookbooks/git/trees/main?recursive=1)。一个文件夹里有什么,有 README 的以它的 README 为准,没有的就看文件名。

| 文件夹 | 里面有什么 | 依据 |
|---|---|---|
| capabilities | 分类、检索增强生成(普通的和带上下文嵌入的)、摘要、text to SQL、知识图谱和内容政策执行的指南 | capabilities/README.md |
| tool_use | 工具调用笔记本:客服智能体、计算器、工具选择、并行工具、结构化 JSON、记忆、上下文压缩、程序化工具调用和工具搜索 | 根目录 README 和文件名 |
| skills | 讲 Claude Skills 功能的笔记本,带金融示例数据和自定义技能 | skills/README.md |
| claude_agent_sdk | 面向 Claude Agent SDK 的编号示例 00 到 08,外加一个独立的定时仓库审查器 | claude_agent_sdk/README.md |
| managed_agents | Claude Managed Agents 的教程和应用笔记本 | managed_agents/README.md |
| multimodal | 讲图像、图表和表单,以及用 Haiku 做子智能体的笔记本 | 根目录 README |
| third_party | Deepgram、ElevenLabs、LlamaIndex、MongoDB、Pinecone、Voyage AI 和 Wolfram Alpha 的文件夹 | 文件夹名 |
| misc | 批处理、提示词缓存、引用、JSON 模式、评测、内容审核过滤器、PDF 上传等 | 根目录 README 和文件名 |
| .claude | 斜杠命令、一个代码审查智能体和 cookbook-audit 技能 | .claude 下的文件 |

其他文件夹各讲一个主题:extended_thinking、observability(OpenTelemetry 追踪和用量与成本 API)、cost_optimization、latency_optimization、finetuning(在 Bedrock 上微调)、coding(提示前端美学)、tool_evaluation、evals/agentic_search 和 patterns/agents。

这个工具包里的安装说明

  • setup/python-and-uv.md:仓库根目录,用 uv 或 pip,以及 .env 文件
  • setup/skills-notebooks.md:skills 文件夹,用虚拟环境和 pip
  • setup/claude-agent-sdk.md:claude_agent_sdk 文件夹,用 Jupyter 内核
  • setup/managed-agents.md:managed_agents 文件夹,以及它的笔记本要用的密钥
  • setup/claude-code.md:.claude 里的斜杠命令和审计技能
  • setup/read-online.md:在 GitHub 和 Claude Cookbook 网站上读示例

依赖一个示例之前

  • 运行一个调用 API 的单元格,会花你自己 Anthropic 账号里的 token。这些页面没有给出价格。
  • 笔记本特意保留了它保存的输出(CLAUDE.md 和 CONTRIBUTING.md 都这么说),所以你可以在运行任何东西之前先读结果。
  • 保存的输出可能比旁边的代码旧。程序化工具调用页面(https://platform.claude.com/cookbook/tool-use-programmatic-tool-calling-ptc)的代码里设的模型是 claude-sonnet-5-5,而它打印出来的输出显示的是 claude-sonnet-4-6。
  • 有些示例通过 beta 请求头调用功能,比如 skills README 列出的那三个。运行前先看一下笔记本发送了什么。

这些页面不一致的地方

这些是 2026 年 11 月 3 日读到的页面和文件之间的差异。它们都不会让你卡住,但每一处都可能耽误几分钟。

  • Python 版本:skills README 要求 Python 3.8 或更高。CONTRIBUTING.md 要求 3.11 或更高。根目录和 claude_agent_sdk 的 pyproject.toml 写的是“>=3.11,<3.13”。
  • skills README 的结构图列出了 custom_skills/financial_analyzer、brand_guidelines 和 report_generator。文件夹里实际是 analyzing-financial-statements、applying-brand-guidelines 和 creating-financial-models。README 还链接了 docs/FAQ.md,而 skills 文件夹里没有 docs 文件夹。
  • beta 请求头:skills README 说笔记本需要三个,而 skills/requirements.txt 说 Skills 和 Files API 在 anthropic 2.x 里已经是正式版(GA)。
  • CONTRIBUTING.md 给的是 pip install -e ".[dev]"。pyproject.toml 把开发工具放在 [dependency-groups] 下,没有定义叫 dev 的 extra。
  • CONTRIBUTING.md 里运行笔记本的示例用的是 skills/classification/guide.ipynb。分类指南实际在 capabilities/classification/guide.ipynb。
  • 根目录 README 表格里的一个链接“Generate images with Claude”(misc/illustrated_responses.ipynb)指向一个文件树里没有的文件。
  • 根目录 README 里的很多链接和它的 issues 链接用的是 anthropic-cookbook 这个名字。仓库叫 claude-cookbooks,克隆命令和各文件夹页面也是。链接打不开的话,到 anthropics/claude-cookbooks 下找同样的路径。
文件
README.md  6 KB
setup/claude-agent-sdk.md  5 KB
setup/claude-code.md  4 KB
setup/managed-agents.md  5 KB
setup/python-and-uv.md  4 KB
setup/read-online.md  3 KB
setup/skills-notebooks.md  5 KB

7 个文件,共 32 KB,以 zip 压缩包下载。

更新内容

  • 第 2 版 · 2026-11-09

    Updated by Mindket to the current version of this kit.

  • 第 1 版 · 2026-11-03

评价

还没有评分

写评价

还没有评价。

大家怎么说

Hacker News、Bluesky、X、Reddit、Facebook 和 YouTube 上提到这个项目的帖子和评论,来自每周一次的搜索和 Trendshift。它们不是 Mindket 写的,也未经核实,点开即可在原帖处阅读。

javatutsFront End Aesthetics: A Prompting Guide1 分 · 1 条回复Anthropic {bot}On the Chartography benchmark (100 questions over dense real-world charts), Fable 5's accuracy goes from 29% to 73% with a zoom tool, and Sonnet 5’s from 13% to 44%. See the cookbook to learn more: https://github.com/anthropics/claude-cookbooks/blob/main/multimodal/crop_tool.ipynb5 赞@undefinedKiTHIS IS PURE GOLD Anthropic just shipped 4 prompts that turn a normal agent into one that upgrades itself overnight. While you sleep, it reads the day's chats, logs failures so it doesn't repeat them in new sessions, saves what worked, and updates its memory. Every new chat starts with all that…r/AgentContext_devGitHub - anthropics/claude-cookbooks: A collection of notebooks/recipes showcasing some fun and effective ways of using Claude.simonwClaude CookbookAnthropic started their in August 2023 https://github.com/anthropics/claude-cookbooks/commit/2b3f4a... OpenAI's started in June 2022 https://github.com/openai/openai-cookbook/commit/535f545be7e...Anthropic {bot}As a bonus you can also bring your own Vercel Sandbox for tool execution, or use the built-in environment. https://github.com/anthropics/claude-cookbooks/tree/main/managed_agents/self_hosted_sandboxes/vercel2 赞@SanketShipsgoing deeper 04 LLMs-from-scratch: build an LLM chapter by chapter https://t.co/rgMHLZ0uCy 05 nanochat: a full ChatGPT clone, end to end https://t.co/rsNRT6cYEO 06 llm-course: fine-tune, quantize, deploy https://t.co/oG22SlwGXDsimonwDesigning agentic loopsYeah, "connected" feels right to me. Those decisions feel to me like problems for the agent harness to solve - Anthropic released a new cookbook about that yesterday: https://github.com/anthropics/claude-cookbooks/blob/main/too...澪公式の中身はかなり良いです。まず評価で正答率とタスク単価を測り、キャッシュ、文脈・往復の整理、バッチ処理、最後にモデル選択へ進む。安いモデルへ急がない順番です。 https://github.com/anthropics/claude-cookbooks/blob/main/cost_optimization/cost_optimization.ipynb1 条回复@theaifastlane4. LLMs from Scratch - https://t.co/M2aQZAuNU3 5. PyTorch - https://t.co/laleei5ebR 6. ML for Beginners - https://t.co/t5oNEyOdnr 7. OpenAI Cookbook - https://t.co/YSK6mM18LK 8. Stable Diffusion - https://t.co/W3uoDItIaC 9. AI for Beginners - https://t.co/JWGIbPFg2S@aynurfaraj.bsky.socialAI agent qurmağı pulsuz öyrənmək üçün 3 GitHub repo: 1) microsoft/ai-agents-for-beginners 2) microsoft/mcp-for-beginners 3) anthropics/claude-cookbooks Hamısı MIT lisenziyalı. Nümunə kod üçün API hesabı lazım ola bilər. Hansından başlayardınız? #AIagent #GitHub #SüniİntellektAZ@BuiltByNav2. Anthropic Prompt Engineering Tutorial ▸ https://t.co/3kO6GQTYhZ

搜索日期

Mindket 的更多商品

查看 Mindket 的全部商品

anaksor-ocr

Sokheng · 工具包

这个模型从文档、收据和路牌照片里读取高棉语和英语文字,用一个检测器找文本行,再用识别器读每一行。适合需要在 Python 里做高棉语 OCR 的开发者。

新上架

Qwen2.5-7B-Instruct-GGUF

Qwen · 工具包

Qwen2.5-7B-Instruct 的 GGUF 文件,提供八种量化大小,可通过 llama.cpp 在本地聊天。适合想在自己电脑上用 7.6B 强力模型、又不想搭 Python 环境的人。

新上架

ACE-Step 1.5 XL SFT

ACE-Step · 工具包

用 4B 扩散解码器根据文字生成音乐,50 步并带引导控制,音频质量高于基础版。适合拥有 12 GB 或更多显存 GPU 的创作者。

新上架

开发类的相似商品

查看开发类的全部商品

Claude Code Skills & Plugins

alirezarezvani · 技能

为 Claude Code 和其他编程智能体提供 411 个现成技能,按角色分组,从工程、产品到营销、财务和合规。以插件方式安装。适合开发者和业务团队。

新上架29.8k

buzz

block · 工具包

可自行托管的工作空间,人和 AI 智能体在同样的房间里协作,基于 Nostr 中继,把每个动作记录为签名事件。适合想自己运行中继的团队。

新上架37.3k

plannotator

backnotprop · 工具包

把你的 AI 编程智能体的计划、规格和代码改动在浏览器里打开,让你加批注或评论,并把反馈直接发回给智能体。

新上架10.5k