Bỏ qua tới nội dung
Ông T.vn

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

12 phút đọcCập nhật

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 →

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

Tóm tắt nhanh

Claude Cookbooks là tập hợp notebook và hướng dẫn mẫu để xây ứng dụng với Claude API. Repo phù hợp cho người muốn học qua ví dụ thực tế, từ phân loại, tóm tắt đến tool use và xử lý hình ảnh. README chưa ghi quy trình cài đặt đầy đủ, nhưng yêu cầu Python 3.11–3.12 và Claude API key.

Repo này là bộ notebook và công thức mẫu giúp bạn học cách xây ứng dụng với Claude API. Nội dung chủ yếu viết bằng Python, tập trung vào các đoạn mã có thể sao chép và điều chỉnh cho dự án thật.

Đây là lựa chọn phù hợp cho lập trình viên mới làm quen với Claude, nhóm sản phẩm muốn thử nhanh một tính năng AI, hoặc người làm kinh doanh cần xem các mẫu ứng dụng trước khi giao cho đội kỹ thuật. Giá trị lớn nhất của repo nằm ở phạm vi ví dụ rộng: bạn có thể bắt đầu từ một notebook đơn giản rồi đi dần đến RAG, tool use, đánh giá tự động, tối ưu chi phí và tối ưu độ trễ.

Repo dùng giấy phép MIT, hiện có khoảng 54.601 sao và 6.625 fork. Nội dung vẫn được cập nhật gần đây. Tuy nhiên, đây là một thư viện ví dụ chứ không phải một ứng dụng cài xong là có giao diện dùng ngay.

Thư viện

anthropics/claude-cookbooks

Bộ notebook và công thức giúp học, thử nghiệm và tích hợp Claude API vào ứng dụng Python.

★ 55kJupyter NotebookMIT
Xem repo trên GitHub

I.Claude Cookbooks làm được gì

A.Học Claude API qua mã mẫu có thể dùng lại

Các notebook trình bày những đoạn mã hoàn chỉnh hơn so với việc chỉ đọc tài liệu lý thuyết. Bạn có thể mở từng ví dụ, chạy thử, thay dữ liệu đầu vào rồi lấy phần phù hợp đưa vào dự án riêng.

README cho biết các ví dụ chủ yếu viết bằng Python. Nếu ứng dụng của bạn dùng ngôn ngữ khác, các khái niệm vẫn có thể chuyển đổi sang ngôn ngữ có khả năng gọi Claude API.

B.Xử lý văn bản và dữ liệu

Nhóm Capabilities có các chủ đề như phân loại, tóm tắt và Retrieval Augmented Generation. Đây là nền tảng cho nhiều việc văn phòng và kinh doanh: phân loại yêu cầu khách hàng, rút gọn nội dung dài, hoặc trả lời dựa trên tài liệu nội bộ.

Điểm thực tế là bạn có thể xem cách tiếp cận theo từng bài toán thay vì phải tự thiết kế mọi thứ từ đầu.

C.Kết nối Claude với công cụ và hệ thống bên ngoài

Nhóm Tool Use and Integration hướng dẫn cách để Claude gọi công cụ hoặc hàm bên ngoài. Ví dụ trong README 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.

Cách này phù hợp khi bạn muốn Claude không chỉ trả lời bằng văn bản mà còn thực hiện một thao tác có kiểm soát, chẳng hạn tính toán, tra dữ liệu hoặc xử lý yêu cầu theo quy trình.

D.Làm việc với dữ liệu bên ngoài và cơ sở dữ liệu vector

Repo có ví dụ Retrieval Augmented Generation với tích hợp bên thứ ba, trong đó có Pinecone, cùng ví dụ đọc nội dung trang web. Ngoài ra còn có hướng dẫn tạo embeddings với Voyage AI.

Những mẫu này giúp bạn hình dung cách đưa tài liệu hoặc dữ liệu riêng vào luồng hỏi đáp. Bạn vẫn cần tự kiểm tra yêu cầu tài khoản và cấu hình của từng dịch vụ bên ngoài vì README tổng quan không mô tả đầy đủ từng tích hợp.

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

