# claude-cookbooks: công thức mẫu dùng Claude, chép là chạy — hướng dẫn cài đặt và dùng

> claude-cookbooks là kho notebook Jupyter chính thức của Anthropic, gồm các công thức code mẫu để làm việc với Claude qua API: phân loại, tóm tắt, RAG, gọi công cụ, xử lý ảnh, tối ưu chi phí. Bạn cần một API key của Claude và Python 3.11 hoặc 3.12. README không ghi lệnh cài đặt riêng, nên cách làm là tải repo về rồi mở từng notebook.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-21 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/claude-cookbooks-cong-thuc-mau-dung-claude-huong-dan-cai-dat

claude-cookbooks là một kho "sách nấu ăn" cho Claude. Bên trong là các notebook Jupyter do Anthropic viết, mỗi cái là một công thức nhỏ: làm sao phân loại văn bản, tóm tắt tài liệu, cho Claude gọi công cụ, đọc ảnh, đọc biểu đồ. Bạn đọc, chạy thử, rồi chép đoạn code cần dùng vào dự án của mình.

Repo này dành cho người đã có hoặc sắp có ý định xây thứ gì đó trên Claude API: lập trình viên mới, người làm kinh doanh có biết chút code, nhân viên văn phòng muốn tự động hoá việc lặp lại. Bạn không cần là chuyên gia AI. README nói rõ mục tiêu là cho bạn những đoạn code có thể chép thẳng vào dự án của mình.

Điểm đáng giá nhất là tính thực dụng và độ chính thống. Mỗi công thức là một bài toán cụ thể, có code chạy được, do chính nhà làm ra Claude viết. Hiện có khoảng 54.590 sao và 6.623 fork, giấy phép MIT, và repo vẫn được cập nhật trong 3 tháng gần đây.

```repo
- repo | anthropics/claude-cookbooks
- kind | Danh sách tuyển chọn
- desc | Bộ notebook và công thức mẫu từ Anthropic: phân loại, tóm tắt, RAG, tool use, thị giác, tối ưu chi phí. Chép đoạn code về dùng ngay.
- stars | 55k
- lang | Jupyter Notebook
- license | MIT
```

## claude-cookbooks làm được gì

Repo không phải một phần mềm để cài rồi bấm. Nó là thư viện công thức, chia thư mục theo chủ đề. Dưới đây là những nhóm mà README liệt kê, cùng lợi ích thực tế của từng nhóm.

**Khả năng cơ bản (capabilities).** Gồm phân loại (classification), RAG (Retrieval Augmented Generation) và tóm tắt (summarization). Phân loại giúp bạn gán nhãn hàng loạt cho email, đánh giá khách hàng, phiếu hỗ trợ. RAG giúp Claude trả lời dựa trên tài liệu của bạn thay vì chỉ dựa vào kiến thức có sẵn. Tóm tắt giúp rút gọn văn bản dài.

**Dùng công cụ (tool use).** Bạn học cách để Claude gọi các hàm bên ngoài. README nêu ví dụ: một agent chăm sóc khách hàng, một máy tính bỏ túi, và việc viết truy vấn SQL. Đây là bước đầu để biến Claude từ "người trả lời" thành "người làm việc".

**Tích hợp bên thứ ba.** Có công thức RAG với cơ sở dữ liệu vector Pinecone, đọc trang web, và tạo embedding với Voyage AI. Phù hợp khi dữ liệu của bạn nằm ở nơi khác.

**Đa phương thức (multimodal).** Có hướng dẫn bắt đầu với ảnh, thực hành tốt nhất khi dùng thị giác, đọc biểu đồ và PowerPoint, và trích nội dung từ biểu mẫu. Hữu ích khi bạn có hoá đơn, phiếu, bảng biểu dạng ảnh.

**Kỹ thuật nâng cao.** Gồm dùng Haiku làm sub-agent kết hợp với Opus, tải PDF lên để tóm tắt, tự động đánh giá prompt, bật chế độ JSON để kết quả luôn đúng khuôn, tạo bộ lọc kiểm duyệt nội dung, và prompt caching.

