# Claude Cookbooks: công thức xây dựng ứng dụng Claude — hướng dẫn cài đặt và dùng

> Claude Cookbooks là thư viện notebook và hướng dẫn mẫu của Anthropic, tập trung vào cách xây dựng ứng dụng bằng Claude API. Repo có ví dụ về phân loại, RAG, tool use, xử lý ảnh, PDF, đánh giá tự động và tối ưu chi phí. Cài đặt không được README mô tả đầy đủ; bạn cần Python đúng phiên bản, API key và xem thêm pyproject.toml hoặc Makefile trong repo.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-18 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/claude-cookbooks-huong-dan-xay-dung-voi-claude

Claude Cookbooks là một bộ notebook và công thức mẫu giúp bạn xây dựng ứng dụng với Claude API. Thay vì chỉ đọc tài liệu lý thuyết, bạn có thể mở từng notebook, chạy thử đoạn mã và lấy phần phù hợp để đưa vào sản phẩm của mình.

Repo phù hợp với lập trình viên mới làm quen với API, nhóm muốn làm chatbot hoặc trợ lý nội bộ, và người cần các ví dụ thực tế về xử lý văn bản, hình ảnh, PDF, dữ liệu bên ngoài hay gọi công cụ. Điểm đáng giá nhất là repo gom nhiều bài toán thường gặp vào cùng một nơi, từ ví dụ nhập môn đến các chủ đề nâng cao như prompt caching, sub-agent, đánh giá tự động, tối ưu chi phí và độ trễ.

Repo hiện có khoảng 54.601 sao và 6.625 fork. Mã nguồn được phát hành theo giấy phép MIT. Phần lớn ví dụ viết bằng Python, nhưng README cũng nói các khái niệm có thể áp dụng cho bất kỳ ngôn ngữ nào tương tác được với Claude API.

```repo
- repo | anthropics/claude-cookbooks
- kind | Thư viện
- desc | Bộ notebook và công thức Python giúp bạn học, thử nghiệm và tích hợp Claude vào ứng dụng thực tế.
- stars | 55k
- lang | Jupyter Notebook
- license | MIT
```

## Claude Cookbooks làm được gì

### Học cách gọi Claude API qua ví dụ có thể dùng lại

Các notebook cung cấp những đoạn mã có thể sao chép và điều chỉnh cho dự án riêng. Bạn không phải bắt đầu từ một tệp trống. Mỗi ví dụ giúp bạn nhìn thấy cách gửi yêu cầu, nhận phản hồi và tổ chức luồng xử lý quanh Claude.

Điều này hữu ích khi bạn đang làm thử một tính năng mới. Bạn có thể chọn một notebook gần với bài toán của mình, chạy thử bằng dữ liệu nhỏ, sau đó tách phần cần thiết vào ứng dụng.

### Phân loại và tóm tắt nội dung

Nhóm Capabilities có ví dụ về phân loại văn bản, phân loại dữ liệu và tóm tắt. Bạn có thể dùng các mẫu này để xử lý yêu cầu hỗ trợ, chia nhóm phản hồi khách hàng, tóm tắt biên bản họp hoặc rút gọn tài liệu dài.

Lợi ích thực tế là bạn có một hướng bắt đầu rõ ràng cho các tác vụ mà đầu vào thường là văn bản và đầu ra cần có cấu trúc hoặc ngắn gọn hơn.

### Kết hợp dữ liệu bên ngoài bằng RAG

Repo có các ví dụ về Retrieval Augmented Generation, tức là đưa kiến thức bên ngoài vào ngữ cảnh trước khi Claude trả lời. Có cả phần tích hợp cơ sở dữ liệu vector như Pinecone và phần đọc nội dung từ trang web.

Cách này phù hợp khi bạn muốn trợ lý trả lời dựa trên tài liệu công ty, danh mục sản phẩm, quy trình nội bộ hoặc kho kiến thức riêng thay vì chỉ dựa vào ngữ cảnh có sẵn của mô hình.