Nhóm Multimodal có các notebook về bắt đầu với hình ảnh, thực hành tốt khi dùng khả năng nhìn, đọc biểu đồ và PowerPoint, cũng như trích xuất nội dung từ biểu mẫu. Repo còn có ví dụ tải PDF lên Claude để tóm tắt.

Đây là phần hữu ích cho nhân viên văn phòng hoặc nhóm vận hành đang có nhiều tài liệu không chỉ gồm văn bản. Bạn có thể dùng notebook làm điểm xuất phát để thử với tài liệu mẫu của mình.

F.Thử nghiệm các kỹ thuật nâng cao

Repo có ví dụ về sub-agent, đánh giá tự động, JSON mode, bộ lọc kiểm duyệt nội dung, prompt caching, tối ưu chi phí và tối ưu độ trễ.

Các phần này giúp đội kỹ thuật trả lời những câu hỏi thực tế hơn: làm sao buộc đầu ra có cấu trúc, làm sao đo chất lượng prompt, làm sao kiểm soát nội dung, và làm sao cân bằng giữa tốc độ, độ chính xác và chi phí.

II.Cần chuẩn bị gì

  • Máy có thể chạy Python phiên bản từ 3.11 đến dưới 3.13, tức Python 3.11 hoặc 3.12.
  • Claude API key. README nói bạn cần API key để khai thác các ví dụ và có thể đăng ký tài khoản miễn phí theo hướng dẫn của Anthropic.
  • Kiến thức Python cơ bản sẽ giúp bạn đọc và sửa notebook dễ hơn. README không yêu cầu GPU.
  • Các ví dụ chủ yếu là Jupyter Notebook. README không nêu hệ điều hành bắt buộc, nên tư liệu được cung cấp chưa xác nhận chi tiết khả năng chạy trên Windows, macOS hay Linux.
  • Một số notebook có thể cần dịch vụ bên thứ ba tương ứng, như Pinecone hoặc Voyage AI. README chỉ nêu các tích hợp này, chưa liệt kê đầy đủ tài khoản hay key riêng cho từng dịch vụ.

Repo có file .env.example với các tên biến cấu hình sau: ANTHROPIC_API_KEY, CLAUDE_MODEL, TEST_MODE, MAX_TOKENS và DEBUG. Tư liệu được cung cấp chỉ cho biết tên biến, chưa ghi giá trị mẫu hoặc cách nạp file này.

Không dán API key vào notebook công khai và không đưa key vào Git. Hãy xem cách repo đọc biến môi trường trước khi chạy các ví dụ có gọi API.

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

  1. Chuẩn bị môi trườngCài Python phù hợp và chuẩn bị Claude API key
  2. Tải mã nguồnClone repo về máy
  3. Đi vào thư mụcMở terminal tại thư mục claude-cookbook
  4. Xem cách chạyĐọc README, pyproject.toml và Makefile để chọn quy trình của repo
  5. Mở notebookChọn công thức phù hợp và cấu hình biến môi trường theo tài liệu trong repo

A.Chuẩn bị Python và API key

Cài Python phiên bản 3.11 hoặc 3.12 trên máy. Đây là yêu cầu được khai báo trong pyproject.toml: Python phải lớn hơn hoặc bằng 3.11 và nhỏ hơn 3.13.

Sau đó chuẩn bị Claude API key. README nói key là điều kiện cần để dùng các ví dụ. Hãy lưu key ở nơi an toàn và kiểm tra hướng dẫn cụ thể trong repo trước khi đặt vào biến môi trường hoặc notebook.

README không cung cấp lệnh cài Python, lệnh tạo môi trường ảo hay lệnh cài dependency. Vì vậy, không nên tự đoán tên cờ hoặc quy trình riêng của repo. Các file có thông tin chạy là pyproject.toml và Makefile; hãy mở hai file này để xem lệnh chính xác.

B.Clone repo về máy

Mở PowerShell hoặc terminal tại thư mục bạn muốn lưu mã nguồn, rồi chạy:

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

