Claude Cookbooks: Recipe để xây dựng với Claude API
anthropics/claude-cookbooksClaude cookbooks là bộ sưu tập notebook Jupyter do chính Anthropic duy trì, cho thấy các cách cụ thể để xây dựng với Claude API. Đây không phải một thư viện bạn cài hay một app bạn chạy — mà là tập các recipe chạy được (RAG, tool use, vision, đánh giá, kiểm duyệt, prompt caching) để bạn mở, đọc và copy code ra dự án của mình.
Hãy dùng Claude cookbooks khi bạn muốn một ví dụ chạy được để copy trước khi tự xây một tính năng trên Claude API — RAG với Pinecone, một agent tool-use, output JSON-mode, hay một vòng đánh giá. Bỏ qua nếu bạn mong đợi một framework hay SDK: đây là notebook để bạn chỉnh sửa, không phải một package để import, và chúng bám riêng vào API của Anthropic, không phải một stack đa nhà cung cấp.
Vấn đề nó giải quyết
Đọc tài liệu API cho bạn biết một tham số làm gì; nó hiếm khi cho thấy trọn vẹn một ví dụ đầu-cuối của một pattern thật. Claude cookbooks lấp khoảng trống đó — thay vì đoán cách nối Claude vào retrieval, tool calling hay đánh giá tự động, bạn có một notebook đã làm sẵn và in ra kết quả, để bạn thấy toàn bộ luồng trước khi tự viết phiên bản của mình.
Đây là gì?
Claude cookbooks (kho anthropics/claude-cookbooks, trước đây là anthropic-cookbook) là bộ recipe notebook Jupyter được Anthropic tuyển chọn để xây dựng với Claude API. Mỗi notebook là một hướng dẫn khép kín — code kèm giải thích — mà bạn chạy bằng API key của mình. Recipe chủ yếu bằng Python, và README nói các khái niệm chuyển được sang bất kỳ ngôn ngữ nào gọi được Claude API. Nó dùng giấy phép MIT, nên bạn có thể lấy code vào dự án riêng.
Vì sao đang được chú ý
Đây là kho ví dụ chính thức của Anthropic, đó là lý do nó đứng gần 47.7k sao và 5.6k fork. Khi ngày càng nhiều đội xây trực tiếp trên Claude API, thứ đầu tiên họ tìm là một ví dụ đã chạy tốt cho một pattern cụ thể — và đây là nơi Anthropic đưa nó ra. Danh sách recipe tiếp tục lớn lên nhờ đóng góp cộng đồng, theo phần contributing của README.
Tính năng chính
- ✓Các recipe retrieval-augmented generation, gồm RAG trên vector database Pinecone và tìm kiếm Wikipedia
- ✓Các hướng dẫn tool-use: một agent chăm sóc khách hàng, tích hợp máy tính, và sinh câu truy vấn SQL
- ✓Notebook vision / đa phương thức — đọc ảnh, biểu đồ và đồ thị, và trích chữ từ biểu mẫu
- ✓Notebook đánh giá tự động dùng Claude để chấm điểm prompt, cùng một recipe JSON-mode cho output có cấu trúc nhất quán
- ✓Một recipe prompt-caching để cắt chi phí ngữ cảnh lặp lại, và một pattern sub-agent ghép Haiku với Opus
- ✓Phân loại, tóm tắt, một bộ lọc kiểm duyệt nội dung, upload/tóm tắt PDF, và embeddings qua Voyage AI
Trường hợp dùng tốt nhất
- •Copy một pipeline RAG đã được chứng minh (embeddings + một vector store như Pinecone) thay vì tự ráp từ đầu
- •Học luồng tool-use / function-calling từ một ví dụ chăm sóc khách hàng hay máy tính chạy được
- •Dựng một vòng đánh giá tự động để so sánh các phiên bản prompt trước khi ship một thay đổi
- •Bắt Claude trả về JSON nghiêm ngặt, hoặc cache một tiền tố prompt lớn dùng chung để giảm chi phí
- •Làm nguyên mẫu tính năng vision — đọc biểu đồ, trích biểu mẫu, tóm tắt PDF — từ một notebook bạn chỉnh được
Cách cài đặt / dùng thử
Không có package nào để cài — Claude cookbooks là một kho notebook, không phải thư viện. Bạn clone anthropics/claude-cookbooks, mở notebook bạn cần trong Jupyter, và chạy nó. Điều kiện tiên quyết cứng duy nhất trong README là một Claude API key (README có link đăng ký); notebook chủ yếu bằng Python, nên bạn sẽ cần anthropic Python SDK và Jupyter trong môi trường của mình. Dependency riêng của từng notebook không được liệt kê ở một chỗ — hãy xem phần import ở đầu mỗi notebook.
Cách sử dụng
Chọn recipe khớp với thứ bạn đang xây — chẳng hạn notebook RAG với Pinecone hay agent chăm sóc khách hàng tool-use — mở trong Jupyter, đặt Claude API key, và chạy các cell để xem pattern hoạt động đầu-cuối. Rồi copy phần bạn cần vào code của mình; README định vị đây là các đoạn code để copy chứ không phải một runtime bạn phụ thuộc vào. Muốn bắt đầu từ số không, README trỏ tới khóa API Fundamentals riêng của Anthropic.
Điểm mạnh
- ✓Ví dụ chính thức của Anthropic, nên cách dùng API bám sát cách Claude thực sự nên được gọi
- ✓Phủ rộng — RAG, tool use, vision, đánh giá, kiểm duyệt, caching — trong một nơi bạn tìm kiếm được
- ✓Notebook chạy được và in ra kết quả, nên bạn thấy toàn bộ luồng chứ không chỉ một đoạn tách rời
- ✓Giấy phép MIT: copy thẳng code vào dự án mà không vướng license
- ✓Recipe khép kín, nên bạn lấy được một pattern mà không phải nhận cả một framework
Hạn chế & rủi ro
- △Đây là code ví dụ, không phải một thư viện được bảo trì — bạn chỉnh từng notebook cho app của mình chứ không import và nhận cập nhật
- △Mọi recipe cần một Claude API key trả phí để thật sự chạy; không có chế độ local miễn phí
- △Notebook có thể tụt lại so với thay đổi của API và SDK, nên một recipe cũ có thể cần cập nhật trước khi chạy sạch
- △Nó bám riêng vào Anthropic/Claude — không có phần nào đa nhà cung cấp, nên bạn không thể ném nguyên xi sang một API model khác
- △Vài link trong README vẫn trỏ về đường dẫn anthropic-cookbook cũ, nên điều hướng một số recipe mất thêm một bước
Lựa chọn thay thế
Ai nên thử — và ai nên bỏ qua
Lập trình viên đã xây trên Claude API muốn một điểm khởi đầu chạy tốt cho một pattern cụ thể — RAG, tool use, vision hay đánh giá — và thoải mái đọc một notebook rồi port code vào dự án của mình. Nếu bạn muốn một framework đa nhà cung cấp, một SDK cắm-là-chạy, hay ví dụ cho một model không phải Anthropic, thì đây không phải: Claude cookbooks là các recipe tham chiếu riêng cho Claude, không phải một runtime bạn phụ thuộc vào.
Câu hỏi thường gặp
Claude cookbooks là bộ sưu tập notebook Jupyter của Anthropic để xây dựng với Claude API. Mỗi notebook là một ví dụ chạy được của một pattern — RAG, tool use, vision, đánh giá, prompt caching — với code bạn có thể copy vào dự án của mình.
Không. Đây là một kho notebook, không phải package. Bạn clone anthropics/claude-cookbooks, mở một notebook trong Jupyter, và chạy nó bằng Claude API key của mình, rồi chỉnh code — không có gì để pip install.
Có. README liệt kê Claude API key là điều kiện tiên quyết cứng duy nhất, vì mỗi recipe gọi Claude API khi bạn chạy. Notebook chủ yếu bằng Python và dùng anthropic SDK.
Các recipe phủ retrieval-augmented generation, tool use / function calling, phân loại, tóm tắt, xử lý vision và PDF, kiểm duyệt nội dung, đánh giá tự động, output JSON-mode, và prompt caching — các pattern bạn copy vào app của mình.
LangChain là một framework với các trừu tượng bạn xây bên trên; Claude cookbooks là các notebook ví dụ độc lập bạn đọc và copy từ đó. Cookbooks bám riêng Anthropic, còn LangChain đa nhà cung cấp.