### Gọi công cụ và hệ thống bên ngoài

Phần Tool use minh họa cách để Claude tương tác với công cụ hoặc hàm do ứng dụng cung cấp. Các ví dụ gồm trợ lý chăm sóc khách hàng, tích hợp máy tính và truy vấn SQL.

Với mô hình này, Claude có thể nhận biết khi nào cần dùng một chức năng được khai báo. Ứng dụng của bạn vẫn kiểm soát việc thực thi, dữ liệu được gửi đi và kết quả trả về. Đây là nền tảng cho các trợ lý có thể tra cứu, tính toán hoặc thực hiện quy trình nhiều bước.

### Phân tích hình ảnh, biểu đồ, slide và biểu mẫu

Nhóm Multimodal có notebook về Vision với Claude, gồm bắt đầu xử lý ảnh, thực hành tốt khi dùng ảnh, đọc biểu đồ và đồ thị trong PowerPoint, cũng như trích xuất nội dung từ biểu mẫu.

Bạn có thể dùng hướng này để đọc hóa đơn hoặc biểu mẫu, kiểm tra tài liệu trực quan, phân tích biểu đồ kinh doanh hay chuyển nội dung trong ảnh thành văn bản để xử lý tiếp.

### Làm việc với PDF và dữ liệu không thuần văn bản

Repo có ví dụ tải PDF lên Claude rồi tóm tắt nội dung. Đây là hướng phù hợp cho người cần đọc nhanh hợp đồng, tài liệu hướng dẫn, báo cáo hoặc hồ sơ có nhiều trang.

Notebook giúp bạn hiểu cách biến tài liệu thành đầu vào cho mô hình. Khi đưa vào hệ thống thật, bạn vẫn cần cân nhắc quyền truy cập, thông tin nhạy cảm và giới hạn chi phí.

### Xây dựng kiểm duyệt và đầu ra JSON

Các công thức nâng cao gồm tạo bộ lọc kiểm duyệt nội dung và bật JSON mode để nhận đầu ra nhất quán hơn. JSON hữu ích khi kết quả của Claude cần được phần mềm khác đọc tiếp, chẳng hạn tạo bản ghi khách hàng hoặc trích xuất trường từ biểu mẫu.

Ví dụ kiểm duyệt có thể giúp bạn thiết kế lớp kiểm tra đầu vào hoặc đầu ra. Tuy nhiên, đây là mẫu kỹ thuật để học và thử nghiệm, không nên mặc định xem là hệ thống an toàn hoàn chỉnh cho mọi sản phẩm.

### Đo chất lượng, chi phí và tốc độ

Repo có notebook về automated evaluations, cost optimization và latency optimization. Bạn có thể đo tỷ lệ hoàn thành, chi phí mỗi tác vụ, thời gian nhận token đầu tiên, tổng thời gian xử lý và độ chính xác.

Điểm quan trọng là không chỉ chọn cấu hình theo cảm giác. Với ứng dụng thực tế, bạn có thể đặt ngưỡng chất lượng rồi so sánh các lựa chọn về mô hình, prompt hoặc luồng xử lý để tìm phương án phù hợp.

### Thử nghiệm sub-agent, prompt caching và tạo ảnh

Một số ví dụ nâng cao minh họa cách kết hợp Haiku làm sub-agent với Opus, dùng prompt caching để tối ưu việc gửi ngữ cảnh lặp lại, và kết hợp Claude với Stable Diffusion để tạo ảnh.

Các công thức này dành cho khi bạn đã hiểu luồng gọi API cơ bản. Chúng giúp mở rộng hệ thống thành nhiều tác vụ chuyên biệt, giảm phần xử lý lặp lại hoặc kết hợp Claude với công cụ khác.

## Cần chuẩn bị gì