Lệnh này tải repo về máy và tạo thư mục claude-cookbooks. Nếu máy báo không nhận diện git, bạn cần cài Git trước. README được cung cấp không có hướng dẫn cài Git.

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

Terminal
cd claude-cookbooks

Sau lệnh này, terminal đang làm việc bên trong repo. Người mới thường chạy lệnh từ sai thư mục hoặc gõ sai tên thư mục. Bạn có thể kiểm tra thư mục hiện tại bằng cách nhìn đường dẫn terminal, sau đó mở README.md, pyproject.toml và Makefile.

D.Đọc quy trình cài đặt có trong repo

Repo có pyproject.toml, Makefile, uv.toml, uv.lock và requirements-dev.txt. Tuy nhiên, nội dung các file này không nằm trong tư liệu được cung cấp, còn README không ghi câu lệnh cài đặt cụ thể.

Vì vậy, README chưa ghi cách cài đầy đủ. Sau khi vào thư mục repo, bạn hãy tìm các mục hướng dẫn trong README.md, các target trong Makefile, phần dependency trong pyproject.toml và cấu hình liên quan trong uv.toml trước khi chạy lệnh.

Không tự thay thế bằng tên gói khác. Tên gói Python được cung cấp là anthropic-cookbook, nhưng tư liệu không đưa lệnh cài package này, nên bài này không bịa thêm lệnh cài đặt.

E.Chọn notebook để chạy

Sau khi hoàn tất quy trình mà repo khai báo, chọn notebook theo nhu cầu. Bạn có thể bắt đầu từ phân loại, tóm tắt hoặc ví dụ vision. Nếu cần truy cập dữ liệu bên ngoài, xem nhóm tool use, RAG hoặc third-party.

Trước khi chạy, kiểm tra notebook có yêu cầu biến nào và điền API key theo đúng cách repo hướng dẫn. Các biến đã được liệt kê trong .env.example gồm ANTHROPIC_API_KEY, CLAUDE_MODEL, TEST_MODE, MAX_TOKENS và DEBUG; tư liệu hiện chưa nói giá trị mặc định hay câu lệnh khởi động notebook.

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

README không đưa một lệnh kiểm tra duy nhất, cũng không mô tả màn hình đầu ra chuẩn sau khi cài. Cách kiểm tra an toàn nhất theo tư liệu là:

  • Xác nhận Python đang ở phiên bản 3.11 hoặc 3.12.
  • Xác nhận đã clone đúng repo và đang ở thư mục claude-cookbooks.
  • Mở một notebook đơn giản trong nhóm Capabilities hoặc Multimodal.
  • Kiểm tra API key đã được cung cấp theo hướng dẫn trong repo.
  • Chạy từng ô theo thứ tự. Nếu notebook trả về kết quả phân loại, tóm tắt hoặc phản hồi từ Claude mà không báo lỗi xác thực, môi trường cơ bản đã hoạt động.

Nếu notebook yêu cầu dịch vụ bên thứ ba, việc chạy thành công còn phụ thuộc cấu hình của dịch vụ đó. README tổng quan không cung cấp kết quả đầu ra cụ thể cho từng notebook, nên hãy dùng phần văn bản và ví dụ ngay trong notebook làm chuẩn đối chiếu.

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

A.Chủ shop phân loại tin nhắn khách hàng

Một chủ shop có thể dùng nhóm Classification để thử phân loại tin nhắn thành các nhóm như hỏi giá, hỏi vận chuyển, đổi trả hoặc khiếu nại. Bạn chuẩn bị một tập tin nhắn mẫu, mở notebook về classification, rồi thay dữ liệu ví dụ bằng dữ liệu của shop.

Kết quả mong muốn là mỗi tin nhắn được xếp vào nhóm phù hợp. Sau khi kiểm tra chất lượng, đội kỹ thuật có thể lấy đoạn mã trong notebook để đưa vào quy trình chăm sóc khách hàng. README xác nhận repo có hướng dẫn phân loại, nhưng không đưa prompt mẫu hay định dạng đầu ra cố định.

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