**Tối ưu chi phí và độ trễ.** Hai notebook riêng: một cái đi qua danh sách việc cần làm để giảm chi phí, đo tỉ lệ đạt và chi phí mỗi tác vụ; cái kia đo thời gian đến token đầu tiên, thời gian hoàn thành và độ chính xác để chọn cấu hình nhanh nhất mà vẫn đạt chất lượng.

Ngoài ra, cấu trúc thư mục còn có các mục như claude_agent_sdk, extended_thinking, finetuning, observability, patterns, skills và managed_agents. README chưa mô tả các mục này, nên mình chỉ nêu tên. Bạn mở thư mục ra xem là biết chủ đề.

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

Theo tư liệu, bạn cần những thứ sau:

- **API key của Claude.** README viết rằng bạn cần một Claude API key và dẫn bạn tới trang của Anthropic để đăng ký. README cũng có câu "sign up for free", nhưng không nói gì về hạn mức hay chi phí khi gọi API. Phần này mình không có thông tin, bạn tự xem bảng giá của Anthropic.
- **Python từ 3.11 đến dưới 3.13.** File pyproject.toml của repo yêu cầu đúng khoảng này (>=3.11,<3.13). Tức là Python 3.11 hoặc 3.12. Bản 3.10 hay 3.13 có thể gây lỗi.
- **Git** để tải repo về. Bạn cũng có thể tải file ZIP từ trang GitHub nếu không muốn dùng git.
- **Nơi mở notebook.** Các file có đuôi .ipynb. README không hướng dẫn cách mở. Bạn có thể xem trực tiếp trên GitHub hoặc dùng công cụ quen thuộc của bạn để chạy chúng.

README còn cho biết code chủ yếu viết bằng Python, nhưng ý tưởng có thể chuyển sang ngôn ngữ khác miễn là gọi được Claude API. Nếu bạn mới hoàn toàn, README gợi ý bắt đầu với khoá Claude API Fundamentals của Anthropic.

Tư liệu không nói gì về GPU, hệ điều hành bắt buộc hay RAM tối thiểu. Các notebook gọi Claude qua API nên bạn không cần tự chạy mô hình, nhưng đó là suy luận của mình, README không ghi.

```note
API key giống mật khẩu và gắn với tiền của bạn. Không dán key vào notebook rồi đẩy lên GitHub, không gửi cho người khác. Mỗi lần chạy notebook là một lần gọi API, có thể bị tính phí.
```

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

Lưu ý trước: README của repo **chưa ghi cách cài**. Nó chỉ có phần Prerequisites và danh sách công thức. Vì vậy các bước dưới đây chỉ dùng lệnh phổ thông chắc chắn đúng, còn phần phụ thuộc thì mình chỉ bạn xem file khai báo trong repo.

```steps
- Chuẩn bị Python và API key | Có Python 3.11 hoặc 3.12 và một Claude API key
- Tải repo về máy | Dùng git clone rồi cd vào thư mục
- Xem thư viện cần có | Mở pyproject.toml và Makefile để biết cách repo khai báo
- Tạo file .env | Sao chép .env.example thành .env và điền key
- Mở một notebook | Chọn công thức, chạy thử từng ô
```

### Chuẩn bị Python và API key

Kiểm tra phiên bản Python bằng lệnh sau. Lệnh này chạy được trên cả Windows lẫn macOS/Linux, miễn là Python đã nằm trong PATH.

```bash
python --version
```

Kết quả cần có dạng 3.11.x hoặc 3.12.x. Nếu ra số khác, hãy cài đúng bản trước khi làm tiếp. Việc đăng ký và lấy API key bạn làm trên trang của Anthropic, mình không có thông tin chi tiết hơn các bước đó.

### Tải repo về máy

Mở terminal (Windows: PowerShell; macOS: Terminal), đi tới thư mục bạn muốn lưu, rồi chạy:

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

Lệnh đầu tải toàn bộ repo về. Lệnh thứ hai đi vào thư mục vừa tải. Chỗ người mới hay vấp: các lệnh sau phải chạy **trong thư mục này**. Nếu terminal vẫn đang ở thư mục khác, bạn sẽ không thấy file nào.