- Máy có thể chạy Python. File pyproject.toml yêu cầu Python từ 3.11 trở lên và nhỏ hơn 3.13.
- Một Claude API key. README nói bạn cần API key để tận dụng các ví dụ trong cookbook.
- Một môi trường làm việc phù hợp với các notebook Python. README cho biết phần lớn ví dụ viết bằng Python.
- Nếu muốn chạy các ví dụ tích hợp, bạn có thể cần dịch vụ hoặc công cụ tương ứng, chẳng hạn Pinecone, Stable Diffusion hoặc nguồn dữ liệu bên ngoài. Tư liệu được cung cấp không nêu đầy đủ yêu cầu cài đặt riêng cho từng notebook.
- Các tên biến cấu hình được khai báo trong `.env.example` gồm `ANTHROPIC_API_KEY`, `CLAUDE_MODEL`, `TEST_MODE`, `MAX_TOKENS` và `DEBUG`.

README không nêu yêu cầu GPU. Vì vậy, không nên tự kết luận rằng toàn bộ repo cần GPU. Một số ví dụ bên thứ ba hoặc tạo ảnh có thể có yêu cầu riêng, bạn cần xem notebook tương ứng trước khi chạy.

```note
API key là thông tin bí mật. Không dán key vào notebook công khai, không commit file chứa key và chỉ cấp quyền cần thiết cho môi trường đang thử nghiệm. Các lệnh gọi Claude API có thể phát sinh chi phí theo tài khoản và cách dùng.
```

## Cài đặt từng bước

```steps
- Tải mã nguồn | Sao chép repo về máy
- Mở thư mục | Đi vào thư mục claude-cookbooks
- Kiểm tra yêu cầu | Đọc pyproject.toml, Makefile và .env.example
- Chuẩn bị cấu hình | Cung cấp API key và các biến cần thiết theo repo
- Chọn notebook | Mở một recipe phù hợp với bài toán rồi chạy thử
```

### Tải mã nguồn về máy

Mở Terminal hoặc PowerShell tại thư mục bạn muốn lưu mã nguồn. Lệnh dưới đây là lệnh phổ thông để sao chép repo về máy:

```bash
git clone https://github.com/anthropics/claude-cookbooks.git
```

Nếu máy báo không tìm thấy `git`, bạn cần cài Git trước hoặc dùng một cách tải mã nguồn khác. README được cung cấp không có lệnh cài Git cụ thể, nên không nên tự thêm cờ hoặc quy trình cài đặt không có trong tư liệu.

### Đi vào thư mục dự án

Sau khi clone xong, chuyển vào thư mục vừa tạo:

```bash
cd claude-cookbooks
```

Bạn nên chạy các thao tác tiếp theo từ chính thư mục này. Lỗi thường gặp là mở Terminal ở nơi khác rồi gọi notebook hoặc file cấu hình bằng đường dẫn tương đối, khiến hệ thống không tìm thấy tệp.

### Đọc các file khai báo cách chạy

Repo có `pyproject.toml` và `Makefile`, là hai nơi được cung cấp để khai báo yêu cầu và cách chạy. `pyproject.toml` cho biết phiên bản Python cần dùng là `>=3.11,<3.13`. Tên gói Python của dự án là `anthropic-cookbook`.

README không ghi các lệnh cài đặt cụ thể. Vì vậy, tài liệu này không tự thêm lệnh cài package, lệnh tạo môi trường ảo hay lệnh chạy Makefile. Hãy mở `pyproject.toml` và `Makefile` trong thư mục repo để xem chính xác các mục tiêu và dependency mà dự án định nghĩa.

Nếu bạn đang dùng Windows, hãy mở các file này bằng trình soạn thảo văn bản hoặc IDE. Khi chạy lệnh trong Makefile, hãy kiểm tra trước công cụ mà mục tiêu đó yêu cầu, vì tư liệu được cung cấp chưa mô tả đầy đủ khả năng tương thích của từng mục tiêu với Windows.

### Chuẩn bị biến cấu hình

Mở `.env.example` và kiểm tra các tên biến có sẵn:

```json
{
  "ANTHROPIC_API_KEY": "",
  "CLAUDE_MODEL": "",
  "TEST_MODE": "",
  "MAX_TOKENS": "",
  "DEBUG": ""
}
```

