claude-cookbooks: sổ công thức code mẫu để làm việc với Claude — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về anthropics/claude-cookbooks — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Claude Cookbooks: công thức xây dựng ứng dụng Claude — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
claude-cookbooks là kho notebook mẫu do Anthropic duy trì, hướng dẫn cách dùng Claude qua API cho các việc như phân loại, tóm tắt, gọi công cụ, RAG và đọc ảnh. Bạn không cài nó như một phần mềm mà tải về, điền API key rồi mở từng notebook để chạy thử và chép đoạn code cần dùng. Việc chuẩn bị không khó nếu bạn có Python và một API key của Claude.
Claude Cookbooks là kho các notebook và công thức code mẫu do Anthropic duy trì, cho bạn thấy từng bước cách dùng Claude qua API. Đây không phải một phần mềm để cài rồi bấm chạy. Nó giống một cuốn sổ nấu ăn: bạn mở đúng công thức cần, chạy thử, rồi chép đoạn code vào dự án của mình.
Repo hợp với lập trình viên mới, người làm kinh doanh hoặc văn phòng có chút nền tảng code, và bất kỳ ai muốn đưa Claude vào quy trình làm việc. Ví dụ: tự động phân loại email khách hàng, tóm tắt tài liệu dài, hay dựng một trợ lý có thể tra cứu dữ liệu. Mỗi công thức là một bài toán cụ thể, nên bạn không phải đọc cả tài liệu dày mới biết bắt đầu từ đâu.
Điểm đáng giá nhất là code có thể chép dùng ngay, kèm các chủ đề thực tế như giảm chi phí và giảm độ trễ. Repo hiện có khoảng 54.590 sao và 6.623 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.
anthropics/claude-cookbooks
Bộ notebook và công thức code mẫu của Anthropic, giúp bạn học cách dùng Claude qua API: phân loại, tóm tắt, tool use, RAG, xử lý ảnh, tối ưu chi phí.
I.Claude Cookbooks làm được gì
Repo chia thành nhiều thư mục theo chủ đề. Dưới đây là những nhóm bạn sẽ dùng nhiều nhất.
- Phân loại (capabilities/classification): cách dùng Claude để gán nhãn cho văn bản và dữ liệu. Hợp với việc chia email, phản hồi khách hàng hay ticket hỗ trợ vào đúng nhóm.
- Tóm tắt (capabilities/summarization): các kỹ thuật tóm tắt văn bản hiệu quả. Có ích khi bạn phải đọc báo cáo, hợp đồng hay biên bản họp dài.
- Retrieval Augmented Generation (RAG): bổ sung kiến thức bên ngoài cho Claude để câu trả lời bám sát dữ liệu của bạn. Có ví dụ với cơ sở dữ liệu vector Pinecone, đọc trang web, và tạo embedding bằng Voyage AI.
- Tool use (tool_use): cho Claude gọi công cụ và hàm bên ngoài. Có sẵn ví dụ trợ lý chăm sóc khách hàng, máy tính bỏ túi, và truy vấn SQL.
- Đa phương thức (multimodal): dùng Claude để đọc ảnh, biểu đồ, slide, và trích nội dung từ biểu mẫu.
- Kỹ thuật nâng cao: dùng Haiku làm sub-agent phối hợp với Opus, đọc PDF, tự động đánh giá prompt, ép đầu ra dạng JSON, dựng bộ lọc nội dung, và prompt caching.
- Tối ưu chi phí và độ trễ: hai notebook hướng dẫn đo tỷ lệ đạt, chi phí mỗi tác vụ, thời gian đến token đầu tiên, rồi chọn cấu hình rẻ nhất hoặc nhanh nhất mà vẫn đạt chất lượng bạn cần.
Ngoài ra, cấu trúc repo còn có các thư mục như claude_agent_sdk, managed_agents, extended_thinking, observability, finetuning, skills, evals và tool_evaluation. Phần này mình chỉ nêu tên thư mục. Bạn nên mở từng thư mục để xem nội dung thực tế trước khi dùng.
II.Cần chuẩn bị gì
Theo tư liệu của repo, bạn cần những thứ sau.
- API key của Claude. README nói bạn đăng ký tại trang của Anthropic để lấy key. Đây là thứ bắt buộc để chạy các ví dụ.
- Python. Các ví dụ chủ yếu viết bằng Python. File pyproject.toml yêu cầu Python từ 3.11 đến dưới 3.13, tức dùng 3.11 hoặc 3.12.
- Git để tải repo về máy. Bạn cũng có thể tải file nén từ trang GitHub nếu không muốn dùng git.
- Một chỗ để mở notebook. Phần lớn nội dung là Jupyter Notebook (đuôi .ipynb). README không ghi bạn phải dùng công cụ nào để mở. Bạn có thể dùng bất kỳ môi trường nào đọc được notebook.
Tư liệu không nhắc tới yêu cầu GPU hay cấu hình máy đặc biệt. Các notebook gọi Claude qua API nên phần tính toán nặng không chạy trên máy bạn.
README cũng gợi ý: nếu bạn mới làm quen với Claude API, hãy học khóa Claude API Fundamentals của Anthropic trước để có nền tảng.
API key giống mật khẩu. Đừng dán key vào notebook rồi đưa lên GitHub, đừng gửi cho người khác. Mỗi lần notebook gọi Claude có thể phát sinh chi phí tùy gói của bạn, nên hãy xem trang giá của Anthropic trước khi chạy hàng loạt.
III.Cài đặt từng bước
README chưa ghi lệnh cài đặt. Vì vậy phần dưới đây chỉ dùng lệnh phổ thông và các tên file có thật trong repo. Phần cài thư viện Python, bạn xem trong pyproject.toml, requirements-dev.txt và Makefile ở thư mục gốc.
- Lấy API keyĐăng ký tài khoản Anthropic và tạo key cho Claude API
- Kiểm tra PythonChắc chắn máy có Python 3.11 hoặc 3.12
- Tải repo về máyDùng git clone rồi vào thư mục vừa tải
- Tạo file .envSao chép .env.example thành .env và điền key
- Cài thư viện và mở notebookXem pyproject.toml để biết cần gói nào, rồi mở notebook bạn muốn thử
A.Lấy API key
Truy cập trang của Anthropic, đăng ký tài khoản và tạo API key theo hướng dẫn trên đó. README nói bạn có thể đăng ký miễn phí, nhưng chưa nói rõ hạn mức dùng thử. Phần này bạn nên xem trực tiếp trên trang của Anthropic. Hãy lưu key ở nơi an toàn, vì nhiều trang chỉ hiện key đầy đủ một lần.
B.Kiểm tra phiên bản Python
Mở terminal. Trên Windows, bạn mở PowerShell hoặc Windows Terminal. Trên macOS hoặc Linux, bạn mở Terminal. Gõ lệnh sau để xem phiên bản.
python --versionKết quả cần là 3.11.x hoặc 3.12.x. Repo yêu cầu từ 3.11 đến dưới 3.13, nên Python 3.10 hay 3.13 có thể không phù hợp. Nếu máy bạn dùng lệnh python3 thay vì python, hãy thử python3 --version.
C.Tải repo về máy
Vẫn trong terminal, hãy chuyển tới thư mục bạn muốn lưu code rồi chạy:
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooksLệnh đầu tải toàn bộ repo về một thư mục tên claude-cookbooks. Lệnh thứ hai đi vào thư mục đó. Chỗ người mới hay vấp là chạy các lệnh sau khi chưa cd vào đúng thư mục, nên không thấy file .env.example. Nếu thấy báo lỗi không tìm thấy file, hãy kiểm tra lại bạn đang đứng ở đâu.
D.Tạo file .env và điền key
Repo có sẵn file mẫu .env.example. File này liệt kê các biến cấu hình: ANTHROPIC_API_KEY, CLAUDE_MODEL, TEST_MODE, MAX_TOKENS và DEBUG. Bạn sao chép nó thành file .env. Trên PowerShell:
Copy-Item .env.example .envTrên macOS hoặc Linux:
cp .env.example .envSau đó mở file .env bằng trình soạn thảo và điền key vào dòng ANTHROPIC_API_KEY, theo dạng như dưới đây. Bạn thay phần sau dấu bằng bằng key thật của mình.
ANTHROPIC_API_KEY=điền-key-của-bạn-vào-đâyCác biến còn lại như CLAUDE_MODEL hay MAX_TOKENS bạn có thể giữ nguyên giá trị mẫu trong file lúc mới thử. README không giải thích từng biến, nên đừng đổi khi chưa hiểu. Lưu ý: file .env chứa key, đừng đưa nó vào git hay gửi cho người khác.
E.Cài thư viện và mở notebook
README chưa ghi cách cài. Bạn mở file pyproject.toml ở thư mục gốc để xem danh sách gói phụ thuộc. Tên gói của dự án là anthropic-cookbook. Repo còn có requirements-dev.txt, Makefile và uv.lock, cho thấy tác giả có dùng công cụ quản lý môi trường riêng. Hãy đọc Makefile và CONTRIBUTING.md để biết các lệnh chính thức, thay vì đoán.
Một số notebook, ví dụ phần Pinecone hay Voyage AI, dùng dịch vụ bên thứ ba. Mỗi notebook thường có ô cài đặt hoặc ghi chú đầu bài. Bạn đọc phần đó trước khi chạy.
Khi môi trường đã sẵn sàng, mở một notebook, ví dụ thư mục capabilities/classification hoặc tool_use, rồi chạy từng ô từ trên xuống dưới.
IV.Kiểm tra đã chạy được chưa
Tư liệu không nêu một lệnh kiểm tra chính thức. Cách đơn giản nhất là chạy thử một notebook nhỏ và xem kết quả.
- Mở một notebook ngắn, ví dụ phần phân loại hoặc tóm tắt.
- Chạy ô đầu tiên (thường là nạp thư viện và cấu hình key). Nếu không báo lỗi thiếu module hay thiếu key là ổn.
- Chạy ô gọi Claude. Nếu bạn nhận được câu trả lời văn bản từ Claude hiển thị ngay dưới ô code, nghĩa là key hợp lệ và kết nối đang hoạt động.
Nếu thấy lỗi xác thực hoặc lỗi thiếu key, hãy xem lại phần tạo .env ở trên.
V.Dùng vào việc thật
Các tình huống dưới đây bám theo những chủ đề có trong repo. Cách làm cụ thể nằm trong notebook tương ứng, nên mình mô tả hướng đi chứ không chép code.
A.Chủ shop online phân loại tin nhắn khách hàng
Bạn bán hàng online và mỗi ngày nhận hàng trăm tin nhắn: hỏi giá, báo lỗi, đổi trả, khiếu nại. Mở notebook trong capabilities/classification để xem cách đặt các nhóm nhãn và viết prompt cho Claude. Bạn thay danh sách nhãn mẫu bằng nhãn của shop mình, như Hỏi giá, Đổi trả, Giao hàng chậm, rồi chạy thử trên vài chục tin nhắn thật. Kết quả là mỗi tin được gán một nhãn, giúp bạn chuyển đúng người xử lý.
Đọc xong một công thức, chạy thử bằng dữ liệu của chính bạn, rồi mới chép vào quy trình. Đó là cách học nhanh nhất.
Ông T
B.Nhân viên văn phòng tóm tắt tài liệu dài
Bạn nhận báo cáo hoặc hợp đồng dài và cần nắm ý chính trước cuộc họp. Notebook trong capabilities/summarization hướng dẫn các kỹ thuật tóm tắt. Nếu tài liệu là PDF, repo còn có notebook tải PDF lên Claude: nó phân tích PDF thành văn bản rồi đưa cho Claude. Kết quả là bản tóm tắt ngắn gọn. Bạn vẫn nên đối chiếu các con số quan trọng với bản gốc.
C.Lập trình viên mới dựng trợ lý chăm sóc khách hàng
Bạn muốn một chatbot không chỉ trả lời chung chung mà còn tra được đơn hàng hay dữ liệu nội bộ. Thư mục tool_use có ví dụ customer_service_agent và calculator_tool. Bạn đọc cách khai báo công cụ, cách Claude quyết định gọi công cụ nào, và cách nhận kết quả trả về. Sau đó bạn thay công cụ mẫu bằng hàm của mình. Kết quả là một trợ lý chạy thử được, từ đó bạn mở rộng dần.
D.Chủ sản phẩm giảm chi phí và độ trễ
Ứng dụng của bạn đã chạy nhưng hóa đơn API cao hoặc phản hồi chậm. Notebook cost_optimization hướng dẫn đo tỷ lệ đạt và chi phí mỗi tác vụ để tìm cấu hình tối ưu. Notebook latency_optimization hướng dẫn đo thời gian đến token đầu tiên và thời gian hoàn thành tác vụ. Ngoài ra còn có notebook prompt caching. Bạn làm theo, thay tác vụ mẫu bằng tác vụ thật của mình, rồi so sánh số đo trước và sau.
VI.Lỗi hay gặp và cách xử lý
A.Báo lỗi thiếu hoặc sai API key
Thường do chưa tạo file .env, điền key sai, hoặc có khoảng trắng thừa. Hãy kiểm tra lại dòng ANTHROPIC_API_KEY trong .env, đảm bảo file nằm đúng thư mục, và khởi động lại notebook sau khi sửa. Nếu nghi key bị lộ, hãy xóa và tạo key mới trên trang của Anthropic.
B.Sai phiên bản Python
Nếu cài gói báo lỗi không tương thích, hãy chạy python --version. Dự án yêu cầu Python từ 3.11 đến dưới 3.13. Hãy dùng đúng phiên bản này, tốt nhất trong một môi trường ảo riêng để không ảnh hưởng các dự án khác.
C.Notebook báo thiếu thư viện
Mỗi chủ đề có thể cần gói riêng, như Pinecone hay Voyage AI cho phần bên thứ ba. Hãy đọc ô cài đặt đầu notebook và các file khai báo như pyproject.toml. Chỉ cài những gói bạn thật sự cần và biết rõ nguồn.
D.Notebook cũ chạy không ra như mô tả
Repo cập nhật liên tục, nhưng công nghệ AI đổi nhanh nên một số notebook có thể dùng tên model hay cách gọi đã cũ. Biến CLAUDE_MODEL trong .env.example cho thấy bạn có thể chọn model. Nếu gặp lỗi liên quan tới model, hãy xem tài liệu mới nhất của Anthropic rồi chỉnh lại cho khớp.
E.Chạy nhiều ô liên tục làm tốn tiền
Một số notebook gọi API nhiều lần, nhất là phần đánh giá hàng loạt. Hãy chạy thử với ít mẫu trước, và theo dõi mức dùng trên trang quản lý tài khoản. Không nên chạy toàn bộ notebook khi chưa đọc nó làm gì.
VII.Có nên dùng không
Điểm mạnh. Đây là nguồn học chính thống từ Anthropic, giấy phép MIT nên bạn thoải mái chép code về dùng. Chủ đề đa dạng, từ cơ bản như phân loại, tóm tắt đến nâng cao như sub-agent, tool use, đánh giá và tối ưu chi phí. Dạng notebook cho phép bạn chạy từng ô và thấy kết quả ngay.
Giới hạn. README chưa có hướng dẫn cài đặt rõ ràng, nên người mới phải tự đọc pyproject.toml và Makefile. Đây không phải công cụ dùng ngay cho người không biết code. Bạn vẫn cần chạm vào terminal, Python và API key. Mỗi lần gọi Claude có thể tốn phí. Các ví dụ là mẫu minh họa, chưa phải sản phẩm hoàn chỉnh, nên bạn cần tự kiểm tra và chỉnh trước khi dùng cho công việc thật.
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, không cần code, hãy dùng ứng dụng Claude thông thường. Nếu bạn cần tra cứu thông số API chi tiết, hãy đọc tài liệu chính thức của Anthropic. Còn nếu bạn muốn học cách đưa Claude vào ứng dụng của mình bằng code mẫu chạy được, Claude Cookbooks là điểm bắt đầu rất tốt.
Câu hỏi thường gặp
Claude Cookbooks có miễn phí không?
Bản thân repo dùng giấy phép MIT nên bạn tải và dùng code miễn phí. Tuy nhiên các notebook gọi Claude qua API, nên cần API key và có thể phát sinh chi phí tùy gói của bạn. README chỉ nói bạn đăng ký key miễn phí, chưa nêu hạn mức dùng thử.
Có cần GPU không?
Tư liệu không nhắc tới yêu cầu GPU. Các ví dụ gọi Claude qua API nên phần xử lý nặng chạy ở phía Anthropic, không phải trên máy bạn.
Chạy được trên Windows không?
README không nêu hệ điều hành cụ thể. Repo dùng Python và notebook nên về nguyên tắc chạy được ở nơi có Python 3.11 hoặc 3.12. Bạn có thể dùng PowerShell để chạy các lệnh git và sao chép file như hướng dẫn.
Cần Python phiên bản nào?
File pyproject.toml yêu cầu Python từ 3.11 đến dưới 3.13. Vì vậy bạn nên dùng 3.11 hoặc 3.12, và kiểm tra bằng lệnh python --version trước khi cài.
Dữ liệu của tôi có an toàn không?
Tư liệu chưa nêu chính sách dữ liệu. Khi chạy notebook, nội dung bạn gửi sẽ đi qua Claude API, nên bạn cần xem chính sách của Anthropic trước khi đưa dữ liệu nhạy cảm vào. Riêng API key thì đừng đưa lên GitHub hay chia sẻ cho người khác.
Repo này khác gì tài liệu chính thức của Anthropic?
README mô tả repo là nơi cung cấp code và hướng dẫn mẫu để bạn chép vào dự án của mình. Tài liệu chính thức thiên về mô tả tính năng và thông số, còn repo này thiên về ví dụ chạy được. README cũng dẫn tới tài liệu nhà phát triển của Anthropic để bạn tra thêm.
Tôi chưa biết gì về Claude API thì bắt đầu từ đâu?
README khuyên bạn học khóa Claude API Fundamentals của Anthropic trước để có nền tảng. Sau đó hãy thử các notebook cơ bản như phân loại và tóm tắt trong thư mục capabilities.