### Xem thư viện cần có

Repo có hai file khai báo cách chạy: pyproject.toml và Makefile. Tên gói Python trong pyproject.toml là anthropic-cookbook, và nó yêu cầu Python >=3.11,<3.13. Ngoài ra repo có uv.lock và uv.toml, tức là tác giả dùng công cụ quản lý gói uv.

README không ghi lệnh nào để cài các thư viện đó, nên mình không đưa lệnh ra để tránh sai. Bạn mở pyproject.toml bằng trình soạn thảo, xem mục dependencies để biết cần những gói nào. Mở Makefile để xem các lệnh tắt mà tác giả đã đặt sẵn. Mỗi notebook thường còn có ô đầu tiên ghi sẵn thư viện nó cần.

### Tạo file .env

Repo có file mẫu .env.example. Theo tên biến trong đó, nó khai báo: ANTHROPIC_API_KEY, CLAUDE_MODEL, TEST_MODE, MAX_TOKENS và DEBUG. README không giải thích ý nghĩa từng biến ngoài tên gọi, nên bạn đọc ghi chú trong file đó. Biến quan trọng nhất với người mới là ANTHROPIC_API_KEY, chỗ điền key của bạn.

Sao chép file mẫu thành file thật. Trên PowerShell:

```powershell
Copy-Item .env.example .env
```

Trên macOS/Linux:

```bash
cp .env.example .env
```

Sau đó mở file .env, điền key vào sau ANTHROPIC_API_KEY. Chỗ hay vấp: file bắt đầu bằng dấu chấm nên có thể bị ẩn trong trình quản lý file. Bạn mở bằng trình soạn thảo code hoặc gõ lệnh để thấy nó. Đừng đưa file .env lên GitHub.

### Mở một notebook

Vào thư mục chủ đề, ví dụ capabilities/classification hoặc tool_use, và mở file .ipynb. Cách đơn giản nhất để đọc là xem ngay trên trang GitHub của repo. Muốn chạy thật thì bạn cần môi trường mở được notebook. README không chỉ định công cụ nào, nên bạn dùng cái mình quen.

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

README không có phần kiểm tra cài đặt riêng, nên mình đưa ra cách kiểm tra hợp lý dựa trên cấu trúc repo.

Bạn chọn một notebook nhỏ, ví dụ phần bắt đầu với ảnh trong thư mục multimodal hoặc ví dụ máy tính trong tool_use. Chạy các ô từ trên xuống. Nếu ô gọi Claude trả về nội dung (một câu trả lời, một nhãn phân loại, một đoạn tóm tắt) mà không báo lỗi, nghĩa là Python, thư viện và API key của bạn đang hoạt động.

Nếu ô báo lỗi thiếu thư viện hay lỗi xác thực, xem phần lỗi hay gặp bên dưới. Repo cũng có thư mục tests, tox.ini và Makefile dành cho người đóng góp, nhưng README không nói chúng dùng thế nào. Nếu bạn quen, có thể xem Makefile để tìm lệnh kiểm tra của tác giả.

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

Nhớ rằng đây là công thức mẫu, không phải ứng dụng làm sẵn. Bạn lấy ý tưởng và code, rồi chỉnh theo dữ liệu của mình. Mấy tình huống dưới đây đều bám vào các công thức README đã liệt kê.

### Chủ shop phân loại đánh giá của khách

**Bối cảnh:** chị Lan bán đồ gia dụng online, mỗi ngày có vài chục đánh giá và tin nhắn. Chị muốn biết cái nào là khen, cái nào là phàn nàn về giao hàng, cái nào hỏi sản phẩm.

**Cách làm:** mở công thức Classification trong capabilities/classification. Xem notebook cách tác giả viết prompt phân loại, rồi thay danh mục mẫu bằng các nhãn của chị, ví dụ: khen, chê giao hàng, chê chất lượng, hỏi thông tin. Prompt mẫu để thử:

```text
Phân loại tin nhắn sau vào đúng một nhãn: khen, chê giao hàng, chê chất lượng, hỏi thông tin. Chỉ trả về tên nhãn.
Tin nhắn: Hàng đến chậm 5 ngày, hộp bị móp.
```

**Kết quả:** mỗi tin nhắn ra một nhãn, dễ đưa vào bảng tính để đếm và xử lý theo nhóm.

> Công thức tốt nhất là công thức bạn chạy được trong mười phút rồi sửa thành của mình.
>
> — Ông T

### Nhân viên văn phòng tóm tắt PDF dài

**Bối cảnh:** anh Minh làm hành chính, hàng tuần phải đọc các báo cáo PDF dài vài chục trang và viết tóm tắt cho sếp.

**Cách làm:** repo có công thức Upload PDFs to Claude (misc/pdf_upload_summarization.ipynb), mô tả là phân tích PDF và đưa nội dung dạng văn bản cho Claude, cùng công thức Summarization. Anh chạy notebook, thay đường dẫn file mẫu bằng file của mình, rồi chỉnh yêu cầu tóm tắt:

```text
Tóm tắt tài liệu này trong 5 ý chính, mỗi ý một câu. Cuối cùng nêu 3 việc cần quyết định.
```

**Kết quả:** bản tóm tắt ngắn để anh đọc nhanh, rồi kiểm tra lại với bản gốc ở những chỗ quan trọng.

### Dev mới làm chatbot chăm sóc khách hàng

**Bối cảnh:** bạn Hà là lập trình viên mới, được giao thử làm trợ lý trả lời khách cho công ty, có thể tra thông tin đơn hàng.

**Cách làm:** mở notebook Customer service agent trong tool_use (tool_use/customer_service_agent.ipynb). Notebook cho thấy cách khai báo công cụ để Claude gọi, ví dụ hàm tra đơn hàng. Hà chạy thử với dữ liệu giả, đọc cách code nối câu hỏi của khách với công cụ, rồi thay hàm giả bằng hàm gọi hệ thống của công ty. Nếu cần câu trả lời có cấu trúc để phần mềm đọc được, Hà xem thêm công thức bật chế độ JSON (misc/how_to_enable_json_mode.ipynb).

**Kết quả:** một bản nguyên mẫu chạy được, đủ để demo cho team và biết cần làm thêm những gì.

### Chủ doanh nghiệp nhỏ cắt chi phí gọi API

**Bối cảnh:** sau vài tuần dùng, hoá đơn API của anh Tuấn tăng nhanh. Anh muốn giảm chi phí mà không làm chất lượng tụt.

**Cách làm:** mở notebook cost_optimization/cost_optimization.ipynb, cái này đi qua danh sách việc cần làm trên một agent, đo tỉ lệ đạt và chi phí mỗi tác vụ để tìm cấu hình tối ưu. Anh đọc thêm công thức prompt caching (misc/prompt_caching.ipynb). Nếu app chậm, anh xem tiếp latency_optimization.

**Kết quả:** anh có một cách đo cụ thể thay vì đoán, và biết đòn bẩy nào đáng thử trước.

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

README không có mục xử lý sự cố. Mấy lỗi dưới đây là loại rất dễ gặp với công cụ kiểu này.

**Báo lỗi xác thực hoặc không có API key.** Thường do chưa điền ANTHROPIC_API_KEY, điền sai, hoặc file .env nằm sai thư mục. Hãy kiểm tra lại file .env, chắc chắn key không có khoảng trắng thừa, rồi khởi động lại notebook để nó đọc lại cấu hình. Nếu nghi key bị lộ, vào trang quản lý của Anthropic để thu hồi và tạo key mới.

**Sai phiên bản Python.** pyproject.toml yêu cầu >=3.11,<3.13. Nếu bạn dùng 3.10 hoặc 3.13, việc cài thư viện có thể thất bại. Chạy lại `python --version`, cài đúng bản và dùng đúng môi trường.

**Lỗi thiếu thư viện (ModuleNotFoundError).** Notebook gọi một thư viện chưa được cài trong môi trường của bạn. Xem ô đầu của notebook hoặc pyproject.toml để biết cần gói nào. Cài đúng gói trong cùng môi trường mà notebook đang chạy, vì cài ở một nơi mà chạy ở nơi khác là lỗi người mới hay gặp.