Khối trên chỉ minh họa tên biến được cung cấp trong tư liệu; README không đưa giá trị mẫu cụ thể cho từng biến. Bạn cần điền API key theo cách repo yêu cầu và xem các notebook hoặc file cấu hình liên quan để biết biến nào bắt buộc trong từng tình huống.

Đặc biệt, không đưa API key vào mã nguồn rồi đẩy lên GitHub. Nếu một notebook có ô chứa key, hãy xử lý theo quy trình bảo mật của nhóm bạn và kiểm tra lại nội dung trước khi chia sẻ.

### Chọn notebook để bắt đầu

README gợi ý người mới bắt đầu với khóa Claude API Fundamentals. Trong repo, bạn có thể bắt đầu từ các chủ đề đơn giản hơn như classification hoặc summarization, sau đó chuyển sang tool use, RAG và multimodal.

Mỗi thư mục có mục tiêu riêng. Hãy đọc phần mô tả ở đầu notebook trước khi chạy. Với ví dụ cần dịch vụ bên ngoài, đừng giả định rằng chỉ cần API key của Claude là đủ; notebook đó có thể yêu cầu thêm cấu hình riêng.

## Kiểm tra đã chạy được chưa

Dấu hiệu đầu tiên là lệnh clone tạo được thư mục `claude-cookbooks` và lệnh `cd` chuyển vào đúng thư mục. Tiếp theo, Python trên máy phải đáp ứng yêu cầu từ 3.11 đến trước 3.13.

Dấu hiệu quan trọng hơn là một notebook có thể chạy qua các ô mã mà không báo thiếu API key hoặc thiếu dependency. Kết quả mong đợi phụ thuộc từng recipe: notebook phân loại trả về nhãn, notebook tóm tắt trả về phần tóm tắt, notebook Vision trả lời dựa trên ảnh, còn ví dụ tool use có thể tạo yêu cầu gọi công cụ.

README không cung cấp một lệnh kiểm tra duy nhất hoặc ảnh chụp màn hình kết quả. Vì vậy, hãy coi việc chạy thành công một notebook nhỏ, phù hợp với cấu hình của bạn, là bài kiểm tra thực tế. Nếu lỗi xuất hiện trước khi notebook tạo phản hồi, kiểm tra lần lượt phiên bản Python, dependency, API key và các biến trong `.env.example`.

## Dùng vào việc thật

### Chủ shop muốn phân loại phản hồi khách hàng

Một chủ shop có thể gom nội dung tin nhắn thành các nhóm như hỏi giá, hỏi tình trạng giao hàng, đổi trả hoặc khiếu nại. Hãy bắt đầu từ recipe classification, thay dữ liệu mẫu bằng một số tin nhắn đã được ẩn thông tin riêng tư, rồi yêu cầu Claude trả về nhãn phù hợp.

Kết quả nhận được có thể dùng để chia hàng đợi chăm sóc khách hàng hoặc thống kê vấn đề xuất hiện nhiều. Nếu cần phần mềm đọc kết quả tự động, xem thêm recipe về JSON mode để thiết kế đầu ra nhất quán hơn. Tư liệu không cho biết một schema cụ thể, nên bạn cần tự xác định các trường phù hợp với quy trình của mình.

### Nhân viên văn phòng cần tóm tắt tài liệu dài

Một nhân viên có thể dùng recipe summarization hoặc PDF upload summarization để rút gọn biên bản, tài liệu hướng dẫn hay báo cáo. Quy trình thực tế là chọn notebook, cung cấp tài liệu theo đúng dạng mà notebook hỗ trợ, rồi yêu cầu bản tóm tắt theo mục tiêu như ý chính, việc cần làm và câu hỏi còn mở.

Kết quả là một bản tóm tắt giúp đọc nhanh hơn. Với tài liệu nội bộ, cần kiểm tra chính sách dữ liệu trước khi gửi lên API. Không nên đưa thông tin mật vào notebook thử nghiệm nếu chưa hiểu rõ nơi dữ liệu được xử lý.