Nhân viên có thể bắt đầu với notebook Summarization để rút gọn biên bản, tài liệu nội bộ hoặc nội dung nghiên cứu. Cách làm là mở notebook tóm tắt, thay phần văn bản mẫu bằng tài liệu cần xử lý và chạy các ô theo hướng dẫn.

Kết quả là bản tóm tắt do Claude tạo ra. Với tài liệu nhạy cảm, cần kiểm tra chính sách dữ liệu của tổ chức trước khi gửi nội dung lên API. README chỉ giới thiệu kỹ thuật tóm tắt, không cam kết mức độ bảo mật hay độ chính xác cho từng loại tài liệu.

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

Một lập trình viên có thể xem notebook customer_service_agent trong nhóm Tool Use. Mục tiêu là để Claude xử lý hội thoại và kết nối với các hàm hoặc công cụ được ứng dụng cung cấp.

Bạn có thể dùng nó làm mẫu để thiết kế trợ lý trả lời câu hỏi thường gặp, sau đó bổ sung quy tắc để các thao tác nhạy cảm cần người duyệt. README xác nhận có ví dụ customer service agent, nhưng không mô tả API cụ thể của một hệ thống bán hàng.

D.Nhóm kỹ thuật xây hỏi đáp trên tài liệu và đọc biểu đồ

Nếu doanh nghiệp có kho tài liệu, nhóm kỹ thuật có thể bắt đầu với các notebook RAG hoặc ví dụ Pinecone để thử truy xuất thông tin liên quan trước khi gửi câu hỏi cho Claude. Nếu dữ liệu nằm trong biểu đồ, biểu mẫu hoặc PowerPoint, nhóm có thể xem phần Multimodal về đọc biểu đồ và trích xuất nội dung.

Kết quả là một quy trình thử nghiệm giúp Claude trả lời dựa trên dữ liệu được cung cấp hoặc diễn giải nội dung hình ảnh. Các tích hợp bên thứ ba có thể cần cấu hình riêng; README không ghi đầy đủ thông số tài khoản và chi phí.

Giá trị của Claude Cookbooks nằm ở chỗ biến một ý tưởng AI thành notebook có thể mở ra, chạy thử và sửa ngay.

Ông T

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

A.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 phù hợp với yêu cầu trong pyproject.toml. Hãy kiểm tra phiên bản Python và dùng phiên bản nằm trong khoảng từ 3.11 đến dưới 3.13.

B.Chưa cấu hình API key

Notebook có thể không gọi được Claude nếu thiếu ANTHROPIC_API_KEY hoặc key không được nạp đúng cách. Kiểm tra .env.example, README và nội dung notebook để biết repo kỳ vọng key ở đâu. Không đưa key trực tiếp vào file sẽ được commit.

C.Chạy sai thư mục

Lệnh hoặc đường dẫn tương đối có thể lỗi nếu terminal không đứng trong thư mục repo. Chạy cd claude-cookbooks trước, rồi kiểm tra các file như README.md, pyproject.toml và Makefile có xuất hiện trong thư mục hiện tại.

D.Tự đoán lệnh cài đặt

README được cung cấp không có lệnh cài dependency. Việc tự gõ một lệnh với package hoặc cờ không được repo ghi có thể tạo môi trường sai. Hãy đọc pyproject.toml, Makefile, uv.toml và uv.lock để lấy quy trình chính xác.

E.Notebook cần dịch vụ bên thứ ba

Các ví dụ Pinecone, Voyage AI hoặc đọc dữ liệu ngoài có thể cần cấu hình riêng. Nếu notebook báo thiếu thông tin xác thực, xem phần hướng dẫn ngay trong notebook và tài liệu của dịch vụ tương ứng; không dùng API key của Claude thay cho key của dịch vụ khác.

VII.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ụ thực tế, cần nhiều mẫu để khởi động nhanh, hoặc đang so sánh các kỹ thuật như tool use, RAG, vision, JSON mode, đánh giá và tối ưu. Số lượng chủ đề lớn giúp repo phù hợp cho cả người mới lẫn đội kỹ thuật đang làm prototype.