**Code mẫu không chạy đúng với mô hình hiện tại.** Các mô hình và tham số thay đổi theo thời gian. Biến CLAUDE_MODEL có trong .env.example, nên tên mô hình có thể cấu hình được. Nếu notebook báo không tìm thấy mô hình, kiểm tra tên mô hình mới nhất trong tài liệu của Anthropic rồi thay vào.

**Chi phí bất ngờ.** Chạy hàng loạt ô, nhất là những notebook xử lý nhiều dữ liệu hoặc agent, sẽ gọi API nhiều lần. Hãy thử với một vài mẫu nhỏ trước, đặt giới hạn chi tiêu trên tài khoản nếu có, và theo dõi mức dùng.

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

**Điểm mạnh.** Đây là tài liệu học bằng cách làm, từ chính Anthropic, giấy phép MIT nên bạn thoải mái chép code. Chủ đề trải rộng từ cơ bản (phân loại, tóm tắt) đến nâng cao (RAG, tool use, tối ưu chi phí và độ trễ). Repo vẫn được cập nhật, và cộng đồng lớn nên dễ tìm người cùng dùng.

**Giới hạn.** Repo không phải phần mềm cài rồi dùng: bạn phải có API key, phải biết đọc code Python ở mức cơ bản và tự chỉnh ví dụ theo dữ liệu của mình. README chưa có hướng dẫn cài đặt đầy đủ, và code mẫu chủ yếu bằng Python. Người hoàn toàn chưa từng chạm vào code sẽ thấy khó hơn người đã quen ít nhiều.

**Khi nào chọn cách khác.** Nếu bạn chỉ muốn chat với Claude hay làm việc hằng ngày mà không viết code, dùng thẳng ứng dụng của Claude sẽ đơn giản hơn. Nếu bạn cần một sản phẩm hoàn chỉnh có giao diện, repo này chỉ là nguyên liệu, không phải sản phẩm. Còn nếu bạn đang bắt đầu xây gì đó với Claude API, đây là nơi nên mở đầu tiên.

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

### claude-cookbooks có miễn phí không?

Bản thân repo là mã nguồn mở với giấy phép MIT, bạn tải và dùng không mất tiền. Tuy nhiên các notebook gọi Claude API và cần API key. README chưa nêu chi phí gọi API, nên bạn xem bảng giá của Anthropic.

### Có cần GPU không?

Tư liệu không yêu cầu GPU. Các notebook gọi Claude qua API, nên phần tính toán nặng nằm ở phía Anthropic. Đây là suy luận từ cách repo hoạt động, README không nói rõ.

### Cần phiên bản Python nào?

File pyproject.toml yêu cầu Python từ 3.11 đến dưới 3.13, tức là 3.11 hoặc 3.12. Hai phiên bản ngoài khoảng này có thể gặp lỗi khi cài thư viện.

### Chạy được trên Windows không?

README không nêu hệ điều hành bắt buộc. Python và Git đều có trên Windows, nên có thể dùng được, nhưng tư liệu không xác nhận riêng. Bạn mở terminal PowerShell để chạy các lệnh trong bài.

### Tôi chưa biết gì về Claude API thì bắt đầu từ đâu?

README khuyên bạn học khoá Claude API Fundamentals của Anthropic trước để có nền tảng. Sau đó chọn các công thức đơn giản như Classification hoặc Summarization trong thư mục capabilities.

### Code mẫu có chỉ dành cho Python không?

Code chủ yếu viết bằng Python, nhưng README nói các ý tưởng có thể chuyển sang ngôn ngữ khác miễn là gọi được Claude API.

### Dữ liệu của tôi có an toàn không?

Tư liệu không có thông tin về quyền riêng tư dữ liệu. Khi chạy notebook, nội dung bạn gửi sẽ đi qua Claude API, nên hãy xem chính sách của Anthropic trước khi gửi dữ liệu nhạy cảm. Tránh đưa API key lên nơi công khai.