### Dev xây trợ lý chăm sóc khách hàng có công cụ

Một dev có thể bắt đầu từ customer service agent trong phần tool use. Ứng dụng nhận câu hỏi của khách, khai báo các hàm mà Claude được phép dùng, rồi để ứng dụng thực thi hàm và trả kết quả về luồng hội thoại.

Ví dụ thực tế là tra cứu trạng thái đơn hàng hoặc tính toán một giá trị. Recipe calculator minh họa hướng tích hợp công cụ tính toán, còn ví dụ SQL cho thấy cách xây luồng truy vấn dữ liệu. Khi đưa vào sản phẩm, cần giới hạn câu lệnh, quyền truy cập và dữ liệu mà công cụ có thể đọc.

> Bắt đầu từ một notebook gần với bài toán, chạy bằng dữ liệu nhỏ, rồi mới đưa phần đã kiểm chứng vào ứng dụng.
>
> — Ông T

### Nhóm sản phẩm muốn đọc biểu đồ và biểu mẫu

Một nhóm có thể dùng các recipe Vision để thử trích xuất nội dung từ biểu mẫu, đọc biểu đồ hoặc phân tích slide. Hãy cung cấp một vài tài liệu đại diện, kiểm tra câu trả lời thủ công và ghi lại những trường hợp Claude hiểu sai.

Kết quả có thể là phần văn bản đã trích xuất, diễn giải biểu đồ hoặc câu trả lời về nội dung ảnh. Với dữ liệu kinh doanh, nên có bước người thật kiểm tra trước khi dùng kết quả cho quyết định quan trọng.

### Dev muốn giảm chi phí hoặc độ trễ của agent

Nếu ứng dụng đã chạy nhưng tốn nhiều chi phí hoặc phản hồi chậm, hãy xem cost optimization và latency optimization. Các notebook tập trung vào đo pass rate, chi phí mỗi tác vụ, thời gian đến token đầu tiên, tổng thời gian và độ chính xác.

Bạn có thể dùng bộ câu hỏi kiểm thử giống nhau, thử các cấu hình khác nhau và so sánh kết quả. Đầu ra hữu ích nhất không chỉ là một con số tốc độ, mà là quyết định cấu hình nào đạt chất lượng tối thiểu với chi phí và thời gian chấp nhận được.

## Lỗi hay gặp và cách xử lý

### Python không đúng phiên bản

Nếu Python thấp hơn 3.11 hoặc từ 3.13 trở lên, dependency có thể không khớp với yêu cầu của `pyproject.toml`. Hãy kiểm tra phiên bản đang dùng và chuyển sang phiên bản nằm trong khoảng từ 3.11 đến trước 3.13.

### Notebook báo thiếu API key

Kiểm tra `.env.example` để biết tên biến, đặc biệt là `ANTHROPIC_API_KEY`. Đừng đổi tên biến theo phỏng đoán. Nếu notebook có hướng dẫn riêng, ưu tiên hướng dẫn trong notebook đó.

### Đã có key nhưng vẫn không nhận cấu hình

Có thể bạn đang chạy notebook từ sai thư mục hoặc cấu hình chưa được nạp theo cách mà recipe yêu cầu. Mở lại file liên quan trong repo, kiểm tra tên biến và cách notebook đọc cấu hình. Không dán key trực tiếp vào nhiều ô mã để sửa nhanh.

### Ví dụ cần dịch vụ bên ngoài

Các recipe về Pinecone, Stable Diffusion, đọc trang web hoặc tích hợp khác có thể không chạy chỉ với Claude API key. Đọc phần đầu notebook để xác định dịch vụ bổ sung và cấu hình cần thiết. Nếu chưa có dịch vụ đó, hãy bắt đầu bằng một recipe độc lập hơn như classification hoặc summarization.

### Kết quả không ổn định hoặc không đúng định dạng