Điểm mạnh là mã nguồn có thể sao chép, nội dung bao phủ nhiều bài toán và có các thư mục chuyên biệt như capabilities, multimodal, tool_use, evals, cost_optimization và latency_optimization. Giấy phép MIT cũng thuận tiện cho việc tham khảo và tích hợp.

Giới hạn là đây không phải sản phẩm hoàn chỉnh. README tổng quan chưa ghi quy trình cài đặt đầy đủ, chưa nêu đầu ra chuẩn cho từng notebook và không cung cấp chi tiết cấu hình của mọi dịch vụ bên thứ ba. Bạn cũng cần tự đánh giá độ chính xác, quyền riêng tư và chi phí khi đưa ví dụ vào vận hành.

Nếu bạn cần một ứng dụng có giao diện sẵn, một framework độc lập với Claude, hoặc một quy trình đã đóng gói cho doanh nghiệp, nên chọn công cụ chuyên biệt khác. Nếu mục tiêu là học nhanh, thử nghiệm và lấy mã mẫu để xây ứng dụng Claude, Claude Cookbooks là điểm bắt đầu đáng cân nhắc.

4.2/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

Repo này có miễn phí không?

Repo dùng giấy phép MIT. README cũng nói bạn có thể đăng ký Claude API key miễn phí, nhưng tư liệu không cho biết chi phí sử dụng API thực tế.

Có cần GPU để chạy Claude Cookbooks không?

README không yêu cầu GPU. Các ví dụ chủ yếu viết bằng Python và tương tác với Claude API.

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

Tư liệu được cung cấp không nêu hệ điều hành bắt buộc và cũng không xác nhận riêng cho Windows. Bạn cần tự kiểm tra quy trình trong repo và môi trường Python của mình.

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

`pyproject.toml` yêu cầu Python từ 3.11 đến dưới 3.13. Vì vậy nên dùng Python 3.11 hoặc 3.12.

Có cần API key không?

Có. README nói cần Claude API key để sử dụng các ví dụ, và `.env.example` có biến `ANTHROPIC_API_KEY`.

Dữ liệu gửi vào notebook có an toàn không?

Tư liệu không đưa cam kết bảo mật dữ liệu. Bạn nên kiểm tra chính sách của tổ chức và tránh đưa dữ liệu nhạy cảm vào API khi chưa được phê duyệt.

Repo có phải ứng dụng cài xong là dùng được không?

Không. Đây là bộ notebook và công thức cho lập trình viên xây ứng dụng với Claude. README chưa ghi quy trình cài đặt đầy đủ, nên bạn cần đọc thêm `pyproject.toml` và `Makefile`.

Chuyển nhanh tới mục

  1. I.Claude Cookbooks làm được gì
    1. A.Học Claude API qua mã mẫu có thể dùng lại
    2. B.Xử lý văn bản và dữ liệu
    3. C.Kết nối Claude với công cụ và hệ thống bên ngoài
    4. D.Làm việc với dữ liệu bên ngoài và cơ sở dữ liệu vector
    5. E.Phân tích hình ảnh, biểu đồ, biểu mẫu và PDF
    6. F.Thử nghiệm các kỹ thuật nâng cao
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chuẩn bị Python và API key
    2. B.Clone repo về máy
    3. C.Đi vào thư mục dự án
    4. D.Đọc quy trình cài đặt có trong repo
    5. E.Chọn notebook để chạy
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop phân loại tin nhắn khách hàng
    2. B.Nhân viên văn phòng tóm tắt tài liệu dài
    3. C.Dev xây trợ lý chăm sóc khách hàng có công cụ
    4. D.Nhóm kỹ thuật xây hỏi đáp trên tài liệu và đọc biểu đồ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Python không đúng phiên bản
    2. B.Chưa cấu hình API key
    3. C.Chạy sai thư mục
    4. D.Tự đoán lệnh cài đặt
    5. E.Notebook cần dịch vụ bên thứ ba
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.