Hãy giảm dữ liệu thử nghiệm, mô tả rõ đầu ra mong muốn và dùng recipe JSON mode khi phần mềm cần dữ liệu có cấu trúc. Với bài toán quan trọng, tạo bộ ví dụ kiểm thử và xem thêm automated evaluations để đo chất lượng thay vì chỉ đánh giá một lần bằng mắt.

## Có nên dùng không

Nên dùng nếu bạn muốn học Claude API bằng ví dụ cụ thể, cần mẫu Python để bắt đầu nhanh, hoặc muốn khảo sát nhiều hướng như RAG, tool use, Vision, PDF, JSON, sub-agent và tối ưu chi phí. Repo có quy mô lớn, được cộng đồng quan tâm với khoảng 54.601 sao và 6.625 fork, đồng thời vẫn còn được cập nhật trong 3 tháng gần đây.

Điểm mạnh là phạm vi chủ đề rộng, các notebook có tính thực hành và nhiều đoạn mã có thể lấy làm nền tảng. Giấy phép MIT cũng thuận tiện cho việc nghiên cứu và tích hợp theo điều kiện của dự án.

Giới hạn là README không cung cấp quy trình cài đặt hoàn chỉnh cho toàn bộ repo. Mỗi notebook có thể có dependency, dịch vụ ngoài và yêu cầu dữ liệu khác nhau. Repo cũng không phải một ứng dụng hoàn chỉnh có giao diện để người không lập trình cài xong là dùng ngay; bạn vẫn cần hiểu Python, API key và cách vận hành notebook.

Nếu bạn cần một sản phẩm đóng gói sẵn, một giao diện chatbot hoàn chỉnh hoặc một giải pháp không phụ thuộc API, hãy tìm công cụ chuyên biệt hơn. Nếu mục tiêu là học, thử nghiệm và xây nguyên mẫu bằng Claude API, Claude Cookbooks là điểm bắt đầu thực tế và đáng xem.

## Câu hỏi thường gặp

### Claude Cookbooks có miễn phí không?

Repo được phát hành theo giấy phép MIT. Tuy nhiên, các ví dụ gọi Claude API có thể phát sinh chi phí theo tài khoản và cách sử dụng. Tư liệu được cung cấp chưa nêu bảng giá cụ thể.

### Có cần GPU để chạy repo không?

Tư liệu không nói repo yêu cầu GPU. Phần lớn ví dụ viết bằng Python và dùng Claude API. Một số tích hợp như Stable Diffusion có thể có yêu cầu riêng, nhưng README được cung cấp chưa mô tả chi tiết.

### Repo có chạy được trên Windows không?

Tư liệu không xác nhận đầy đủ khả năng tương thích của Windows. Bạn có thể clone repo và xem pyproject.toml, Makefile cùng notebook liên quan để kiểm tra yêu cầu cụ thể. README chưa cung cấp hướng dẫn cài đặt riêng cho Windows.

### Cần chuẩn bị gì để bắt đầu?

Bạn cần Python từ 3.11 đến trước 3.13, một Claude API key và môi trường chạy notebook Python. Các biến cấu hình được nêu trong .env.example gồm ANTHROPIC_API_KEY, CLAUDE_MODEL, TEST_MODE, MAX_TOKENS và DEBUG.

### Dữ liệu trong notebook có an toàn không?

Tư liệu không đưa ra cam kết bảo mật dữ liệu cụ thể. Bạn nên tránh đưa API key hoặc dữ liệu nhạy cảm vào notebook công khai, đồng thời kiểm tra chính sách của tổ chức trước khi gửi tài liệu lên API.

### Repo này khác gì tài liệu hướng dẫn API thông thường?

Claude Cookbooks tập trung vào notebook và công thức có thể sao chép, với ví dụ về RAG, tool use, Vision, PDF, JSON, đánh giá và tối ưu. README vẫn khuyến nghị người mới học nền tảng Claude API trước khi đi sâu vào các ví dụ.
